Grupo de Comandos RepositoryCheckpointCommands para o Objeto AdminTask Utilizando o Script Wsadmin

É possível usar a linguagem de script Jython ou Jacl para criar, restaurar, excluir e administrar pontos de verificação com a ferramenta wsadmin. Os pontos de verificação de repositório representam imagens salvas do repositório antes de as mudanças na configuração serem feitas. Os comandos no grupo RepositoryCheckpointCommands suportam as funções do ponto de verificação de repositório no wsadmin local e modos conectados.

É possível configurar um ponto de verificação para fazer backup de cópias de arquivos do repositório de configuração principal. Um ponto de verificação integral é uma cópia completa do repositório de configuração completo. Um ponto de verificação delta é um snapshot de subconjunto do repositório de configuração, feito ao alterar uma configuração do produto. Use um ponto de verificação para restaurar o repositório de configuração de volta a um estado anterior.

Para ativar pontos de verificação automáticos, use o comando setAutoCheckpointEnabled e configure -autoCheckpointEnabled como true. O produto cria um ponto de verificação delta sempre que uma mudança for feita no repositório de configuração. Não é necessário reiniciar o servidor após executar o comando. Após ativar a função de ponto de verificação automático, o produto cria um ponto de verificação delta automaticamente no diretório profile_root/checkpoints quando qualquer mudança na configuração for feita e salva no repositório de configuração. O produto armazena o repositório de configuração no diretório profile_root/config. Ações como a criação de um servidor de aplicativos e salvamento de mudança na configuração resulta na criação de um ponto de verificação delta. O ponto de verificação preserva uma imagem do repositório antes da mudança na configuração ser efetuada.

Após executar os comandos que alteram o repositório de configuração, o produto automaticamente salva as mudanças na configuração. Não é necessário executar AdminConfig.save() após executar comandos como createFullCheckpoint, deleteCheckpoint, restoreCheckpoint, setAutoCheckpointDepth, setAutoCheckpointEnabled ou setCheckpointLocation.

createFullCheckpoint

Use o comando createFullCheckpoint para criar um ponto de verificação integral. Forneça um valor -checkpointName para nomear o ponto de verificação integral.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

-checkpointName
Especifica o nome do ponto de verificação integral. (Sequência, obrigatória)

Após executar o comando com sucesso, o produto retorna o valor -checkpointName.

Parâmetros Opcionais

-checkpointDesc
Especifica uma descrição do ponto de verificação integral. (String, opcional)

Exemplo de uso do modo em lote

  • Utilizando a cadeia Jython:
    AdminTask.createFullCheckpoint('[-checkpointName full2 -checkpointDesc "a test"]')
  • Utilizando a lista Jython:
    AdminTask.createFullCheckpoint(['-checkpointName', 'full2'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.createFullCheckpoint('[-interactive]')

deleteCheckpoint

Use o comando deleteCheckpoint para excluir o ponto de verificação especificado pelo valor -checkpointName. É possível excluir qualquer ponto de verificação integral. Como para pontos de verificação delta, é possível excluir somente o ponto de verificação delta mais antigo.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

-checkpointName
Especifica o nome do ponto de verificação a ser excluído. É possível especificar o nome de qualquer ponto de verificação integral a ser excluído. (Sequência, obrigatória)
Nota: Para excluir um ponto de verificação delta, é necessário especificar o nome do ponto de verificação delta mais antigo.

Parâmetros Opcionais

Nenhuma.

Exemplo de uso do modo em lote

  • Utilizando a cadeia Jython:
    AdminTask.deleteCheckpoint('[-checkpointName full2]')
  • Utilizando a lista Jython:
    AdminTask.deleteCheckpoint(['-checkpointName', 'full2'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.deleteCheckpoint('[-interactive]')

extractRepositoryCheckpoint

Use o comando extractRepositoryCheckpoint para extrair um ponto de verificação do repositório delta. Forneça um valor -checkpointName para identificar o repositório para a extração e um valor -extractToFile para especificar o nome do caminho completo do arquivo compactado para reter os arquivos de ponto de verificação extraídos.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

-checkpointName
Especifica o nome do ponto de verificação de repositório para extração. É possível extrair somente um ponto de verificação do repositório delta. (Sequência, obrigatória)
-extractToFile
Especifica o nome e o local de destino do arquivo compactado ao qual o produto extrai o ponto de verificação de repositório. O nome do arquivo compactado pode ter a extensão .zip ou .jar ou o nome do arquivo pode não possuir extensão. (Sequência, obrigatória)

Parâmetros Opcionais

Nenhuma.

Exemplo de uso do modo em lote

  • Utilizando a cadeia Jython:
    [AIX][HP-UX][Linux][Solaris][z/OS]
    AdminTask.extractRepositoryCheckpoint('[-checkpointName Delta-132 -extractToFile /temp/test1.zip]')
    [Windows]
    AdminTask.extractRepositoryCheckpoint('[-checkpointName Delta-132 -extractToFile c:/temp/test1.zip]')
  • Utilizando a lista Jython:
    [AIX][HP-UX][Linux][Solaris][z/OS]
    AdminTask.extractRepositoryCheckpoint(['-checkpointName', 'Delta2', '-extractToFile', '/temp/test1.zip'])
    [Windows]
    AdminTask.extractRepositoryCheckpoint(['-checkpointName', 'Delta2', '-extractToFile', 'c:/temp/test1.zip'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.extractRepositoryCheckpoint('[-interactive]')

getAutoCheckpointDepth

Use o comando getAutoCheckpointDepth para obter o número de pontos de verificação delta automáticos que o produto mantém. Após o número de pontos de verificação delta ser atingido, o produto exclui o ponto de verificação delta mais antigo toda vez que um novo ponto de verificação delta é criado. O comando retorna o número de pontos de verificação delta automáticos a serem mantidos.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

Nenhuma.

Parâmetros Opcionais

Nenhuma.

Exemplo de uso

print AdminTask.getAutoCheckpointDepth()

getAutoCheckpointEnabled

Use o comando getAutoCheckpointEnabled para descobrir se a criação automática de pontos de verificação delta está ativada. O comando retorna true se os pontos de verificação automáticos estiverem ativados e false se os pontos de verificação automáticos estiverem desativados.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

Nenhuma.

Parâmetros Opcionais

Nenhuma.

Exemplo de uso

print AdminTask.getAutoCheckpointEnabled()

getCheckpointLocation

Use o comando getCheckpointLocation para obter o caminho do diretório em que os pontos de verificação são armazenados. O comando retorna o caminho do diretório. O produto armazena os pontos de verificação no diretório profile_root/checkpoints.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

Nenhuma.

Parâmetros Opcionais

Nenhuma.

Exemplo de uso

print AdminTask.getCheckpointLocation()

getConfigRepositoryLocation

Use o comando getConfigRepositoryLocation para obter o caminho do diretório em que o repositório de configuração é armazenado. O comando retorna o caminho do diretório. O produto armazena o repositório de configuração no diretório profile_root/config.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

Nenhuma.

Parâmetros Opcionais

Nenhuma.

Exemplo de uso

print AdminTask.getConfigRepositoryLocation()

listCheckpoints

Use o comando listCheckpoints para obter uma lista de pontos de verificação existentes.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

Nenhuma.

Parâmetros Opcionais

Nenhuma.

Exemplo de uso

print AdminTask.listCheckpoints()

Exemplo de saída

full1(cells/MyCell/repository/checkpoints/full1|checkpoint.xml)
Delta-1323948371187(cells/MyCell/repository/checkpoints/Delta-1323948371187|checkpoint.xml)
Delta-1323904606781(cells/MyCell/repository/checkpoints/Delta-1323904606781|checkpoint.xml)
Delta-1323904256625(cells/MyCell/repository/checkpoints/Delta-1323904256625|checkpoint.xml)

listCheckpointDocuments

Use o comando listCheckpointDocuments para obter uma lista de documentos em um repositório de pontos de verificação. Forneça um valor -checkpointName para identificar o ponto de verificação no qual é possível obter a lista de documentos.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

-checkpointName
Especifica o nome do ponto de verificação para procurar uma lista de documentos. (Sequência, obrigatória)

Parâmetros Opcionais

Nenhuma.

Exemplo de uso do modo em lote

  • Utilizando a cadeia Jython:
    AdminTask.listCheckpointDocuments('[-checkpointName Delta-132]')
  • Utilizando a lista Jython:
    AdminTask.listCheckpointDocuments(['-checkpointName', 'Delta-132'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.listCheckpointDocuments('[-interactive]')

Exemplo de saída

authorizationgroup.xml(cells/MyCell/repository/checkpoints/Delta-132|checkpoint.xml#CheckpointDocument_1325)
audit-authz.xml(cells/MyCell/repository/checkpoints/Delta-132|checkpoint.xml#CheckpointDocument_1326)
admin-authz.xml(cells/MyCell/repository/checkpoints/Delta-132|checkpoint.xml#CheckpointDocument_1327)

restoreCheckpoint

Use o comando restoreCheckpoint para restaurar o repositório de configuração de volta ao estado em que estava no momento em que um ponto de verificação foi feito. Forneça um valor -checkpointName para identificar o ponto de verificação integral ou delta para restauração.

Utilize um ponto de verificação completo para restaurar o repositório de configuração inteiro ao estado em que se encontrava no momento em que o ponto de verificação completo foi feito.

Utilize os pontos de verificação delta para desfazer as alterações recentes. Restaure pontos de verificação delta somente na ordem reversa na qual eles foram criados. Cada ponto de verificação delta possui um número de seqüência. O mais alto número de seqüência representa o ponto de verificação delta mais recente. Assim, restaure pontos de verificação delta somente no número de sequência decrescente.
Nota: Após o repositório de configuração ser restaurado a partir de um ponto de verificação delta, o produto cria um ponto de verificação que contém a configuração antes da restauração.
Evitar Problemas Evitar Problemas: Se o ponto de verificação delta que você deseja restaurar for o ponto de verificação mais antigo salvo, é possível que seja necessário aumentar o número de pontos de verificação delta. Execute o comando getAutoCheckpointDepth para descobrir quantos pontos de verificação delta são mantidos pelo produto. Após o número de pontos de verificação delta ser atingido, o produto exclui o ponto de verificação delta mais antigo toda vez que um novo ponto de verificação delta é criado. Para aumentar o número de pontos de verificação delta salvos, use o comando setAutoCheckpointDepth.gotcha

Ao restaurar um ponto de verificação, ocorrem conflitos de salvamento se você possui mudanças não confirmadas em sua área de trabalho. O ponto de verificação é restaurado, mas as mudanças não confirmadas são sinalizadas como um conflito de salvamento quando você tenta salvá-las. Além disso, se mais de um usuário estiver trabalhando em mudanças na configuração no repositório, outros usuários com mudanças não confirmadas terão conflitos de salvamento também se um usuário executar uma restauração de ponto de verificação.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

-checkpointName
Especifica o nome do ponto de verificação a ser restaurado. (Sequência, obrigatória)

Parâmetros Opcionais

Nenhuma.

Exemplo de uso do modo em lote

  • Utilizando a cadeia Jython:
    AdminTask.restoreCheckpoint('[-checkpointName Delta-132]')
  • Utilizando a lista Jython:
    AdminTask.restoreCheckpoint(['-checkpointName', 'Delta-132'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.restoreCheckpoint('[-interactive]')

setAutoCheckpointDepth

Use o comando setAutoCheckpointDepth para especificar o número de pontos de verificação delta a serem mantidos. Se o número de pontos de verificação delta salvos exceder a profundidade do ponto de verificação especificado, o produto exclui os pontos de verificação delta mais antigos, mantendo não mais que a profundidade especificada do ponto de verificação.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

-autoCheckpointDepth
Especifica o número de pontos de verificação delta automáticos a serem mantidos. (Número inteiro, obrigatório)

Parâmetros Opcionais

Nenhuma.

Exemplo de uso do modo em lote

  • Utilizando a cadeia Jython:
    AdminTask.setAutoCheckpointDepth('[-autoCheckpointDepth 5]')
  • Utilizando a lista Jython:
    AdminTask.setAutoCheckpointDepth(['-autoCheckpointDepth', '5'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.setAutoCheckpointDepth('[-interactive]')

setAutoCheckpointEnabled

Use o comando setAutoCheckpointEnabled para ativar ou desativar os pontos de verificação delta automáticos. Se os pontos de verificação de repositório automáticos estiverem ativados, o produto cria um ponto de verificação delta sempre que uma mudança for feita no repositório de configuração. Um arquivo compactado do ponto de verificação delta contém as versões anterior e posterior dos arquivos de configuração que foram alterados. É possível extrair o conteúdo do arquivo compactado e, em seguida, examinar os arquivos extraídos para determinar o que foi alterado na configuração.

Após executar setAutoCheckpointEnabled, não é necessário reiniciar o servidor para que a mudança de configuração entrar em vigor.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

-autoCheckpointEnabled
Especifica se a configuração do produto será salva antes de uma mudança automática na configuração para um ponto de verificação de repositório. Um valor true ativa os pontos de verificação automáticos. Um valor false, o padrão, desativa os pontos de verificação automáticos. (Booleano, obrigatório)

Parâmetros Opcionais

Nenhuma.

Exemplo de uso do modo em lote

  • Utilizando a cadeia Jython:
    AdminTask.setAutoCheckpointEnabled('[-autoCheckpointEnabled true]')
  • Utilizando a lista Jython:
    AdminTask.setAutoCheckpointEnabled(['-autoCheckpointEnabled', 'true'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.setAutoCheckpointEnabled('[-interactive]')

setCheckpointLocation

Use o comando setCheckpointLocation para configurar o caminho do diretório onde os pontos de verificação são armazenados. Por padrão, o produto armazena os pontos de verificação no diretório profile_root/checkpoints.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

-checkpointLocation
Especifica o caminho do diretório no qual pontos de verificação são armazenados. (Sequência, obrigatória)

Parâmetros Opcionais

Nenhuma.

Exemplo de uso do modo em lote

  • Utilizando a cadeia Jython:
    AdminTask.setCheckpointLocation('[-checkpointLocation ${USER_INSTALL_ROOT}/checkpoints/temp]')
  • Utilizando a lista Jython:
    AdminTask.setCheckpointLocation(['-checkpointLocation', '${USER_INSTALL_ROOT}/checkpoints/temp'])

Exemplo de uso do modo interativo

  • Utilizando Jython:
    AdminTask.setCheckpointLocation('[-interactive]')

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_checkpoint_repository
Nome do arquivo: rxml_checkpoint_repository.html