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]:exp[y]
Blade server management card	system:blade[x]:mgmtcrd
Blade server microprocessor	system:blade[x]:cpu[y]
Blade server storage expansion unit	system:blade[x]:be[y]
Blade server high-speed expansion card	system:blade[x]:hsec[y]
Blade server memory	system:blade[x]:memory[y]
Blade server mezzanine for double-width form factor	system:blade[x]:sb
Blade server concurrent KVM feature card	system:blade[x]:ckvm
I/O (switch) module	system:switch[x]
Power module	system:power[x]
Blower	system:blower[x]
Media tray	system:mt[x]
Media tray battery backup unit	system:mt[x]:bbu[y]
Alarm panel (BladeCenter HT only)	system:tap
Multiplexer expansion module (BladeCenter HT only)	system:mux[x]
Network clock module (BladeCenter HT only)	system:ncc[x]
Storage module (BladeCenter S unit only)	system:storage[x]
Storage module disk drive (BladeCenter S unit only)	system:storage[x]:disk[y]

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 Storage expansion unit High-speed expansion card Memory Mezzanine assembly for double-width form factor blade servers	`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 `exp`[x] for I/O-expansion card (where x identifies the expansion card) `cpu`[x] for microprocessor (where x identifies the microprocessor) `be`[x] for storage expansion unit (where x identifies the expansion unit) `ckvm` for concurrent KVM feature card `hsec`[x] for high-speed expansion card (where x identifies the high-speed expansion card) `memory`[x] for memory (where x identifies the memory module) `mgmtcrd` for management card `sb` for mezzanine assembly for double-width form factor blade servers )	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 `exp`[x] for I/O-expansion card (where x identifies the expansion card) `cpu`[x] for microprocessor (where x identifies the microprocessor) `be`[x] for storage expansion unit (where x identifies the expansion unit) `ckvm` for concurrent KVM feature card `hsec`[x] for high-speed expansion card (where x identifies the high-speed expansion card) `memory`[x] for memory (where x identifies the memory module) `mgmtcrd` for management card `sb` for mezzanine assembly for double-width form factor blade servers )
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`[x] where x is the media-tray bay where the media tray is installed.	The env command can be directed to any installed device, in this case `-T system:mt[x]` where x is the media-tray bay where the media tray is installed.
Set media tray battery backup unit as command target	Sets the specified battery backup unit on the specified media tray as the persistent target for commands during the current session.	`env -T system:mt`[x]:bbu[y] where x is the media tray on which the battery backup unit is installed. where y is the battery backup unit number:	The env command can be directed to any installed device, in this case `-T system:mt[x]:bbu[y]` where x is the media tray on which the battery backup unit is installed. where y is the battery backup unit number:
Set alarm panel as command target (BladeCenter HT units only)	Sets the alarm panel as the persistent target for commands during the current session.	`env -T system:tap`	The env command can be directed to any installed device, in this case `-T system:tap`
Set multiplexer expansion module as command target (BladeCenter HT units only)	Sets the multiplexer expansion module as the persistent target for commands during the current session.	`env -T system:mux`[x] where x is the multiplexer expansion module number.	The env command can be directed to any installed device, in this case `-T system:mux[x]` where x is the multiplexer expansion module number.
Set network clock module as command target (BladeCenter HT units only)	Sets the network clock module as the persistent target for commands during the current session.	`env -T system:ncc`[x] where x is the network clock module number.	The env command can be directed to any installed device, in this case `-T system:ncc[x]` where x is the network clock module number.
Set storage module as command target (BladeCenter S units only)	Sets the storage module as the persistent target for commands during the current session.	`env -T system:storage`[x] where x is the storage-module bay where the storage module is installed.	The env command can be directed to any installed device, in this case `-T system:storage[x]` where x is the storage-module bay where the storage module is installed.
Set storage module disk drive as command target (BladeCenter S units only)	Sets the specified disk drive in the specified storage module as the persistent target for commands during the current session.	`env -T system:storage`[x]:disk[y] where x is the storage module on which the disk drive is installed. where y is the disk drive number:	The env command can be directed to any installed device, in this case `-T system:storage[x]: disk[y]` where x is the storage module on which the disk drive is installed. where y is the disk drive number:

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]