Using and Administering

Step 5: Specify Adapter Stanzas

An adapter stanza identifies network adapters that are available on the machines in the LoadLeveler cluster. Adapter stanzas are optional, but you need to specify them when you want LoadLeveler jobs to be able to request a specific adapter. You do not need to specify an adapter stanza when you want LoadLeveler jobs to access a shared, default adapter via TCP/IP.

Note the following when using an adapter stanza:

• An adapter stanza is required for each adapter stanza name you specify on the adapter_stanzas keyword of the machine stanza.
• The adapter_name, interface_address, and interface_name keywords are required. For an SP switch adapter, the switch_node_number keyword is also required.

For information on creating adapter stanzas for an SP system, see llextSDR - Extract adapter information from the SDR.

An adapter stanza has the following format:

Figure 29. Format of an Adapter Stanza

label: type = adapter adapter_name = name css_type = type interface_address = IP_address interface_name = name network_type = type switch_node_number = integer

You can specify the following keywords in an adapter stanza:

adapter_name = string

Where string is the name used to refer to a particular interface card installed on the node. Some examples are en0, tk1, and css0. This keyword defines the adapters a user can specify in a job command file using the network keyword. This keyword is required.

css_type = type

Where type is the designation for the type of switch adapter to be used. The allowable choices are: SP_Switch_Adapter, SP_Switch_MX_Adapter, SP_Switch_MX2_Adapter, RS/6000_SP_System_Attachment_Adapter, and SP_Switch2_Adapter. This keyword must be specified in combination with a switch adapter ("css . . ."), otherwise it will be ignored. The css_type attribute for the available adapters are defined in the SDR. Execute the command SDRGetObjects Adapter css_type to obtain a list of css_types, or use llextSDR to obtain all of the adapter information from the SDR.

interface_address = string

Where string is the IP address by which the adapter is known to other nodes in the network. For example: 7.14.21.28. This keyword is required.

interface_name = string

Where string is the name by which the adapter is known by other nodes in the network. This keyword is required.

network_type = string

Where string specifies the type of network that the adapter supports (for example, Ethernet). This is an administrator defined name. This keyword defines the types of networks a user can specify in a job command file using the network keyword.

switch_node_number = integer

Where integer specifies the node on which the SP switch adapter is installed. This keyword is required for SP switch adapters. Its value is defined in the switch_node_number field in the Node class in the SDR. This value must match the value in the /spdata/sys1/st/switch_node_number file of the Parallel System Support Programs (PSSP).

Example of an Adapter Stanza

Example 1: Specifying an SP Switch Adapter

In the following example, the adapter stanza called "sp01sw.ibm.com" specifies an SP switch adapter. Note that sp01sw.ibm.com is also specified on the adapter_stanzas keyword of the machine stanza for the "yugo" machine.

          yugo:  type=machine
                 adapter_stanzas = sp01sw.ibm.com
                 ...
 
sp01sw.ibm.com:  type = adapter
                 adapter_name = css0
                 interface_address = 12.148.44.218
                 interface_name = sp01sw.ibm.com
                 network_type = switch
                 switch_node_number = 7
                 css_type = SP_Switch_MX2_Adapter