使用 wsadmin 脚本编制的 AdminTask 对象的 ConfigArchiveOperations 命令组
可以使用 Jython 或 Jacl 脚本编制语言来配置环境中的服务器。ConfigArchiveOperations 组中的命令和参数可用于导出或导入服务器配置和整个单元配置。
exportProxyProfile
使用 exportProxyProfile 命令来将安全代理服务器的整个单元配置导出到配置归档。exportProxyProfile 命令在分布式操作系统与 z/OS® 操作系统之间不起作用。
目标对象
无。
必需参数
- -archive
- 指定导出的配置归档的标准文件路径。(字符串,必需)
返回值
此命令不会返回输出。
批处理方式示例用法
使用 Jython 字符串:
AdminTask.exportProxyProfile('[-archive "c:/myCell.car"]')
使用 Jython 字符串:
AdminTask.exportProxyProfile('-archive c:/myCell.car')
使用 Jython 列表:
AdminTask.exportProxyProfile(['-archive', 'c:/myCell.car'])
使用 Jython 列表:
AdminTask.exportProxyProfile(['-archive', 'c:/myCell.car'])
交互方式示例用法
- 使用 Jython:
AdminTask.exportProxyProfile('-interactive')
exportProxyServer
使用 exportProxyServer 命令来将安全代理服务器配置导出到配置归档中定义的节点。该命令导出服务器所在的节点的元数据文件。可以稍后在导入配置归档时使用此信息以验证目标节点是否与您正在导出服务器的节点兼容。
exportProxyServer 命令虚拟化服务器配置并将服务器导出到配置归档。此进程中断配置归档中的服务器配置和系统中的配置之间的任何现有关联。
目标对象
无必需参数
- -archive
- 指定导出的配置归档的标准路径。(字符串,必需)
- -serverName
- 指定安全代理服务器名称。(字符串,必需)
可选参数
- -nodeName
- 指定安全代理服务器的节点名。仅当安全代理服务器名称在整个单元上不是唯一名称时才需要此参数。(字符串,可选)
返回值
此命令不会返回输出。
示例
批处理方式示例用法:
- 使用 Jython 字符串:
AdminTask.exportProxyServer('[-archive c:/myProxyServer.car -nodeName node1 -serverName server1]')
- 使用 Jython 列表:
AdminTask.exportProxyServer(['-archive', 'c:/myProxyServer.car', '-nodeName', 'node1', '-serverName', 'server1'])
- 使用 Jython 字符串:
AdminTask.exportProxyServer('[-archive /myProxyServer.car -nodeName node1 -serverName server1]')
- 使用 Jython 列表:
AdminTask.exportProxyServer(['-archive', '/myProxyServer.car', '-nodeName', 'node1', '-serverName', 'server1'])
交互方式示例用法:
- 使用 Jython:
AdminTask.exportServer ('-interactive')
exportServer
使用 exportServer 命令来将服务器配置导出到配置归档中定义的节点。使用 exportProxyServer 命令来导出代理服务器配置。
exportServer 命令虚拟化服务器配置并将服务器导出到配置归档。 此进程中断配置归档中的服务器配置和系统中的配置之间的任何现有关联。此进程还从您指定的服务器除去应用程序,中断您指定的服务器和服务器的核心组、集群或服务集成总线成员之间的关系。
exportServer 命令用于导出服务器所在的节点的元数据文件。可以稍后在导入配置归档时使用此信息以验证目标节点是否与您正在导出服务器的节点兼容。
目标对象
无参数和返回值
- -archive
- 指定导出的配置归档的标准路径。(字符串,必需)
- -nodeName
- 指定服务器的节点名。仅当整个单元的服务器名不是唯一的名称时才需要此参数。(字符串,可选)
- -serverName
- 指定服务器名。(字符串,必需)
示例
批处理方式示例用法:
- 使用 Jacl:
$AdminTask exportServer {-archive c:/myServer.car -nodeName node1 -serverName server1}
- 使用 Jython 字符串:
AdminTask.exportServer('[-archive c:/myServer.car -nodeName node1 -serverName server1]')
- 使用 Jython 列表:
AdminTask.exportServer(['-archive', 'c:/myServer.car', '-nodeName', 'node1', '-serverName', 'server1'])
交互方式示例用法:
- 使用 Jacl:
$AdminTask exportServer {-interactive}
- 使用 Jython 字符串:
AdminTask.exportServer ('[-interactive]')
- 使用 Jython 列表:
AdminTask.exportServer (['-interactive'])
exportWasprofile
目标对象
无参数和返回值
- -archive
- 指定导出的配置归档的标准文件路径。(字符串,必需)
示例
批处理方式示例用法:- 使用 Jacl:
$AdminTask exportWasprofile {-archive c:/myCell.car}
- 使用 Jython 字符串:
AdminTask.exportWasprofile('[-archive c:/myCell.car]')
- 使用 Jython 列表:
AdminTask.exportWasprofile(['-archive', 'c:/myCell.car'])
- 使用 Jacl:
$AdminTask exportWasprofile {-interactive}
- 使用 Jython 字符串:
AdminTask.exportWasprofile ('[-interactive]')
- 使用 Jython 列表:
AdminTask.exportWasprofile (['-interactive'])
importApplicationsFromWasprofile
此脚本将所指定应用程序服务器的 Java EE 应用程序从 AdminTask exportWasprofile 命令生成的配置归档文件(.car文件)导入到目标单元配置。
如果要导入依赖于共享库的 Java EE 应用程序,那么共享库必须已配置并且位于目标节点上,然后所导入的应用程序才可以成功启动。不能导入已部署到特定目标单元的 Java EE 应用程序。
目标对象
无。
参数和返回值
- -archive
- 指定配置归档的标准文件路径。(字符串,必需)
- -targetNodeName
- 指定将从中导入应用程序的目标应用程序服务器的节点名。所指定的节点必须存在于目标系统中。如果指定了 targetClusterName 参数的值,那么请不要指定此参数。(字符串,如果未指定 targetClusterName 参数,那么需要指定此参数)
- -targetServerName
- 指定应用程序将导入到的目标应用程序服务器的名称。所指定的服务器必须存在于目标系统中。如果指定了 targetClusterName 参数的值,那么请不要指定此参数。(字符串,如果未指定 targetClusterName 参数,那么需要指定此参数)
- -targetClusterName
- 指定应用程序将导入到的目标集群的名称。所指定的集群必须存在于目标系统中。如果指定了 targetNodeName 和 targetServerName 参数的值,那么请不要指定此参数。(字符串,如果未指定 targetNodeName 和 targetServerName 参数,那么需要指定此参数)
- -sourceServerName
- 指定将从中导入应用程序的源服务器的名称。所指定的服务器必须存在于配置归档文件中。在下列情况下此参数是必需参数。要么
- 配置归档文件中存在多个服务器并且源服务器和目标服务器的名称不同,要么
- 指定了 targetClusterName 参数。
(字符串,可选)
样本输出
此命令不会返回输出。
示例
批处理方式示例用法:
- 使用 Jacl:
$AdminTask importApplicationsFromWasprofile {-archive c:/myCell.car -targetNodeName myNodeName -targetServerName myServerName -sourceServerName mySourceServerName}
$AdminTask importApplicationsFromWasprofile {-archive c:/myCell.car -targetClusterName myClusterName -sourceServerName mySourceServerName}
- 使用 Jython 字符串:
AdminTask.importApplicationsFromWasprofile('[-archive c:/myCell.car -targetNodeName myNodeName -targetServerName myServerName -sourceServerName mySourceServerName]')
AdminTask.importApplicationsFromWasprofile('[-archive c:/myCell.car -targetClusterName myClusterName -sourceServerName mySourceServerName]')
- 使用 Jython 列表:
AdminTask.importApplicationsFromWasprofile(['-archive', 'c:/myCell.car', '-targetNodeName', 'myNodeName', '-targetServerName', 'myServerName', '-sourceServerName', 'mySourceServerName'])
AdminTask.importApplicationsFromWasprofile(['-archive', 'c:/myCell.car', '-targetClusterName', 'myClusterName', '-sourceServerName', 'mySourceServerName'])
交互方式示例用法:
- 使用 Jacl:
$AdminTask importApplicationsFromWasprofile {-interactive}
- 使用 Jython 字符串:
AdminTask.importApplicationsFromWasprofile ('[-interactive]')
- 使用 Jython 列表:
AdminTask.importApplicationsFromWasprofile (['-interactive'])
importProxyProfile
importProxyProfile 命令用于将配置归档中的单元配置导入到系统中。仅基本单服务器配置支持此命令。importProxyProfile 命令在分布式平台与 z/OS 平台之间不起作用。
目标对象
无。
必需参数
- -archive
- 指定导出的配置归档的标准文件路径。(字符串,必需)
可选参数
- -deleteExistingServers
- 指定是否将概要文件中的现有安全代理服务器替换为已导入的代理概要文件中的服务器。指定 true 以覆盖现有服务器。(布尔值,可选)
返回值
此命令不会返回输出。
批处理方式示例用法
使用 Jython 字符串:
AdminTask.importProxyProfile('-archive c:/myCell.car -deleteExistingServers true')
使用 Jython 字符串:
AdminTask.importProxyProfile('-archive /myCell.car -deleteExistingServers true')
使用 Jython 列表:
AdminTask.importProxyProfile('-archive', 'c:/myCell.car', '-deleteExistingServers', 'true')
使用 Jython 列表:
AdminTask.importProxyProfile('-archive', '/myCell.car', '-deleteExistingServers', 'true')
交互方式示例用法
- 使用 Jython:
AdminTask.importProxyProfile('-interactive')
importProxyServer
importProxyServer 命令用于将位于配置归档中的安全代理服务器导入到系统中。此命令将在配置归档中定义的所有服务器作用域配置都导入到系统配置。
目标对象
无必需参数
- -archive
- 指定要导入的配置归档的标准路径。(字符串,必需)
可选参数
- -nodeInArchive
- 指定配置归档中定义的服务器的节点名。如果配置归档中存在多个节点,那么请为此参数指定值。(字符串,可选)
- -serverInArchive
- 指定配置归档中定义的安全代理服务器的名称。如果归档中存在多个安全代理服务器,那么请为此参数指定值。(字符串,可选)
- -deleteExistingServer
- 如果现有服务器与要导入的服务器具有相同名称,那么请指定是否对其进行删除和替换。将此命令的值设置为 true 以覆盖具有相同名称的现有服务器。(字符串,可选)
- -nodeName
- 指定将安全代理服务器导入到其中的节点的名称。仅当安全代理服务器名称在整个单元上不是唯一名称时才需要此参数。(字符串,可选)
- -serverName
- 指定安全代理服务器名称。如果您指定的服务器名与节点下的现有服务器名相同,那么会产生异常。(字符串,可选)
- -coreGroup
- 指定安全代理服务器所属的核心组的名称。(字符串,可选)
返回值
此命令不会返回输出。
示例
批处理方式示例用法:
- 使用 Jython 字符串:
AdminTask.importProxyServer('[-archive c:/myProxyServer.car -nodeName node1 -serverInArchive server1 -deleteExistingServer true]')
- 使用 Jython 列表:
AdminTask.importProxyServer(['-archive', 'c:/myProxyServer.car', '-nodeName', 'node1', '-serverInArchive', 'server1', '-deleteExistingServer', 'true'])
- 使用 Jython 字符串:
AdminTask.importProxyServer('[-archive /myProxyServer.car -nodeName node1 -serverInArchive server1 -deleteExistingServer true]')
- 使用 Jython 列表:
AdminTask.importProxyServer(['-archive', '/myProxyServer.car', '-nodeName', 'node1', '-serverInArchive', 'server1', 'server1', '-deleteExistingServer', 'true'])
交互方式示例用法:
- 使用 Jython:
AdminTask.importProxyServer('-interactive')
importServer
importServer 命令用于将位于配置归档中的服务器导入到系统中。此命令将在配置归档中定义的所有服务器作用域配置都导入到系统配置。importProxyServer 命令用于导入安全代理服务器配置。
目标对象
无参数和返回值
- -archive
- 指定配置归档的标准路径。(字符串,必需)
- -nodeInArchive
- 指定配置归档中定义的服务器的节点名。(字符串,如果配置归档中仅定义了一个节点则是可选的,如果在配置归档中定义了多个节点则是必需的)
- -serverInArchive
- 指定配置归档中定义的服务器的名称。(字符串,如果指定的 nodeInConfiguration 归档中仅定义了一个服务器,那么此参数是可选参数;如果指定的 nodeInConfiguration 归档中定义了多个服务器,那么此参数为必需参数)
- -nodeName
- 指定将服务器导入到其中的节点的名称。(字符串,如果仅有一个节点则是可选的)
- -serverName
- 指定将服务器导入到其中的服务器的名称。如果您指定的服务器名与节点下的现有服务器名相同,那么会产生异常。(字符串,可选参数,缺省值:serverInArchive)
- -coreGroup
- 指定服务器应该所属的核心组的名称。(字符串,可选)
示例
批处理方式示例用法:
- 使用 Jacl:
$AdminTask importServer {-archive c:/myServer.car -nodeInArchive node1 -serverInArchive server1}
- 使用 Jython 字符串:
AdminTask.importServer('[-archive c:/myServer.car -nodeInArchive node1 -serverInArchive server1]')
- 使用 Jython 列表:
AdminTask.importServer(['-archive', 'c:/myServer.car', '-nodeInArchive', 'node1', '-serverInArchive', 'server1'])
交互方式示例用法:
- 使用 Jacl:
$AdminTask importServer {-interactive}
- 使用 Jython 字符串:
AdminTask.importServer ('[-interactive]')
- 使用 Jython 列表:
AdminTask.importServer (['-interactive'])
importWasprofile
importWasprofile 命令用于将配置归档中的单元配置导入到系统中。此命令仅支持带有单个节点的服务器基本部件配置。importProxyProfile 命令用于导入安全代理服务器概要文件。
importWasprofile 命令在分布式操作系统与 z/OS 操作系统之间不起作用。
目标对象
无参数和返回值
- -archive
- 指定配置归档的标准文件路径。(字符串,必需)
- -deleteExistingServers
- 如果设置为 true,则表示从目标概要文件中除去现有服务器并将配置归档导入到目标概要文件中。(布尔值,可选)
缺省值为 false,这表示不要替换服务器。
示例
- 使用 Jacl:
$AdminTask importWasprofile {-archive c:/myCell.car}
$AdminTask importWasprofile { -archive profile.car -deleteExistingServers true}
- 使用 Jython 字符串:
AdminTask.importWasprofile('[-archive c:/myCell.car]')
AdminTask.importWasprofile('[-archive profile.car -deleteExistingServers true]')
- 使用 Jython 列表:
AdminTask.importWasprofile(['-archive', 'c:/myCell.car'])
AdminTask.importWasprofile(['-archive', 'profile.car', '-deleteExistingServers', true])
- 使用 Jacl:
$AdminTask importWasprofile {-interactive}
- 使用 Jython 字符串:
AdminTask.importWasprofile ('[-interactive]')
- 使用 Jython 列表:
AdminTask.importWasprofile (['-interactive'])