logo

Manual Pages


Table of Contents

NAME

na_atm_elconfig - ATM Forum LAN Emulation configuration tool

SYNOPSIS

atm elconfig show [ elan | -auto | -all | -configured -lecs ]
[ -unit unit ]

atm elconfig add elan | -auto [ -unit unit ] [ -if inter_face ]

atm elconfig add [ -les ATMaddress ]

atm elconfig add [ -type ethernet ]

atm elconfig delete elan | -auto | -lecs [ -unit unit ]

atm elconfig set -lecs ATMaddress | -wellknown | -manual [ -unit unit ]

atm elconfig wait [ maxSeconds ]

DESCRIPTION

The atm elconfig command allows one to display and modify the ATM Forum LAN Emulation Client configuration. atm elconfig allows the super-user to set the ATM address of the LAN Emulation Configuration Server (LECS), display the list of Emulated LANs (ELANs) configured in the LECS for this host, display the list of ELANs locally configured along with the membership state of each, and locally administer ELAN membership.

COMMANDS

show
The -configured flag is used to display the name, the ATM addresses of the LE Services, local ATM addresses of the LEC, specific ELAN information, and the local network interface name of each ELAN currently configured in the system. Since the LE Services' ATM addresses may be acquired dynamically, only those addresses that have been learned will be displayed. In addition, if connections exist to the LE Services, the VPI/VCI pairs for each connection are displayed. Alternatively, a single ELAN's configuration information may be displayed by specifying the single argument elan. To retrieve the ATM address of the current LECS, the -lecs flag is used. If no options are given, the name and ATM address of the LES for each ELAN returned by the LECS are displayed.

add
The add command enables the user to join a particular ELAN and specify certain configuration parameters. The -auto flag is used to instruct the LEC to join the ELAN that is returned by the LECS. The -if flag maps elan to the network interface (e.g. el0 ), providing a mapping between ELAN name and network interface name. The -les flag allows the specification of the LES's ATM address as ATMaddress for joining ELANs whose configuration information is not returned by a LECS. The -les flag can be used only when -manual flag is set in the `atm elconfig set' command.

delete
Used with elan, unjoin the specified ELAN, terminating connections to both its LES and BUS and removing the network interface associated with this ELAN. The -auto flag is used to delete an Automatic ELAN that was specified by -auto flag during the add operation. Used with the -lecs flag, remove the current LECS from the configuration. A LECS may be deleted only if no ELANs are currently configured from that LECS.

set -lecs
If the single argument, ATMaddress is used, set the ATM address of the LECS to ATMad_dress and mark this LECS as current. If another set command is invoked with a different LECS address, this LECS is now marked as current. The add and delete commands may only be applied to ELANs returned by the current LECS. The -manual flag places the host in a manual configuration mode; configuration information will not be retrieved from the LECS and the addition of ELANs will require the user to set the LES address by using -les flag in the `atm elconfig add' command.

wait
The wait command waits until all ELAN interfaces are ready, or until the number of seconds specified by maxSeconds have elapsed, whichever occurs first. If maxSeconds is not specified, then the default is 60 seconds. The atm elconfig wait command should be put in the /etc/rc file after the last ifconfig command so that subsequent commands that depend on the ELAN interfaces do not fail. When the filer is booted, the ELAN interfaces may not become ready immediately when ifconfig'ed because it may take several seconds for the filer and ATM switch to complete the initialization required by the UNI signalling, ILMI, and LANE protocols.

NOTES

The -unit flag is mandatory if there is more than one adapter installed.

RESTRICTIONS

The interface associated with an ELAN must first be configured "down" through ifconfig(1) before deleting the ELAN. If the user attempts to delete an ELAN that is "up", the message `atm elconfig: ELAN in use' will be displayed.

CLUSTER CONSIDERATIONS

In takeover mode, the ELAN interface names and unit numbers are those on the live filer, and in partner mode the interface names and unit numbers are those on the failed filer. Only ELANs associated with the live or failed filer are shown, depending on the current host mode.

SEE ALSO

na_ifconfig(1)


Table of Contents

Copyright © 1994-2007 Network Appliance. Legal Information