Accessing and Monitoring the Server Using the ELOM CLI

C H A P T E R 6

This chapter provides information about how to use the command-line interface (CLI) and the Sun Blade X6450 Server Module software to monitor your server.

See the following sections:

Accessing the CLI

Using the CLI

Monitoring Server System Information

Accessing the CLI

To view and monitor the server module’s SP ELOM, use one of the methods listed below to access the CLI. The recommended method is to access the server module’s SP directly using an Ethernet connection and SSH. You can also connect to the Chassis Monitoring Module (CMM) using Ethernet and SSH. You can also use a serial terminal and connect directly to the server module’s SP, using the multi-port dongle cable and the UCP connector on the front panel of the server module, or connect to the serial connector on the chassis to access the CMM. TABLE 6-1 describes these methods and points to the relevant connect procedure.

TABLE 6-1 Methods for Accessing the CLI
Method	Description	Procedure
Serial port	Connect to the CLI using a serial terminal, the multi-port dongle cable, and the UCP connector on the front of the server module.	Connecting to Server Module’s SP CLI ELOM Using the Serial Port
SSH-to-CLI (Recommended)	Connect to the CLI using an Ethernet connection and secure shell (SSH). SSH connections are enabled by default.	Connecting to the Server Module’s SP ELOM Using Ethernet
SSH-to-CMM	Connect to the Chassis Monitoring Module (CMM) using an Ethernet connection, and navigate to the SP CLI.	Connecting to the Server Module’s SP ELOM Through the CMM

Logging In to the CLI

You must log in to the CLI by supplying a user name and password. When you first access the CLI, and you have not set up any other user accounts (using the web interface), you must log in using the preconfigured administrator user account called root. This account has full read and write privileges, and will enable you monitor, manage and configure the ELOM. Telnet connections to the ELOM are not supported. For more information about the preconfigured administrator account, see About the Preconfigured Administrator Account.

Using the CLI

The CLI enables you to monitor, manage and configure the ELOM (for a list of common tasks that you can perform with the CLI, see TABLE 1-1, in the section, Embedded Lights Out Manager Common Tasks). To use the CLI, you enter commands at the CLI prompt. The CLI has a structure and the command set has a syntax. The CLI structure and command syntax are discussed in the next section.

CLI Structure and Command Syntax

The CLI architecture is a hierarchical namespace that contains every managed object in the system. The top of the hierarchical structure is designated by /. The namespace targets directly below are /SP, /SYS, and /CH (see FIGURE 6-1).

FIGURE 6-1 The Top Levels of the CLI Namespace

Within each namespace, you can do the following:

/SP - Manage, maintain, and configure the server.

/SYS - Manage the server and view server system information.

/CH - View chassis information.

Syntax

The syntax of a command is:

command [options] target [propertyname=value]

For more information on the CLI command line, see Appendix A.

User Accounts and Permissions Levels

To use the CLI, you must have a user account. Every user account must have an assigned permission level. The permission level sets the ELOM read and write limitations for the account. ELOM permissions for user accounts define user limitations. For example:

Administrator - Enables unlimited (read and write) access to all ELOM features, functions, and commands.

Operator (default)- Enables read-only access to a limited number of ELOM software features, functions, and commands, plus management access to Indicator and Fault LEDs.

User and Callback- Enable read-only access to a limited number of ELOM software features, functions, and commands.

TABLE 4-2, in Chapter 4, shows the user permission levels and the access each level has to the ELOM menus and screens. For information about how to create a user account, see Managing User Accounts.

Monitoring Server System Information

You can use the CLI to navigate the /SYS namespace to view the following server system information:

1. Server module-specific information

2. Server module sensor information

3. Chassis and midplane information

The following is a list of the specific information that is available for viewing in the /SYS namespace:

/SYS Namespace	Description	Section/Procedure
/SYS/BoardInfo	Board level information: Manufacturer, manufacture date and time, BIOS version and board name, serial number, and part number	Viewing Server Module-Specific Information
/SYS/ProductInfo	Product level information: Manufacturer, name, part number, serial number, and asset tag	Viewing Server Module-Specific Information
/SYS/CtrlInfo	Power control information: Power status, power control, boot control, Id LED control, Fault LED status, and Fault LED control	Viewing Server Module-Specific Information
/SYS/CPU	CPU information: Socket designation, manufacturer, name, speed, status	Viewing Server Module-Specific Information
/SYS/Memory	Memory module information: Designation, type, speed, size, status	Viewing Server Module-Specific Information
/SYS/NICInfo0	NIC information: Manufacturer, name, part number, serial number	Viewing Server Module-Specific Information
/SYS/Temperature	Temperature sensor information: Designation, status, sensor reading, low warning threshold, low critical threshold, upper warning threshold, upper critical threshold	Viewing Server Module Sensor Information Viewing Server Module Sensor Information
/SYS/Voltage	Voltage sensor information: Designation, status, sensor reading, low warning threshold, low critical threshold, upper warning threshold, upper critical threshold
/SYS/ChassisInfo	Chassis level information: Type, part number, serial number	Viewing Chassis and Midplane Information
/SYS/MIDPlane	Chassis midplane information: Part number, serial number, asset tab, chassis serial number, and chassis part number	Viewing Server Module Sensor Information

For information about available targets, command verbs, and properties for System Information, see Appendix A and the section, System Information.

Viewing Server Module-Specific Information

You can use the CLI to view server module-specific information, such as serial numbers, part numbers, component parameters, and threshold settings. This information is accessible in the following /SYS namespace:

BoardInfo

ProductInfo

CtrlInfo

Memory

NicInfo0

SP Version (accessible from any namespace)

The following procedure describes how to view server module-specific information using the CLI:

To View Server Module-Specific Information

1. Navigate to the /SYS namespace, and enter the following commands:

-> cd /SYS

-> show

Example:

 -> cd /SYS
/SYS
 
 -> show
 
  /SYS
    Targets:
        BoardInfo
        ProductInfo
        ChassisInfo
        CtrlInfo
        CPU
        Memory
        NICInfo0
        Temperature
        Voltage
        MIDPlane
 
    Properties:
 
    Target Commands:
        show
        cd
        start
        stop
        reset
 ->

The above example shows the available targets in the /SYS namespace.

Note - When additional targets (namespace levels) are available, you can navigate to a target and execute the show command to view the target, properties, and commands for that target. For more information about namespace levels and targets, see Appendix A and the section, Namespace Levels and Targets.

a. To view board information, enter the following commands:

-> cd /SYS/BoardInfo

-> show

b. To view product information, enter the following commands:

-> cd /SYS/ProductInfo

-> show

c. To view power status infomation, enter the following commands:

-> cd /SYS/CtrlInfo

-> show

Example:

 -> cd /SYS/CtrlInfo
/SYS/CtrlInfo
 
 -> show
 
  /SYS/CtrlInfo
    Targets:
        FaultLed
 
    Properties:
        PowerStatus = on
        PowerCtrl = (Could not show property)
        BootCtrl = regular
        IdLedCtrl = off
 
    Target Commands:
        show
        cd
        set
 ->

The above example shows the available targets for the /SYS/CtrlInfo namespace. This namespace contains some configuration capabilities (note the availability of the set command). For information about managing the /SYS/CtrlInfo namespace, see Managing the Power State of the Server.

d. To view CPU information, enter the following commands:

-> cd /SYS/CPU

-> show

Example:

-> cd /SYS/CPU
/SYS/CPU
 
 -> show
 
  /SYS/CPU
    Targets:
        CPU0
        CPU1
        CPU2
        CPU3
 
    Properties:
 
    Target Commands:
        show
        cd
 ->

The above example shows the available targets for the /SYS/CPU namespace.

e. To view individual CPU information, enter the following commands:

-> cd /SYS/CPU[0...3]

where 0...3 is the CPU number.

-> show

f. To view memory module information, enter the following commands:

-> cd /SYS/Memory-> show

Example:

 -> cd /SYS/Memory
/SYS/Memory
 
 -> show
 
  /SYS/Memory
    Targets:
        DIMM_A0
        DIMM_A1
        DIMM_A2
        DIMM_A3
        DIMM_A4
        DIMM_A5
        DIMM_B0
        DIMM_B1
        DIMM_B2
        DIMM_B3
        DIMM_B4
        DIMM_B5
        DIMM_C0
        DIMM_C1
        DIMM_C2
        DIMM_C3
        DIMM_C4
        DIMM_C5
        DIMM_D0
        DIMM_D1
        DIMM_D2
        DIMM_D3
        DIMM_D4
        DIMM_D5
 
    Properties:
 
    Target Commands:
        show
        cd
 ->

The above example shows the available targets for the /SYS/Memory namespace.

g. To view indivdual memory module information, enter the following commands:

-> cd /SYS/Memory/DIMM_module_number
where module_number is the specific memory module number.
-> show

h. To view NIC0 information, enter the following commands:

-> cd /SYS/NICInfo0-> show

i. To view SP version information, enter the following command:

-> version

Example:

 -> version
SM CLP Version v1.0.0
SM ME Addressing Version v1.0.0
 ->

Viewing Server Module Sensor Information

You can use the CLI to view server module temperature and voltage sensor information for system critical components, such as the CPUs and DIMMs. This information is accessible in the following /SYS namespaces:

Temperature

Voltage

The following procedure describes how to view server module sensor information using the CLI:

To View Server Module Sensor Information

1. To navigate to the /SYS namespace, enter the following commands:

-> cd /SYS

-> show

Example:

 -> cd /SYS
/SYS
 
 -> show
 
  /SYS
    Targets:
        BoardInfo
        ProductInfo
        ChassisInfo
        CtrlInfo
        CPU
        Memory
        NICInfo0
        Temperature
        Voltage
        MIDPlane
 
    Properties:
 
    Target Commands:
        show
        cd
        start
        stop
        reset
 ->

The above example shows the available targets in the /SYS namespace.

Note - When additional targets (namespace levels) are available, you can navigate to a target using the cd command, and execute the show command to view the target, properties, and commands for that target. For more information about namespace levels and targets, see Appendix A and the section, Namespace Levels and Targets..

a. To view temperature information, enter the following commands:

-> cd /SYS/Temperature

-> show

Example:

 -> show
 
  /SYS/Temperature
    Targets:
        CPU_0_TEMP
        CPU_1_TEMP
        CPU_2_TEMP
        CPU_3_TEMP
        VRD_0_TEMP
        VRD_1_TEMP
        VRD_2_TEMP
        VRD_3_TEMP
        DIMM_0_TEMP
        DIMM_1_TEMP
        PROCESSOR_0_HOT
        PROCESSOR_1_HOT
        PROCESSOR_2_HOT
        PROCESSOR_3_HOT
 
    Properties:
 
    Target Commands:
        show
        cd

The above example shows the available targets for this namespace.

b. To view voltage information, enter the following commands:

-> cd /SYS/Voltage-> show

Example:

 -> cd /SYS/Voltage
/SYS/Voltage
 
 -> show
 
  /SYS/Voltage
    Targets:
        P_VCCP0
        P_VCCP1
        P_VCCP2
        P_VCCP3
        P1V2_VTT
        P1V5_MCH
        P1V5_ESB
        P1V8_B0
        P1V8_STB
        P1V2_NIC
        P12V_CPU1
        P12V_CPU0
        P12V
        P3V3_SUS
        P3V3
        P5V
        P1V25_VTT_STB
        P1V5_B0
        P1V5_B1
        P2V5_STB
        P1V8_B1
        P0V9_B0
        P0V9_B1
        P12V_CPU3
        P12V_CPU2
        P1V8_NIC
        P3V3_SUS
        VCC5_SUS
        HOST_PWR
        STBY_PWR
 
    Properties:
 
    Target Commands:
        show
        cd
 ->

The above example shows the available targets for this namespace.

Viewing Chassis and Midplane Information

You can use the CLI to view information about the chassis and chassis midplane. This information is accessible in the following /SYS namespace:

Temperature

Voltage

The following procedure describes how to view server module sensor information using the CLI:

To View Chassis and Midplane Information

1. To navigate to the /SYS namespace, enter the following commands:

-> cd /SYS

-> show

a. To view chassis information, enter the following commands:

-> cd /SYS/ChassisInfo-> show

b. To view midplane information, enter the following commands:

-> cd /SYS/MIDPlane-> show