env (environment) command

This command sets the persistent environment for commands that are entered during the remainder of the current session.

The persistent command environment is indicated by the command prompt. When you start the command-line interface, the persistent command environment is the BladeCenter unit, denoted as system by the command prompt. You can target a single command to an environment other than the one that is set as the default by adding a -T option to the command that includes a valid target destination (see Selecting the command target for information). Target environments can be specified using the full path name, or using a partial path name based on the persistent command environment. Full path names always begin with system. The levels in a path name are divided by using a colon ( : ).

The following table lists BladeCenter components and the command paths that are supported as targets by the env command.

Table 1. Components and command paths
Component Target path
BladeCenter unit system
Management module system:mm[x]
Blade server system:blade[x]
Blade server integrated system management processor (BMC or service processor) system:blade[x]:sp
Blade server I/O-expansion card system:blade[x]:dtr[y]
Blade server high-speed expansion card system:blade[x]:hsdc
Blade server microprocessor system:blade[x]:cpu[y]
Blade server storage expansion unit system:blade[x]:be
I/O (switch) module system:switch[x]
Power module system:power[x]
Blower system:blower[x]
Media tray system:mt
Table 2. env (environment) command
Function What it does Command Valid targets
Set BladeCenter unit as command target Sets the BladeCenter unit as the persistent target for commands during the current session. This is the persistent command environment you are in at the beginning of each command-line interface session, indicated by the system> prompt. env

env -T system

The env command can be directed to any installed device.
Set management module as command target Sets the management module as the persistent target for commands during the current session. env -T system:mm[x]

where x is the bay (1 or 2) that identifies the management module.

The env command can be directed to any installed device, in this case
                           -T system:mm[x]
                        

where x is the management-module bay number.

Set blade server as command target Sets the specified blade server as the persistent target for commands during the current session. env -T system:blade[x]

where x is the blade bay that identifies the blade server. A blade server that occupies more than one blade bay is identified by the lowest bay number that it occupies.

The env command can be directed to any installed device, in this case
                           -T system:blade[x]
                        

where x is the blade bay that identifies the blade server.

Set blade server sub-component as command target Sets the specified sub-component on the specified blade server as the persistent target for commands during the current session. Valid sub-components are:
  • Integrated system management processor (BMC or service processor)
  • I/O-expansion card
  • Microprocessor
  • High-speed expansion card
  • Storage expansion unit
env -T system:blade[x]:comp

where x is the blade bay that identifies the blade server on which the sub-component is installed. A blade server that occupies more than one blade bay is identified by the lowest bay number that it occupies.

where comp is the sub-component:

  • sp for BMC or service processor
  • dtr[x] for I/O-expansion card (where x identifies the expansion card)
  • cpu[x] for microprocessor (where x identifies the microprocessor)
  • hsdc for high-speed expansion card
  • be[x] for storage expansion unit (where x identifies the expansion unit)
The env command can be directed to any installed device, in this case

-T system:blade[x]:comp

where x is the blade bay that identifies the blade server on which the integrated system management processor is installed.

where comp is the sub-component:

  • sp for BMC or service processor
  • dtr[x] for I/O-expansion card (where x identifies the expansion card)
  • hsdc for high-speed expansion card
  • cpu[x] for microprocessor (where x identifies the microprocessor)
  • be[x] for storage expansion unit (where x identifies the expansion unit)
Set I/O module as command target Sets the specified I/O module as the persistent target for commands during the current session. env -T system:switch[x]

where x is the I/O-module bay where the I/O module is installed.

The env command can be directed to any installed device, in this case
                           -T system:switch[x]
                        

where x is the I/O-module bay where the I/O module is installed.

Set power module as command target Sets the specified power module as the persistent target for commands during the current session. env -T system:power[x]

where x is the power module bay where the power module is installed.

The env command can be directed to any installed device, in this case
                           -T system:power[x]
                        

where x is the power module bay where the power module is installed.

Set blower as command target Sets the specified blower as the persistent target for commands during the current session. env -T system:blower[x]

where x is the blower bay where the blower is installed.

The env command can be directed to any installed device, in this case
                           -T system:blower[x]
                        

where x is the blower bay where the blower is installed.

Set media tray as command target Sets the media tray as the persistent target for commands during the current session. env -T system:mt The env command can be directed to any installed device, in this case

-T system:mt

Example: To set the persistent target of commands to the service processor on the blade server in blade bay 5, while the BladeCenter unit is set as the default command target, at the system> prompt, type

                  env -T system:blade[5]:sp
               

The following example shows the information that is returned:

               system> env -T system:blade[5]:sp
OK
system:blade[5]:sp>
            

To set the persistent target of commands to the service processor on the blade server in blade bay 5, while the BladeCenter unit is set as the default command target, at the system> prompt, you can also type

                  env -T blade[5]:sp
               

The following example shows the information that is returned:

               system> env -T blade[5]:sp
OK
system:blade[5]:sp>
            

To issue the reset command on the blade server in blade bay 5, while the management module is set as the default command target, at the system:mm[x]> prompt, type

               reset -T system:blade[5]