Manuals

enclosure Commands : Dell Command Line Interface Reference Back to Contents Page

enclosure Commands

This chapter discusses the enclosure commands listed in Table 1. These enclosure commands operate on enclosure management devices that support Version 1.0 of the SCSI Accessed Fault-Tolerant Enclosures (SAF-TE) specification.

Table 1. enclosure Commands

Command Summary Description

enclosure activate slot Activates a device in the enclosure

enclosure identify slot Identifies a device in the enclosure

enclosure list Displays a list of components for one or all enclosure devices

enclosure prepare slot Prepares a device in a slot for insertion/removal

enclosure set alarm Turns the audible alarm on the enclosure on or off

enclosure set door Locks or unlocks the enclosure door

enclosure set fan Sets the fan speed for the enclosure

enclosure set interval Sets the monitor interval, in seconds

enclosure set power Turns the power supply on the enclosure on or off

enclosure set scsiid Sets the SCSI ID for a slot

enclosure set temperature Sets the temperature warning threshold

enclosure show fan Displays the status of one or more fans

enclosure show power Displays the status of one or more power supplies

enclosure show slot Displays the status of one or more slots

enclosure show status Displays enclosure status

enclosure show temperature Displays temperature status

Use the following syntax for enclosure commands:

enclosure command [/switch{=value}] [parameter]

enclosure activate slot

To activate a device in a specified slot of the specified SAF-TE enclosure management device, use the enclosure activate slot command. Specifically, this command makes the device that resides in the slot available on the SCSI bus.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure activate slot {enclosure} {slot}

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device on which you want to activate a device. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

{slot}

Specifies the unit number associated with the slot. This is the slot that contains the device you want to activate. This unit number can range from 0 to 15 inclusive. Typically, the slot unit number is limited by the physical number of device slots in the enclosure management device.

Examples

Before activating a device, you might want to use the enclosure show slot command to determine the current device state. As the following example shows, the current device state setting is NOTACTIVATE:

 AFA0> enclosure show slot 0
 Executing: enclosure show slot 0
 
 Enclosure Slot scsiId Insert  Status                                    
 --------- ---- ------ ------- ------------------------------------------
    0       0   0:00:0     4   OK UNCONFIG NOTACTIVATE
    0       1   0:01:0     0   OK UNCONFIG ACTIVATE
    0       2   0:10:0     0   OK UNCONFIG ACTIVATE
    0       3   0:03:0     0   OK UNCONFIG ACTIVATE
    0       4   0:04:0     0   OK UNCONFIG ACTIVATE
    1       0   1:00:0     0   OK CONFIG   ACTIVATE
    1       1   1:01:0     0   OK UNCONFIG ACTIVATE
    1       2   1:10:0     0   OK UNCONFIG ACTIVATE
    1       3   1:03:0     0   OK UNCONFIG ACTIVATE
    1       4   1:04:0     0   OK UNCONFIG ACTIVATE

The following example shows how to activate a device in slot 0 of enclosure management device 0 using the enclosure activate slot command:

 AFA0> enclosure activate slot 0 0
 Executing: enclosure activate slot 0 0

You may want to use the enclosure show slot command again to see the change in the device slot's status, as in the following example. Note that the OK ACTIVATE in the status column indicates that the device is activated and working properly.

 AFA0> enclosure show slot 0
 Executing: enclosure show slot 0
 
 Enclosure Slot scsiId Insert  Status                                    
 --------- ---- ------ ------- ------------------------------------------
    0       0   0:00:0     4   OK UNCONFIG ACTIVATE
    0       1   0:01:0     0   OK UNCONFIG ACTIVATE
    0       2   0:10:0     0   OK UNCONFIG ACTIVATE
    0       3   0:03:0     0   OK UNCONFIG ACTIVATE
    0       4   0:04:0     0   OK UNCONFIG ACTIVATE
    1       0   1:00:0     0   OK CONFIG   ACTIVATE
    1       1   1:01:0     0   OK UNCONFIG ACTIVATE
    1       2   1:10:0     0   OK UNCONFIG ACTIVATE
    1       3   1:03:0     0   OK UNCONFIG ACTIVATE
    1       4   1:04:0     0   OK UNCONFIG ACTIVATE

Related Information

enclosure Commands:

enclosure identify slot (enclosure identify slot)
enclosure list (enclosure list)
enclosure prepare slot (enclosure prepare slot)
enclosure show slot (enclosure show slot)

enclosure identify slot

To identify a slot on a specified SAF-TE enclosure management device, use the enclosure identify slot command. Typically, an enclosure management device indicates to the operator which slot is currently being identified by flashing an adjacent light.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure identify slot {enclosure} {slot}

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device on which you want to identify a slot. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

{slot}

Specifies the unit number associated with the slot. This is the slot that you want the enclosure management device to identify. This unit number can range from 0 to 15 inclusive. Typically, the slot unit number is limited by the physical number of device slots in the enclosure management device.

Switches

/stop{=boolean}

Specifies whether to stop the identification of the specified slot. If you set this switch to TRUE, the command stops identification of the specified slot. Typically, you use this switch to stop the identification of a slot that you previously identified with the enclosure identify slot command.

This switch defaults to FALSE.

This switch is supported on the following operating systems:

Windows NT
NetWare
UNIX

Examples

The following example shows how to identify slot 1 in enclosure management device 0 using the enclosure identify slot command:

 AFA0> enclosure identify slot 0 1
 Executing: enclosure identify slot 0 1

Related Information

enclosure Commands:

enclosure activate slot (enclosure activate slot)
enclosure list (enclosure list)
enclosure prepare slot (enclosure prepare slot)
enclosure show slot (enclosure show slot)

enclosure list

To display the list of components associated with one or all SAF-TE enclosure management devices connected to the controller, use the enclosure list command.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure list [/all{=boolean}] [/full{=boolean}][{enclosure}]

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device whose associated components you want to display. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

Switches

/all{=boolean}

Specifies whether to display the components for all currently connected enclosure devices. If you set this switch to TRUE, the command displays a list of all enclosure devices connected to the controller and their associated components.

This switch defaults to FALSE if you specify a unit number; otherwise, the switch defaults to TRUE.

This switch is supported on the following operating systems:

Windows NT
NetWare
UNIX
/full{=boolean}

Specifies whether to display detailed component information. If you specify TRUE, the command displays detailed component information. If you specify FALSE, the command displays non-detailed component information.

This switch defaults to FALSE.

This switch is supported on the following operating systems:

Windows NT
NetWare
UNIX

Examples

The following example shows a non-detailed list of components for enclosure management devices 0 and 1:

 AFA0> enclosure list /all=TRUE
 Executing: enclosure list /all=TRUE
 
 Enclosure Fan Power Slot Sensor Door ScsiId Speaker  Standard Diagnostic 
 --------- --- ----- ---- ------ ---- ------ -------- -------- ---------- 
    0       1    1    5     1     5  0:06:0   No     SAF-TE   PASSED
    1       1    1    5     1     5  1:06:0   No     SAF-TE   PASSED

The non-detailed enclosure list display contains the following columns of information:

Enclosure
Fan
Power
Slot
Sensor
Door
ScsiId
Speaker
Standard
Diagnostic

The detailed enclosure list display contains the previous columns of information plus the following columns:

EnclosureId
VendorId
ProductId
Firmware

The following sections provide brief descriptions of each enclosure list column.

The Enclosure Column

The Enclosure column displays the ID of a specific enclosure management device. This is the ID that you specify for the enclosure parameter on the command line. In the example, the enclosure list command displays enclosure management device IDs 0 and 1 (because the /all switch was specified).

The Fan and Power Columns

The Fan column displays the number of fans on the enclosure management device. Typically, enclosure management devices support a maximum of sixteen fans. In the example, enclosure management devices 0 and 1 each have one fan.

The Power column displays the number of power supplies on the enclosure management device. Typically, enclosure management devices support a maximum of sixteen power supplies. In the example, enclosure management devices 0 and 1 each have one power supply.

The Slot and Sensor Columns

The Slot column displays the number of device slots on the enclosure management device. Typically, enclosure management devices support a maximum of sixteen device slots. In the example, enclosure management devices 0 and 1 each have five device slots.

The Sensor column displays the number of temperature sensors on the enclosure management device. Typically, enclosure management devices support a maximum of sixteen temperature sensors. In the example, enclosure management devices 0 and 1 each have one temperature sensor.

The Door Column

The Door column displays the number of doors on the enclosure management device. Typically, enclosure management devices support a maximum of sixteen doors. In the example, enclosure management devices 0 and 1 each have five doors.

The ScsiId Column

The ScsiId column displays the SCSI channel number (in the example, 0 and 1), the SCSI ID (in the example, 06), and the SCSI logical unit number (in the example, 0) for the enclosure management device.

The Speaker Column

The Speaker column displays whether there is a speaker installed on the enclosure management device. Specifically, the column can display the items listed in Table 2.

Table 2. Speaker Status

Status Meaning

Yes Speaker is installed.

No Speaker is not installed. This is the status displayed in the example.

The Standard Column

The Standard column displays a value that indicates whether the enclosure management device is compliant with the SAF-TE Interface Specification. This column should display the value SAF-TE, as in the example.

The Diagnostic Column

The Diagnostic column displays the status of the enclosure management device's boot-time diagnostic tests. Typically at boot time, an enclosure management device performs diagnostic self-tests on itself.

Specifically, the column can display the items listed in Table 3.

Table 3. Diagnostic Status

Status Meaning

PASSED No errors were detected and the diagnostic self-tests were successful. This is the value displayed in the example for both enclosure management devices.

FAILED Errors were detected and the diagnostic self-tests were not successful.

UNKNOWN The status of the diagnostic self-tests is unknown.

The EnclosureId, VendorId, and ProductId Columns

The EnclosureId column displays an identification number that is unique for each enclosure management device product sold by a particular manufacturer. In the example, the identification numbers are 41302e3131303030 and 41302e3132303030 for enclosure management devices 0 and 1.

The VendorId column displays a string that identifies the manufacturer of the enclosure management device. In the example, the string that identifies the manufacturer of enclosure management devices 0 and 1 is ESG-SHV.

The ProductId column displays a string that identifies the enclosure management device's product ID. In the example, the product ID for enclosure management devices 0 and 1 is SCA HSBP M2.

The Firmware Column

The Firmware column displays the current firmware revision of the enclosure management device. In the example, the firmware revision for enclosure management devices 0 and 1 is 0.14.

Related Information

enclosure Commands:

enclosure show fan (enclosure show fan),
enclosure show power (enclosure show power)
enclosure show slot (enclosure show slot)
enclosure show status (enclosure show status)
enclosure show temperature (enclosure show temperature)

enclosure prepare slot

To indicate to the SAF-TE enclosure management device that it should take the appropriate action to prepare the device in a specific slot for removal or insertion, use the enclosure prepare slot command.

This command may perform such operations as shutting off power to the device slot. This allows users to safely remove a disk device from or insert a disk device into the device slot.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure prepare slot {enclosure} {slot}

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device on which you want to prepare a slot. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

{slot}

Specifies the unit number associated with the slot. This is the slot that contains the device you want to prepare to make available. This unit number can range from 0 to 15 inclusive.

Examples

Before preparing a device in the slot, you might want to use the enclosure show slot command to determine the current device slot status:

 AFA0> enclosure show slot
 Executing: enclosure show slot
 
 Enclosure Slot scsiId Insert  Status                                    
 --------- ---- ------ ------- ------------------------------------------
    0       0   0:00:0     4   OK UNCONFIG ACTIVATE
    0       1   0:01:0     0   OK UNCONFIG ACTIVATE
    0       2   0:10:0     0   OK UNCONFIG ACTIVATE
    0       3   0:03:0     0   OK UNCONFIG ACTIVATE
    0       4   0:04:0     0   OK UNCONFIG ACTIVATE
    1       0   1:00:0     0   OK CONFIG   ACTIVATE
    1       1   1:01:0     0   OK UNCONFIG ACTIVATE
    1       2   1:10:0     0   OK UNCONFIG ACTIVATE
    1       3   1:03:0     0   OK UNCONFIG ACTIVATE
    1       4   1:04:0     0   OK UNCONFIG ACTIVATE

The following example prepares the device in slot 0 on enclosure management device 0 for insertion or removal as a result of using the enclosure prepare slot command:

 AFA0> enclosure prepare slot 0 0
 Executing: enclosure prepare slot 0 0

You may want to use the enclosure show slot command again to see the change in the device slot's status, as in the following example:

 AFA0> enclosure show slot
 Executing: enclosure show slot
 
 Enclosure Slot scsiId Insert  Status                                    
 --------- ---- ------ ------- ------------------------------------------
    0       0   0:00:0     4   OK UNCONFIG I/R READY NOTACTIVATE
    0       1   0:01:0     0   OK UNCONFIG ACTIVATE
    0       2   0:10:0     0   OK UNCONFIG ACTIVATE
    0       3   0:03:0     0   OK UNCONFIG ACTIVATE
    0       4   0:04:0     0   OK UNCONFIG ACTIVATE
    1       0   1:00:0     0   OK CONFIG   ACTIVATE
    1       1   1:01:0     0   OK UNCONFIG ACTIVATE
    1       2   1:10:0     0   OK UNCONFIG ACTIVATE
    1       3   1:03:0     0   OK UNCONFIG ACTIVATE
    1       4   1:04:0     0   OK UNCONFIG ACTIVATE

Note that the Status column now displays I/R READY and NOTACTIVATE, which means the device slot is off and ready for the insertion or removal of a device.

Related Information

enclosure Commands:

enclosure activate slot (enclosure activate slot)
enclosure identify slot (enclosure identify slot)
enclosure list (enclosure list)
enclosure show slot (enclosure show slot)

enclosure set alarm

To turn the audible alarm on a specific SAF-TE enclosure management device on or off, use the enclosure set alarm command.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure set alarm [/on{=boolean}] {enclosure}

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device whose audible alarm you want to set. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

Switches

/on{=boolean}

Specifies whether to turn the enclosure management device's audible alarm on or off. If you set this switch to TRUE, the command turns on the audible alarm. If you set this switch to FALSE, the command turns off the audible alarm.

The default is FALSE.

This switch is supported on the following operating systems:

Windows NT
NetWare
UNIX

Examples

The following example turns on the audible alarm on enclosure management device 0:

 AFA0> enclosure set alarm /on=TRUE 0
 Executing: enclosure set alarm /on=TRUE 0

Related Information

enclosure Commands:

enclosure list (enclosure list)

enclosure set door

To lock or unlock a specific door on a specific SAF-TE enclosure management device, use the enclosure set door command.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure set door [/lock{=boolean}] {enclosure} {door}

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device on which you want to lock the door. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

{door}

Specifies the unit number of the door for which you want to set the lock. This number can range from 0 to 15 inclusive.

Switches

/lock{=boolean}

Specifies whether to lock the door associated with the specified unit number. If you set this switch to TRUE, the command locks the door associated with the specified unit number. If you set this switch to FALSE, the command unlocks the door associated with the specified unit number.

This switch defaults to FALSE, which means the command unlocks the door.

This switch is supported on the following operating systems:

Windows NT
NetWare
UNIX

Examples

The following example locks the door associated with unit 1 on enclosure management device 0:

 AFA0> enclosure set door /lock=TRUE 0 1
 Executing: enclosure set door /lock=TRUE 0 1

Related Information

enclosure Commands:

enclosure list (enclosure list)

enclosure set fan

To set the speed of a specific fan on a specific SAF-TE enclosure management device, use the enclosure set fan command.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure set fan [/off{=boolean}] {enclosure} {fan} [{speed}]

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device on which you want to set the speed of a specific fan. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

{fan}

Specifies the unit number associated with the fan whose speed you want to set. The unit number for the fan ranges from 0 to 15 inclusive.

{speed}

Specifies the speed at which you want to set this fan. Table 4 lists the fan speed values you can specify.

Table 4. Fan Speed Values

Value Meaning

0 Turns off the fan

1 Runs the fan at 1/4 the full speed.

2 Runs the fan at 1/2 the full speed.

3 Runs the fan at 3/4 the full speed.

4 Runs the fan at full speed.

The fan speed defaults to full speed.

Switches

/off{=boolean}

Specifies whether to turn off the fan associated with the specified unit number. If you set this switch to TRUE, the command turns off the fan associated with the specified unit number. You must turn on the fan if you want to set its speed.

This switch defaults to FALSE, which means the fan remains on and you can set its speed.

This switch is supported on the following operating systems:

Windows NT
NetWare
UNIX

Examples

The following example sets fan unit 0 on enclosure management device 0 to full speed:

 AFA0> enclosure set fan 0 0 4
 Executing: enclosure set fan 0 0 4

Related Information

enclosure Commands:

enclosure list (enclosure list)
enclosure set alarm (enclosure set alarm)
enclosure set power (enclosure set power)

enclosure set interval

To set the monitor reporting interval for a specific SAF-TE enclosure management device, use the enclosure set interval command. The monitor reporting interval indicates how often the controller checks the status of the enclosure management device and its associated components. In setting this value, consider the needs of your computing environment. Setting the monitor reporting level to less than ten seconds could cause slower system performance.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure set interval {second}

Parameters

{second}

Specifies the number of seconds for the monitor reporting interval. You can specify 1 to n seconds where n represents the number of seconds for the monitor reporting interval. (The maximum value is 86,400, the number of seconds in a day.)

The default is 10 seconds.

Examples

Before setting the monitor reporting interval, you might want to use the enclosure show status command to determine the current monitor reporting interval setting.

As the following example shows, the current monitor reporting interval setting is 10:

 AFA0> enclosure show status
 Enclosure UpTime D:H:M   PowerCycle Interval Door     Alarm 
 --------- -------------- ---------- -------- -------- ------- 
    0             0:00:00        0       10   UNLOCKED OFF    
 .
 .
 .
 Enclosure UpTime D:H:M   PowerCycle Interval Door     Alarm 
 --------- -------------- ---------- -------- -------- ------- 
    1             0:00:00        0       10   UNLOCKED OFF

The following example sets the monitor reporting interval for enclosure management devices 0 and 1 to 20 seconds:

 AFA0> enclosure set interval 20
 Executing: enclosure set interval 20

You may want to use the enclosure show status command again to see the change in the power supply's status, as in the following example:

 Enclosure UpTime D:H:M   PowerCycle Interval Door     Alarm 
 --------- -------------- ---------- -------- -------- ------- 
    0             0:00:00        0       20   UNLOCKED OFF    
 .
 .
 .
 Enclosure UpTime D:H:M   PowerCycle Interval Door     Alarm 
 --------- -------------- ---------- -------- -------- ------- 
    1             0:00:00        0       20   UNLOCKED OFF

Related Information

enclosure Commands:

enclosure list (enclosure list)
enclosure show status (enclosure show status)

enclosure set power

To turn the power of a specific power supply on a specific SAF-TE enclosure management device on or off, use the enclosure set power command. Typically, most enclosure management devices turn on their associated power supplies by default after power up.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure set power [/off{=boolean}] {enclosure} {powersupply}

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device on which you want to turn the power of a specific power supply on or off. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

{powersupply}

Specifies the unit number associated with the power supply whose power you want to turn on or off. The unit number for the power supply can range from 0 to 15 inclusive.

Switches

/off{=boolean}

Specifies whether to turn the power supply associated with the specified unit number on or off. If you set this switch to TRUE, the command turns off the power supply associated with the specified unit number. If you specify FALSE, the command turns on the power supply associated with the specified unit number.

This switch defaults to FALSE, which means the command turns on the power supply if you do not specify the switch.

This switch is supported on the following operating systems:

Windows NT
NetWare
UNIX

Examples

Before turning a power supply on or off, you might want to use the enclosure show power command to determine the current setting for the power supply or supplies. As the following example shows, power supply 0 on enclosure management device 1 is off and operational:

 AFA0> enclosure show power
 Executing: enclosure show power
 
 Enclosure Power State        Status 
 --------- ----- ------------ -------
    0       0     ON           OK
    1       0     ON           OK

The following example turns on power supply 0 on enclosure management device 1:

 AFA0> enclosure set power 1 0
 Executing: enclosure set power 1 0

You may want to use the enclosure show power command again to see the change in the power supply's status, as in the following example:

 AFA0> enclosure show power
 Executing: enclosure show power
 
 Enclosure Power State        Status 
 --------- ----- ------------ -------
    0       0     ON            OK
    1       0     ON            OK

Related Information

enclosure Commands:

enclosure list (enclosure list)
enclosure show power (enclosure show power)

enclosure set scsiid

To set the SCSI device ID for a specific device slot on a specific SAF-TE enclosure management device, use the enclosure set scsiid command. As discussed in other chapters, a SCSI ID consists of a SCSI channel number (for example, 0, 1, 2, 3, etc.), SCSI device ID (0 through 15 inclusive), and SCSI device logical unit number (0 through 7 inclusive). The enclosure set scsiid command allows you to set the specified device slot to a specific SCSI device ID (the middle number of a SCSI ID).

Notes

Before setting the SCSI device ID for a specific device slot on a specific SAF-TE enclosure management device, use the controller pause_io command. This command pauses all I/O activity on the currently opened controller.

You cannot set the SCSI device ID for a specific device slot to a SCSI device ID that is already in use. The command checks for SCSI device ID conflicts and will display an appropriate error message if you try to assign a SCSI device ID that is already in use.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure set scsiid {enclosure} {slot} {device_id}

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device. The device slot to be assigned a SCSI channel number is located on this enclosure management device. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

{slot}

Specifies the unit number associated with the device slot that you want to assign a SCSI channel number. This integer can range from 0 to 15 inclusive.

{device_id}

Specifies the ID (0 through 15 inclusive) of the SCSI device you want to assign to the specified device slot.

Examples

Before setting a device slot to a specific SCSI ID, you might want to use the enclosure show slot command to determine the current SCIS ID setting for the device slots, as in the following example:

 AFA0> enclosure show slot
 Executing: enclosure show slot
 
 Enclosure Slot scsiId Insert  Status                                    
 --------- ---- ------ ------- ------------------------------------------
    0       0   0:00:0     4   OK NOTACTIVATE
    0       1   0:01:0     0   OK UNCONFIG ACTIVATE
    0       2   0:10:0     0   OK UNCONFIG ACTIVATE
    0       3   0:03:0     0   OK UNCONFIG ACTIVATE
    0       4   0:04:0     0   OK UNCONFIG ACTIVATE
    1       0   1:00:0     0   OK CONFIG ACTIVATE
    1       1   1:01:0     0   OK UNCONFIG ACTIVATE
    1       2   1:10:0     0   OK UNCONFIG ACTIVATE
    1       3   1:03:0     0   OK UNCONFIG ACTIVATE
    1       4   1:04:0     0   OK UNCONFIG ACTIVATE

The following example sets device slot 2 on enclosure management device 0 to SCSI device ID 05. The example also shows how to pause all I/O activity on the controller by using the controller pause_io command:

 AFA0> controller pause_io 30
 Executing: controller pause_io 30
 AFA0> enclosure set scsiid 0 2 5
 Executing: enclosure set scsiid 0 2 5

You may want to use the enclosure show slot command again to see the change in the SCSI ID setting, as in the following example:

 AFA0> enclosure show slot
 Executing: enclosure show slot
 
 Enclosure Slot scsiId Insert  Status                                    
 --------- ---- ------ ------- ------------------------------------------
    0       0   0:00:0     4   OK NOTACTIVATE
    0       1   0:01:0     0   OK UNCONFIG ACTIVATE
    0       2   0:05:0     0   OK UNCONFIG ACTIVATE 
    0       3   0:03:0     0   OK UNCONFIG ACTIVATE 
    0       4   0:04:0     0   OK UNCONFIG ACTIVATE 
    1       0   1:00:0     0   OK CONFIG ACTIVATE 
    1       1   1:01:0     0   OK UNCONFIG ACTIVATE 
    1       2   1:10:0     0   OK UNCONFIG ACTIVATE 
    1       3   1:03:0     0   OK UNCONFIG ACTIVATE 
    1       4   1:04:0     0   OK UNCONFIG ACTIVATE

Related Information

controller commands:

controller pause_io (controller pause_io)

enclosure Commands:

enclosure list (enclosure list)
enclosure show slot (enclosure show slot)

enclosure set temperature

To set the temperature threshold on a specific SAF-TE enclosure management device, use the enclosure set temperature command. Typically, an enclosure management device contains individual temperature sensors.

With this command, you can set a temperature threshold so that the enclosure management device alerts you if one or more of the temperature sensors exceeds the threshold. The FAST utility, not the CLI, displays this alert.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure set temperature {enclosure} {degree}

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device on which you want to set a temperature threshold. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

{degree}

Specifies the temperature (in degrees Fahrenheit) at which you want to set the threshold for this enclosure management device. You can specify from 0 to 255 degress Fahrenheit.

The default is 120 degrees Fahrenheit.

Examples

Before setting the threshold temperature, you might want to use the enclosure show temperature command to determine the current temperature(s). As the following example shows, the current temperature is 70 degrees Fahrenheit and the threshold setting is 120 degrees Fahrenheit:

 Enclosure Sensor Temperature Threshold Status   
 --------- ------ ----------- --------- -------- 
    0       0       70 F         120    NORMAL

The following example sets the threshold temperature associated with enclosure management device 0 to 100 degrees Fahrenheit:

 AFA0> enclosure set temperature 0 100
 Executing: enclosure set temperature 0 100

You may want to use the enclosure show temperature command again to see the change in threshold temperature, as in the following example:

 AFA0> enclosure show temperature 0
 Executing: enclosure show temperature 0
 
 Enclosure Sensor Temperature Threshold Status   
 --------- ------ ----------- --------- -------- 
    0       0       70 F         100    NORMAL

The Threshold column now displays 100 degrees.

Related Information

enclosure Commands:

enclosure list (enclosure list)
enclosure show temperature (enclosure show temperature)

enclosure show fan

To display the status of a specific fan on a specific SAF-TE enclosure management device, use the enclosure show fan command.You can also use this command to display the status of all fans on the enclosure management device or devices.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure show fan [{enclosure}] [{fan}]

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device for which you want to display fan status information. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

If you do not specify a unit number, the command displays the fan status for all enclosure management devices connected to the controller.

{fan}

Specifies the unit number associated with the fan whose status you want to display. This integer can range from 0 to 15 inclusive.

If you do not specify a unit number, the command displays the status for all fans on the enclosure management device or devices.

Examples

The following example displays the status of all fans on enclosure management devices 0 and 1:

 AFA0> enclosure show fan
 Executing: enclosure show fan
 
 Enclosure Fan Status       
 --------- --- -------------
    0       0   OK           
    1       0   NOT INSTALLED

As the example shows, the fan status display contains the following columns:

Enclosure
Fan
Status

The following sections describe the information that the enclosure show fan command can display in these columns.

The Enclosure and Fan Columns

The Enclosure column displays the ID associated with the enclosure management device that you specified on the command line. If you did not specify an ID , the enclosure show fan command displays the IDs for all enclosure managment devices connected to the controller. In the example, the enclosure show fan command displays enclosure management device IDs 0 and 1.

The Fan column displays the unit number associated with the fan that you specified on the command line. If you did not specify a unit number, the enclosure show fan command displays the unit numbers for all fans on the enclosure management device or devices. In the example, there is one fan (unit 0) each on enclosure management devices 0 and 1.

The Status Column

The Status column displays the status for each fan listed in the display. The enclosure show fan command can display the fan status values listed in Table 5.

Table 5. Fan Status Values

Status Meaning

OK The fan is operational. In the example, fan 0 on enclosure management device 0 is operational.

BAD The fan is not working properly.

NOT INSTALLED The fan is not installed. In the example, fan 0 on enclosure management device 1 is not installed.

UNKNOWN The status of the fan is not reportable. Or, the fan status is unknown.

Related Information

enclosure Commands:

enclosure list (enclosure list)
enclosure set fan (enclosure set fan)
enclosure show status (enclosure show status)

enclosure show power

To display the status of a specific power supply on a specific SAF-TE enclosure management device, use the enclosure show power command. You can also use this command to display the status of all power supplies on the enclosure management device or devices.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure show power [{enclosure}] [{powersupply}]

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device for which you want to display power supply status information. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

If you do not specify an ID, the command displays the power supply status for all enclosure management devices connected to the controller.

{powersupply}

Specifies the unit number associated with the power supply whose status you want to display. This integer can range from 0 to 15 inclusive.

If you do not specify a unit number, the command displays the status for all power supplies on the enclosure management device or devices.

Examples

The following example displays the status of the power supplies on enclosure management devices 0 and 1:

 AFA0> enclosure show power
 Executing: enclosure show power
 
 Enclosure Power State        Status 
 --------- ----- ------------ -------
    0       0     OK            ON
    1       0     OK            OFF

As the example shows, the power supply status display contains the following columns:

Enclosure
Power
State
Status

The following sections describe the information that the enclosure show power command can display in these columns.

The Enclosure and Power Columns

The Enclosure column diplays the ID associated with the enclosure management device that you specified on the command line. If you did not specify an ID, the enclosure show power command displays the IDs for all enclosure managment devices connected to the controller. In the example, 0 is specified.

The Power column displays the unit number associated with the power supply that you specified on the command line. If you did not specify a unit number, enclosure show power command displays the unit numbers for all power supplies on the enclosure management device or devices. In the example, there is one power supply (unit 0) each on enclosure management devices 0 and 1.

The State and Status Columns

The State column displays the state and the Status column displays the status of the power supply. Specifically, the column can display the items listed in Table 6.

Table 6. Power Supply State and Status Values

Status State Meaning

ON OK The power supply is on and operational. In the example, power supply 0 on enclosure management device 0 has these values.

OFF OK The power supply is off and operational. In the example, power supply 0 on enclosure management device 1 has these values.

ON BAD The power supply is on and not working properly.

OFF BAD The power supply is off and not working properly.

INSTALLED UNKNOWN The power supply is installed and its status is not reportable or unknown.

NOT INSTALLED Not Applicable The power supply is not installed.

UNKNOWN UNKNOWN The state and status of the power supply is not reportable or unknown.

Related Information

enclosure Commands:

enclosure list (enclosure list)
enclosure set power (enclosure set power)

enclosure show slot

To display the status of a specific device slot on a specific SAF-TE enclosure management device, use the enclosure show slot command. You can also use this command to display the status of all device slots on the enclosure management device or devices.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure show slot [{enclosure}] [{slot}]

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device for which you want to display device slot status information. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

If you do not specify an ID, the command displays the device slot status for all enclosure management devices connected to the controller.

{slot}

Specifies the unit number associated with the device slot whose status you want to display. This integer can range from 0 to 15 inclusive. Typically, the slot unit number is limited by the physical number of device slots in the enclosure management device.

If you do not specify a unit number, the command displays the status for all device slots on the enclosure management device or devices.

Examples

The following example displays the status of all device slots on enclosure management devices 0 and 1:

 AFA0> enclosure show slot
 Executing: enclosure show slot
 
 Enclosure Slot scsiId Insert  Status                                    
 --------- ---- ------ ------- ------------------------------------------
    0       0   0:00:0     4   OK
    0       1   0:01:0     0   UNCONFIG 
    0       2   0:10:0     0   UNCONFIG 
    0       3   0:03:0     0   UNCONFIG 
    0       4   0:04:0     0   UNCONFIG 
    1       0   1:00:0     0   UNCONFIG 
    1       1   1:01:0     0   UNCONFIG 
    1       2   1:10:0     0   UNCONFIG 
    1       3   1:03:0     0   UNCONFIG 
    1       4   1:04:0     0   UNCONFIG

As the example shows, the device slot status display contains the following columns:

Enclosure
Slot
scsiId
Insert
Status

The following sections describe the information that the enclosure show slot command can display in these columns.

The Enclosure and Slot Columns

The Enclosure column diplays the ID associated with the enclosure management device that you specified on the command line. If you did not specify an ID, the enclosure show slot command displays the IDs for all enclosure managment devices connected to the controller. In the example, the enclosure show slot command displays enclosure management device IDs 0 and 1.

The Slot column displays the unit number associated with the device slot that you specified on the command line. If you did not specify a unit number, the enclosure show slot command displays the unit numbers for all device slots on the enclosure management device or devices. In the example, the enclosure show slot command displays the device slot status for device slots 0 through 4 for enclosure management devices 0 and 1.

The scsiId Column

The scsiId column displays the SCSI ID associated with the device slot. A SCSI ID consists of a SCSI channel number (for example, 0, 1, 2, 3, etc.), SCSI device ID (0 through 15 inclusive), and SCSI device logical unit number (0 through 7 inclusive). In the example, the enclosure show slot command displays the SCSI IDs for device slots 0 through 4.

The Insert Column

The Insert column displays a number that indicates how many times a user inserted a device into the device slot. In the example, a user inserted a device into device slot 0 four times.

The Status Column

The Status column displays status information about a device slot. Specifically, the column can display the values listed in Table 7.

Table 7. Device Slot Status Values

Status Meaning

OK The device that resides in this slot is operational. In the example, the device that resides in device slot 0 on enclosure management device 0 is operational.

ERROR The device that resides in this slot has error conditions.

FAULTY The device that resides in this slot has some hardware or data fault.

REBUILD The device that resides in this slot is being rebuilt.

FAILED The device that resides in this slot is in a device array. One member of this device array has an error.

CRITICAL The device that resides in this slot is in a device array that was previously fault-tolerant and is now non-fault-tolerant.

SCRUB The device that resides in this slot is in a device array that is undergoing a parity check operation.

WARNING The device that resides in this slot is likely to fail in the near future.

UNCONFIG The device that resides in this slot is not currently configured as a member of a device array or as a hot spare.

HOTSPARE The device that resides in this slot is configured as a hot spare.

REBUILDSTOP The device that resides in this slot was rebuilding, but the rebuild operation terminated abnormally or unsuccessfully.

EMPTY No physical device resides in this slot.

I/R READY The slot is ready for the physical insertion or removal of a device.

NOTACTIVATE The slot is not activated. The device that resides in the slot cannot be accessed on the SCSI bus.

ACTIVATE The slot is activated. The device that resides in the slot can be accessed on the SCSI bus.

Related Information

enclosure Commands:

enclosure list (enclosure list)
enclosure set scsiid (enclosure set scsiid)

enclosure show status

To display the general status of a specific SAF-TE enclosure management device, use the enclosure show status command. You can also use this command to display the general status of all enclosure management devices connected to the controller.

In addition to general status information, this command also displays status information available from the following commands:

enclosure show fan
enclosure show power
enclosure show slot
enclosure show temperature

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure show status [{enclosure}]

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device for which you want to display status information. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

If you do not specify an ID, the command displays status information for all enclosure management devices connected to the controller.

Examples

The following example displays status information for enclosure management devices 0 and 1:

 AFA0> enclosure show status
 Executing: enclosure show status
 
 Enclosure UpTime D:H:M   PowerCycle Interval Door     Alarm 
 --------- -------------- ---------- -------- -------- ------- 
    0             0:04:25        2       20   UNLOCKED OFF
 
 Enclosure Fan Status       
 --------- --- -------------
    0       0   OK
 
 Enclosure Power State        Status 
 --------- ----- ------------ -------
    0       0     UNKNOWN       UNKNOWN
 
 Enclosure Slot scsiId Insert  Status                                    
 --------- ---- ------ ------- ------------------------------------------
    0       0   0:00:0     0   OK UNCONFIG ACTIVATE
    0       1   0:01:0     0   OK UNCONFIG ACTIVATE
    0       2   0:10:0     0   OK UNCONFIG ACTIVATE 
    0       3   0:03:0     0   OK UNCONFIG ACTIVATE 
    0       4   0:04:0     0   OK UNCONFIG ACTIVATE
 
 Enclosure Sensor Temperature Threshold Status   
 --------- ------ ----------- --------- -------- 
    0       0       72 F         120    NORMAL
 
 Enclosure UpTime D:H:M   PowerCycle Interval Door     Alarm 
 --------- -------------- ---------- -------- -------- ------- 
    1             2:20:25        3       20   UNLOCKED OFF
 
 Enclosure Fan Status       
 --------- --- -------------
    1       0   NOT INSTALLED
 
 Enclosure Power State        Status 
 --------- ----- ------------ -------
    1       0     UNKNOWN       UNKNOWN
 
 Enclosure Slot scsiId Insert  Status                                    
 --------- ---- ------ ------- ------------------------------------------
    1       0   1:00:0     0   UNCONFIG 
    1       1   1:01:0     0   UNCONFIG 
    1       2   1:10:0     0   UNCONFIG 
    1       3   1:03:0     0   UNCONFIG 
    1       4   1:04:0     0   UNCONFIG 
 
 Enclosure Sensor Temperature Threshold Status   
 --------- ------ ----------- --------- -------- 
    1       0       75 F         120    NORMAL

The general status of an enclosure management device is encapsualted in the following columns:

Enclosure
UpTime D:H:M
PowerCycle
Interval
Door
Alarm

The following sections describe the information that the enclosure show status command can display in these columns. For information about the status displays for fans, power supplies, device slots, and temperature sensors see the Related Information section.

The Enclosure Column

The Enclosure column displays the ID associated with the enclosure management device that you specified on the command line. If you did not specify an ID, the enclosure show status command displays the IDs for all enclosure managment devices connected to the controller.

The UpTime D:H:M Column

The UpTime D:H:M column displays the total time (days:hours:minutes) that the enclosure management device has been running. This count is cumulative over the life of the enclosure management device.

The PowerCycle Column

The PowerCycle column displays the number of times a user has powered on the enclosure management device. In the example, a user powered on enclosure management device 0 two times and enclosure management device 1 three times. This count is cumulative over the life of the enclosure management device.

The Interval Column

The Interval column displays the monitor interval. You can set the monitor interval with the enclosure set interval command. In the example, the monitor interval reporting level for both enclosure management devices is 20 seconds.

The Door and Alarm Columns

The Door column displays the status of the door lock. The enclosure show status command can display the door lock status values listed in Table 8.

Table 8. Door Lock Status Values

Status Meaning

LOCKED The door is currently locked.

UNLOCKED The door is currently unlocked or there is no controllable door lock installed. This is the value displayed in the example.

UNKNOWN The status of the door lock is not reportable. Or, the door lock status is unknown.

The Alarm column displays the status of the audible alarm. The enclosure show status command can display the audible alarm status values listed in Table 9.

Table 9. Audible Alarm Status Values

Status Meaning

ON The alarm is currently on.

OFF The alarm is currently off or there is no alarm installed. This is the value displayed in the example.

Related Information

enclosure Commands:

enclosure list (enclosure list)
enclosure set interval (enclosure set interval)
enclosure show fan (enclosure show fan)
enclosure show power (enclosure show power)
enclosure show slot (enclosure show slot)
enclosure show temperature (enclosure show temperature)

enclosure show temperature

To display the temperature status of a specific temperature sensor on a specific SAF-TE enclosure management device, use the enclosure show temperature command. You can also use this command to display the temperature status of all temperature sensors on the enclosure management device or devices.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

enclosure show temperature [{enclosure}] [{sensor}]

Parameters

{enclosure}

Specifies the ID associated with the enclosure management device for which you want to display temperature status information. For this version, the controller supports a maximum of eight enclosure management devices on each channel.

If you do not specify an ID, the command displays the temperature status information for all enclosure management devices connected to the controller.

{sensor}

Specifies the unit number associated with the temperature sensor whose status you want to display. This integer can range from 0 to 15 inclusive.

If you do not specify a unit number, the command displays the status for all temperature sensors on the enclosure management device or devices.

Examples

The following example displays the temperature status of temperature sensor unit 0 on enclosure management device 0:

 AFA0> enclosure show temperature 0 0
 Executing: enclosure show temperature 0 0
 
 Enclosure Sensor Temperature Threshold Status   
 --------- ------ ----------- --------- -------- 
    0       0        70          120   NORMAL

As the example shows, the temperature sensor status display contains the following columns:

Enclosure
Sensor
Temperature
Threshold
Status

The following sections describe the information that the enclosure show temperature command can display in these columns.

The Enclosure Column

The Enclosure column diplays the ID associated with the enclosure management device that you specified on the command line. If you did not specify an ID, the enclosure show temperature command displays the IDs for all enclosure managment devices connected to the controller. In the example, 0 is specified.

The Sensor Column

The Sensor column displays the unit number associated with the temperature sensor that you specified on the command line. If you did not specify a unit number, the enclosure show temperature command displays the unit numbers for all temperature sensors on the enclosure management device or devices.

The Temperature Column

The Temperature column displays the internal enclosure temperature for this temperature sensor, in degrees Fahrenheit. The temperature can range from -10 degrees to 245 degrees Fahrenheit. In the example, the temperature is 70 degrees Fahrenheit.

The Threshold Column

The Threshold column displays the temperature at which the FAST utility reports a warning if the temperature goes above the threshold. In the example, the temperature threshold is 120 degrees Fahrenheit. You can change the temperature threshold by using the enclosure set temperature command.

The Status Column

The Status column displays the status of the temperature displayed in the Temperature column. The enclosure show temperature command can display the temperature status values listed in Table 10.

Table 10. Temperature Status Values

Status Meaning

NORMAL The temperature is within the normal range for this temperature sensor. In this case, the enclosure management device does not send an alarm. This is the value that appears in the example.

ABNORMAL The temperature exceeds the normal range for this temperature sensor. In this case, the enclosure management device may send an alarm.

Related Information

enclosure Commands:

enclosure list (enclosure list)
enclosure set temperature (enclosure set temperature)
enclosure show status (enclosure show status)

Back to Contents Page