atmilmid(1M)atmilmid(1M)NAMEatmilmid - SNMP agent supporting ATM Forum's ILMI MIBs
SYNOPSIS
/usr/etc/atmilmid [ -d debug ] [ -l loglevel ] [ -p port ]
DESCRIPTIONatmilmid is an SNMP agent supporting the ATM Forum's Interim Local
Management Interface (ILMI) MIBs. It is registered as a subagent with the
snmpd, so these MIBs can be scanned with any of the browsers used with
snmpd. atmilmid listens on a UDP(7P) socket for queries from the main
SNMP agent (i.e. snmpd). By default, it uses port 23849, however
alternate ports can be specified with the -p flag.
In addition to fielding queries from the main agent over IP, the atmilmid
also exchanges SNMP-encoded ILMI messages with the ATM switch on the
other side of each User-Network-Interface (UNI) that it manages. The most
important of the UNI ILMI procedures is the address registration
procedure at switch or user startup. Without this autoconfiguration
procedure, the ATM address to be used at each UNI would have to be
statically configured on both the switch and host.
By default (without use of the -d flag), atmilmid logs its messages to
syslog(3B).
Options
atmilmid accepts the following command line options.
-p port This option defines an alternate UDP port to use for
servicing queries by the main agent (i.e. snmpd). If this
option is used, the port field for this subagent (atmilmid)
in the file /etc/snmpd.remote.conf must be changed to match.
-l loglevel This option controls the level of messages produced by
atmilmid. The value of loglevel is the text string as used
by syslog(3B): DEBUG, INFO, NOTICE, WARNING, ERR, CRIT,
ALERT, and EMERG and can be found in
/usr/include/sys/syslog.h. For example, the loglevel WARNING
would display all warning messages and all messages with a
level higher than WARNING. The default value for loglevel is
ERR.
-d debug This option sets the debugging modes of atmilmid. This is
meant for interactive use only and must not be placed in the
atmilmid.options file. Possible values for debug are dump,
input, output, and foreground. dump will hex dump incoming
and outgoing packets; input will display decoded incoming
packets; output will display decoded outgoing packets; and
foreground will make the daemon run in the foreground and log
messages to the standard output. The dump, input, and output
options all imply the foreground option.
Page 1
atmilmid(1M)atmilmid(1M)
Stipulating these options in the file /etc/config/atmilmid.options will
cause the options to be used whenever atmilmid is invoked at boot time
from the shell script /etc/init.d/atm. WARNING: Do not place the -d flag
in the /etc/config/atmilmid.options file as it causes the atmilmid to run
in the foreground, blocking everything after it in the boot sequence. The
-d flags should only be used when debugging a specific problem, when the
original atmilmid process should be killed, and a new instance started
with debug output redirected to a disk file. Killing and restarting the
atmilmid process will not disrupt any ATM connections in progress, and
none of the other ATM software needs to be reset or re-initialized. The
only noticeable disruption is that there may be a temporary inability to
initiate new connections during the time when there is no atmilmid
running.
The atmilmid uses the file /etc/snmpd.auth to authorize queries over the
IP UDP port (see snmpd(1M) for more details). ILMI messages received from
switch(es) over the ATM port(s) are valid if they use community ILMI, as
specified by the ATM Forum UNI.
The Configuration File
All configuration for the atmilmid is defined in the file
/var/atm/atmilmid.conf.
The ATM Forum ILMI defines the concept of a unique Port Interface Index
associated with each ATM port on the system. These are defined in the
file /var/atm/atmilmid.conf using the ATMPORT keyword. Read the comments
section at the start of the file for an explanation of the syntax used.
This file must be edited when additional ATM cards are installed (or
removed) to define ports to be managed by the atmilmid. The ATM Forum
has defined VPI 0, VCI 16 as the default VPI/VCI pair to be used for ILMI
messages, so if your switch is configured to use a non-standard VPI/VCI,
edit this file to specify the VPI and VCI to be used.
If the IRIX ATM port is attached to a switch that does not support ILMI
address registration, then an ATM address has to be assigned to that
port, and that address has to be configured both on this system, as well
as in the switch's routing table. To configure an ATM address for a port,
use the ATMADDRESS keyword to define the address in the configuration
file /var/atm/atmilmid.conf. The syntax and address formats are described
in the comments in the ATMADDRESS section in that file. This address does
not have to be defined if the port is attached to a switch supporting
ILMI address registration.
DIAGNOSTICS
When running in (the default) daemon mode, error messages are logged in
/usr/adm/SYSLOG. If the atmilmid encounters any I/O errors on any ATM
port, it will shut down operations on that port, but keep running
otherwise. This behaviour ensures that there are no disruptions in
service on other ATM ports in the system. The following error message
will be logged in /usr/adm/SYSLOG:
"Terminating operation on /hw/atm/#, send SIGHUP signal to resume
Page 2
atmilmid(1M)atmilmid(1M)
when board is operational"
When you send the SIGHUP signal ("killall -HUP atmilmid") it will cause
the atmilmid to probe every interface which it has marked as
unoperational. If the error conditions are no longer present, the
atmilmid will resume operations on that interface. If you use atmconfig
to reset a board, you must send a SIGHUP to the atmilmid after you have
brought the board back up.
FILES
/usr/etc/atmilmid
/etc/config/atmilmid.options
/etc/init.d/atm
/etc/snmpd.data
/etc/snmpd.auth
/etc/snmpd.remote.conf
/usr/lib/netvis/mibs/atmf_ilmi.mib
/var/atm/atmilmid.conf
SEE ALSOatm(7M), if_atm(7M), atmsigd(1M), atmconfig(1M), atmstat(1M),
ifatmconfig(1M), snmpd(1M)
Page 3
