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. Many efforts are driven by a defined SMASH architecture that is targeted as a foundation for more standardized systems management set of components. The SMWG SM-CLP is a subcomponent of the overall SMASH efforts driven 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 specification provides a common set of standard SM-CLP verbs that can be used for simple systems management through the CLI.
Table 11-1 provides a list of supported CLI verbs.
Table 11-1. Supported CLI Verbs
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.
SM-CLP Management Operations and Targets
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 11-1.
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
Targets
Table 11-2 provides a list of targets provided through the SM-CLP to support these operations.
Table 11-2. SM-CLP Targets
Target
Definition
/system1
The managed system target.
/system1/logs1
The log collections target
/system1/logs1/log1
The System Event Log (SEL) target on the managed system.
/system1/logs1/log1/record1
An individual SEL record instance on the managed system.
Properties:
LogCreationClassName = CIM_RecordLog
CreationClassName = CIM_LogRecord
LogName = IPMI SEL
RecordID = 1
MessageTimeStamp = 20050620100512.000000-
000
Description = FAN 7 RPM: fan sensor,
detected a failure
ElementName = IPMI SEL Record
Commands:
cd
show
help
exit
version
Clearing the SEL
->delete /system1/logs1/log1/record*
All records deleted successfully
MAP Target Navigation
Table 11-6 provides examples of using the cd verb to navigate the MAP. In all examples, the initial default target is assumed to be /.
Table 11-6. 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 11-7 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 11-7. 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.
