Commande lvupdateRegScript

Objectif

La commande 'lvupdateRegScript est utilisée pour enregistrer un script qui sera exécuté à des points de notification au cours d'une opération AIX Live Update.

Syntaxe

Pour enregistrer un script, utilisez la syntaxe suivante:

lvupdateRegScript  -a -n label -s script -d { orig | surr } -P phase -p priority

Pour annuler l'enregistrement d'un script, utilisez la syntaxe suivante:

lvupdateRegScript  -r -n label -d { orig | surr } -P phase [ -p priority ]

Pour répertorier tous les scripts enregistrés, utilisez la syntaxe suivante:

lvupdateRegScript  -l

Descriptif

Les phases valides pour lesquelles un script peut être enregistré sont les suivantes:

Commande LVUP_CHECK: Exécuté au début d'une opération Live Update . Cette phase garantit aux scripts exécutés que tous les services associés sont prêts pour l'opération Live Update .
PLE_PRE: Exécuté avant que les applications ne soient gelées sur la partition logique d'origine. Cette phase permet aux scripts exécutés de sauvegarder les données requises avant que les applications ne soient figées.
LVUP_PRE_KERNEL: Exécuté après le gel des applications sur la partition logique d'origine et avant le redémarrage des applications sur la partition logique de substitution. Cette phase est exécutée sur la partition logique d'origine avant d'être exécutée sur la partition logique de substitution.
LLVUP_POST: Exécuté sur la partition logique de substitution après le redémarrage des applications. Ces scripts sont exécutés dans l'environnement chroot .
ERREUR LVUP_: Exécuté en cas d'erreur lors de la phase LVUP_CHECK ou de toute phase ultérieure de l'opération Live Update .
LVUP_TERMINE: Exécuté sur la partition logique de substitution une fois l'opération Live Update terminée. Cette phase inclut la suppression de la partition logique d'origine et la réinitialisation de l'identificateur unique universel de la partition logique de remplacement. Les scripts enregistrés pour cette phase sont exécutés dans l'environnement chroot .

Lors de l'opération Live Update , avant que les scripts DR_CHECK ne soient appelés, les scripts enregistrés avec la phase LVUP_CHECK sont exécutés. Pour les phases LVUP_CHECK, LVUP_PRE, LVUP_PRE_KERNEL, LVUP_POSTet LVUP_COMPLETE, les scripts sont exécutés dans un ordre de priorité spécifique qui varie entre les partitions logiques d'origine et de substitution. Sur la partition logique d'origine, l'ordre est de la priorité 1 à la priorité 10, et l'ordre est inversé sur la partition logique de substitution, exécutant la priorité 10 en premier et jusqu'à la priorité 1. Dans le cas d'un événement LVUP_ERROR , les scripts sont exécutés dans l'ordre de priorité opposé.

La même méthodologie est appliquée au reste des phases.

Le propriétaire du script doit indiquer si le script doit être exécuté sur la partition logique d'origine ou de substitution. Si le script doit être exécuté sur les partitions logiques d'origine et de substitution, il doit être enregistré deux fois, une fois pour la partition logique d'origine et une fois pour la partition logique de substitution.

Lorsqu'un script enregistré est exécuté, il doit renvoyer 0 pour indiquer la réussite, ou une valeur différente de zéro en cas d'échec. L'opération Live Update échoue si un script échoue lors de l'événement LVUP_CHECK ou LVUP_PRE .

Remarque: Le script à enregistrer avec la commande lvupdateRegScript doit être présent dans l'un des systèmes de fichiers suivants: /, /var, /usr, /opt, /tmp.

Paramètres

Article	Descriptif
`libellé`	Chaîne de 80 caractères maximum qui spécifie un libellé, qui identifie un script particulier.
`script`	Chaîne de 1024 caractères au maximum qui spécifie un script à exécuter. La chaîne doit contenir le chemin d'accès complet au script ainsi que les arguments souhaités.
`phase`	Chaîne qui spécifie l'une des phases d'un ensemble: `LVUP_CHECK`, `LVUP_PRE`, `LVUP_PRE_KERNEL`, `LVUP_POST`, `LVUP_ERROR`et `LVUP_COMPLETE`.
`priority`	Entier compris entre 1 et 10 qui identifie une priorité d'exécution du script.

Indicateurs

Article	Descriptif
-a	Enregistre un script à exécuter lors de l'opération Live Update .
-d `orig` \| `surr`	Indique la partition logique sur laquelle le script doit être exécuté: partition logique d'origine (`orig`) ou partition logique de remplacement (`surr`).
-l	Répertorie les scripts et les libellés associés qui sont enregistrés.
-n `libellé`	Indique un libellé à associer à un script enregistré.
-P `phase`	Sélectionne la phase au cours de laquelle le script doit être appelé.
-p `priorité`	Indique une priorité comprise entre 1 et 10. Les scripts enregistrés pour une phase particulière sont exécutés dans l'ordre allant de la priorité la plus élevée (1) à la priorité la plus faible (10).
-r	Annule l'enregistrement d'un script.
-s `scénario`	Indique le script à exécuter.

Exemples

Pour répertorier tous les scripts de notification enregistrés pour être appelés lors de l'opération Live Update , entrez la commande suivante:
```
# lvupdateRegScript -l
```
Pour enregistrer un script à exécuter sur la partition logique d'origine lors d'un événement LVUP_PRE de l'opération Live Update , entrez la commande suivante:
Pour enregistrer un script à exécuter sur la partition logique de substitution lors de l'événement LVUP_POST de l'opération Live Update , entrez la commande suivante:
```
# lvupdateRegScript -a -n putFiles -s "/opt/myapp/bin/rest_files /var/myapp/data"
                              -P LVUP_POST -p 10 -d surr
```
Pour supprimer un script précédemment enregistré pour être appelé lors de l'opération Live Update , entrez la commande suivante:
```
# lvupdateRegScript -r -n getFiles -d orig -P LVUP_PRE
```