Using and Administering

llextSDR - Extract adapter information from the SDR

Purpose

Extracts adapter information from the system data repository (SDR) and creates adapter and machine stanzas for each node in an RS/6000 SP partition. You can use the information in these stanzas in the LoadLeveler administration file. This command writes the stanzas to standard output.

Syntax

llextSDR [-?] [-H] [-v] [-a adapter]

Flags

-?

Provides a short usage message.

-H

Provides extended help information.

-v

Outputs the name of the command, release number, service level, service level date, and operating system used to build the command.

-a adapter

Specifies that the interface name of the given adapter on each node is used as the label (machine stanza name) of the generated machine stanza. If you do not specify an adapter, the label used is the initial_hostname field of the Node class in the SDR.

Description

In the SDR, the Node class contains an entry for each node in the SP partition. The Adapter class contains an entry for each adapter configured on a node. This command extracts the information in the Adapter class and creates an adapter stanza. This command also creates a machine stanza which identifies the node and the adapters attached to the node. The generated machine stanza also includes the spacct_excluse_enable keyword, whose value is obtained from the spacct_excluse_enable attribute in the SP class of the SDR. For more information on adapter stanzas, see Step 5: Specify Adapter Stanzas. For more information on machine stanzas, see Step 1: Specify Machine Stanzas.

The partition for which information is extracted is either the default partition or that specified with the SP_NAME environment variable. For the control workstation, the default partition is the default system partition. For an SP node, the default partition is the partition to which the node belongs.

You must issue this command on a machine with the ssp.clients file set installed. If you issue this command from a non-SP workstation, you must set SP_NAME to the IP address of the appropriate SDR instance for the partition.

Examples

The following example creates adapter and machine stanzas for all nodes in a partition:

llextSDR

The following example creates machine stanzas with each node's css0 interface name as the label:

llextSDR -a css0

Results

You may need to alter or add information to the stanzas produced by this command when you incorporate the stanzas into the administration file. For example, administrators may want to have each network_type field use a value that reflects the type of nodes installed on the network. Users will need to know the values used for network_type so that they can specify an appropriate value in their job command files.

Also, the output of this command includes fully-qualified machine names. If your existing administration file uses short names, you may need to change either the command output or your existing administration file so that you use either all fully-qualified names or all short names.

This is sample output for the llextSDR command, where the default partition is c187s. This sample shows machine and adapter stanzas for three of the nodes in a 16-node partition.

#llextSDR: System Partition = "c187s" on Thu Sep 30 10:15:47 1999
 
c187n16.ppd.pok.ibm.com: type = machine
	adapter_stanzas = c187sn16.ppd.pok.ibm.com c187n16.ppd.pok.ibm.com 
	spacct_excluse_enable = true
	dce_host_name = c187n16.ppd.pok.ibm.com
	alias = c187sn16.ppd.pok.ibm.com
 
c187sn16.ppd.pok.ibm.com: type = adapter
	adapter_name = css0
	network_type = switch
	interface_address = 9.114.45.144
	interface_name = c187sn16.ppd.pok.ibm.com
	switch_node_number = 15
	css_type = SP_Switch_MX_Adapter
 
c187n16.ppd.pok.ibm.com: type = adapter
	adapter_name = en0
	network_type = ethernet
	interface_address = 9.114.45.80
	interface_name = c187n16.ppd.pok.ibm.com
 
c187n14.ppd.pok.ibm.com: type = machine
	adapter_stanzas = c187sn14.ppd.pok.ibm.com c187n14.ppd.pok.ibm.com 
	spacct_excluse_enable = true
	dce_host_name = c187n14.ppd.pok.ibm.com
	alias = c187sn14.ppd.pok.ibm.com
 
c187sn14.ppd.pok.ibm.com: type = adapter
	adapter_name = css0
	network_type = switch
	interface_address = 9.114.45.142
	interface_name = c187sn14.ppd.pok.ibm.com
	switch_node_number = 13
	css_type = SP_Switch_Adapter
 
c187n14.ppd.pok.ibm.com: type = adapter
	adapter_name = en0
	network_type = ethernet
	interface_address = 9.114.45.78
	interface_name = c187n14.ppd.pok.ibm.com
     .
     .
     .
 
c187n01.ppd.pok.ibm.com: type = machine
	adapter_stanzas = c187sn01.ppd.pok.ibm.com c187n01.ppd.pok.ibm.com 
	spacct_excluse_enable = true
	dce_host_name = c187n01.ppd.pok.ibm.com
	alias = c187sn01.ppd.pok.ibm.com
 
c187sn01.ppd.pok.ibm.com: type = adapter
	adapter_name = css0
	network_type = switch
	interface_address = 9.114.45.129
	interface_name = c187sn01.ppd.pok.ibm.com
	switch_node_number = 0
	css_type = SP_Switch_MX_Adapter
 
c187n01.ppd.pok.ibm.com: type = adapter
	adapter_name = en0
	network_type = ethernet
	interface_address = 9.114.45.65
	interface_name = c187n01.ppd.pok.ibm.com
 

The following shows sample output for the llextSDR -a css0 command for a single node:

k10sn09.ppd.pok.ibm.com: type = machine
 adapter_stanzas = k10sn09.ppd.pok.ibm.com k10n09.ppd.pok.ibm.com
 spacct_excluse_enable = true
 
k10sn09.ppd.pok.ibm.com: type = adapter
 adapter_name = css0
 network_type = switch
 interface_address = 9.114.51.137
 interface_name = k10sn09.ppd.pok.ibm.com
 switch_node_number = 8
 css_type = SP_Switch_MX_Adapter
 
k10n09.ppd.pok.ibm.com: type = adapter
 adapter_name = en0
 network_type = ethernet
 interface_address = 9.114.51,73
 interface_name = k10n09.ppd.pok.ibm.com