29. März 2011

Ein kleines HMC Commandline Howto

Dieses Dokument stellt die wichtigsten HMC-Kommandos vor. Dabei werden die alten Kommandos der power4-HMCs den neuen der power5-HMCs gegenübergestellt. Viele nette Kommandos, die es unter V3 noch gab, hat IBM Stück für Stück entfernt. So gibt es beispielsweise keine lslpars mehr. Dies alles soll wohl den Zweck haben, wsm bzw. WebSM zu benutzen. Leider lässt nicht jede Leitung ein Arbeiten mit diesem Tool zu. Um trotzdem mit der HMC arbeiten zu können, hier das Überlebenspaket.

In den folgenden Beispielen wird ein ganzer power4- oder power5-Frame, das sogenannte Managed System mit pserver bezeichnet, eine LPAR mit mylpar, nummeriert falls mehrere dieser Einheiten auftauchen. Profile sind mit myprofile bezeichnet. Für diese Bezeichnungen sind die entsprechenden Objektnamen zu setzen. Die power5-Kommandos sind auch für power6- und power7-Systeme gültig (HMC Version 7).

Inhalt

HMC Management

1. Versionsstand der HMC Software

hscroot@hmc> lshmc -V
 Version: 3
 Release: 3.2
HMC Build level 20040827.1

power4-HMCs können keinen höheren Versionsstand als 3.x aufweisen - die Versionen 4.x aufwärts sind den power5-HMCs vorbehalten. Power6-Systeme benötigen HMC Version 7.x.

2. Netzwerkkonfiguration der HMC

hscroot@hmc> lshmc -n

3. HMC rebooten

power4 + power5:

hscroot@hmc> hmcshutdown -t now -r

4. HMC-Passwort ändern (Benutzer hscroot)

power4 + power5:

hscroot@hmc> chhmcusr -u hscroot -t passwd
Enter the new password:
Retype the new password:

5. Dateisystem-Füllstand anzeigen

power5:

hscroot@hmc> monhmc -r disk -n 0
Filesystem           1K-blocks      Used Available Use% Mounted on
/dev/sda2             16121184   4958484  10343788  33% /
udev                    517300       156    517144   1% /dev
/dev/sda3              6040320   1341736   4391744  24% /var
/dev/sda7              8056524    154132   7493140   3% /dump
/dev/sda8             38669964    203056  36502564   1% /extra

Die Ausgabe entspricht dem UNIX-Befehl df.

LPAR Management: Informationen anzeigen

1. Status der LPARs

So erhält man einen Überblick über alle von der HMC kontrollierten Systeme:

power4:

hscroot@hmc> lslpars

power5:

hscroot@hmc> lssyscfg -r sys -F name:serial_num:state
pserver1:656D24A:Operating
pserver2:656FFFF:Operating

Und für jedes System aus der obigen Liste lassen sich die LPARs dann wie folgt anzeigen:

hscroot@hmc> lssyscfg -m pserver -r lpar -F name:state

Beispiel:

hscroot@hmc> lssyscfg -m pserver1 -r lpar -F name:state
mylpar1:Running
mylpar2:Running
mylpar3:Not Activated

In einer kleinen Schleife lassen sich die beiden Schritte oben zusammenfassen, so dass man wieder so eine Art lslpars hat:

hscroot@hmc> for m in $(lssyscfg -r sys -F name); do echo $m ; lssyscfg -r lpar -m $m -F name:state ; done

Der Format-String 'name:serial_num:state' ganz oben informiert auch über die Seriennummer der angeschlossenen Systeme.

2. Status und LED/LCD-Anzeige einer LPAR anzeigen

power4:

hscroot@hmc> lssyscfg -r lpar -m pserver -n mylpar

power5:


hscroot@hmc> lsrefcode -m pserver -r lpar --filter "lpar_names=mylpar" -F lpar_name:refcode

Es lässt sich auch eine Historie der LED-Codes anzeigen, dazu wird der Schalter -n gefolgt von einer ganzen Zahl, die die Tiefe der Historie angibt, also für die 5 letzten Werte etwa:

hscroot@hmc> lsrefcode -m pserver -r lpar --filter "lpar_names=mylpar"  -n 5 -F lpar_name:refcode
mylpar:
mylpar:0c33
mylpar:
mylpar:0539
mylpar:0538

... und für die Status-LEDs:

hscroot@hmc> lsled -m pserver -r sa -t virtuallpar --filter ""lpar_names=mylpar""

3. Status und LED/LCD-Anzeige eines Systems im FullSystemPartition anzeigen

power4:

hscroot@hmc> lssyscfg -r sys -n pserver

4. Übersicht LPAR-IDs

power5:

hscroot@hmc> lssyscfg -r lpar -m pserver -F lpar_id:state | sort -n
1:vioserver1:Running
2:vioserver2:Running
3:mylpar1:Not Activated
4:mylpar2:Running
5:mylpar3:Running
6:mylpar4:Running
7:mylpar5:Running
8:mylpar6:Running
9:mylpar7:Running
10:mylpar8:Not Activated

5. Übersicht Verbindungsstatus

Sind alle Service-Prozessoren mit der HMC verbunden?

power5:

hscroot@hmc> lssysconn -r all -F type_model_serial_num:ipaddr:state | sort
9117-570*65AE18C:172.16.255.253:Connected
9117-570*65AE18C:172.16.254.255:Connected
9117-570*65AE2AC:172.16.255.254:Connected
9117-570*65AE2AC:172.16.254.254:Connected
9117-570*650D70D:172.16.255.252:Connected
9117-570*650D70D:172.16.253.255:Connected
9117-570*650D71D:172.16.254.253:Connected
9117-570*650D71D:172.16.255.251:Connected
9131-52A*065F7BB:172.16.253.254:Connected
9131-52A*065F8BA:172.16.254.252:Connected

Die Verbindung zum Namen des Managed Systems erfolgt über die Seriennummer, nicht über die IP-Adresse! Die IP-Adressen in der Übersicht oben sind die IP-Adressen des Serviceprozessors und werden über den in der HMC integrierten DHCP-Server vergeben.

6. Liste aller I/O-Adapter anzeigen

Mit dem folgenden Befehl wird eine Liste aller in einem Managed System verbauten Adapter angezeigt:

power5:

hscroot@hmc> lshwres -r io -m pserver --rsubtype slot --filter -F lpar_name:drc_name:description
null:U78C0.001.DBJC357-P2-C8-T5:Universal Serial Bus UHC Spec
mylpar1:U78C0.001.DBJC357-P2-C1:Fibre Channel Serial Bus
null:U78C0.001.DBJC357-P2-C2:Fibre Channel Serial Bus
vios2:U78C0.001.DBJC357-P2-T3:RAID Controller
vios2:U78C0.001.DBJC357-P2-C8-T7:Generic XT-Compatable Serial Controller
vios2:U78C0.001.DBJC357-P2-C5:Fibre Channel Serial Bus
vios2:U78C0.001.DBJC357-P2-C6:Ethernet controller
vios2:U78C0.001.DBJC357-P2-C9-T2:PCI-E SAS Controller
vios2:U78C0.001.DBJC357-P2-C9-T1:PCI-E SAS Controller
null:U78C0.001.DBJC373-P2-C8-T5:Universal Serial Bus UHC Spec
mylpar1:U78C0.001.DBJC373-P2-C1:Fibre Channel Serial Bus
null:U78C0.001.DBJC373-P2-C2:Fibre Channel Serial Bus
vios1:U78C0.001.DBJC373-P2-T3:RAID Controller
vios1:U78C0.001.DBJC373-P2-C8-T7:Generic XT-Compatable Serial Controller
vios1:U78C0.001.DBJC373-P2-C5:Fibre Channel Serial Bus
vios1:U78C0.001.DBJC373-P2-C6:Ethernet controller
vios1:U78C0.001.DBJC373-P2-C9-T2:PCI-E SAS Controller
vios1:U78C0.001.DBJC373-P2-C9-T1:PCI-E SAS Controller

Ein "none" in der ersten Zeile zeigt an, dass der Adapter kener LPAR zugeordnet ist. Möchte man die Liste auf eine LPAR einschränken, kann man einen Filter setzen:

power5:

hscroot@hmc> lshwres -r io -m pserver --rsubtype slot -F lpar_name:drc_name:description --filter "lpar_names=mylpar1"
mylpar1:U78C0.001.DBJC357-P2-C1:Fibre Channel Serial Bus
mylpar1:U78C0.001.DBJC373-P2-C1:Fibre Channel Serial Bus

6. Übersicht DLPAR-Status

DLPAR steht für die Möglichkeit, einer LPAR im laufenden Betrieb, I/O-Ressourcen zuzweisen oder zu entziehen sowie Änderungen am Hauptspeicher oder der Anzahl der Prozessoren zur Laufzeit durchzuführen: power5:

hscroot@hmc> lspartition -dlpar
<#0> Partition:<6*9117-MMB*656D24A, mylpar1.unixwerk.de, 111.111.15.66>
       Active:<0>, OS:<AIX, 5.3, 5300-09-08-1036>, DCaps:<0x0>, CmdCaps:<0x0, 0x0>, PinnedMem:<512>
<#1> Partition:<2*9117-MMB*656D24A, vios1.unixwerk.de, 111.111.15.65>
       Active:<1>, OS:<AIX, 6.1, 6100-06-00-0000>, DCaps:<0x4f9f>, CmdCaps:<0x1b, 0x1b>, PinnedMem:<520>
<#2> Partition:<1*9117-MMB*656D24A, vios2.unixwerk.de, 111.111.15.64>
       Active:<1>, OS:<AIX, 6.1, 6100-06-00-0000>, DCaps:<0x4f9f>, CmdCaps:<0x1b, 0x1b>, PinnedMem:<518>
<#3> Partition:<3*9117-570*656FFFF, mylpar2.unixwerk.de, 111.111.226.4>
       Active:<1>, OS:<AIX, 5.3, 5300-09-04-0920>, DCaps:<0x2f>, CmdCaps:<0xb, 0xb>, PinnedMem:<1707>
<#4> Partition:<1*9117-570*656FFFF, mylpar3.unixwerk.de, 111.111.226.2>
       Active:<1>, OS:<AIX, 5.3, 5300-09-04-0920>, DCaps:<0x2f>, CmdCaps:<0xb, 0xb>, PinnedMem:<884>
<#5> Partition:<1*9133-55A*650D71D, mylpar7.unixwerk.de, 111.111.0.26>
       Active:<1>, OS:<AIX, 5.3, 5300-09-03-0918>, DCaps:<0x2f>, CmdCaps:<0xb, 0xb>, PinnedMem:<406>
<#6> Partition:<4*9117-570*656FFFF, mylpar4.unixwerk.de, 111.111.226.5>
       Active:<1>, OS:<AIX, 5.3, 5300-09-04-0920>, DCaps:<0x2f>, CmdCaps:<0xb, 0xb>, PinnedMem:<967>

Der Wert für Active: sollte auf <1> stehen.

LPAR Management: Operationen ausführen

1. Soft-Reset einer LPAR

power4:

hscroot@hmc> chsysstate -m pserver -r lpar -n mylpar -o reset

power5:

hscroot@hmc> chsysstate -r lpar -m pserver -o shutdown -n mylpar

2. Soft Reset eines Systems im FullPartitionMode

power4:

hscroot@hmc> chsysstate -n pserver -r sys -o reset

3. Hard Reset einer LPAR

power4:

hscroot@hmc> chsysstate -m pserver -r lpar -n mylpar -o off

power5:

hscroot@hmc> chsysstate -r lpar -m pseries -o shutdown -n mylpar --immed

4. Hard Reset eines Systems im FullSystemPartitionMode

power4:

hscroot@hmc> chsysstate -n pserver -r sys -o off

5. Virtuelle Konsole

Eine Konsolenverbindung zu einer LPAR wird mit

power4 + power5:

hscroot@hmc> mkvterm -m pserver -p mylpar

geöffnet; eine Konsolenverbindung zu einem System, das im FullSystemPartition-Mode läuft, dagegen durch:

power4:

hscroot@hmc> mkvterm -m pserver

Durch Eingabe von ~~ (2xTilde) und . (Punkt) am Zeilenanfang wird die Verbindung geschlossen. Scheitert der Aufbau einer Konsolenverbindung mit der Fehlermeldung

All available virtual terminal sessions have been opened and are in use. 
To force a new open session, perform a Close Terminal Session operation
which frees up the session.

ist noch eine Verbindung aktiv, diese kann mit

power4 + power5:

hscroot@hmc> rmvterm -m pserver -p mylpar

geschlossen werden.

Wissen Sie nicht so genau zu welchem Managed System eine LPAR gehört? Dann bietet sich das vtmenu an:

hscroot@hmc> vtmenu
 Retrieving name of managed system(s) . . . 

 ----------------------------------------------------------
  Managed Systems:
 ----------------------------------------------------------
   1) pserver1
   2) pserver2
   3) pserver3

 Enter Number of Managed System.   (q to quit): 1

 ----------------------------------------------------------
  Partitions On Managed System:  pserver1
 ----------------------------------------------------------
   1)    mylpar1                              Running
   2)    mylpar2                              Running
   3)    mylpar3                              Running
   4)    mylpar4                              Running
   5)    mylpar5                              Running


 Enter Number of Running Partition (q to quit):

Geben Sie die eine der Ziffern ein und sie werden mit der Konsole der entsprechenden LPAR verbunden.

6. LPAR hochfahren

power4:

hscroot@hmc> chsysstate -r lpar -m pserver -o on [ -f myprofile ] -n mylpar

power5:

hscroot@hmc> chsysstate -r lpar -m pserver -o on -f myprofile -n mylpar

7. Ein System im FullPartitionMode einschalten

power4:

hscroot@hmc> chsysstate -o on -r sys -n pserver -c full

8. Schlüsselschalter auf Position "normal" zurückdrehen

power5:

hscroot@hmc> chsysstate -r lpar -o chkey -k norm -n mylpar -m pserver

ACHTUNG: Bei einigen power5-HMCs kann es vorkommen, dass die LPAR nicht normal bootet, falls der virtuelle Schlüsselschalter in der Stellung "manual" verharrt. Dies wird durch eine Fehlermeldung

0514-440 cfgcon: failed to create log file: check path name, permissions, and available space

angezeigt. Danach kann nur der Diagnose- oder Single-User-Modus gestartet werden.

LPAR Konfiguration

1. Namen einer LPAR ändern

Die Situation vor der Namensänderung:

hscroot@hmc> lssyscfg -r lpar -m pserver -F lpar_id:name:state
1:vios1:Running
2:vios2:Running
3:barney:Running
4:mylpar2:Running
5:mylpar3:Running

Der Name soll von barney in mylpar1 geändert werden:

power5:

hscroot@hmc> chsyscfg -r lpar -m pserver -i "name=barney,new_name=mylpar1"

Und so sieht es nach der Namensänderung aus:

hscroot@hmc> lssyscfg -r lpar -m pserver -F lpar_id:name:state
1:vios1:Running
2:vios2:Running
3:mylpar1:Running
4:mylpar2:Running
5:mylpar3:Running

2. Managed System umbenennen

So lässt sich z.B. das Managed System pserver in pserver1 umbenennen:

power5:

hscroot@hmc> chsyscfg -r sys -m pserver -i "new_name=pserver1"

3. DLPAR: Prozessoren dynamisch hinzufügen

So werden 8 weitere physikalische Prozessoren einer LPAR zugewiesen:

power5:

hscroot@hmc> chhwres -r proc -m pserver -o a -p mylpar --procunits 8