Befehl "lvupdateRegScript"

Zweck

Der Befehl ' lvupdateRegScript wird verwendet, um ein Skript zu registrieren, das an Benachrichtigungspunkten während eines AIX® Live-Update-Vorgangs ausgeführt wird.

Syntax

Verwenden Sie die folgende Syntax, um ein Script zu registrieren:
lvupdateRegScript  -a -n label -s script -d { orig | surr } -P phase -p priority
Verwenden Sie die folgende Syntax, um die Registrierung eines Scripts aufzuheben:
lvupdateRegScript  -r -n label -d { orig | surr } -P phase [ -p priority ]
Verwenden Sie die folgende Syntax, um alle registrierten Scripts aufzulisten:
lvupdateRegScript  -l

Beschreibung

Die gültigen Phasen, für die ein Script registriert werden kann, sind im Folgenden aufgelistet:

LVUP_CHECK
Wird zu Beginn einer Live Update -Operation ausgeführt In dieser Phase wird sichergestellt, dass die ausgeführten Scripts alle zugehörigen Services für die Operation Live Update bereit sind.
LVUP_PRE
Wird ausgeführt, bevor die Anwendungen in der ursprünglichen logischen Partition (LPAR) eingefroren werden. In dieser Phase können die ausgeführten Scripts alle erforderlichen Daten vor dem Einfrieren der Anwendungen speichern.
LVUP_PRE_KERNEL
Wird ausgeführt, nachdem die Anwendungen in der ursprünglichen LPAR eingefroren wurden und bevor die Anwendungen in der Ersatz-LPAR erneut gestartet werden. Diese Phase wird in der ursprünglichen LPAR ausgeführt, bevor sie in der Ersatz-LPAR ausgeführt wird.
LVUP_POST
Wird in der Ersatz-LPAR ausgeführt, nachdem die Anwendungen erneut gestartet wurden. Diese Scripts werden in der chroot-Umgebung ausgeführt.
LVUP_ERROR
Wird ausgeführt, wenn während der Phase LVUP_CHECK oder einer späteren Phase der Operation Live Update ein Fehler auftritt.
LVUP_COMPLETE
Wird in der Ersatz-LPAR ausgeführt, nachdem die Operation Live Update abgeschlossen ist. Diese Phase beinhaltet das Löschen der ursprünglichen LPAR und das Zurücksetzen der UUID der Ersatz-LPAR. Die für diese Phase registrierten Scripts werden in der chroot-Umgebung ausgeführt.

Während der Operation Live Update werden vor dem Aufruf der DR_CHECK -Scripts die Scripts ausgeführt, die in der Phase LVUP_CHECK registriert sind. Für die Phasen LVUP_CHECK, LVUP_PRE, LVUP_PRE_KERNEL, LVUP_POST und LVUP_COMPLETE werden die Scripts in einer bestimmten Prioritätsreihenfolge ausgeführt, die je nach den ursprünglichen logischen Partitionen und den logischen Ersatzpartitionen variiert. In der ursprünglichen LPAR ist die Reihenfolge von Priorität 1 bis Priorität 10, und die Reihenfolge wird in der Ersatz-LPAR umgekehrt, wobei Priorität 10 zuerst und Priorität 1 zuerst ausgeführt wird. Im Fall eines LVUP_ERROR -Ereignisses werden die Scripts in der entgegengesetzten Prioritätsreihenfolge ausgeführt.

Dieselbe Methodik wird auf die restlichen Phasen angewendet.

Der Scripteigner muss festlegen, ob das Script in der ursprünglichen oder in der Ersatz-LPAR ausgeführt werden muss. Wenn das Script sowohl in der ursprünglichen als auch in der Ersatz-LPAR ausgeführt werden soll, muss es zweimal registriert werden, einmal für die ursprüngliche LPAR und einmal für die Ersatz-LPAR.

Wenn ein registriertes Script ausgeführt wird, muss es 0 zurückgeben, wenn es erfolgreich ausgeführt wurde, andernfalls einen Wert ungleich null. Die Operation Live Update schlägt fehl, wenn ein Script während des Ereignisses LVUP_CHECK oder LVUP_PRE fehlschlägt.

Anmerkung: Das Script, das mit dem Befehl lvupdateRegScript registriert wird, muss in einem der folgenden Dateisysteme vorhanden sein: /, /var, /usr, /opt, /tmp.

Parameter

Element Beschreibung
Kennsatz Eine Zeichenfolge mit bis zu 80 Zeichen, die einen Kennsatz angibt, der ein bestimmtes Script identifiziert.
script Eine Zeichenfolge mit bis zu 1024 Zeichen, die ein auszuführendes Script angibt. Die Zeichenfolge muss den vollständigen Pfad zum Script und alle gewünschten Argumente enthalten.
phase Eine Zeichenfolge, die eine Gruppe von Phasen angibt: LVUP_CHECK, LVUP_PRE, LVUP_PRE_KERNEL, LVUP_POST, LVUP_ERROR und LVUP_COMPLETE.
priority Eine ganze Zahl zwischen 1 und 10, die die Priorität für die Ausführung des Scripts angibt.

Flags

Element Beschreibung
-a Registriert ein Script, das während der Operation Live Update ausgeführt werden soll
-d orig | surr Gibt die LPAR an, in der das Script ausgeführt werden soll: ursprüngliche LPAR (orig) oder Ersatz-LPAR (surr).
-l Listet die registrierten Scripts mit ihren Kennsätzen auf.
-n Kennsatz Gibt einen Kennsatz an, der einem registrierten Script zugeordnet werden soll.
-P Phase Wählt die Phase aus, in der das Script aufgerufen werden soll.
-p Priorität Gibt eine Priorität zwischen 1 bis 10 an. Die Scripts, die für eine bestimmte Phase registriert sind, werden in der Reihenfolge von der höchsten (1) bis zur niedrigsten (10) Priorität ausgeführt.
-r Hebt die Registrierung eines Scripts auf.
-s -Script Gibt das auszuführende Script an.

Beispiele

  1. Geben Sie den folgenden Befehl ein, um alle Benachrichtigungsscripts aufzulisten, die für den Aufruf während der Operation Live Update registriert sind:
    # lvupdateRegScript -l
  2. Geben Sie den folgenden Befehl ein, um ein Script zu registrieren, das auf der ursprünglichen LPAR während eines LVUP_PRE -Ereignisses der Operation Live Update ausgeführt wird:
  3. Geben Sie den folgenden Befehl ein, um ein Script zu registrieren, das auf der Ersatz-LPAR während des Ereignisses LVUP_POST der Operation Live Update ausgeführt werden soll:
    # lvupdateRegScript -a -n putFiles -s "/opt/myapp/bin/rest_files /var/myapp/data"
                                  -P LVUP_POST -p 10 -d surr
  4. Geben Sie den folgenden Befehl ein, um ein Script zu entfernen, das zuvor für den Aufruf während der Operation Live Update registriert wurde:
    # lvupdateRegScript -r -n getFiles -d orig -P LVUP_PRE