26
SMCLP verwenden
ANMERKUNG: SMCLP wird nur in iDRAC-Versionen unterstützt, die älter als 4.00.00.00 sind.
Die Server Management Command Line Protocol (SMCLP)-Spezifikation aktiviert die CLI-basierte Systemverwaltung. Sie definiert ein Protokoll für die Verwaltungsbefehle, die über Standardzeichen-basierte Streams übertragen werden. Dieses
Protokoll greift über einen von Hand eingegebenen Befehlssatz auf einen Common Information Model Object Manager
(CIMOM) zu. Das SMCLP ist eine Unterkomponente der Distributed Management Task Force (DMTF)-Initiative, mit der die
Systemverwaltung über mehrere Plattformen hinweg optimiert werden kann. In Verbindung mit der Spezifikation für verwaltete
Elementadressierung und zahlreichen Profilen zu SMCLP-Zuordnungsspezifikationen beschreibt die SMCLP-Spezifikation die
Standard-Verben und -Ziele zum Ausführen verschiedener Managementaufgaben.
ANMERKUNG: Es wird angenommen, dass Sie mit der SMASH-Initiative (Systemverwaltungsarchitektur für
Serverhardware) und den SMWG SMCLP-Angaben vertraut sind.
Das SM-CLP ist eine Unterkomponente der Distributed Management Task Force (DMTF)-Initiative, mit der die Server-
Verwaltung über mehrere Plattformen hinweg optimiert werden kann. In Verbindung mit der Spezifikation für verwaltete
Elementadressierung und zahlreichen Profilen zu SM-CLP-Zuordnungsspezifikationen beschreibt die SM-CLP-Spezifikation die
Standard-Verben und -Ziele zum Ausführen verschiedener Managementaufgaben.
Das SMCLP wird von der iDRAC-Controller-Firmware gehostet und unterstützt SSH- und serielle Anschlüssen. Die iDRAC
SM-CLP-Schnittstelle basiert auf der SM-CLP-Spezifikation Version 1.0 der Organisation DMTF.
ANMERKUNG: Informationen zu den Profilen, Erweiterungen und MOFs können unter https://www.dell.com/support abgerufen werden, und die gesamten DMTF-Informationen können von dmtf.org/standards/profiles/ abgerufen werden.
SM-CLP-Befehle nutzen eine Teilmenge der lokalen RACADM-Befehle. Die Befehle sind für die Skripterstellung nützlich, da sie von einer Befehlszeile der Management Station aus ausgeführt werden können. Sie können die Ausgabe von Befehlen in genau definierten Formaten, einschließlich XML, abrufen, was die Skripterstellung und die Integration mit bestehende
Berichterstellungs- und Managementtools erleichtert.
Themen:
•
System-Verwaltungsfunktionen über SMCLP
•
SMCLP-Befehle ausführen
•
iDRAC-SMCLP-Syntax
•
MAP-Adressbereich navigieren
•
Verb „show“ verwenden
•
Anwendungsbeispiele
System-Verwaltungsfunktionen über SMCLP
Mit iDRAC SMCLP können Sie die folgenden Funktionen ausführen:
● Serverenergieverwaltung – System einschalten, herunterfahren oder neu starten
● Verwaltung des Systemereignisprotokolls (SEL) – SEL-Datensätze anzeigen oder löschen
● iDRAC-Benutzerkonten anzeigen
● Systemeigenschaften anzeigen
SMCLP-Befehle ausführen
Sie können die SMCLP-Befehle über die SSH-Schnittstelle ausführen. Öffnen Sie eine SSH-Sitzung und melden Sie sich bei iDRAC als Administrator an. Die SMCLP-Eingabeaufforderung (admin->) wird angezeigt.
SMCLP-Befehlseingaben:
● yx1x-Blade-Server verwenden -$ .
SMCLP verwenden 351
● yx1x-Rack- und -Tower-Server verwenden admin-> .
● yx2x-Blade-, -Rack- und -Tower-Server verwenden admin-> .
Hier steht „y“ für ein alphanumerisches Zeichen wie „M“ (für Blade-Server), „R“ (für Rack-Server) und „T“ (für Tower-Server) und „x“ für eine Zahl. Die Zahl dient der Kennzeichnung der Dell PowerEdge-Servergeneration.
ANMERKUNG: Skripte, die -$ verwenden, können diese für yx1x-Systeme verwenden, aber beginnend bei yx2x-Systemen kann ein Skript mit admin-> für Blade-, Rack- und Tower-Server verwendet werden.
iDRAC-SMCLP-Syntax
set
Hilfe reset show start stop exit
Version load iDRAC-SMCLP verwendet das Konzept von Verben und Zielen und stellt Systemverwaltungsfunktionen über die CLI bereit. Das
Verb gibt den auszuführenden Vorgang an und das Ziel bestimmt die Entität (oder das Objekt), die den Vorgang ausführt.
Die SMCLP Befehlszeilensyntax:
<verb> [<options>] [<target>] [<properties>]
Die folgende Tabelle zeigt die Verben sowie ihre Definitionen.
Tabelle 62. SMCLP-Verben
Verb Definition cd Navigiert durch den MAP mittels der Shell.
Stellt eine Eigenschaft auf einen bestimmten Wert ein.
Zeigt die Hilfe für ein bestimmtes Ziel an.
Setzt das Ziel zurück.
Zeigt die Zieleigenschaften, Verben und Unterziele an.
Schaltet ein Ziel ein.
Fährt ein Ziel herunter.
Beendet die SMCLP-Shell-Sitzung
Zeigt die Versionsattribute eines Ziels an.
Lädt ein Binärbild von einer URL zu einer bestimmten
Zieladresse.
Die folgende Tabelle enthält eine Liste mit Zielen.
Tabelle 63. SMCLP-Ziele
Ziel Definitionen admin domain admin1
Registrierte Profile in iDRAC admin1/profiles1
Hardware admin1/hdwr1
Ziel des verwalteten Systems admin1/system1
352 SMCLP verwenden
Tabelle 63. SMCLP-Ziele (fortgesetzt)
Ziel admin1/system1/capabilities1 admin1/system1/capabilities1/elecap1 admin1/system1/logs1 admin1/system1/logs1/log1 admin1/system1/logs1/log1/record* admin1/system1/settings1 admin1/system1/capacities1 admin1/system1/consoles1 admin1/system1/sp1 admin1/system1/sp1/timesvc1 admin1/system1/sp1/capabilities1 admin1/system1/sp1/capabilities1/clpcap1 admin1/system1/sp1/capabilities1/ pwrmgtcap1 admin1/system1/sp1/capabilities1/ acctmgtcap* admin1/system1/sp1/capabilities1/ rolemgtcap* admin1/system1/sp1/capabilities1/elecap1 admin1/system1/sp1/settings1 admin1/system1/sp1/settings1/clpsetting1 admin1/system1/sp1/clpsvc1
Definitionen
SMASH-Erfassungsfunktionen des verwalteten Systems
Zielfunktionen des verwalteten Systems
Datensatzprotokoll-Erfassungsziel
Systemereignisprotokoll (SEL) Datensatzeintrag
Eine einzelne SEL-Datensatzinstanz auf dem verwalteten
System
SMASH-Erfassungseinstellungen des verwalteten Systems
SMASH-Erfassung der verwalteten Systemkapazitäten
SMASH-Erfassung der verwalteten Systemkonsolen
Serviceprozessor
Zeitansage des Serviceprozessors
SMASH-Erfassung der Serviceprozessorfunktionen
CLP-Dienstfunktionen
Dienstfunktionen der Stromzustandsverwaltung auf dem
System
Dienstfunktionen der Kontoverwaltung
Lokale rollenbasierte Verwaltungsfunktionen
Authentifizierungsfunktionen
Sammlung von Serviceprozessoreinstellungen
CLP-Dienst-Einstellungsdaten
CLP-Dienst-Protokolldienst
SMCLP verwenden 353
Tabelle 63. SMCLP-Ziele (fortgesetzt)
Ziel admin1/system1/sp1/clpsvc1/clpendpt* admin1/system1/sp1/clpsvc1/tcpendpt* admin1/system1/sp1/jobq1 admin1/system1/sp1/jobq1/job* admin1/system1/sp1/pwrmgtsvc1 admin1/system1/sp1/account1-16 admin1/sysetm1/sp1/account1-16/identity1 admin1/sysetm1/sp1/account1-16/identity2 admin1/sysetm1/sp1/account1-16/identity3 admin1/sysetm1/sp1/account1-16/identity4 admin1/system1/sp1/acctsvc2 admin1/system1/sp1/acctsvc3 admin1/system1/sp1/rolesvc1 admin1/system1/sp1/rolesvc1/Role1-16 admin1/system1/sp1/rolesvc1/Role1-16/ privilege1 admin1/system1/sp1/rolesvc2 admin1/system1/sp1/rolesvc2/Role1-3 admin1/system1/sp1/rolesvc2/Role4 admin1/system1/sp1/rolesvc3
Definitionen
CLP-Dienst-Protokollendpunkt
CLP-Dienst-Protokoll-TCP-Endpunkt
Auftragswarteschlange des CLP-Dienst-Protokolls
CLP-Dienst-Protokollaufgabe
Stromzustandsverwaltungsdienst
Lokales Benutzerkonto
Identitätskonto des lokalen Benutzers
IPMI-Identitätskonto (LAN)
IPMI-Identitätskonto (seriell)
CLP-Identitätskonto
IPMI-Kontoverwaltungsdienst
CLP-Kontoverwaltungsdienst
Lokaler rollenbasierter Authentifizierungsdienst (RBA)
Lokale Rolle
Lokale Rollenberechtigung
IPMI-RBA-Dienst
IPMI-Rolle
IPMI Seriell-über-LAN-Rolle (SOL)
CLP-RBA-Dienst
354 SMCLP verwenden
Tabelle 63. SMCLP-Ziele (fortgesetzt)
Ziel admin1/system1/sp1/rolesvc3/Role1-3 admin1/system1/sp1/rolesvc3/Role1-3/ privilege1
Definitionen
CLP-Rolle
CLP-Rollenberechtigung
MAP-Adressbereich navigieren
Objekte, die mit SM-CLP verwaltet werden können, werden durch Ziele repräsentiert, die in einem hierarchischen
Bereich namens Manageability Access Point(MAP)-Adressbereich angeordnet sind. Ein Adresspfad legt den Pfad vom
Adressbereichsstamm zu einem Objekt im Adressbereich fest.
Das Stammziel wird durch einen Schrägstrich (/) oder einen umgekehrten Schrägstrich (\) dargestellt. Es ist der standardmäßige Ausgangspunkt, wenn Sie sich beim iDRAC anmelden. Navigieren Sie vom Stamm abwärts, indem Sie das
Verb cd verwenden.
ANMERKUNG: Der Schrägstrich (/) und der umgekehrte Schrägstrich (\) sind in SM-CLP-Adresspfaden austauschbar.
Mit einem umgekehrten Schrägstrich am Ende einer Befehlszeile wird jedoch der Befehl in der nächsten Zeile fortgesetzt und der Schrägstrich wird ignoriert, wenn der Befehl geparst wird.
Wenn Sie z. B. zum dritten Eintrag des Systemereignisprotokolls (SEL) wechseln möchten, geben Sie den folgenden Befehl ein:
->cd /admin1/system1/logs1/log1/record3
Geben Sie das Verb cd ohne Ziel ein, um Ihre aktuelle Position im Adressbereich zu ermitteln. Die Abkürzungen ..
und .
funktionieren wie in Windows und Linux: ..
bezieht sich auf die übergeordnete Ebene und .
auf die aktuelle Ebene.
Verb „show“ verwenden
Verwenden Sie zum Anzeigen weiterer Informationen zu einem Ziel das Verb show . Durch dieses Verb werden die Eigenschaften der Ziele, die Unterziele, die Verknüpfungen und eine Liste der SM-CLP-Verben angezeigt, die an einem bestimmten Standort zulässig sind.
Option -display verwenden
Mit der Option show –display können Sie in der Befehlsausgabe die folgenden Elemente einschränken: Eigenschaften, Ziele,
Zuordnungen und Verben. Wenn Sie z. B. nur die Eigenschaften und Ziele des aktuellen Orts anzeigen möchten, verwenden Sie den folgenden Befehl: show -display properties,targets
Wenn Sie nur bestimmte Eigenschaften aufführen möchten, qualifizieren Sie sie, wie im folgenden Befehl gezeigt wird: show –d properties=(userid,name) /admin1/system1/sp1/account1
Wenn Sie nur eine Eigenschaft anzeigen möchten, können Sie die Klammern auslassen.
Option -level verwenden
Die Option show -level führt show über zusätzliche Ebenen unterhalb des festgelegten Ziels aus. Wenn Sie alle Ziele und
Eigenschaften im Adressbereich anzeigen möchten, verwenden Sie die -l all -Option.
SMCLP verwenden 355
Option -output verwenden
Die Option -output legt eins von vier Formaten für die Ausgabe von SM-CLP-Verben fest: text , clpcsv , keyword und clpxml .
Das Standardformat ist text , die am einfachsten lesbare Ausgabe. Das Format clpcsv ist ein Format, bei dem Werte durch Kommas getrennt werden. Es eignet sich zum Laden in ein Tabellenkalkulationsprogramm. Das Format keyword gibt
Informationen als Liste von keyword=value-Paaren (eins pro Zeile) aus. Das Format clpxml ist ein XML-Dokument, das ein response -XML-Element enthält. Die DMTF hat die Formate clpcsv und clpxml festgelegt, deren Spezifikationen auf der
DMTF-Website unter dmtf.org
verfügbar sind.
Das folgende Beispiel zeigt, wie der Inhalt des SEL in XML ausgegeben werden kann: show -l all -output format=clpxml /admin1/system1/logs1/log1
Anwendungsbeispiele
In diesem Abschnitt werden die Fallbeispiele für SMCLP dargestellt:
●
Server-Energieverwaltung auf Seite 356
●
SEL-Verwaltung
auf Seite 356
●
MAP-Zielnavigation
auf Seite 358
Server-Energieverwaltung
Die folgenden Beispiele stellen die Verwendung von SMCLP für die Ausführung von Energieverwaltungsaufgaben auf einem
Managed System dar.
Geben Sie die folgenden Befehle an der SMCLP-Befehlseingabe ein:
● Ausschalten des Servers: stop /system1
Die folgende Meldung wird angezeigt: system1 has been stopped successfully
● Einschalten des Servers: start /system1
Die folgende Meldung wird angezeigt: system1 has been started successfully
● Neustart des Servers: reset /system1
Die folgende Meldung wird angezeigt: system1 has been reset successfully
SEL-Verwaltung
Die folgenden Beispiele stellen die Verwendung von SMCLP für die Ausführung von SEL-bezogenen Aufgaben auf einem verwalteten System dar. Geben Sie die folgenden Befehle an der SMCLP-Befehlseingabe ein:
● So zeigen Sie das Systemereignisprotokoll (SEL) an: show/system1/logs1/log1
Die folgende Ausgabe wird angezeigt :
/system1/logs1/log1
Targets:
Record1
356 SMCLP verwenden
Record2
Record3
Record4
Record5
Properties:
InstanceID = IPMI:BMC1 SEL Log
MaxNumberOfRecords = 512
CurrentNumberOfRecords = 5
Name = IPMI SEL
EnabledState = 2
OperationalState = 2
HealthState = 2
Caption = IPMI SEL
Description = IPMI SEL
ElementName = IPMI SEL
Commands: cd show help exit version
● Zum Anzeigen des SEL-Datensatzes: show/system1/logs1/log1
Die folgende Ausgabe wird angezeigt :
/system1/logs1/log1/record4
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
SMCLP verwenden 357
MAP-Zielnavigation
Die folgenden Beispiele zeigen, wie das cd-Verb für die Navigation des MAP verwendet werden kann. In allen Beispielen wird angenommen, dass das erste Standardziel „/“ ist.
Geben Sie die folgenden Befehle an der SMCLP-Befehlseingabe ein:
● Anhand des folgenden Befehls navigieren Sie für einen Neustart zum Systemziel: cd system1 reset – Das aktuelle Ziel lautet „/“.
● So wechseln Sie zum SEL-Ziel und zeigen die Protokolldatensätze an: cd system1 cd logs1/log1 show
● So zeigen Sie das aktuelle Ziel an:
Geben Sie cd . ein.
● So gehen Sie eine Ebene nach oben:
Geben Sie cd .. ein.
● So schließen Sie die Befehlseingabe: exit
358 SMCLP verwenden
