RACADM-Spickzettel: über 30 iDRAC9-Befehle für den Alltag
Kurze Antwort
RACADM ist die Dell-Kommandozeile für iDRAC9 auf PowerEdge-Servern der 14., 15. und 16. Generation. Sie führen es lokal auf dem Host aus, remote mit racadm -r <ip> -u <user> -p <pass> <subcommand> oder in einer SSH-Sitzung zum iDRAC. Die folgenden Befehle decken die täglichen Aufgaben ab: getsysinfo, getsel, serveraction, getniccfg, set iDRAC.Users.N.*, BIOS-Änderungen mit jobqueue create BIOS.Setup.1-1, storage get pdisks, update -f, racreset und techsupreport.
Grundlage: the Dell iDRAC9 RACADM CLI Guide (2024, firmware 7.x) and the iDRAC9 Attribute Registry, PowerEdge 14G to 16G
Wie führen Sie RACADM aus: lokal, remote oder per SSH?
Dell liefert RACADM in drei Formen. Alle drei akzeptieren dieselben Unterbefehle, nur der Weg zum iDRAC unterscheidet sich.
| Modus | Wo es läuft | So starten Sie es |
|---|---|---|
| Lokales RACADM | Im Server-Betriebssystem, In-Band zum iDRAC | Paket iDRAC Tools vom Dell-Support installieren, dann racadm <subcommand> als root oder Administrator |
| Remote-RACADM | Auf Ihrem Arbeitsplatz, per HTTPS zur iDRAC-IP | racadm -r <ip> -u <user> -p <pass> <subcommand> |
| SSH (Firmware-RACADM) | Im iDRAC selbst | ssh root@<ip>, dann Befehle am Prompt racadm>> eingeben |
# Lokal
racadm getsysinfo
# Remote, Warnung zum selbstsignierten Zertifikat unterdrücken
racadm -r 10.0.20.15 -u root -p '<password>' getsysinfo --nocertwarn
# SSH
ssh [email protected]
racadm>> getsysinfoRemote-RACADM schreibt das Passwort in Ihre Shell-History. Lesen Sie es in Skripten aus einer Variablen oder einem Tresor, oder nutzen Sie SSH-Schlüssel für das iDRAC-Konto.
Welche RACADM-Befehle zeigen Systeminfo und Inventar?
| Befehl | Funktion |
|---|---|
racadm getsysinfo | iDRAC-Firmware, BIOS-Version, Service-Tag, Hostname, Stromstatus, iDRAC-IP |
racadm getsvctag | Nur das Service-Tag; auf der Dell-Supportseite prüfen Sie damit Garantie und Originalkonfiguration |
racadm getversion | Firmwareversionen von iDRAC, BIOS und Lifecycle Controller |
racadm hwinventory | Vollständige Hardwareliste: CPUs, DIMMs, NICs, Laufwerke, Netzteile mit FQDDs |
racadm hwinventory NIC | Nur Netzwerkadapter; die ausgegebenen FQDDs nutzen Sie in späteren Befehlen |
racadm getsensorinfo | Temperaturen, Lüfter, Spannungen, Netzteil- und Gehäusesensoren mit Status |
Wie lesen und löschen Sie SEL und Lifecycle-Log?
| Befehl | Funktion |
|---|---|
racadm getsel | System Event Log: Ereignisse zu DIMMs, Netzteilen, Lüftern und Temperatur |
racadm getsel -i | Anzahl der Einträge im SEL |
racadm clrsel | Löscht das SEL. Vorher exportieren oder kopieren |
racadm lclog view -s warning,critical -n 20 | Die letzten 20 Lifecycle-Log-Einträge mit Schweregrad Warnung oder kritisch |
racadm lclog export -f lclog.xml -u <shareuser> -p <sharepass> -l //10.0.0.5/logs | Exportiert das Lifecycle-Log auf eine CIFS-Freigabe |
Wie schalten Sie einen Server mit RACADM ein, aus oder neu?
Jede Aktion nutzt racadm serveraction <action> und erfordert die Berechtigung Execute Server Control Commands.
racadm serveraction powerstatus # ON oder OFF
racadm serveraction powerup # einschalten
racadm serveraction graceshutdown # Betriebssystem sauber herunterfahren
racadm serveraction powerdown # hart ausschalten
racadm serveraction powercycle # aus und wieder ein
racadm serveraction hardreset # erzwungener Neustart wie die Reset-TasteWie setzen Sie iDRAC-IP-Adresse und NIC mit RACADM?
racadm getniccfg # IP, NIC-Auswahl, Link, Geschwindigkeit
racadm setniccfg -s 10.0.20.15 255.255.255.0 10.0.20.1 # statische IPv4: Adresse, Maske, Gateway
racadm setniccfg -d # zurück auf DHCP
racadm get iDRAC.NIC # alle NIC-Attribute (VLAN, Autoneg, Failover)
racadm set iDRAC.NIC.Selection Dedicated # dedizierten iDRAC-Port nutzen
racadm set iDRAC.NIC.Selection LOM1 # oder ersten Onboard-Port teilenÄndern Sie Netzwerkeinstellungen möglichst über lokales RACADM oder die Konsole. Remote über dieselbe Verbindung bricht die Sitzung ab, sobald sich Adresse oder Port ändert.
Wie legen Sie einen iDRAC-Benutzer mit RACADM an?
iDRAC9 hat 16 Benutzerplätze. Platz 2 ist das werkseitige root-Konto. Wählen Sie einen freien Platz, setzen Sie zuerst den Namen, dann Passwort, Berechtigung und Aktivierung.
racadm get iDRAC.Users.2 # Benutzerplatz anzeigen
racadm set iDRAC.Users.3.UserName opsadmin # Benutzer auf Platz 3 anlegen
racadm set iDRAC.Users.3.Password '<new-password>'
racadm set iDRAC.Users.3.Privilege 0x1ff # 0x1ff = Administrator
racadm set iDRAC.Users.3.Enable 1Der Berechtigungswert ist eine Summe von Bits: Login 1, Configure 2, Configure Users 4, Logs 8, System Control 16, Virtual Console 32, Virtual Media 64, System Operations 128, Debug 256. Ein reiner Lesezugriff ist 0x1 plus 0x8.
Wie ändern Sie BIOS- und Booteinstellungen mit RACADM?
BIOS-Attribute werden vorgemerkt. Ein set stellt den Wert nur in die Warteschlange, ein Job wendet ihn beim nächsten Neustart an.
racadm get BIOS.BiosBootSettings # Bootmodus und Bootreihenfolge
racadm set BIOS.BiosBootSettings.BootMode Uefi
racadm jobqueue create BIOS.Setup.1-1 -r pwrcycle -s TIME_NOW # sofort mit Aus/Ein anwenden
racadm jobqueue view # Jobs und Status anzeigen
racadm jobqueue delete -i <JobID> # einzelnen hängenden Job entfernen
# einmalig von der virtuellen CD booten (virtuelle Medien erfordern iDRAC Enterprise oder Datacenter)
racadm set iDRAC.ServerBoot.FirstBootDevice VCD-DVD
racadm set iDRAC.ServerBoot.BootOnce 1Auf manchen Plattformen liegt das Bootmodus-Attribut in einer anderen Gruppe. Meldet set ein ungültiges Attribut, führen Sie racadm get BIOS aus und suchen Sie in der Ausgabe nach BootMode.
Wie prüfen Sie Laufwerke, aktualisieren Firmware und sehen Lizenzen?
| Befehl | Funktion |
|---|---|
racadm storage get controllers | RAID-Controller und HBAs mit FQDDs |
racadm storage get pdisks -o | Physische Laufwerke mit Status, Größe, Medientyp und Predictive-Failure-Kennzeichen |
racadm storage get vdisks -o | Virtuelle Laufwerke: RAID-Level, Größe, Status |
racadm update -f BIOS_XXXXX.EXE -l http://10.0.0.5/fw -u <user> -p <pass> | Lädt ein Dell Update Package von einer HTTP-Freigabe und stellt es bereit |
racadm update -f iDRAC_XXXXX.d9 | Lokales RACADM: Update aus einer Datei auf dem Host |
racadm license view | Installierte iDRAC-Lizenz: Express, Enterprise oder Datacenter, mit Entitlement-ID |
Hängen Sie --reboot an update an, wenn das Paket einen Neustart des Hosts braucht (BIOS, NIC, Storage-Controller, Netzteil). Die iDRAC-Firmware selbst wird ohne Neustart des Hosts angewendet.
Wie setzen Sie den iDRAC zurück und erstellen einen TSR?
racadm racreset # iDRAC neu starten, Einstellungen bleiben
racadm techsupreport collect -t SysInfo,TTYLog # SupportAssist-Sammlung erstellen
racadm jobqueue view # warten, bis der TSR-Job fertig ist
racadm techsupreport export -f tsr.zip # lokales RACADM: auf dem Host speichern
racadm techsupreport export -l //10.0.0.5/logs -u <shareuser> -p <sharepass>racadm racreset berührt weder das Host-Betriebssystem noch dessen Netzwerk. Der iDRAC braucht bis zu zwei Minuten, bis er wieder antwortet. Verwechseln Sie ihn nicht mit racadm racresetcfg: Dieser Befehl setzt den iDRAC auf Werkseinstellungen zurück und löscht Netzwerk- und Benutzereinstellungen.
racadm jobqueue delete -i JID_CLEARALL löscht zwangsweise alle Jobs, auch laufende Firmware-Updates. Nutzen Sie es nur, wenn die Warteschlange hängt und nichts läuft.
Häufige Fragen
Brauche ich eine iDRAC-Enterprise-Lizenz für RACADM?
Nein. RACADM selbst funktioniert mit iDRAC9 Express. Einige Funktionen, die Sie damit steuern, etwa virtuelle Medien und die virtuelle Konsole, erfordern Enterprise oder Datacenter. Prüfen Sie das mit racadm license view.
Warum scheitert Remote-RACADM mit einem SSL- oder TLS-Fehler?
Ältere RACADM-Clients beherrschen eventuell die TLS-Version nicht, die Ihr iDRAC verlangt. Installieren Sie das aktuelle Paket iDRAC Tools für Ihr Betriebssystem oder prüfen Sie racadm get iDRAC.WebServer.TLSProtocol über lokales RACADM oder SSH.
Sollte ich RACADM oder Redfish für die Automatisierung nutzen?
RACADM eignet sich für schnelle Aufgaben und Shell-Skripte nur für Dell. Redfish ist die bessere Wahl für herstellerübergreifende Skripte oder eine stabile REST-API; Dell veröffentlicht iDRAC-Redfish-Beispiele auf GitHub.
Wie finde ich die richtige FQDD für eine NIC oder ein Laufwerk?
Führen Sie racadm hwinventory oder racadm storage get pdisks aus. Jede Zeile beginnt mit der FQDD, zum Beispiel NIC.Integrated.1-1-1 oder Disk.Bay.0:Enclosure.Internal.0-1:RAID.Integrated.1-1.