使用 wsadmin 脚本编制的 AdminTask 对象的 RepositoryCheckpointCommands 命令组

可以将 Jython 或 Jacl 脚本语言与 wsadmin 工具一起使用来创建、复原、删除和管理检查点。存储库检查点表示在更改配置之前已保存的存储库图像。RepositoryCheckpointCommands 组中的命令以 wsadmin 本地方式和已连接方式支持存储库检查点功能。

可以配置检查点以备份主配置库文件的副本。完整检查点是整个配置库的完整副本。增量检查点是配置库的子集快照,当您更改产品配置时将制作此检查点。使用检查点可以将配置库恢复到较早的状态。

要启用自动检查点,请使用 setAutoCheckpointEnabled 命令并将 -autoCheckpointEnabled 设置为 true。每当更改配置库时,产品就会创建增量检查点。运行命令后,不需要重新启动服务器。启用自动检查点功能后,如果更改了任何配置并将更改保存到配置库,那么产品会自动在 profile_root/checkpoints 目录中创建增量检查点。产品会将配置库存储在 profile_root/config 目录中。创建应用程序服务器及保存配置更改等操作会导致创建增量检查点。在作出配置更改之前,检查点会保留存储库的映像。

运行用来更改配置库的命令后,产品会自动地保存配置更改。运行 createFullCheckpointdeleteCheckpointrestoreCheckpointsetAutoCheckpointDepthsetAutoCheckpointEnabledsetCheckpointLocation 等命令后,不需要运行 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 字符串:
    [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]')
  • 使用 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'])

交互方式示例用法

  • 使用 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 值来确定要复原的完整或增量检查点。

通过使用完整检查点,可以使整个配置库复原为创建完整检查点时它所处的状态。

通过使用增量检查点,可以撤销最近进行的更改。请仅按创建增量检查点的相反顺序来复原增量检查点。每个增量检查点都有一个序号。最大的序号表示最近的增量检查点。因此,只能按创建增量检查点的相反顺序来恢复增量检查点。
注: 通过增量检查点复原配置库后,产品会创建一个包含复原前的配置的检查点。
避免故障 避免故障: 如果要复原的增量检查点是最早保存的检查点,那么可能需要增加增量检查点的数目。运行 getAutoCheckpointDepth 命令以了解产品所保留的增量检查点数目。达到增量检查点数目后,产品在每次生成新增量检查点时会删除最早的增量检查点。要增加所保存增量检查点的数目,请使用 setAutoCheckpointDepth 命令。gotcha

复原检查点时,如果在工作空间中有未落实的更改,会出现保存冲突。虽然会复原检查点,但是当您尝试保存未落实的更改时,会将其标志为保存冲突。此外,当多个用户处理对存储库的配置更改时,只要其中一个用户执行了检查点复原,那么具有未落实更改的其他用户也会出现保存冲突。

目标对象

必需参数

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

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_checkpoint_repository
文件名:rxml_checkpoint_repository.html