This section provides information about the Server Management Workgroup (SMWG) Server Management-Command Line Protocol (SM-CLP) that is incorporated in the DRAC 5.
NOTE: This section assumes that you are familiar with the Systems Management
Architecture for Server Hardware (SMASH) Initiative and the SMWG SM-CLP
specifications. For more information on these specifications, see the Distributed
Management Task Force (DMTF) website at www.dmtf.org.
The DRAC 5 SM-CLP is a protocol driven by the DMTF and SMWG to provide standards for systems management CLI implementations. The SMWG SM-CLP is a subcomponent of the overall SMASH efforts overseen by DMTF.
DRAC 5 SM-CLP Support
DRAC 5 is the first RAC product that provides support for the SM-CLP standard-based command line protocol. The SM-CLP is hosted from the DRAC 5 controller firmware and supports telnet, SSH, and serial-based interfaces. The DRAC 5 SM-CLP interface is based on the SM-CLP Specification Version 1.0 provided by the DMTF organization.
The following sections provide an overview of the SM-CLP feature that is hosted from the DRAC 5.
SM-CLP Features
The SM-CLP promotes the concept of verbs and targets to provide system management capabilities through the CLI. The verb indicates the operation to perform, and the target determines the entity (or object) that runs the operation.
Below is an example of the SM-CLP command line syntax.
<verb> [<options>] [<target>] [<properties>]
During a typical SM-CLP session, the user can perform operations using the verbs listed in Table 12-1 and Table 12-2.
Table 12-1. Supported CLI Verbs for System
Verb
Definition
cd
Navigates through the MAP using the shell.
delete
Deletes an object instance.
help
Displays help for a specific target.
reset
Resets the target.
show
Displays the target properties, verbs, and subtargets.
start
Turns on a target.
stop
Shuts down a target.
exit
Exits from the SM-CLP shell session.
version
Displays the version attributes of a target.
Table 12-2. Supported CLI Verbs for Fans, Batteries, Intrusion, Hardware Performance, Power supplies, Temperatures and Voltages
Verb
Definition
cd
Navigates through the MAP using the shell.
help
Displays help for a specific target.
show
Displays the target properties, verbs, and subtargets.
exit
Exits from the SM-CLP shell session.
version
Displays the version attributes of a target.
Using SM-CLP
SSH (or telnet) to the DRAC 5 with correct credentials.
At the command prompt, type smclp.
The SMCLP prompt (->) is displayed.
SM-CLP Management Operations and Targets
Management Operations
The DRAC 5 SM-CLP enables users to manage the following:
Server Power Management — Turn on, shutdown, or reboot the system
System Event Log (SEL) Management — Display or clear the SEL records
Table 12-8 provides examples of using the cd verb to navigate the MAP. In all examples, the initial default target is assumed to be /.
Table 12-8. Map Target Navigation Operations
Operation
Syntax
Navigate to the system target and reboot
->cd system1 ->reset
NOTE: The current default target is /.
Navigate to the SEL target and display the log records
->cd system1
->cd logs1/log1
->show
->cd system1/logs1/log1
->show
Display current target
->cd .
Move up one level
->cd ..
Exiting the shell
->exit
System Properties
The Table 12-9 lists the system properties that are displayed when the user types the following:
show /system1
These properties are derived from the Base System Profile that is provided by the standards body and is based on the CIM_ComputerSystem class as defined by the CIM schema.
For additional information, see the DMTF CIM schema definitions.
Table 12-9. System Properties
Object
Property
Description
CIM_ComputerSystem
Name
Unique identifier of a System instance that exists in the enterprise environment.
MaxLen = 256
ElementName
User-friendly name for the system.
MaxLen = 64
NameFormat
Identifies the method by which the Name is generated.
Enumeration indicating whether the system is a special-purpose system or general-purpose system.
Values:
0=Not Dedicated
1=Unknown
2=Other
3=Storage
4=Router
5=Switch
6=Layer 3 Switch
7=CentralOffice Switch
8=Hub
9=Access Server
10=Firewall
11=Print
12=I/O
13=Web Caching
14=Management
15=Block Server
16=File Server
17=Mobile User Device,
18=Repeater
19=Bridge/Extender
20=Gateway
21=Storage Virtualizer
22=Media Library
23=Extender Node
24=NAS Head
25=Self-Contained NAS
26=UPS
27=IP Phone
28=Management Controller
29=Chassis Manager
ResetCapability
Defines the reset methods available on the system
Values:
1=Other
2=Unknown
3=Disabled
4=Enabled
5=Not Implemented
CreationClassName
The superclass from which this instance is derived.
EnabledState
Indicates the enabled/disabled states of the system.
Values:
0=Unknown
1=Other
2=Enabled
3=Disabled
4=Shutting Down
5=Not Applicable
6=Enabled but Offline
7=In Test
8=Deferred
9=Quiesce
10=Starting
EnabledDefault
Indicates the default startup configuration for the enabled state of the system. By default, the system is "Enabled" (value=2).
Values:
2=Enabled
3=Disabled
4=Not Applicable
5=Enabled but Offline
6=No Default
RequestedState
Indicates the last requested or desired state for the system.
Values:
2=Enabled
3=Disabled
4=Shut Down
5=No Change
6=Offline
7=Test
8=Deferred
9=Quiesce
10=Reboot
11=Reset
12=Not Applicable
HealthState
Indicates the current health of the system.
Values:
0=Unknown
5=OK
10=Degraded/Warning
15=Minor Failure
20=Major Failure
30=Critical Failure
35=Non-recoverable Error
OperationalStatus
Indicates the current status of the system.
Values:
0=Unknown
1=Other
2=OK
3=Degraded
4=Stressed
5=Predictive Failure
6=Error
7=Non-Recoverable Error
8=Starting
9=Stopping
10=Stopped
11=In Service
12=No Contact
13=Lost Communication
14=Aborted
15=Dormant
16=Supporting Entity in Error
17=Completed
18=Power Mode
Description
A text-based description of the system.
Property Names for Fan, Temperature, Numeric Voltage, Power
Consumption, and Amperage Sensors
Supported Property Names for Fans, Temperature, Numeric Voltage, Power
Consumption, and Amperage Sensors
Table 12-10. Sensors
Object
Property
Description
CIM_NumericSensor
SystemCreationClassName
The name of the system creation class— CIM_ComputerSystem)
SystemName
The service tag of the system, which is a unique identifier of a system that exists in the enterprise environment
CreationClassName
The creation class name —CIM_NumericSensor
DeviceID
The unique ID for the sensor in the system
fan1...n (for tachsensor) temp 1...n (for tempsensor) numeric voltage 1...n) for numericsensor (voltage) (PMBus systems only)) power consumption 1...n (for power consumption (PMBus systems only)) amperage 1...n (for amperage (PMBus systems only))
{ "no intrusion", "chassis intrusion," "drive bay intrusion," "I/O card area intrusion," "processor area intrusion," "LAN disconnect," "unauthorized dock," "FAN area intrusion" } (for the Intrusion sensor)
{ "absent," "low," "failed," "good" } (for the Battery sensor)
{ "good," "bad," "unknown" } (for the Voltage sensor)
