Using the atmadmin Configuration Program

The SunATM configuration program, atmadmin, is an interactive command-line interface. The program contains a hierarchy of menus, which divide the configuration into six main parameter groups: system, physical layer, signalling, ILMI, Classical IP, and LAN Emulation. All but the system parameter group are specific to individual SunATM interfaces, so you must configure the parameters in these groups separately for each interface.

If you prefer, you can enter and change the SunATM configuration information by editing the SunATM configuration files directly. See Chapter 3, Editing SunATM Configuration Files.

See the Glossary for descriptions of the ATM and SunATM terms used in this chapter. Chapter 3, Editing SunATM Configuration Files," and Chapter 5, Classical IP and LAN Emulation ," also provide more information about ATM protocols and the SunATM implementation of these protocols.

Starting the atmadmin Configuration Program

The atmadmin program is installed with the SUNWatm software package in the /etc/opt/SUNWconn/bin directory. The program must be run as superuser. It can be run in any local or remote shell on the SunATM system.

# /etc/opt/SUNWconn/bin/atmadmin

atmadmin Main Menu

After you start the atmadmin configuration program, you see the atmadmin Main Menu. From this menu you can either go to the system parameter group menu (see "System Parameter Group Menu"), or you can enter the SunATM interface you want to configure. The following screen example is from a system with one interface named ba0.

Welcome to the SunATM Admin Program.
The following interfaces are installed in your system:
        ba0
        [S] Modify System Parameters
        [X] Exit
        [?] Help

Enter interface name or option: ba0

After selecting an interface, you will then see the Interface Configuration menu (see "Interface Configuration Menu").

atmadmin Navigation Commands

Table 2-1 lists the basic commands that let you navigate through the menu hierarchy.

System Parameter Group Menu

The system parameter group contains parameters that are not specific to an interface; they apply to the entire system. The following example shows the system parameter group menu.

Modifying system-wide parameters;
Currently configured as an ATM SNMP agent, using UDP port 1000
The SNMP agent options are:
        [A] ATM SNMP agent
        [N] not an agent
        [U] UDP Port


        [P] Previous Menu
        [M] Main Menu
        [X] Exit
        [?] Help

Enter selection:

ATM SNMP Agent Status

You can configure your SunATM system as an ATM SNMP agent. The SunATM SNMP daemon, atmsnmpd, always runs on an ATM host. If you do not run your system as an SNMP agent, the daemon does not bind to a UDP port.

Interface Configuration Menu

Once you select a SunATM interface, you will see the atmadmin Interface Configuration menu. From this menu you can proceed to the interface parameter group sub-menus, which are described in "atmadmin Parameter Groups". You can use these sub-menus to change the SunATM interface configuration parameters.

Modifying ba0
        [Y] Physical Layer
        [U] UNI Signalling
        [I] ILMI Address Registration
        [C] Classical IP
        [L] LAN Emulation

        [P] Previous Menu
        [M] Main Menu
        [X] Exit
        [?] Help

Enter selection:

atmadmin and the SunATM Configuration Files in the /etc/opt/SUNWconn/atm directory

The atmadmin program first attempts to read the current configuration information from the /etc/opt/SUNWconn/atm/atmconfig, /etc/opt/SUNWconn/atm/aarconfig, and /etc/opt/SUNWconn/atm/laneconfig files. If no configuration information is found, or if the files do not exist, the default values listed in Table 2-2 are applied to the installed interfaces.

When saving configuration information, atmadmin overwrites the existing SunATM configuration files in the /etc/opt/SUNWconn/atm directory. Therefore, any comments or other changes you manually made to the files will be lost.