comando lvupdateRegScript

Propósito

O comando ' lvupdateRegScript é usado para registrar um script a ser executado em pontos de notificação durante uma operação de AIX® Live Update.

Sintaxe

Para registrar um script, use a sintaxe a seguir:

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

Para desregistrar um script, use a sintaxe a seguir:

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

Para listar todos os scripts registrados, use a sintaxe a seguir:

lvupdateRegScript  -l

Descrição

As fases válidas que um script pode ser registrado são as seguintes:

LVUP_CHECK: Executado no início de uma operação Live Update . Esta fase garante os scripts executados que quaisquer serviços associados estão prontos para a operação Live Update .
LVUP_PRE: Executado antes que os aplicativos estejam congelados na partição lógica original (Lógica). Esta fase permite que os scripts executados salvem quaisquer dados conforme necessário antes que os aplicativos sejam congelados.
LVUP_PRE_KERNEL: Executado após os aplicativos serem congelados na Partição Lógica original e antes que os aplicativos sejam reiniciados na Partição Lógica substituta. Esta fase é executada na Partição Lógica original antes de ser executada na Partição Lógica de barriga de aluguel.
LVUP_POST: Executado na Partição Lógica substituta após os aplicativos serem reiniciados. Esses scripts são executados no ambiente chroot .
LVUP_ERROR: Executado em caso de erro durante a fase LVUP_CHECK ou qualquer fase posterior da operação Live Update .
LVUP_COMPLETO: Executado na Partição Lógica substituta após a operação Live Update está concluída. Esta fase inclui exclusão da Partição Lógica original e reajustes da UUID da Partição Lógica de aluguel. Os scripts que estão registrados para esta fase são executados no ambiente chroot .

Durante a operação Live Update , antes de os scripts DR_CHECK serem chamados, os scripts que são registrados com a fase LVUP_CHECK são executados. Para as fases LVUP_CHECK, LVUP_PRE, LVUP_PRE_KERNEL, LVUP_POSTe LVUP_COMPLETE, os scripts são executados em uma ordem de prioridade específica que varia entre as partições lógicas originais e as substituta. Na Partição Lógica original, a ordem é de prioridade 1 para prioridade 10, e a ordem é revertida na partição lógica substituta, executando prioridade 10 primeiro e em até a prioridade 1. Em caso de um evento LVUP_ERROR , os scripts são executados em ordem de prioridade oposta.

A mesma metodologia é aplicada ao descanso das fases.

O proprietário do script deve especificar se o script deve ser executado no original ou no sub-rogado da LPARs. Se o script deve ser executado tanto no original quanto no LPARs substituta, ele deve ser registrado duas vezes, uma vez para a Partição Lógica original e uma vez para a LPARs substituta.

Quando um script registrado é executado, ele deve retornar 0 para indicar o sucesso, ou um valor diferente de zero caso ele tenha falhado. A operação Live Update falha se um script falhar durante o evento LVUP_CHECK ou LVUP_PRE .

Nota: O script que deve ser registrado com o comando lvupdateRegScript deve estar presente em um dos seguintes sistemas de arquivos: /, /var, /usr, /opt, /tmp.

Parâmetros

Item	Descrição
`rótulo`	Uma sequência de até 80 caracteres que especifica um rótulo, que identifica um determinado script.
`script`	Uma sequência de até 1024 caracteres que especifica um script a ser executado. A string deve conter o caminho completo para o script, assim como quaisquer argumentos desejados.
`phase`	Uma string que especifica um de um conjunto de fases: `LVUP_CHECK`, `LVUP_PRE`, `LVUP_PRE_KERNEL`, `LVUP_POST`, `LVUP_ERROR`e `LVUP_COMPLETE`.
`prioridade`	Um inteiro de 1 10 que identifica uma prioridade para executar o script.

Sinalizações

Item	Descrição
-a	Registra um script a ser executado durante a operação Live Update .
-d `orig` \| `surr`	Especifica a Partição Lógica em que o script deve ser executado: original da Partição Lógica (`orig`) ou de sub-rogação (`surr`).
-l	Lista os scripts e etiquetas associadas que estão registrados.
-n `rótulo`	Especifica uma etiqueta para associar a um script registrado.
-P `fase`	Seleciona a fase quando o script deve ser invocado.
-p `prioridade`	Especifica uma prioridade de 1 10. Os scripts que são registrados para uma determinada fase são executados em ordem da mais alta (1) para a menor (10) prioridade.
-r	Desregistra um script.
-s `script`	Especifica o script a ser executado.

Exemplos

Para listar todos os scripts de notificação que estão registrados para serem chamados durante a operação Live Update , digite o seguinte comando:
```
# lvupdateRegScript -l
```
Para registrar um script para executar na Partição Lógica original durante um evento LVUP_PRE da operação Live Update , digite o seguinte comando:
Para registrar um script para executar na partição lógica substituta durante o evento LVUP_POST da operação Live Update , digite o seguinte comando:
```
# lvupdateRegScript -a -n putFiles -s "/opt/myapp/bin/rest_files /var/myapp/data"
                              -P LVUP_POST -p 10 -d surr
```
Para remover um script que foi registrado anteriormente para ser invocado durante a operação Live Update , digite o seguinte comando:
```
# lvupdateRegScript -r -n getFiles -d orig -P LVUP_PRE
```