Platform Notes: The SunATM Driver Software

Error Messages from aarsetup and lanesetup


aarsetup: could not become control process lanesetup: could not become control process

An instance of the setup program was running when another instance was started up. The second instance exits with this error message. Make sure that there is not a previous instance of the program still running. The setup program might take a while to complete if the switch is slow to respond.


aarsetup: could not open stream to Q93B lanesetup: could not open stream to Q93B

The program was unable to communicate with the Q93B driver. Make sure that you run aarsetup or lanesetup as root, and that the SUNWatm package has been properly installed.


aarsetup: could not scan input file lanesetup: could not scan input file

The program was unable to open the /etc/opt/SUNWconn/atm/aarconfig or /etc/opt/SUNWconn/atm/laneconfig file (or the file specified on the command line). Verify that the appropriate file exists, and has the proper permissions. Also make sure you run aarsetup or lanesetup as root.


aarsetup: exiting because of errors lanesetup: exiting because of errors

Errors were encountered while parsing the /etc/opt/SUNWconn/atm/aarconfig or /etc/opt/SUNWconn/atm/laneconfig file, so the setup program cannot successfully complete. Correct the error condition and then execute either aarsetup or lanesetup.


aarsetup: <interface> running as a server, but PVC-only `t' entries exist

The aarsetup program has found an L entry in /etc/opt/SUNWconn/atm/aarconfig, meaning that this interface will be running as a server; however, there are table entries (t entries) containing only PVCs, which cannot be entered into the server's ATM ARP table. Verify your interface's status (server, client, or stand-alone), make sure all t entries include ATM addresses, and execute aarsetup. See "Editing the /etc/opt/SUNWconn/atm/aarconfig File", for more information.


aarsetup: waiting for ilmid to provide prefix lanesetup: waiting for ilmid to provide prefix

In some cases, the address registration process may take several minutes. If so, aarsetup or lanesetup prints out this message saying that it cannot complete until address registration completes. If the messages continue for more than a minute or two, verify your connection to the switch, and that the switch and interface are both supporting ILMI.


undefined variable

You used a variable in a configuration file without using a set statement to assign the value. Add a set statement, or correct the variable name, and run aarsetup or lanesetup again. See "Using Variables in the  /etc/opt/SUNWconn/atm/aarconfig File", and "Using Variables in the /etc/opt/SUNWconn/atm/laneconfig File", for more information.


variable already defined

You tried to set a variable that had been previously set in the same configuration file. Remove the second assignment and run aarsetup or lanesetup again.


variable name ill-formed

You created a variable in /etc/opt/SUNWconn/atm/aarconfig or /etc/opt/SUNWconn/atm/laneconfig that was syntactically invalid. Variable names are a combination of letters, digits, and underscores (_). Choose a conforming variable name and run aarsetup or lanesetup again.


variable name too long

You created a variable in /etc/opt/SUNWconn/atm/aarconfig or /etc/opt/SUNWconn/atm/laneconfig with a name that is greater than the maximum length (32 characters). Choose a variable name shorter than 32 characters and run aarsetup or lanesetup again.


variable value too long

You assigned a value longer than the maximum value length of 128 characters to a variable in a configuration file. If you want a longer value, use a combination of variable names, with each value less than 128 characters. After correcting the variable value lengths, run aarsetup or lanesetup again.


ifname:cannot join ELAN (frame size too large; please use a different ELAN and rerun lanesetup)

The largest MTU size supported by the SunATM software is 9 kilobytes. If the LAN Emulation Services try to set a size larger than 9 Kbytes, the SunATM client cannot join the emulated LAN. Reset your LAN Emulation services to use an MTU size less than or equal to 9 Kbytes, and rerun lanesetup to join the emulated LAN.


ifname: frame-size change (please rerun lanesetup)

The MTU size was changed by the LAN Emulation Services; rerun lanesetup to notify IP of the change. There is a slight chance that TCP connections will remain open during this change, and if that is the case, performance on those connections is affected by the change. Either restart the affected applications or reboot the system if this becomes a problem.


<ifname> could not download the MAC address

This message indicates that an error occurred while lanesetup was attempting to retrieve a MAC address for the indicated interface. Most likely the kernel is out of memory or you have not run atmplumb for the specified interface.


Could not find driver for <ifname>

Each LAN Emulation interface is associated with an ATM driver when LAN Emulation is set up by atmplumb. This message indicates that this interface/driver association has not been made, most likely because you have not run atmplumb for the specified interface.


Not enough MAC addresses on <ATM interface>

The number of Emulated LANs that can be joined over a single physical interface is limited by the number of MAC addresses on the ATM interface board. This message indicates that you tried to join more Emulated LANs than allowed by the number of MAC addresses on the specified interface. You can find the number of MAC addresses on an interface by using the count option on the atmgetmac(1M) command; the number of Emulated LANs and lane instances indicated in /etc/opt/SUNWconn/atm/atmconfig and /etc/opt/SUNWconn/atm/laneconfig should not exceed this number. See "Supporting Multiple Emulated LANs on a Single Interface".