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 :
AdminTask.extractRepositoryCheckpoint('[-checkpointName Delta-132 -extractToFile /temp/test1.zip]')
AdminTask.extractRepositoryCheckpoint('[-checkpointName Delta-132 -extractToFile c:/temp/test1.zip]')
- Avec une liste Jython :
AdminTask.extractRepositoryCheckpoint(['-checkpointName', 'Delta2', '-extractToFile', '/temp/test1.zip'])
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.

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]')