Platform Notes: The SunATM Driver Software

Configuring a LAN Emulation Interface

LAN Emulation, standardized by the ATM Forum's LAN Emulation 1.0 specification, is another way of providing TCP/IP and UDP/IP support over an ATM interface. Address resolution information is provided by a series of LAN Emulation services. When a LAN Emulation interface is brought up, it must "join the LAN," that is, it must register with these services. This process, and the address resolution process is described in "LAN Emulation".

Unlike Classical IP, the LAN Emulation protocol provides a broadcast service to the upper layer protocols. Therefore, the multicast and broadcast limitations described in "Classical IP Parameter Group", do not affect LAN Emulation interfaces. With this broadcast service, address resolution is supported through the standard means, ARP for an IPv4 environment and Neighbor Discovery for an IPv6 environment. thus IPv6 works transparently over LANs.

Editing the /etc/opt/SUNWconn/atm/laneconfig File

The /etc/opt/SUNWconn/atm/laneconfig file contains the required configuration information for each interface that uses LAN Emulation. One entry is required for each SunATM interface.

Each time you modify the /etc/opt/SUNWconn/atm/laneconfig file, run the LAN Emulation setup program (lanesetup). lanesetup is in the /etc/opt/SUNWconn/atm/bin directory.

Each /etc/opt/SUNWconn/atm/laneconfig entry follows this format:


Interface         MAC Address/      ATM Address  VCI  Flag
                  ELAN Name

These entry fields are described in Table 3-5.

Table 3-5 /etc/opt/SUNWconn/atm/laneconfig Entry Descriptions

Field 

Description 

Interface

Refers to the LAN Emulation interface, laneN.

MAC Address/ELAN Name

This field is for the 6-byte MAC address of the interface, or, in the case of an n entry, the name of the emulated LAN to join.

ATM Address

This field is for the 20-byte ATM address. The $myaddress variable assigns the local switch prefix, local MAC address, and default selector.

VCI

The VCI field is a positive decimal integer identifying a Permanent Virtual Circuit. Place a dash in this field if VCI is not used. 

Flag

This field identifies the type of entry. For a complete description of the laneconfig flags, see Table 3-6.

Table 3-6 describes the flags used in the /etc/opt/SUNWconn/atm/laneconfig file.

Table 3-6 /etc/opt/SUNWconn/atm/laneconfig Flag Descriptions

Flag 

Description 

l

This flag designates a local address entry. There must be an l entry for each interface running LAN Emulation. The interface and the ATM address must be included; the MAC address may be included (default is the MAC address assigned to the board).

t

This flag designates a table entry for the local MAC-ATM address resolution table. If you wish to avoid the address resolution process for a frequently accessed system, for instance, you may include a t entry for that system; you may also create PVCs with a t entry. The interface, MAC address, and either ATM address or VCI (for SVC or PVC connection, respectively) must be included.

n

This flag allows you to specify the name of an emulated LAN to join. By default, the SunATM implementation will use the name provided by the LECS. If you wish to specify a different name, or if your LECS requires that a user include a name in its requests, a name may be provided with this flag. Interface is required; the name should be entered in the second field. 

M

Notifies the system that a larger MTU size will be used in the ELAN which this lane instance will join. The default MTU size is 1500 bytes. With the M flag, you can set the MTU size to be either 4 Kbytes (4528 bytes) or 9 Kbytes (9218 bytes). 

a

Represents an address that may have access to this host. If no a entries appear in the laneconfig file, access to the host is unrestricted. Including a entries allows access to be restricted to known hosts. As an alternative to listing individual addresses, the ATM address field may contain a prefix, followed by the wildcard $anymacsel, which matches any 7-byte ESI/Selector combination following the given prefix. This allows access by any host connected to the switch specified by the given prefix. Mac Address and VCI should not appear; ATM Address is required. See Table 3-7.

c

This flag allows an alternate LECS address to be specified. By default, the SunATM software uses the well-known address specified in the LAN Emulation standard. If, however, your LECS has a different address, or you wish to connect to the LECS over a PVC, you may provide the alternate ATM address or VCI in a c entry. If you wish to make a PVC connection, the VCI must be 17, as required by the LAN Emulation standard. The interface and ATM address or VCI must be included. 

s

This flag specifies the LES address or VCI, and instructs the system to contact the LES directly, and to use default subnet configuration information. This flag should be used if your subnet does not have an LECS. Without this entry, the system first connects to the LECS, which provides the LES address and configuration information. 

m

Notifies the system that the entire ATM address, including the network prefix, must be configured manually on this interface. If your interface is connected to a switch that does not support ILMI address registration, you must include this option in your /etc/opt/SUNWconn/atm/aarconfig file. Note that the variables $myaddress, $prefix and $localswitch_server (which use the switch prefix obtained from the switch via ILMI) may not be used if ILMI address registration is disabled.

Table 3-7 describes the required, optional, and illegal fields for each flag type.

Table 3-7 laneconfig Flag Requirements and Options

Interface 

MAC Address/ELAN Name 

ATM Address 

VCI 

Flag 

required 

optional 

required 

illegal 

l

required 

required 

xor1

xor1

t

required 

Emulated LAN name 

illegal 

illegal 

n

required 

MTU Size in bytes 

illegal 

illegal 

M

required 

illegal 

required 

illegal 

a

required 

illegal 

xor1

xor 

c

required 

illegal 

xor1

xor 

s

required 

illegal 

illegal 

illegal 

m

1xor means that you can use either the ATM Address field or the VCI field, but not both.


Note -

Designate unused fields in the /etc/opt/SUNWconn/atm/laneconfig file with a dash.


Using Variables in the /etc/opt/SUNWconn/atm/laneconfig File

You can use some of the predefined variables from /etc/opt/SUNWconn/atm/aarconfig file in the /etc/opt/SUNWconn/atm/laneconfig. These variables are listed in Table 3-8. For a complete description of how to use these variables, see "Using Variables in the  /etc/opt/SUNWconn/atm/aarconfig File".


Note -

Using predefined or user-defined variables in the MAC address field of local (`l') entries is not supported. Variables may be used in the MAC address field of other entry types, such as in table (`t') entries.



Note -

You can not use the $prefix variable or any other variables that use it (including $myaddress), on interfaces that are not running ILMI.


Table 3-8 Predefined SunATM Variables

Variable 

Description 

prefix

The 13-byte prefix associated with the local switch. 

mac

The 6-byte MAC address associated with the local host or interface.

sel

The default 1-byte selector for the local interface. 

macsel

The concatenation of $mac:$sel.

myaddress

The concatenation of $prefix:$mac:$sel, resulting in the default address for the local interface.

anymac

A wild card representing any 6-byte ESI. Should only be used in a entries.

anymacsel

A wild card representing any 7-byte ESI and Selector combination. Should only be used in a entries.

?

A wild card matching one or two hexadecimal digits within any colon-separated field. For example, $prefix:$anymac:? is equivalent to both $prefix:$anymac:?? and $prefix:$anymacsel. However, it is not the same as $prefix:$anymacsel:0?, which requires that the first digit of the selector byte is a 0. This wild card should only be used in a entries.

Sample LAN Emulation Configurations

The following examples demonstrate entries in the /etc/opt/SUNWconn/atm/laneconfig file for several common configurations.

Although some of the examples show only one sample laneconfig file, similarly configured files must appear on each LAN Emulation client.

  1. Basic LAN Emulation client. The ATM and MAC address of a frequently used server is provided. The LECS provides the name of the Emulated LAN.


    set srvr_mac = 08:00:20:01:02:03
    
    Interface     MAC_Address/     ATM_Address         VCI   Flag
                  ELAN Name
    lane0            -             $myaddress           -      l
    lane0         $srvr_mac        $prefix:$srvr_mac:00 -      t

  2. LAN Emulation client. The LECS requires that the client send the Emulated LAN name in its messages.


    Interface   MAC_Address/    ATM_Address    VCI   Flag
                ELAN Name
    lane0          -            $myaddress      -     l
    lane0       elan1               -           -     n