Grupo de mandatos RepositoryCheckpointCommands para el objeto AdminTask utilizando scripts wsadmin

Puede utilizar el lenguaje de script Jython o Jacl para crear, restaurar, suprimir y administrar puntos de comprobación con la herramienta wsadmin. Los puntos de comprobación de repositorio representan imágenes guardadas del repositorio antes de que se realicen cambios de configuración. Los mandatos del grupo RepositoryCheckpointCommands dan soporte a las funciones de punto de comprobación de repositorio en las modalidades conectada y local de wsadmin.

Puede configurar un punto de comprobación para realizar copias de seguridad de los archivos del repositorio de configuración maestra. Un punto de comprobación completo es una copia completa de todo el repositorio de configuración. Un punto de comprobación delta delta es una instantánea de subconjuntos del repositorio de configuración que se realiza cuando cambia la configuración de un producto. Utilice un punto de comprobación para volver a restaurar el repositorio de configuración a un estado anterior.

Para habilitar los puntos de comprobación automáticos, utilice el mandato setAutoCheckpointEnabled y establezca -autoCheckpointEnabled en true. El producto crea un punto de comprobación delta siempre que se realiza un cambio en el repositorio de configuración. No es necesario reiniciar el servidor después de ejecutar el mandato. Una vez habilitada la función de punto de comprobación automático, el producto crea un punto de comprobación delta automáticamente en el directorio raíz_perfil/checkpoints cuando se realiza un cambio de configuración y se guarda en el repositorio de configuración. El producto almacena el almacén en el directorio raíz_perfil/config. Las acciones como, por ejemplo, crear un servidor de aplicaciones y guardar el cambio de configuración, dan como resultado la creación de un punto de comprobación delta. El punto de comprobación conserva una imagen del repositorio antes de realizar el cambio de configuración.

Después de ejecutar los mandatos que cambian el repositorio de configuración, el producto guarda automáticamente los cambios de configuración. No es necesario ejecutar AdminConfig.save() después de ejecutar mandato como, por ejemplo, createFullCheckpoint, deleteCheckpoint, restoreCheckpoint, setAutoCheckpointDepth, setAutoCheckpointEnabled o setCheckpointLocation.

createFullCheckpoint

Utilice el mandato createFullCheckpoint para crear un punto de comprobación completo. Proporcione un valor -checkpointName para denominar el punto de comprobación completo.

Objeto de destino

Ninguna

Parámetros necesarios

-checkpointName
Especifica el nombre del punto de comprobación completo. (Serie, obligatorio)

Cuando el mandato se ejecuta satisfactoriamente, el producto devuelve el valor -checkpointName.

Parámetros opcionales

-checkpointDesc
Especifica una descripción del punto de comprobación completo. (String, opcional)

Ejemplo de utilización de la modalidad por lotes

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

Ejemplo de utilización de la modalidad interactiva

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

deleteCheckpoint

Utilice el mandato deleteCheckpoint para suprimir el punto de comprobación que se especifica mediante el valor -checkpointName. Puede suprimir cualquier punto de comprobación completo. Por lo que respecta a los puntos de comprobación delta, sólo podrá suprimir el punto de comprobación delta más antiguo.

Objeto de destino

Ninguna

Parámetros necesarios

-checkpointName
Especifica el nombre del punto de comprobación que se va a suprimir. Puede especificar el nombre de cualquier punto de comprobación completo para suprimirlo. (Serie, obligatorio)
Nota: Para suprimir un punto de comprobación delta, debe especificar el nombre del punto de comprobación delta más antiguo.

Parámetros opcionales

Ninguna

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.deleteCheckpoint('[-checkpointName full2]')
  • Utilizando la lista de Jython:
    AdminTask.deleteCheckpoint(['-checkpointName', 'full2'])

Ejemplo de utilización de la modalidad interactiva

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

extractRepositoryCheckpoint

Utilice el mandato extractRepositoryCheckpoint para extraer un punto de comprobación de repositorio delta. Proporcione un valor -checkpointName para identificar el repositorio que se va a extraer y un valor -extractToFile para especificar el nombre de vía de acceso completo del archivo comprimido que contendrá los archivos del punto de comprobación extraído.

Objeto de destino

Ninguna

Parámetros necesarios

-checkpointName
Especifica el nombre del punto de comprobación de repositorio que se va a extraer. Puede extraer sólo un punto de comprobación de repositorio delta. (Serie, obligatorio)
-extractToFile
Especifica el nombre y la ubicación de destino del archivo comprimido en el que el producto extrae el punto de comprobación de repositorio. El nombre del archivo comprimido puede tener una extensión .zip o .jar, o no tener ninguna extensión. (Serie, obligatorio)

Parámetros opcionales

Ninguna

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de 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 la lista de 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'])

Ejemplo de utilización de la modalidad interactiva

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

getAutoCheckpointDepth

Utilice el mandato getAutoCheckpointDepth para obtener el número de puntos de comprobación delta automáticos que mantiene el producto. Después de que se alcance el número de puntos de comprobación delta, el producto suprime el punto de comprobación delta más antiguo, cada vez que se realiza un nuevo punto de comprobación delta. El mandato devuelve el número de puntos de comprobación delta automáticos que se mantienen.

Objeto de destino

Ninguna

Parámetros necesarios

Ninguna

Parámetros opcionales

Ninguna

Ejemplo de uso

print AdminTask.getAutoCheckpointDepth()

getAutoCheckpointEnabled

Utilice el mandato getAutoCheckpointEnabled para determinar si está habilitada la creación automática de puntos de comprobación delta. El mandato devuelve true si los puntos de comprobación automáticos están habilitados y false si los puntos de comprobación automáticos están inhabilitados.

Objeto de destino

Ninguna

Parámetros necesarios

Ninguna

Parámetros opcionales

Ninguna

Ejemplo de uso

print AdminTask.getAutoCheckpointEnabled()

getCheckpointLocation

Utilice el mandato getCheckpointLocation para obtener la vía de acceso del directorio donde se almacenan los puntos de comprobación. El mandato devuelve la vía de acceso del directorio. El producto almacena los puntos de comprobación en el directorio raíz_perfil/checkpoints.

Objeto de destino

Ninguna

Parámetros necesarios

Ninguna

Parámetros opcionales

Ninguna

Ejemplo de uso

print AdminTask.getCheckpointLocation()

getConfigRepositoryLocation

Utilice el mandato getConfigRepositoryLocation para obtener la vía de acceso del directorio donde se almacena el repositorio de configuración. El mandato devuelve la vía de acceso del directorio. El producto almacena el almacén en el directorio raíz_perfil/config.

Objeto de destino

Ninguna

Parámetros necesarios

Ninguna

Parámetros opcionales

Ninguna

Ejemplo de uso

print AdminTask.getConfigRepositoryLocation()

listCheckpoints

Utilice el mandato listCheckpoints para obtener una lista de los puntos de comprobación existentes.

Objeto de destino

Ninguna

Parámetros necesarios

Ninguna

Parámetros opcionales

Ninguna

Ejemplo de uso

print AdminTask.listCheckpoints()

Salida de ejemplo

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

Utilice el mandato listCheckpointDocuments para obtener una lista de documentos en un repositorio de punto de comprobación. Proporcione un valor -checkpointName para identificar el punto de comprobación del que se obtiene la lista de documentos.

Objeto de destino

Ninguna

Parámetros necesarios

-checkpointName
Especifica el nombre del punto de comprobación en el que se va a buscar una lista de documentos. (Serie, obligatorio)

Parámetros opcionales

Ninguna

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.listCheckpointDocuments('[-checkpointName Delta-132]')
  • Utilizando la lista de Jython:
    AdminTask.listCheckpointDocuments(['-checkpointName', 'Delta-132'])

Ejemplo de utilización de la modalidad interactiva

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

Salida de ejemplo

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

Utilice el mandato restoreCheckpoint para restaurar el repositorio de configuración al estado en el que se encontraba en el momento de realizar un punto de comprobación. Proporcione un valor -checkpointName para identificar el punto de comprobación delta o completo que se va a restaurar.

Utilice un punto de comprobación completo para volver a restaurar todo el repositorio de configuración al estado en que estaba cuando se realizó el punto de comprobación completo.

Utilice los puntos de comprobación delta para deshacer cambios recientes. Restaure los puntos de comprobación delta sólo en el orden inverso en el que se crearon. Cada punto de comprobación delta tiene un número de secuencia. El número de secuencia mayor representa el punto de comprobación delta más reciente. Así pues, restaure los puntos de comprobación delta sólo en un número de secuencia descendiente.
Nota: Después de que se haya restaurado el repositorio de configuración a partir de un punto de comprobación delta, el producto crea un punto de comprobación que contiene la configuración antes de la restauración.
Avoid trouble Avoid trouble: Si el punto de comprobación delta que desea restaurar es el punto de comprobación más antiguo guardado, es posible que tenga que aumentar el número de puntos de comprobación delta. Ejecute el mandato getAutoCheckpointDepth para determinar cuántos puntos de comprobación delta automáticos mantiene el producto. Después de que se alcance el número de puntos de comprobación delta, el producto suprime el punto de comprobación delta más antiguo, cada vez que se realiza un nuevo punto de comprobación delta. Para aumentar el número de puntos de comprobación delta guardados, utilice el mandato setAutoCheckpointDepth. gotcha

Cuando restaure un punto de comprobación, guarde los conflictos que se produzcan si tiene cambios sin confirmar en el espacio de trabajo. El punto de comprobación se restaura, pero los cambios sin confirmar se marcan como como conflicto al guardar cuando intenta guardarlos. Asimismo, si más de un usuario está trabajando en los cambios de configuración en el repositorio, los otros usuarios con cambios sin confirmar también obtienen conflictos al guardar, si un usuario realiza una restauración de punto de comprobación.

Objeto de destino

Ninguna

Parámetros necesarios

-checkpointName
Especifica el nombre del punto de comprobación que se va a restaurar. (Serie, obligatorio)

Parámetros opcionales

Ninguna

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.restoreCheckpoint('[-checkpointName Delta-132]')
  • Utilizando la lista de Jython:
    AdminTask.restoreCheckpoint(['-checkpointName', 'Delta-132'])

Ejemplo de utilización de la modalidad interactiva

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

setAutoCheckpointDepth

Utilice el mandato setAutoCheckpointDepth para especificar el número de puntos de comprobación delta que se van a mantener. Si el número de puntos de comprobación delta guardados excede la profundidad de puntos de comprobación especificada, el producto suprime los puntos de comprobación delta más antiguos y sólo mantiene la profundidad de puntos de comprobación especificada.

Objeto de destino

Ninguna

Parámetros necesarios

-autoCheckpointDepth
Especifica el número de puntos de comprobación delta automáticos que se mantienen. (Integer, obligatorio)

Parámetros opcionales

Ninguna

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.setAutoCheckpointDepth('[-autoCheckpointDepth 5]')
  • Utilizando la lista de Jython:
    AdminTask.setAutoCheckpointDepth(['-autoCheckpointDepth', '5'])

Ejemplo de utilización de la modalidad interactiva

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

setAutoCheckpointEnabled

Utilice el mandato setAutoCheckpointEnabled para habilitar o inhabilitar los puntos de comprobación delta automáticos. Si los puntos de comprobación delta automáticos están habilitados, el producto crea un punto de comprobación delta siempre que se realiza un cambio en el repositorio de configuración. Un archivo comprimido de puntos de comprobación delta contiene las versiones anterior y posterior de los archivos de configuración que han cambiado. Puede extraer el contenido del archivo comprimido y, a continuación, examinar los archivos extraídos para determinar qué ha cambiado en la configuración.

Después de ejecutar setAutoCheckpointEnabled, no es necesario reiniciar el servidor para que entre en vigor el cambio de valores.

Objeto de destino

Ninguna

Parámetros necesarios

-autoCheckpointEnabled
Especifica si se debe guardar la configuración del producto antes de que la configuración cambie automáticamente a un punto de comprobación de repositorio. Un valor true habilita los puntos de comprobación automáticos. Un valor false, el valor predeterminado, inhabilita los puntos de comprobación automáticos. (Boolean, necesario)

Parámetros opcionales

Ninguna

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.setAutoCheckpointEnabled('[-autoCheckpointEnabled true]')
  • Utilizando la lista de Jython:
    AdminTask.setAutoCheckpointEnabled(['-autoCheckpointEnabled', 'true'])

Ejemplo de utilización de la modalidad interactiva

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

setCheckpointLocation

Utilice el mandato setCheckpointLocation para establecer la vía de acceso del directorio donde se almacenan los puntos de comprobación. De forma predeterminada, el producto almacena los puntos de comprobación en el directorio raíz_perfil/checkpoints.

Objeto de destino

Ninguna

Parámetros necesarios

-checkpointLocation
Especifica la vía de acceso del directorio donde se almacenan los puntos de comprobación. (String, necesario)

Parámetros opcionales

Ninguna

Ejemplo de utilización de la modalidad por lotes

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

Ejemplo de utilización de la modalidad interactiva

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

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_checkpoint_repository
File name: rxml_checkpoint_repository.html