Utilisation du groupe de commandes RepositoryCheckpointCommands de l'objet AdminTask avec les scripts de wsadmin

Les langages de script Jython ou Jacl permettent de créer, restaurer, supprimer et administrer les points de contrôle à l'aide de l'outil wsadmin. Les points de contrôle de référentiel représentent des images du référentiel enregistrées avant modification de la configuration. Les commandes du groupe RepositoryCheckpointCommands prennent en charge les fonctions de point de contrôle de référentiel dans les modes local et connecté de wsadmin.

Vous pouvez configurer un point de contrôle pour sauvegarder des copies de fichier du référentiel de configuration principal. Un point de contrôle complet est une copie complète du référentiel de configuration dans sa totalité. Un point de contrôle delta est une image instantanée de sous-ensemble du référentiel de configuration qui est prise lorsque vous modifiez la configuration d'un produit. Utilisez un point de contrôle pour restaurer le référentiel de configuration dans son état précédent.

Pour activer les points de contrôle automatiques,utilisez la commande setAutoCheckpointEnabled et définissez -autoCheckpointEnabled sur true. Le produit crée un point de contrôle delta chaque fois qu'une modification est apportée au référentiel de configuration. Vous n'avez pas besoin de redémarrer le serveur après l'exécution de la commande. Une fois la fonction de point de contrôle automatique activée, le produit crée un point de contrôle delta automatiquement dans le répertoire racine_profil/checkpoints lorsqu'une modification de configuration est appliquée et sauvegardée dans le référentiel de configuration. Le produit stocke le référentiel de configuration dans le répertoire profile_root/config. Des opérations telles que la création d'un serveur d'applications et la sauvegarde d'une modification de configuration entraîne la création d'un point de contrôle delta. Le point de contrôle conserve une image du référentiel avant que la modification de configuration ne soit effectuée.

Après l'exécution des commandes qui modifient le référentiel de configuration, le produit sauvegarde automatiquement les modifications de configuration. Il n'est pas nécessaire d'exécuter AdminConfig.save() après l'exécution de commandes telles que createFullCheckpoint, deleteCheckpoint, restoreCheckpoint, setAutoCheckpointDepth, setAutoCheckpointEnabled ou setCheckpointLocation.

createFullCheckpoint

Utilisez la commande createFullCheckpoint pour créer un point de contrôle complet. Fournissez une valeur -checkpointName pour nommer le point de contrôle complet.

Objet cible

Aucun

Paramètres requis

-checkpointName
Indique le nom du point de contrôle complet. (Chaîne, obligatoire)

Une fois la commande exécutée, le produit retourne la valeur -checkpointName.

Paramètres facultatifs

-checkpointDesc
Indique une description du point de contrôle complet. (Chaîne, facultatif)

Syntaxe d'un exemple de mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.createFullCheckpoint('[-checkpointName full2 -checkpointDesc "a test"]')
  • Avec une liste Jython :
    AdminTask.createFullCheckpoint(['-checkpointName', 'full2'])

Syntaxe d'un exemple de mode interactif

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

deleteCheckpoint

Utilisez la commande deleteCheckpoint pour supprimer le point de contrôle qui est spécifié par la valeur -checkpointName. Vous pouvez supprimer n'importe quel point de contrôle complet. Comme pour les points de contrôle delta, vous pouvez supprimer uniquement le point de contrôle delta le plus ancien.

Objet cible

Aucun

Paramètres requis

-checkpointName
Indique le nom du point de contrôle à supprimer. Vous pouvez indiquer le nom d'un point de contrôle complet à supprimer. (Chaîne, obligatoire)
Remarque : Pour supprimer un point de contrôle delta delta, vous devez indiquer le nom du point de contrôle delta le plus ancien.

Paramètres facultatifs

Aucun

Syntaxe d'un exemple de mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.deleteCheckpoint('[-checkpointName full2]')
  • Avec une liste Jython :
    AdminTask.deleteCheckpoint(['-checkpointName', 'full2'])

Syntaxe d'un exemple de mode interactif

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

extractRepositoryCheckpoint

Utilisez la commande extractRepositoryCheckpoint pour extraire un point de contrôle de référentiel delta. Fournissez une valeur -checkpointName pour identifier le référentiel à extraire et une valeur -extractToFile pour spécifier le nom de chemin complet du fichier compressé qui va contenir les fichiers de point de contrôle extraits.

Objet cible

Aucun

Paramètres requis

-checkpointName
Indique le nom du point de contrôle de référentiel à extraire. Vous ne pouvez extraire qu'un point de contrôle de référentiel delta. (Chaîne, obligatoire)
-extractToFile
Indique le nom et l'emplacement cible du fichier compressé dans lequel le produit extrait le point de contrôle de référentiel. Le nom du fichier compressé peut avoir l'extension .zip ou .jar ou il peut ne pas avoir d'extension du tout. (Chaîne, obligatoire)

Paramètres facultatifs

Aucun

Syntaxe d'un exemple de mode de traitement par lots

  • A l'aide de la chaîne 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]')
  • Avec une liste 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'])

Syntaxe d'un exemple de mode interactif

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

getAutoCheckpointDepth

Utilisez la commande getAutoCheckpointDepth pour obtenir le nombre de points de contrôle delta automatiques conservés par le produit. Une fois le nombre de points de contrôle delta atteint, le produit supprime le point de contrôle delta le plus ancien à chaque fois qu'un nouveau point de contrôle delta est réalisé. La commande renvoie le nombre d points de contrôle delta automatiques à conserver.

Objet cible

Aucun

Paramètres requis

Aucun

Paramètres facultatifs

Aucun

Exemple d'utilisation

print AdminTask.getAutoCheckpointDepth()

getAutoCheckpointEnabled

Utilisez la commande getAutoCheckpointEnabled pour savoir si la création automatique des points de contrôle delta est activée. La commande renvoie true si les points de contrôle automatiques sont activés et false si les points de contrôle automatiques sont désactivés.

Objet cible

Aucun

Paramètres requis

Aucun

Paramètres facultatifs

Aucun

Exemple d'utilisation

print AdminTask.getAutoCheckpointEnabled()

getCheckpointLocation

Utilisez la commande getCheckpointLocation pour obtenir le chemin de répertoire dans lequel les points de contrôle sont stockés. La commande renvoie le chemin de répertoire. Le produit stocke les points de contrôle dans le répertoire profile_root/checkpoints.

Objet cible

Aucun

Paramètres requis

Aucun

Paramètres facultatifs

Aucun

Exemple d'utilisation

print AdminTask.getCheckpointLocation()

getConfigRepositoryLocation

Utilisez la commande getConfigRepositoryLocation pour obtenir le chemin de répertoire dans lequel est stocké le référentiel de configuration. La commande renvoie le chemin de répertoire. Le produit stocke le référentiel de configuration dans le répertoire profile_root/config.

Objet cible

Aucun

Paramètres requis

Aucun

Paramètres facultatifs

Aucun

Exemple d'utilisation

print AdminTask.getConfigRepositoryLocation()

listCheckpoints

Utilisez la commande listCheckpoints pour obtenir la liste des points de contrôle existants.

Objet cible

Aucun

Paramètres requis

Aucun

Paramètres facultatifs

Aucun

Exemple d'utilisation

print AdminTask.listCheckpoints()

Exemple de résultat

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

Utilisez la commande listCheckpointDocuments pour obtenir la liste des documents d'un référentiel de point de contrôle. Fournissez une valeur -checkpointName pour identifier le point de contrôle à partir duquel obtenir la liste de documents.

Objet cible

Aucun

Paramètres requis

-checkpointName
Indique le nom du point de contrôle pour lequel recherche une liste de documents. (Chaîne, obligatoire)

Paramètres facultatifs

Aucun

Syntaxe d'un exemple de mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.listCheckpointDocuments('[-checkpointName Delta-132]')
  • Avec une liste Jython :
    AdminTask.listCheckpointDocuments(['-checkpointName', 'Delta-132'])

Syntaxe d'un exemple de mode interactif

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

Exemple de résultat

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

Utilisez la commande restoreCheckpoint pour restaurer le référentiel de configuration à l'état dans lequel il se trouvait lorsqu'un point de contrôle a été effectué. Fournissez une valeur -checkpointName pour identifier le point de contrôle delta ou complet à restaurer.

Utilisez un point de contrôle complet pour restaurer le référentiel de configuration dans sa totalité dans l'état dans lequel il se trouvait au moment de l'exécution de ce point de contrôle.

Utilisez des points de contrôle delta pour annuler les modifications récentes. Restaurez les points de contrôle delta uniquement dans l'ordre inverse de leur ordre de création. Chaque point de contrôle delta comporte un numéro de séquence. Le numéro de séquence le plus élevé représente le point de contrôle delta le plus récent. Par conséquent, restaurez les points de contrôle delta par ordre de numéro de séquence décroissant uniquement.
Remarque : Lorsque le référentiel de configuration est restauré à partir d'un point de contrôle delta, le produit crée un point de contrôle contenant la configuration avant restauration.
Eviter les incidents Eviter les incidents: Si le point de contrôle delta que vous souhaitez restaurer est le point de contrôle sauvegardé le plus ancien, vous devrez peut-être augmenter le nombre de points de contrôle delta. Exécutez la commande getAutoCheckpointDepth pour rechercher le nombre de points de contrôle delta conservés par le produit. Une fois le nombre de points de contrôle delta atteint, le produit supprime le point de contrôle delta le plus ancien à chaque fois qu'un nouveau point de contrôle delta est réalisé. Pour augmenter le nombre de points de contrôle delta sauvegardés, utilisez la commande setAutoCheckpointDepth.gotcha

Lorsque vous restaurez un point de contrôle, des conflits d'enregistrement se produisent si vous n'avez pas validé les modifications dans votre espace de travail. Le point de contrôle est restauré mais les modifications non validées sont marquées comme conflit d'enregistrement lorsque vous tentez de les sauvegarder. De plus, si plusieurs utilisateurs travaillent sur des modifications de configuration du référentiel, d'autres utilisateurs avec des modifications non validées rencontrent également des conflits d'enregistrement si un utilisateur procède à une restauration de point de contrôle.

Objet cible

Aucun

Paramètres requis

-checkpointName
Indique le nom du point de contrôle à restaurer. (Chaîne, obligatoire)

Paramètres facultatifs

Aucun

Syntaxe d'un exemple de mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.restoreCheckpoint('[-checkpointName Delta-132]')
  • Avec une liste Jython :
    AdminTask.restoreCheckpoint(['-checkpointName', 'Delta-132'])

Syntaxe d'un exemple de mode interactif

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

setAutoCheckpointDepth

Utilisez la commande setAutoCheckpointDepth pour indiquer le nombre de points de contrôle delta à conserver. Si le nombre de points de contrôle delta sauvegardés dépasse la profondeur de point de contrôle spécifiée, le produit supprime les points de contrôle delta les plus anciens, en conservant uniquement la profondeur de point de contrôle spécifiée.

Objet cible

Aucun

Paramètres requis

-autoCheckpointDepth
Indique le nombre de points de contrôle delta automatiques à conserver. (Entier, obligatoire)

Paramètres facultatifs

Aucun

Syntaxe d'un exemple de mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.setAutoCheckpointDepth('[-autoCheckpointDepth 5]')
  • Avec une liste Jython :
    AdminTask.setAutoCheckpointDepth(['-autoCheckpointDepth', '5'])

Syntaxe d'un exemple de mode interactif

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

setAutoCheckpointEnabled

Utilisez la commande setAutoCheckpointEnabled pour activer ou désactiver les points de contrôle delta automatiques. Si les points de contrôle de référentiel automatiques sont activés, le produit crée un point de contrôle delta chaque fois qu'une modification est apportée au référentiel de configuration. Un fichier compressé de point de contrôle delta contient les versions antérieures et postérieures des fichiers de configuration qui ont été modifiés. Vous pouvez extraire le contenu du fichier compressé et examiner les fichiers extraits afin de déterminer ce qui a été modifié dans la configuration.

Après avoir exécuté setAutoCheckpointEnabled, il n'est pas nécessaire de redémarrer le serveur pour que la modification de paramètre soit prise en compte.

Objet cible

Aucun

Paramètres requis

-autoCheckpointEnabled
Indique si la configuration produit doit être sauvegardé avant qu'une modification de configuration soit stockée dans un point de contrôle de référentiel. La valeur true active les points de contrôle automatiques. La valeur false (par défaut) désactive les points de contrôle automatiques. (Booléen, obligatoire)

Paramètres facultatifs

Aucun

Syntaxe d'un exemple de mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.setAutoCheckpointEnabled('[-autoCheckpointEnabled true]')
  • Avec une liste Jython :
    AdminTask.setAutoCheckpointEnabled(['-autoCheckpointEnabled', 'true'])

Syntaxe d'un exemple de mode interactif

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

setCheckpointLocation

Utilisez la commande setCheckpointLocation pour définir le chemin de répertoire dans lequel les points de contrôle sont stockés. Par défaut, le produit stocke les points de contrôle dans le répertoire profile_root/checkpoints.

Objet cible

Aucun

Paramètres requis

-checkpointLocation
Indique le chemin de répertoire dans lequel des points de contrôle sont stockés. (Chaîne, obligatoire)

Paramètres facultatifs

Aucun

Syntaxe d'un exemple de mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.setCheckpointLocation('[-checkpointLocation ${USER_INSTALL_ROOT}/checkpoints/temp]')
  • Avec une liste Jython :
    AdminTask.setCheckpointLocation(['-checkpointLocation', '${USER_INSTALL_ROOT}/checkpoints/temp'])

Syntaxe d'un exemple de mode interactif

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

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_checkpoint_repository
Nom du fichier : rxml_checkpoint_repository.html