registerNode 命令
使用 registerNode 命令向管理代理程序注册独立节点,这样管理代理程序可以管理该节点。
从管理代理程序服务器的 bin 目录运行 registerNode 命令,以便向管理代理程序注册节点。运行此命令时,独立节点转换为管理代理程序管理的节点。
管理代理程序和所注册的节点必须在同一计算机上。
管理代理程序提供了单一界面,可用于在开发、单元测试或服务器场之类的环境中管理多个未联合的(独立)应用程序服务器节点。通过使用单一接口来管理应用程序服务器,可以降低在每个应用程序服务器中运行管理服务所产生的开销。
您可以使用管理代理程序的管理控制台来配置管理代理程序、查看和更改向管理代理程序注册的节点的属性、向作业管理器注册和注销应用程序服务器节点以及查看和更改已注册的节点的作业管理器配置。对于已向管理代理程序注册的节点,如果该节点还向作业管理器注册,那么作业管理器允许您以异步方式为该节点提交和管理作业。有关管理代理程序子系统的更多详细信息,请参阅 developerWorks 文章 Overview of administrative enhancements 中的 Administrative agent 部分。

您只能对未联合的节点运行此命令。如果对已联合的节点运行此命令,那么此命令会退出并返回错误。
运行 registerNode 命令时,命令将停止节点上所有运行的应用程序服务器。 运行 registerNode 命令之前,可以选择性地停止正在注册节点上的应用程序服务器。
如果所注册应用程序服务器的管理控制台或管理 Enterprise JavaBeans (EJB) 应用程序处于已启用状态,那么节点注册过程会将其禁用。
语法
registerNode 命令语法如下所示:
registerNode [options]
参数
以下选项可用于 registerNode 命令:
- -conntype<JSR160RMI|IPC|RMI|SOAP>
- 用来连接到管理代理程序以开始节点注册的可选连接符。缺省值为 SOAP。
不推荐使用的功能部件: 最后,应该将 RMI 连接符转换为 JSR160RMI 连接符,因为对 RMI 连接符的支持不是推荐的连接符。depfeat
- -host host_name
- 可选参数,指定管理代理程序主机名。
- -name managed_node_name
- 可选参数,指定向管理代理程序注册节点后,受管节点的名称。
- -nodepassword node_password
- 可选参数,指定要注册的节点密码。如果开启节点安全,那么指定此参数,且该密码不同于管理代理程序密码。和 -nodeusername 参数一起使用此参数。-nodeusername 和 -nodepassword 参数用来停止节点上的所有服务器。
- -nodeusername node_user_name
- 这是可选参数,指定要注册的节点的用户名。如果开启节点安全,那么指定此参数,且该用户名不同于管理代理程序用户名。和 -nodeuserpassword 参数一起使用此参数。-nodeusername 和 -nodepassword 参数用来停止节点上的所有服务器。
- -openConnectors connectors
- 可选参数,指定管理代理程序将要打开的连接符列表(连接符用逗号分开)。 缺省情况下,打开所有连接符。
- -port port_number
- 可选参数,指定管理代理程序连接符端口的端口号。
管理代理程序的缺省 SOAP 端口的缺省端口号为 8878。SOAP 是命令的缺省 Java™ 管理扩展 (JMX) 连接器类型。如果有多个产品安装或多个概要文件,那么 SOAP 端口可能不是 8878。请检查管理代理程序的 SystemOut.log 文件以查看当前使用的端口。
注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.log、SystemErr.log、trace.log 和 activity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用 HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。 - -profilePath profile_path
- 必需参数,指定要注册的应用程序服务器节点概要文件的路径。
- -trace
- 可选参数,提供 registerNode 命令的跟踪输出。
- -portsFile ports_file
- 可选参数,指定定义新近注册节点端口设置的文件路径。
节点注册期间,如果未指定 -portsFile 参数,那么 registerNode 命令将使用推荐端口自动生成的设置。根据缺省端口的可用性,建议的端口值可与缺省端口值不同。
指定的 ports_file 文件格式与 portdef.props 文件相同,除了它只使用以下端口:SOAP_CONNECTOR_ADDRESS、RMI_CONNECTOR_ADDRESS、JSR160RMI_CONNECTOR_ADDRESS 和 IPC_CONNECTOR_ADDRESS。
- -profileName profile_name
- 可选参数,指定管理代理程序概要文件名。
- -username username
- 可选参数,指定登录到管理代理程序的用户标识。
- -password password
- 可选参数,指定登录到管理代理程序的密码。
- -help
- 可选参数,打印用法语句。
- -?
- 可选参数,打印用法语句。
使用方案
以下示例说明了正确的语法。命令分为多行以便于打印。
![[z/OS]](../images/ngzos.gif)
registerNode.sh -conntype SOAP -port 8878
-profilePath app_server_root/profiles/default
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
registerNode.sh -conntype SOAP -port 8878
-profilePath app_server_root/profiles/AppSrv01
![[Windows]](../images/windows.gif)
registerNode.bat -conntype SOAP -port 8878
-profilePath app_server_root\profiles\AppSrv01
![[IBM i]](../images/iseries.gif)
registerNode -conntype SOAP -port 8878
-profilePath user_data_root/profiles/AppSrv01