You can use the L2 config command to view the current system configuration from a brick level, as follows:

L2> config
127.0.0.1:
127.0.0.1:0:0 - 003c01
127.0.0.1:0:1 - 004c01
127.0.0.1:0:2 - 002c01
127.0.0.1:0:3 - 001x01
L2>

As shown above, config produces a list of bricks in the system and the system controller address of each brick. This is similar to the output from using the config command on the L1 with the addition of the L2 IP address and USB port number. The structure of the brick's address is as follows:

a.b.c.d:x:y - rrrtss.p

where:

A brick is identified by its rack and slot. In the example shown above, 003c01 is a C–brick in rack 3 and unit position 1.

If a command is not understood by the L2 system controller, in general it is passed on to the L1 system controllers. The destination determines which L1s receive the command. A destination is a range of racks and slots, specified as follows:

rack <rack list> slot <slot list> 

The <rack list> specifies a list of racks. This can be a list delimited by commas, such that 2,4,7 specifies racks 2, 4, and 7. You can use a dash to specify a range of racks, such that 2-4 specifies racks 2, 3, and 4. Both nomenclatures can be combined, such that 2-4,7 specifies racks 2, 3, 4, and 7.

You can specify the <slot list> using the same nomenclature. The slot number, sometimes referred to as a bay number, is the unit position number located on the rack, slightly above where the bottom of the brick sits. Each rack unit position number is located toward the top of the two lines that mark the unit position that the number represents. For example, the rack numbering for a brick located in slot 10 would appear on the left front side of the rack, as shown in Figure 2-1:

Figure 2-1. Rack Numbering

The slot <slot list> is optional; if not given, then all slots in the specified rack(s) are implied. You should avoid specifying a rack list and slot list that include multiple racks and slots, such as rack 2-4,7 slot 1-8,11,13. Generally, a rack and slot together are used to specify an individual brick.

You can use the aliases r and s to specify rack and slot, respectively. You can use the alias all or * in either or both the <rack list> and the <slot list> to specify all racks and all slots.

To send a command to all bricks in a partition, type the following:

l2> partition <partition> <cmd>

Default Destination 

When the L2 starts, the default destination is set to all racks and all slots. You can determine the default destination by using the destination command, as follows:

L2> destination 
all racks, all slots
L2>

The following command sets the destinations to rack 2 and 3, all slots:

L2> r 2,3 destination 
2 default destination(s) set
L2>

The following example shows what bricks are found in the default destination. If you type a command not understood by the L2, the command is sent to these bricks.

---

Note: In the current implementation, adding a brick to either rack 2 or 3 would not automatically include it in the default destination. You would need to reset the default destination.

---

L2> destination 
002c01 (127.0.0.1:0:2)
003c01 (127.0.0.1:0:0)
L2>

The following command resets the default destination to all racks and all slots:

L2> destination reset 
default destination reset to all racks and slots
L2>

Current Destination 

The current destination is a range of racks and slots for a given command. For example, the following command sends the command <L1 command> to all bricks in racks 2, 3, 4, and 7:

L2> r 2-4,7 <L1 command> 

This is a one-time destination.

Command Interpretation

Some L2 commands are the same as the L1 commands. In many cases, this is intentional because the L2 provides sequencing that is necessary for a command to function correctly.

When L1 and L2 commands are similar, you can assure that an L1 command is entered for the bricks in the current destination by preceding <L1 command> with the L1 command (this is a one-time destination), as follows:

L2> r 2-4,7 l1 <L1 command> 

All information, warnings, and error messages generated by any of the system controllers are in the following form:

002c01 ERROR: invalid arguments for `ver' command, try “help ver”

The general format includes a brick identification and the type of message, followed by the message. A message may be the result of an invalid command, as shown in the example, or the result of tasks running on the L1, such as the environmental monitor.

Each L1 has a log of local events. Use the L1 command log to view events on any of the L1s.

The system can be powered on and off with the power command. This command is interpreted by the L2, because the bricks must be powered on in a specific order.

L2> power up 
L2>

The power command may require several seconds to several minutes to complete. In the example above, all racks and slots in the default destination are affected. Any errors or warnings are reported as described in the prior “Viewing Information, Warnings, and Error Messages” section.

To power on or power off a specific brick, specify a current destination, as follows:

L2> r 2 s 5 power up 
L2>

You can enter the power down and reset commands in a similar way, as follows:

L2> partition <partition number> <power down or reset>

The L2 system controller detects the system console based on two things - the last brick and node/subchannel to produce output and the brick with the lowest rack and slot number.

Enter the select command alone to show the current console mode settings as follows:

L2> select
known system consoles (non-partitioned)

        007c11 - L2 detected

current system console

console input: 007c11 console
console output: not filtered

On a partitioned system, enter the select command alone to show the current console mode settings as follows:

L2>select

known system consoles (partitioned)

        partition  1: 007c11 - L2 detected
        partition  2: 007c14 - L2 detected
        partition  3: 007c20 - L2 detected
        partition  4: 007c27 - L2 detected
        partition  5: 007c30 - L2 detected
        partition  6: 007c17 - L2 detected

current system console

console input: partition 1, 007c11 console
console output: any brick partition 1
L2>

When a system is partitioned, the L2 prompt shows the partition number of the partition you selected, as follows:

L2>sel p 2
console input: partition 2, 001c24 console0
console output: any brick partition 2
L2:p2>

The following are common subchannels associated with console communications on an SGI Altix system:

The following are common subchannels associated with console communications on an SGI Origin 3900 systems:

The following common subchannels are associated with console communications on all other MIPS/IRIX systems:

To select a subchannel as the current subchannel, for a specific node/CPU, perform the following:

L2> select sub 0a

or

L2> select sub 0c

or

L2> select sub 2a

and so on.

For console subchannels, perform the following:

L2> select sub console0

or

L2> select sub console1

and so on.

The output console input: 001c05 console0 shows that the L2 will send console input to brick 001c05 and the subchannel to be used is the console0 subchannel.

To change system console status from one brick to the attached C-brick, use the select <rack> <slot> command:

001c05-L2> select r 2 s 1 
console input: 001c05 console
console output: not filtered.
001c05-L2>

When selecting the rack and slot for the console, you could also select <rack>.<slot>, as follows:

001c05-L2> select 2.4

To change the subchannel used on the selected brick, use the select command followed by the subchannel number or the word console:

001c05-L2> select sub 0A
console input: 001c05 CPU 0A
console output: not filtered.
001c05-L2>

An L1 has limited knowledge of the system configuration. A C–brick only has information about its attached I/O brick and, if another C–brick is attached to it, information about that C–brick and its attached I/O brick. An I/O brick only has information about its attached C–brick. An R–brick only has information about itself.

You can view a brick's configuration information with the config command, as follows:

003c01-L1> config 
:0 - 003c01
:1 - 004i01
:2 - 002c01
:3 - 001x01
003c01-L1>

Bricks are referenced by their racks and slot or bay locations. These values are stored in nonvolatile memory on the L1. Virtually all system controller communications require that each brick has a valid and unique rack and slot.

If a brick is not set with its rack and slot number, it appears in the output of an L2 config command, as shown in the following example:

L2> config
137.38.88.82.1.0 ---c-- (no rack/slot set)
L2>

To set the rack and slot for a brick, address it by its IP address, USB port, and L1 controller index. Note the following example:

L2> 137.38.88.82:1:0 brick rack 1
L2> 137.38.88.82:1:0 brick slot 8
L2> 137.38.88.82:1:0 reboot_l1
INFO: closed USB /dev/sgil1_0
INFO: opened USB /dev/sgil1_0
L2>config
137.38.88.82:1:0 001c08
L2.

The following example shows how to set rack 1, slot 8, for the C-brick with an IP address of 127.0.0.1:

L2> config 
127.0.0.1:
127.0.0.1:0:0 - ---c--
127.0.0.1:0:1 - 001i01
127.0.0.1:0:5 - 001c05
L2> :0:0 brick rack 1 
brick rack set to 001.
L2> :0:0 brick slot 8
brick slot set to 08.
L2> :0:0 reboot_l1 
INFO: closed USB /dev/sgil1_0
INFO: opened USB /dev/sgil1_0
L2>
L2> config 
127.0.0.1:
127.0.0.1:0:0 - 001c05
127.0.0.1:0:1 - 001i01
127.0.0.1:0:5 - 001c08
L2>

To set the rack and slot from the L1 prompt, simply use the brick rack and brick slot commands. To set the rack and slot on one of the attached bricks (an attached I/O brick, C-brick, or a C-brick's I/O brick), use the L1 targeting commands iia, iib or nia, nib, as follows:

001c05-L1> config 
:0 - 001c05
:1 - ---i--
:5 - 001c08
:6 - 001p01
001c05-L1> iia brick rack 4 
---i--:
brick rack set to 004.
001c05-l1> iia brick slot 1
---i--
brick slot set to 01
001c05-l1> iia reboot_l1 
001c05 ERROR: no response from ---i--
001c05-L1> config 
:0 - 001c05
:1 - 004i01
:5 - 001c08
:6 - 001p01
001c05-L1>

In the preceding code, the number after the colon symbol (:) indicates the following:

0 = local brick
1 = IIA (II0)
2 = IIB (II1)
5 = NIA (Nl0)
10 = NIB (N11)

Only 0 has a valid meaning, other values are arbitrary based on the system type.

To obtain a detailed configuration explanation from the L1 perspective, enter the following:

001c05-L1> config verbose

All commands affect only the local brick, unless the command is prefixed with an asterisk (*). To target a command to all bricks (including the local brick), prefix the command, as shown in the following example:

003c01-L1> * version 
003c01:
L1 0.7.37 (Image A), Built 05/24/2001 14:59:42 [P1 support]
004i01:
L1 0.7.37 (Image A), Built 05/24/2001 14:59:42 [P1 support]
002c01:
L1 0.7.37 (Image A), Built 05/24/2001 14:59:42 [P1 support]
001x01:
L1 0.7.37 (Image A), Built 05/24/2001 14:59:42 [P1 support]
003c01-L1>

The L1 also supports a L1> <rack>.<slot> <command> target. For example,

003c01-L1> 4.1 version
004i01:
L1 0.7.37 (Image A), Built 05/24/2001 14:59:42 [P1 support]
003c01-L1>

You can also target commands to a single attached brick with either the iia, iib, or nia, nib command, as follows:

003c01-L1> iia version
004i01:
L1 0.7.37 (Image A), Built 05/24/2001 14:59:42 [P1 support]
003c01-L1>

All information, warnings, and error messages generated by any of the system controllers are in the following form:

002c01 ERROR: invalid arguments for `ver' command, try “help ver”

The general format of the message includes a brick identification (this is not present if the command was to the local brick only), type of message, and the message. These messages can be the result of an invalid command (as shown in the example) or from tasks running on the L1, such as the environmental monitor.

Each L1 has a log of local events. Use the L1 command log to view the event on any of the L1s.

You can power on and power off the brick with the power command, as follows:

003c01-L1> power up 
003c01-L1>

If an L2 is not present, you need to power on, power off, and reset the system from one of the C–bricks. You do so by targeting all bricks, as follows:

003c01-L1> * power up 
003c01-L1>

This command can require from several seconds to several minutes to complete.

You can enter the power off and reset commands in similar ways.

The brick with which the L1 communicates in console mode is the system console or global master, and you can view and set it with the select command. By default, the C–brick attempts to communicate with its local CPUs when it enters console mode. If the system has been powered on and either one of the bricks has a request to be the system console, then the C–brick attempts to communicate with that brick. Enter the select command alone to show the current console mode settings, as follows:

003c01-L1> select 
console input: 003c01 console
console output: not filtered.

The following are common subchannels associated with console communications on an SGI Altix system:

The following are common subchannels associated with console communications on an SGI Origin 3900 systems:

The following five common subchannels are associated with console communications on all other MIPS/IRIX systems:

To select a subchannel as the current subchannel, for a specific node/CPU, perform the following:

L1> select sub 0a

or

L1> select sub 0c

or

L1> select sub 2a

and so on.

For console subchannels, perform the following:

L1> select sub console0

or

L1> select sub console1

and so on.

The output console input: 003c01 console shows that the L1 will send console input to brick 003c01 and the console subchannel will be used.

To change system console status from one brick to the attached C–brick, use the select command, followed by the rack and slot number of the attached C–brick, as follows:

003c01-L1> select r 2 s 1 
console input: 002c01 console
console output: not filtered.
003c01-L1> 

To change the subchannel used on the selected brick, use the select command, followed by the subchannel number or the word console, as follows:

003c01-L1> select 2 
console input: 002c01 CPU C
console output: not filtered.
003c01-L1>

During the boot process on a multi-rack system, there is a window of time during which both C–bricks are producing output. This resulting output may be somewhat jumbled at the L1. However, you can filter the console output so that the L1 shows output only from the brick chosen to receive console input. You can turn filtering on and off with the select filter command.

If you try to communicate with a brick that is not responding, a time-out condition results, as follows:

003c01-L1> 
entering console mode 002c01 console, <CTRL-T> to escape to L1
no response from 002c01 bedrock console UART:UART_TIMEOUT

When this time-out condition occurs, either the brick is hung or the subchannel is incorrect.