AdminTask 对象的实用程序命令组

可使用 Jython 或 Jacl 脚本编制语言以通过 wsadmin 工具管理服务器。Utility 组中的命令和参数可用于更改节点的主机名、查询 Deployment Manager 的名称以及确定系统是单服务器还是 Network Deployment。

AdminTask 对象的实用程序命令组包括以下命令:

changeHostName

使用 changeHostName 命令更改节点的主机名。

目标对象

参数和返回值

-hostName
新的主机名。(字符串,必需)
-nodeName
将更改其主机名的节点的名称。(字符串,必需)

可选参数:

-systemName
此节点将在其上运行的 z/OS 系统的名称。仅在将节点从一个系统移到另一系统(例如,从系统 SYSA 到系统 SYSB)时才需要填写此字段。如果您不确定应该为此参数指定的值,请在 z/OS 系统上发出 IPLINFO 命令,并将在 Sysname= 字段中显示的名称用作此参数的值。
注: 以交互方式运行 changeHostName 命令时,将显示 systemName 参数,但是仅用于 z/OS 系统。systemName 参数表示 server.xml 文件中定义的 z/OS 系统名(作为属性 was.ConfiguredSystemName 的值)。如果选择了 systemName 参数,那么此属性将更改。
-regenDefaultCert
请求重新生成缺省证书。如果您要重新生成缺省证书,此参数的唯一有效值为“true”。 其他任何值假设不重新生成缺省证书。将字符串参数作为布尔值处理。如果字符串参数非空且等于字符串“true”(忽略大小写),那么返回的布尔值表示值 true。regenDefaultCert 参数操作类似 AdminTask.createChainedCertificate 且具有以下缺省值:
  • -keyStoreName "NodeDefaultKeyStore"
  • -keyStoreScope "(node):" + nodeName
  • -certificateAlias" "default_" + hostName
  • -certificateCommonName" nodeName
  • -certificateOrganization" "IBM"
  • -certificateOrganizationalUnit" nodeName
  • -certificateCountry "US"
注: 对于 AdminTask.createChainedCertificateregenDefaultCert 参数,如果使用 Deployment Manager 节点,那么 -keyStoreName 值更改为 -keyStoreName "CellDefaultKeyStore",-keyStoreScope value 值更改为 -keyStoreScope "(cell):" + cellname。

开关是一个便捷开关,它对证书参数的缺省值进行假设。如果没有使用缺省值,那么应该使用 AdminTask.createChainedCertificateregenDefaultCert

请了解下列功能详细信息:
  • keyStoreName 和 keyStoreScope 对于 regenDefaultCert 参数无效。
  • 当您运行 changeHostName 命令时,无法指定 certificateCommonName(新证书的 CN)。要将新的主机名指定为 CN,需要使用 AdminTask.createChainedCertificate

示例

批处理方式示例用法:

  • 使用 Jacl:

    $AdminTask changeHostName {-hostName host_name -nodeName node_name 
    -systemName system_name}
  • 使用 Jython 字符串:

    AdminTask.changeHostName('-hostName host_name -nodeName node_name 
    -systemName system_name')
  • 使用 Jython 列表:

    AdminTask.changeHostName(['-hostName', 'host_name', '-nodeName', 'node_name',
    '-systemName', 'system_name'])

交互方式示例用法:

  • 使用 Jacl:

    $AdminTask changeHostName {-interactive}
  • 使用 Jython 字符串:

    AdminTask.changeHostName ('[-interactive]')
  • 使用 Jython 列表:

    AdminTask.changeHostName (['-interactive'])

getDmgrProperties

使用 getDmgrProperties 命令来返回 Deployment Manager 的名称。

目标对象

参数和返回值

  • 参数:无
  • 返回:Network Deployment 系统中 Deployment Manager 的名称。如果系统是单个服务器,那么返回空字符串。

示例

批处理方式示例用法:

  • 使用 Jacl:

    $AdminTask getDmgrProperties {}
  • 使用 Jython:

    AdminTask.getDmgrProperties()

isFederated

isFederated 命令用于检查系统是单个服务器还是 network deployment。

目标对象

参数和返回值

  • 参数:无
  • 返回:布尔值。如果系统是 network deployment 系统则返回 true。否则它返回 false

示例

批处理方式示例用法:

  • 使用 Jacl:
    $AdminTask isFederated {}
  • 使用 Jython 字符串:
    AdminTask.isFederated ()

renameCell

新功能部件 新功能部件:
使用 renameCell 命令来更改独立应用程序服务器、Deployment Manager、管理代理程序、作业管理器及联合节点概要文件的单元名。此命令只能在 wsadmin 本地方式(即 wsadmin -conntype none)下运行。newfeat
避免故障 避免故障: 不要在混合单元环境(在此环境中,一个单元包含安装有不同 WebSphere Application Server 版本的若干节点)中使用 renameCell 命令。gotcha

目标对象

参数和返回值

-newCellName
新单元名。(字符串,必需)
-dmgr_host
Deployment Manager 计算机的主机或 IP 地址的名称。(字符串,如果该命令在联合节点上运行,那么需要指定此参数)
-dmgr_port
Java 管理扩展 (JMX) 连接端口。(字符串,如果该命令在联合节点上运行,那么需要指定此参数。如果未指定,那么将使用缺省值“8879”)
-connType
要用于连接至 Deployment Manager 的 JMX 连接器类型。SOAP 是此命令的缺省 JMX 连接器类型。其他有效类型是 JSR160RMI 或远程方法调用 (RMI)。(字符串,如果该命令在联合节点上运行,那么需要指定此参数。如果未指定,那么将使用缺省值“SOAP”)
-userName
指定启用安全性后用于认证的用户名。(字符串,如果该命令在联合节点上运行并且已启用安全性,那么需要指定此参数)
-password
指定启用安全性后用于认证的密码。(字符串,如果该命令在联合节点上运行并且已启用安全性,那么需要指定此参数)

可选参数:

-regenCerts
确定是否对单元的所有节点重新生成安全套接字层 (SSL) 证书。只会重新生成缺省密钥库的证书。此参数不适用于 z/OS 操作系统上的单元。请记住,重新生成证书可能导致客户机访问服务器以与服务器重新建立信任关系(通过获取新证书)。缺省值为 false。设置为 true 将对单元的节点重新生成 SSL 证书。(布尔值,可选)
-updateJaccContextID
确定是否更新 Java Authorization Contract for Containers (JACC) 提供程序使用的应用程序的安全上下文标识。缺省值为 false。设置为 true 以更新安全上下文标识。(布尔值,可选)

批处理方式示例用法:

  • 使用 Jython 字符串:
    AdminTask.renameCell('-newCellName new_cell_name')
  • 使用 Jython 列表:
    AdminTask.renameCell(['-newCellName', 'new_cell_name'])

交互方式示例用法:

  • 使用 Jython 字符串:
    AdminTask.renameCell ('[-interactive]')
  • 使用 Jython 列表:
    AdminTask.renameCell (['-interactive'])

使用 renameCell 的示例方案

避免故障 避免故障: 使用 renameCell 命令对该节点更改单元名称之前,建议使用 backupConfig 工具从 profile_root/bin 目录备份节点配置。如果对 renameCell 命令结果不满意,并且 renameCell 命令执行意外失败,请使用 restoreConfig 工具复原备份配置。gotcha
避免故障 避免故障: 运行 renameCell 命令前,备份 profile_root/bin/setupCmdLine 脚本文件。此命令使用新单元名称来更新此文件中的单元名称,但是,如果用户决定废弃因为执行此命令而产生的配置更改,那么无法更改回来。如果决定这样做,那么您需要在废弃配置更改后复原该文件;否则您无法在此概要文件中启动服务器。gotcha
对独立应用程序服务器重命名单元:
  • 停止独立服务器。
  • 通过以本地方式使用 wsadmin 来重命名单元:
    AdminTask.renameCell('-newCellName new_cell_name')
对 Deployment Manager 及其联合节点重命名单元:

要对 Network Deployment 拓扑重命名单元,需要在 Deployment Manager 节点/概要文件及所有联合节点/概要文件上运行该命令。

避免故障 避免故障: 如果该单元包含在多单元拓扑中,请在执行这些步骤之前取消该单元与其他单元的链接,并在执行这些步骤之后再次进行链接。gotcha
  • 停止该单元中的所有服务器,包括 Deployment Manager 服务器、节点代理程序服务器和所有应用程序服务器。
  • 重命名 Deployment Manager 节点/概要文件的单元:以本地方式启动 wsadmin 并运行以下命令,这会导致单元名称及 dmgr 主存储库中的 SSL 证书发生更改。
    AdminTask.renameCell('[-newCellName new_cell_name]')
  • 对单元中的所有联合节点/概要文件运行重命名单元命令。
  • 启动 Deployment Manager 服务器。
  • 在每个节点代理程序的概要文件中,对于 Deployment Manager 节点以外的每个节点,以本地方式启动 wsadmin 并运行以下所示的命令:
    AdminTask.renameCell('[-newCellName new_cell_name –dmgr_host dmgr_hostname –dmgrPort dmgr_connector_port –connType SOAP –username my_user –password my_password]')
对管理代理服务器重命名单元:
  • 停止管理代理服务器。
  • 通过以本地方式使用 wsadmin 来重命名单元:
    AdminTask.renameCell('-newCellName new_cell_name')
注: 如果要对已向管理代理服务器注册的独立应用程序服务器重命名单元,那么需要先向该管理服务器注销该独立节点。如果希望该管理服务器继续管理该独立节点,那么在运行重命名单元命令后,您需要再次向管理服务器注册该节点。
对作业管理器服务器重命名单元:
  • 停止作业管理器服务器。
  • 通过以本地方式使用 wsadmin 来重命名单元:
    AdminTask.renameCell('-newCellName new_cell_name')
    避免故障 避免故障: 此项仅适用于独立作业管理器概要文件。不要对充当作业管理器的 Deployment Manager 使用此项。gotcha
在多单元拓扑中重命名单元:

要在多单元拓扑(例如,星型拓扑)中重命名单元,那么在重命名之前,必须将该单元与其他单元拆离。重命名该单元后,应将该单元连接回其他单元。


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



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