snmp management software LoriotProsnmp management software LoriotPro

Administrator Handbook
www.loriotpro.com

TOC

LoriotPro Service Plugin

Introduction

Additional Services are loaded in complement of the LoriotPro resources and default services. They are not linked to Directory objects like other Plugin. They are use to provide extended services to LoriotPro such as could be other Windows applications.

They are linked to the LoriotPro kernel therefore have no places in the Directory but in a dedicated tree. When you load a new Directory (A set of objects and a working environment) all current objects are removed but the service Plugin stay active.

Figure 12 : Arbre des plugins de services

The service tree and its options are described in other chapters of the manual. The WEB  server has been presented in a previous paragraph thus we describe hereafter only the functions and parameters of the Plugin.

Few examples of this Plugin types are provided by default, source codes are within the SDK.

Plugin : NetbiosNameResolve.sp

This Plugin finds out all Netbios name, the names used in Microsoft environment, by doing Netbios requests on the Directory host Objects.

This Plugin is a good example of use of the DSNMP Directory API within a service Plugin.

Figure 14 : Plugin NetbiosNameResolve.sp

      Warning

By using this Plugin, on demand links  (Dialup lines) could be involuntary opened.

Plugin : TraceRouteDiscover.sp

The TraceRouteDiscover Plugin discovers by means of ICMP protocol, the path between the LoriotPro hosts and any other host. The path contains the successive crossed router.

It allows the discovering of the network topology from its routing information table. It could be useful when SNMP is not available or implemented. The discovered information could be added to the Directory.

Figure 15 : Plugin TraceRouteDiscover.sp

Plugin : CHttp.sp

This service plugin provides the WEB server function integrated in LoriotPro. It supports advanced script function. Whitout this Plugin the remote access from a WEB Navigator to the LoriotPro console is impossible.

This Plugin is explained in detail in another chapter.

Figure 16 : Plugin CHttp.sp

Configuration

Table of parameters

Parameters

Functions

name

The name that should be use as SMTP sender

Address

Complementary information, Your E-mail for example.

Warning

Filling this field is obligatory

Server :

Host name / Address

The IP address or the name of the SMTP server.

Example 

187.1.1.9

smtp.nodo-vide.com

Server :

Port

The protocol port number used by the SMTP server.

By default 25.

Scheduler :

Timeout

The time between two sending.

Update Parameters

This button takes in account the new parameters each time you do a change.

Example

In the following example the file trapfilter.txt located in the /bin directory is configured to perform  the sending of an E-mail message to address ludo3@test.com when receiving a  SNMP LinkDown Trap.

File trapfilter.txt (extract)

trap  LinkDown 2 0 6 "%r for %n from %i  Interface %1 at %t Description %1 Type %2 Status %3" 10002
 action 10.33.10.121 255.255.255.255 public wave "wave/ding.wav"
 action 0.0.0.0 0.0.0.0 * smtp "ludo3@test.com %T %i  %r for %n from %i from proxy [%p] Request from station [%0]"

Each time a trap of this type is received a new file is created in the

bin/smtp_out directory.

C         Remark

Refers to the chapter “Event management” to have more detailed explanations on the Trap management and about the syntax used in the trapfilter.txt file.

Figure 18 :  Répertoire smtp_out

The file created in the bin/smtp_out directory have a predefined structure:

Ø     The first line contains the EMAIL address.

Ø     The second line contains the parameters of the trapfilter.txt file.

File 1007835798.ludo@test.com.txt

ludo3@test.com

ludo3@test.com Sat Dec 08 19:23:18 2001 10.33.10.121  LinkDown for linkdown from 10.33.10.121 from proxy [10.33.10.121] Request from station [153781]

The Plugin working in background mode will browse the directory at regular interval and send all waiting messages.

Plugin : LoriotNetFlowCollectorService.sp

Introduction

Cisco has developed within some of its equipment what they call the NetFlowCollector.

Netflow is a protocol use to collect on a “collector” traffic information from the devices.

This Plugin is able to receive NetFlow UDP packets of version 5 and thus works as a “collector”

All gathered information by this way could be stored in the ODBC Database if this one is configured.

This Plugin is a good example of use of the ODBC API provided within the SDK.

Figure 19 : Plugin LoriotNetFlowCollectorService.sp

Configuration

This Plugin is configured from the menu  with the Properties option or directly by clicking on the properties button in the main window.

Table of parameter

Parameters

Functions

UDP Recept Port

The UDP port is configured in the Cisco equipment (here 9999)

Example: If your LoriotPro has the address 10.33.10.130

The Cisco configuration would be

ip flow-cache entries 1024

ip flow-cache feature-accelerate

!

interface Ethernet0

 ip address 10.33.10.121 255.255.0.0

 ip route-cache flow

!

ip flow-export version 5

ip flow-export destination 10.33.10.130 9999 

 

http Server URL

The URL to use for displaying the records of the database.

A PHP script is provided as example in the www/www directory.

bin\www\www\l_netflowmenu.html

Create loriot_netflow table

Remark

Normally the Database tables are created when configuring the ODBC access. This option is here to provide examples on the API ODBC utilization within a Plugin

Example MySQL :

CREATE TABLE loriot_netflow (

  number int(4) unsigned NOT NULL auto_increment,

  timestamp int(4) unsigned NOT NULL DEFAULT '0' ,

  sysuptime int(4) unsigned ,

  version int(1) unsigned ,

  host_id int(4) unsigned NOT NULL DEFAULT '0' ,

  engine_type int(1) unsigned ,

  engine_id int(1) unsigned ,

  ip_src char(15) ,

  ip_dst char(15) ,

  srcaddr int(4) unsigned ,

  dstaddr int(4) unsigned ,

  nexthop int(4) unsigned ,

  input int(2) unsigned ,

  output int(2) unsigned ,

  dPkts int(4) unsigned ,

  dOctets int(4) unsigned ,

  first int(4) unsigned ,

  last int(4) unsigned ,

  srcport int(2) unsigned ,

  dstport int(2) unsigned ,

  tcp_flags int(1) unsigned ,

  prot int(1) unsigned ,

  tos int(1) unsigned ,

  dst_as int(2) unsigned ,

  src_as int(2) unsigned ,

  dst_mask int(1) unsigned ,

  src_mask int(1) unsigned ,

  flow_sequence int(4) unsigned ,

  UNIQUE number (number,host_id,srcaddr,dstaddr,nexthop)

);

The Analyze button starts the WEB navigator by default and displays the URL previously set.

Figure 20 : Using a PHP script

C         Remark

This Plugin supports the status color concept in the service tree.

In the screen shot above the NetFlow Collector service is green therefore operational.


www.loriotpro.com
Copyright © 2004 LUTEUS SARL. All rights reserved. This documentation is copyrighted by LUTEUS SARL. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying or otherwise, without the prior express written permission of LUTEUS SARL