![[IBM i]](../images/iseries.gif)
chgwassvr 命令
chgwassvr 命令允许您更改概要文件中应用程序服务器的端口。
有关用法指示信息和示例,请参阅“更改应用程序服务器属性”主题。要运行此脚本,用户概要文件必须具有 *ALLOBJ 权限。
从 Network Deployment 概要文件中,使用 chgwassvr 命令来修改由单元的 Deployment Manager 管理的服务器的端口值。使用 -profileName 参数可以指定受影响的 Deployment Manager 概要文件。当您修改受管服务器的端口时,您必须使用 -node 参数来指定受管节点的节点名,该受管节点包含您要修改的服务器。当 Deployment Manager 和节点之间的下一次同步发生时,将更新服务器的配置文档。您也可以使用 syncNode 命令使配置同步。有关更多信息,请参阅syncNode 命令主题。可以从节点的 WebSphere® Application Server Base 运行 syncNode 命令。
也可使用管理控制台来创建和管理应用程序服务器。请参阅管理应用程序服务器主题以了解更多信息。
语法
命令语法如下所示:
chgwassvr -server servername
[instance instancename] [-profileName instancename]
[-node nodename] [-portblock portnumber]
[-transport -oldport oldvalue -newport newvalue]
[-endpoint endpointname -port newvalue]
[-inthttp inthttpport]
[-inthttpssl inthttpsslport] [-admin adminport]
[-adminssl adminsslport] [-soap soapport]
[-nameservice nameserviceport]
[-celldiscovery celldiscoveryport]
[-sas sasserverport] [-csiv2server csiv2serverauthport]
[-csiv2client csiv2clientauthport] [-nodediscovery nodediscport]
[-nodemulti nodemultdiscport] [-verbose] [-help | -?]
参数
以下选项可用于 chgwassvr 命令:
- -server
- 这是一个必需参数。值 servername 指定要更改的服务器的名称。对于缺省 WebSphere Application Server 概要文件,缺省服务器名称为 server1。对于缺省 Network Deployment 概要文件,缺省服务器名是 dmgr。此参数的值区分大小写且必须与服务器名完全匹配。您可以使用 dspwasinst 命令查看与概要文件相关联的服务器。有关更多信息,请参阅dspwasinst 命令主题。
- -profileName
- 这是一个可选参数。值 profile 指定概要文件的名称,该概要文件包含要更改的应用程序服务器。缺省值为 default。
- -node
- 这是一个可选参数。值 nodename 指定主管您要更改的应用程序服务器的节点。缺省值为管理概要文件的 Network Deployment。
- -portblock
- 这是一个可选参数。值 portblock 指定概要文件使用的端口号块的第一个号码。如果您指定此参数,那么脚本更改应用程序服务器的所有端口号。如果您不指定此参数,那么除非您指定要更改的端口参数(请参阅下面的端口参数),否则应用程序服务器的端口号不会更改。您可以使用“使用 TCP/IP 网络状态”(NETSTAT
*CNN) 命令来显示当前正在使用的端口号列表。
- WebSphere Application Server 概要文件将多个端口用于不同功能。当您更改应用程序服务器的属性时,将根据以下排序的条件分配端口:
- 特定端口参数
- 如果指定特定端口参数的值,那么脚本将使用这些值。特定端口参数为 -inthttp(基本应用程序服务器)、-admin、-jmsqueued(基本应用程序服务器)、-jmsdirect(基本应用程序服务器)、-jmssecure(基本应用程序服务器)、-soap、-orblistener (Network Deployment)、-nameservice、-drsclient 和 -celldiscovery (Network Deployment)。
- -portblock 参数
- 将从 -portblock 参数的值开始,为尚未指定端口号的服务分配连续的端口。如果脚本遇到正在使用的端口,那么它跳过该端口号并继续分配下一个未使用的端口。
- 当前值
- 如果未指定 -portblock,那么尚未指定端口参数的所有服务都将保留它们的当前值。
- 对于 -portblock 参数,脚本仅检查 WebSphere Application Server 的所有概要文件的主索引。脚本无法检测其他应用程序(包括 WebSphere Application Server 的先前版本)对端口的使用情况。
- WebSphere Application Server 概要文件将多个端口用于不同功能。当您更改应用程序服务器的属性时,将根据以下排序的条件分配端口:
- -transport
- 这是一个可选参数集。值 oldvalue 指定您要更改的 Web 容器传输端口号。值 newvalue 指定您要分配给 Web 容器传输的新端口号。如果在虚拟主机的主机别名中也指定了 Web 容器传输,那么还将更新主机别名的端口。
请使用 -transport 参数集代替 -admin、-adminssl、-inthttp 或 -inthttpssl 参数。不推荐使用这些参数。
- -endpoint
- 这是一个可选参数。值 endpointname 指定要修改的端点端口名称。值 newvalue 指定要将端点的端口设置为的端口号。
- -inthttp
- 这是一个可选参数。值 inthttpport 指定 Web 容器侦听来自 Web 服务器的请求时使用的端口号。如果 -portblock 参数和 -inthttp 参数都未指定,那么不会更改此端口。请参阅 -portblock 参数以了解更多信息。
- -inthttpssl
- 这是一个可选参数。值 inthttpsslport 指定应用程序服务器用于与内部 HTTP Server 进行安全通信的端口号。如果 -portblock 参数和 -inthttpssl 参数都未指定,那么不会更改此端口。请参阅 -portblock 参数以了解更多信息。
- -admin
- 这是一个可选参数。值 adminport 指定将用于管理控制台的端口号。如果 -portblock 参数和 -admin 参数都未指定,那么不会更改此端口。请参阅 -portblock 参数以了解更多信息。
- -adminssl
- 这是一个可选参数。值 adminportssl 指定将用于通过管理控制台进行安全通信的端口号。如果 -portblock 参数和 -adminssl 参数都未指定,那么不会更改此端口。请参阅 -portblock 参数以了解更多信息。
- -soap
- 这是一个可选参数。值 soapport 指定将用于 SOAP 的端口号。如果 -portblock 参数和 -soap 参数都未指定,那么不会更改此端口。请参阅 -portblock 参数以了解更多信息。
- -nameservice
- 这是一个可选参数。值 nameserviceport 指定将用于名称服务(或 RMI 连接器)端口的端口号。如果 -portblock 参数和 -nameservice 参数都未指定,那么不会更改此端口。请参阅 -portblock 参数以了解更多信息。
- -celldiscovery
- 这是一个可选参数。值 celldiscoveryport 指定 Network Deployment 概要文件侦听节点以尝试查找该节点所属的单元而使用的端口。如果 -portblock 参数和 -celldiscovery 参数都未指定,那么不会更改此端口。请参阅 -portblock 参数以了解更多信息。
- -sas
- 这是一个可选参数。值 sasserverport 指定安全关联服务 (SAS) 侦听入站认证请求所使用的端口。如果未指定 -sas 参数,那么不会更改此端口。此端口由 serverindex.xml 中的 SAS_SSL_SERVERAUTH_LISTENER_ADDRESS 属性指定。
- -csiv2server
- 这是一个可选参数。值 csiv2serverauthport 指定公共安全互操作性 V2 (CSIv2) 服务侦听入站服务器认证请求所使用的端口。如果未指定 -csiv2server 参数,那么不会更改此端口。此端口由 serverindex.xml 中的 CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS 属性指定。
- -csiv2client
- 这是一个可选参数。值 csiv2clientauthport 指定公共安全互操作性 V2 (CSIv2) 服务侦听入站客户机认证请求所使用的端口。如果未指定 -csiv2client 参数,那么不会更改此端口。此端口由 serverindex.xml 中的 CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS 属性指定。
- -nodediscovery
- 这是一个可选参数。值 nodediscport 指定 Node Agent 发现服务的节点进行侦听所使用的端口。
- -nodemulti
- 这是一个可选参数。值 nodemultidiscport 指定 Node Agent 的多点广播发现服务进行侦听所使用的端口。
- -verbose
- 此可选参数打开详细消息,如果您需要调试脚本,那么这些消息很有用。
- -help
- 此可选参数显示帮助消息。如果您指定此参数,那么脚本忽略所有其他参数。