使用 wsadmin 脚本编制的 AdminTask 对象的 RepositoryCheckpointCommands 命令组
可以将 Jython 或 Jacl 脚本语言与 wsadmin 工具一起使用来创建、复原、删除和管理检查点。存储库检查点表示在更改配置之前已保存的存储库图像。RepositoryCheckpointCommands 组中的命令以 wsadmin 本地方式和已连接方式支持存储库检查点功能。
可以配置检查点以备份主配置库文件的副本。完整检查点是整个配置库的完整副本。增量检查点是配置库的子集快照,当您更改产品配置时将制作此检查点。使用检查点可以将配置库恢复到较早的状态。
要启用自动检查点,请使用 setAutoCheckpointEnabled 命令并将 -autoCheckpointEnabled 设置为 true。每当更改配置库时,产品就会创建增量检查点。运行命令后,不需要重新启动服务器。启用自动检查点功能后,如果更改了任何配置并将更改保存到配置库,那么产品会自动在 profile_root/checkpoints 目录中创建增量检查点。产品会将配置库存储在 profile_root/config 目录中。创建应用程序服务器及保存配置更改等操作会导致创建增量检查点。在作出配置更改之前,检查点会保留存储库的映像。
运行用来更改配置库的命令后,产品会自动地保存配置更改。运行 createFullCheckpoint、deleteCheckpoint、restoreCheckpoint、setAutoCheckpointDepth、setAutoCheckpointEnabled 或 setCheckpointLocation 等命令后,不需要运行 AdminConfig.save()。
createFullCheckpoint
使用 createFullCheckpoint 命令来创建完整检查点。提供 -checkpointName 值以对完整检查点进行命名。
目标对象
无
必需参数
- -checkpointName
- 指定完整检查点的名称。(字符串,必需)
命令成功运行后,产品会返回 -checkpointName 值。
可选参数
- -checkpointDesc
- 指定完整检查点的描述。(字符串,可选)
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.createFullCheckpoint('[-checkpointName full2 -checkpointDesc "a test"]')
- 使用 Jython 列表:
AdminTask.createFullCheckpoint(['-checkpointName', 'full2'])
交互方式示例用法
- 使用 Jython:
AdminTask.createFullCheckpoint('[-interactive]')
deleteCheckpoint
使用 deleteCheckpoint 命令来删除由 -checkpointName 值指定的检查点。可以删除任何完整检查点。对于增量检查点,只能删除最旧的增量检查点。
目标对象
无
必需参数
- -checkpointName
- 指定要删除的检查点的名称。可以指定要删除的任何完整检查点的名称。(字符串,必需)注: 要删除增量检查点,必须指定最早增量检查点的名称。
可选参数
无
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.deleteCheckpoint('[-checkpointName full2]')
- 使用 Jython 列表:
AdminTask.deleteCheckpoint(['-checkpointName', 'full2'])
交互方式示例用法
- 使用 Jython:
AdminTask.deleteCheckpoint('[-interactive]')
extractRepositoryCheckpoint
使用 extractRepositoryCheckpoint 命令来解压缩增量存储库检查点。提供 -checkpointName 值来确定要解压缩的存储库,且提供 -extractToFile 值来指定用于保留所解压缩的检查点文件的压缩文件完整路径名。
目标对象
无
必需参数
- -checkpointName
- 指定要解压缩的存储库检查点的名称。只能解压缩增量存储库检查点。(字符串,必需)
- -extractToFile
- 指定产品将存储库检查点解压缩到的压缩文件名称和目标位置。压缩文件的名称可以具有扩展名 .zip 或 .jar,或者文件名可以没有扩展名。(字符串,必需)
可选参数
无
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.extractRepositoryCheckpoint('[-checkpointName Delta-132 -extractToFile /temp/test1.zip]')
AdminTask.extractRepositoryCheckpoint('[-checkpointName Delta-132 -extractToFile c:/temp/test1.zip]')
- 使用 Jython 列表:
AdminTask.extractRepositoryCheckpoint(['-checkpointName', 'Delta2', '-extractToFile', '/temp/test1.zip'])
AdminTask.extractRepositoryCheckpoint(['-checkpointName', 'Delta2', '-extractToFile', 'c:/temp/test1.zip'])
交互方式示例用法
- 使用 Jython:
AdminTask.extractRepositoryCheckpoint('[-interactive]')
getAutoCheckpointDepth
使用 getAutoCheckpointDepth 命令来获取产品所保留的自动增量检查点数目。达到增量检查点数目后,产品在每次生成新增量检查点时会删除最早的增量检查点。命令会返回要保留的自动增量检查点数目。
目标对象
无
必需参数
无
可选参数
无
用法示例
print AdminTask.getAutoCheckpointDepth()
getAutoCheckpointEnabled
使用 getAutoCheckpointEnabled 命令来了解是否已启用自动创建增量检查点的功能。如果已启用自动检查点,那么命令会返回 true;如果已禁用自动检查点,那么会返回 false。
目标对象
无
必需参数
无
可选参数
无
用法示例
print AdminTask.getAutoCheckpointEnabled()
getCheckpointLocation
使用 getCheckpointLocation 命令来获取存储检查点的目录路径。该命令会返回目录路径。产品会将检查点存储在 profile_root/checkpoints 目录中。
目标对象
无
必需参数
无
可选参数
无
用法示例
print AdminTask.getCheckpointLocation()
getConfigRepositoryLocation
使用 getConfigRepositoryLocation 命令来获取存储配置库的目录路径。该命令会返回目录路径。产品会将配置库存储在 profile_root/config 目录中。
目标对象
无
必需参数
无
可选参数
无
用法示例
print AdminTask.getConfigRepositoryLocation()
listCheckpoints
使用 listCheckpoints 命令来获取现有检查点的列表。
目标对象
无
必需参数
无
可选参数
无
用法示例
print AdminTask.listCheckpoints()
示例输出
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
使用 listCheckpointDocuments 命令来获取检查点存储库中文档的列表。提供 -checkpointName 值来确定从其获取文档列表的检查点。
目标对象
无
必需参数
- -checkpointName
- 指定要在其中搜索文档列表的检查点的名称。(字符串,必需)
可选参数
无
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.listCheckpointDocuments('[-checkpointName Delta-132]')
- 使用 Jython 列表:
AdminTask.listCheckpointDocuments(['-checkpointName', 'Delta-132'])
交互方式示例用法
- 使用 Jython:
AdminTask.listCheckpointDocuments('[-interactive]')
示例输出
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
使用 restoreCheckpoint 命令来将配置库复原回建立检查点时所处的状态。提供 -checkpointName 值来确定要复原的完整或增量检查点。
通过使用完整检查点,可以使整个配置库复原为创建完整检查点时它所处的状态。

复原检查点时,如果在工作空间中有未落实的更改,会出现保存冲突。虽然会复原检查点,但是当您尝试保存未落实的更改时,会将其标志为保存冲突。此外,当多个用户处理对存储库的配置更改时,只要其中一个用户执行了检查点复原,那么具有未落实更改的其他用户也会出现保存冲突。
目标对象
无
必需参数
- -checkpointName
- 指定要复原的检查点的名称。(字符串,必需)
可选参数
无
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.restoreCheckpoint('[-checkpointName Delta-132]')
- 使用 Jython 列表:
AdminTask.restoreCheckpoint(['-checkpointName', 'Delta-132'])
交互方式示例用法
- 使用 Jython:
AdminTask.restoreCheckpoint('[-interactive]')
setAutoCheckpointDepth
使用 setAutoCheckpointDepth 命令来指定要保留的增量检查点数目。如果保存的增量检查点数目超过了所指定检查点深度,那么产品会删除最旧的增量检查点,从而保持不超过所指定检查点深度。
目标对象
无
必需参数
- -autoCheckpointDepth
- 指定要保留的自动增量检查点数目。(整数,必需)
可选参数
无
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.setAutoCheckpointDepth('[-autoCheckpointDepth 5]')
- 使用 Jython 列表:
AdminTask.setAutoCheckpointDepth(['-autoCheckpointDepth', '5'])
交互方式示例用法
- 使用 Jython:
AdminTask.setAutoCheckpointDepth('[-interactive]')
setAutoCheckpointEnabled
使用 setAutoCheckpointEnabled 命令来启用或禁用自动增量检查点。如果启用了自动存储库检查点,那么只要对配置库进行更改,产品就会创建增量检查点。增量检查点压缩文件包含已更改配置文件的更改前和更改后版本。可以对压缩文件的内容进行解压缩,然后检查所解压缩的文件来确定配置中所作的更改。
运行 setAutoCheckpointEnabled 后,不需要重新启动服务器也可以使设置更改生效。
目标对象
无
必需参数
- -autoCheckpointEnabled
- 指定是否要在配置更改之前自动将产品配置保存到存储库检查点。true 值会启用自动检查点。false 值(缺省值)会禁用自动检查点。(布尔值,必需)
可选参数
无
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.setAutoCheckpointEnabled('[-autoCheckpointEnabled true]')
- 使用 Jython 列表:
AdminTask.setAutoCheckpointEnabled(['-autoCheckpointEnabled', 'true'])
交互方式示例用法
- 使用 Jython:
AdminTask.setAutoCheckpointEnabled('[-interactive]')
setCheckpointLocation
使用 setCheckpointLocation 命令来设置存储检查点的目录路径。缺省情况下,产品会将检查点存储在 profile_root/checkpoints 目录中。
目标对象
无
必需参数
- -checkpointLocation
- 指定存储检查点的目录路径。(字符串,必需)
可选参数
无
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.setCheckpointLocation('[-checkpointLocation ${USER_INSTALL_ROOT}/checkpoints/temp]')
- 使用 Jython 列表:
AdminTask.setCheckpointLocation(['-checkpointLocation', '${USER_INSTALL_ROOT}/checkpoints/temp'])
交互方式示例用法
- 使用 Jython:
AdminTask.setCheckpointLocation('[-interactive]')