NAME
lcell_dis - Discover LattisCell ATM Switches, place them,
and add them to the Network Map.
SYNOPSIS
lcell_dis [ -vn viewname ] [ - st snmptimeout ] [ - rc
retrycount ] [ -pd polldefault ] [ -rd readdefault ] [ -wd
writedefault ] [ -ws windowsize ]
DESCRIPTION
This program reads the user's SunNet Manager Database and
extracts the properties necessary to be able to discover the
ATM network devices from the CMS. Then it begins the pol-
ling cycle, during which it combines new data from the agent
in the CMS with old data from the SNM Database, and updates
the network map to show ATM objects and links. It also
writes status change messages to the discover fault log.
The polling cycle consists of the following. First, dis-
cover locks the SNM Database to prevent changes during the
polling cycle. Then it reads the contents of the indicated
view. Then it queries the CMS agent using SNMP for several
MIB objects that indicate the topology of switches and ports
on those switches. Next, it merges the old data from the
database with the new data from the agent, and constructs a
new updated map of the ATM network. Then it checks for any
objects that have changed status, and reports those to the
discover fault log. Finally, it alters the contents of the
SNM database to show the proper objects and links, all with
the proper colors. Then it gets to wait for the polling
interval configured by the user. During the wait period,
the program will react within five seconds to any change of
the polling interval. To change the polling interval, use
SNM's Properties window to modify "Secs between polls" for
the named domain view.
OPTIONS
-vn viewname Names the view to be discovered. This
option is required. The
attributes/properties of that view determine
the IP Address to which SNMP requests are
sent, and therefore a particular instance of
CMS. The resulting topology is placed inside
the named view in the database.
-st snmptimeout
Tells how many milliseconds to wait before
assuming that a UDP/IP (SNMP) packet between
NMS and CMS has been lost. If responses are
not received within that time, discover
treats the response as lost, and reissues the
request. The default is 5000 (five seconds).
-rc retrycount After a timeout occurs (see snmptimeouts
above), discover will try again this many
times before giving up on this particular
poll cycle. If it has to retry at least once
but less than retrycount, then the CMS icon
in the network map will change to the margi-
nal (yellow) state. If it has to retry as
many as retrycount times, it will assume the
CMS agent is either not running or is not
accessible, and the CMS will move to the down
(red) state. The default is 5 (five
retries).
-pd polldefault
If the user does not enter the "Secs between
polls" attribute for the view (using SNM Pro-
perties dialog), then polldefault will be
used. This is the case when the "Secs
between polls" value is zero. This value is
20 seconds if not specified.
-rd readdefault
This determines the default read community
string, if the user has not entered one (or
it is null) in the view's "SNMP RdCommunity"
property. This value is "public" if not
specified.
-wd writedefault
This determines the default write community
string, if the user has not entered one (or
it is null) in the view's "SNMP WrCommunity"
property. This value is "private" if not
specified.
-ws windowsize This tells the amount of space into which
the discover placement algorithm should place
the ATM network objects. The windowsize
takes the form "WIDTHxHEIGHT", and defaults
to 555x305, which fits nicely in the default
size of the SNM console.
EXAMPLES
lcell_dis -vn my-domain
FILES
The status change messages go to a log file placed in
/usr/lnms/tmp. The logfile has a suffix of lcell_dis_log
and this file is also read by the Fault Log dialog. If this
file grows too large, the user should exit lcell_dis, remove
the file, and restart lcell_dis.
To prevent the situation where two processes are trying to
manage the same CMS agent for the same user at the same
time, a lock file is used. The lock file has the suffix of
lcell_dis_lock and this file is normally handled automati-
cally. In the unusual situation where lcell_dis will not
start but a previous copy of lcell_dis is not running,
remove the lock file, and restart lcell_dis.
ENVIRONMENT
The environment variable "LCELLNMS_DIS_SIZE" can also be
used to control the window size for placement of objects.
Set this environment variable before starting SunNet Manager
(if you launch LattisCell Discover from menu items). A typ-
ical, larger, non-default value for this environment vari-
able might be "800x500". If the environment variable is set
and "-ws" is also used, the value with "-ws" will be used.
SEE ALSO
none.