The chgwassvr script

The chgwassvr script allows you to change properties of an application server within an instance. For usage instructions and examples, see Change application server properties.

Note: You can also use the administrative console to create and manage application servers. See Administer application servers for more information.

Product

The chgwassvr script is available in WebSphere Application Server and WebSphere Application Server Network Deployment.

Authority

To run this script, your user profile must have *ALLOBJ authority.

Syntax

The syntax of the script is:

• WebSphere Application Server

  chgwassvr -server servername [ -instance instance ]
   [ -embeddedjms yes|no ] [ -portblock portblock ]
   [ -transport -oldport oldvalue -newport newvalue ]
   [ -inthttp inthttpport ] [ -inthttpssl inthttpsslport ]
   [ -admin adminport ] [ -adminssl adminsslport ]
   [ -jmsqueued jmsqueuedport ] [ -jmsdirect jmsdirectport ]
   [ -jmssecure jmssecureport ] [ -soap soapport ]
   [ -nameservice nameserviceport ] [ -drsclient drsclientport ]
   [ -sas sasserverport ] [ -csiv2server csiv2serverauthport ]
   [ -csiv2client csiv2clientauthport ] [ -verbose ] [ -help ]

• WebSphere Application Server Network Deployment

  chgwassvr -server servername [ -instance instance ] [ -node nodename ]
   [ -portblock portblock ] [ -transport -oldport oldvalue -newport newvalue ]
   [ -inthttp inthttpport ] [ -inthttpssl inthttpsslport ] [ -admin adminport ]
   [ -adminssl adminsslport ] [ -jmsqueued jmsqueuedport ]
   [ -jmsdirect jmsdirectport ] [ -jmssecure jmssecureport ]
   [ -orblistener orblistenerport ] [ -soap soapport ]
   [ -orblistener orblistenerport ] [ -nameservice nameserviceport ]
   [ -drsclient drsclientport ] [ -celldiscovery celldiscoveryport ]
   [ -sas sasserverport ] [ -csiv2server csiv2serverauthport ]
   [ -csiv2client csiv2clientauthport ] [ -nodediscovery nodediscport ]
   [ -nodemulti nodemultdiscport ] [ -verbose ] [ -help ]

Note: In a Network Deployment environment, use the chgwassvr script from the Network Deployment instance to modify port values for the servers managed by the deployment manager for the cell. When you modify a managed server's ports, use the -node parameter to specify the node name of the managed node that contains the server that you want to modify. The configuration documents for the servers are updated when the next synchronization between the deployment manager and the nodes occurs. You can also synchronize the configuration with the syncNode script. You run the syncNode script from the WebSphere Application Server base application server for the node.

Parameters

The parameters of the script are:

• -server
  This is a required parameter. The value servername specifies the name of the server to change. For the default WebSphere Application Server instance, the default server name is server1. For the default Network Deployment instance, the default server name is dmgr. Use the dspwasinst script to view the servers associated with an instance. The value for this parameter is case-sensitive and must match the server name exactly.

• -instance
  Optional. The value instance specifies the name of the instance that contains the application server you want to change. The default value is default.

• -node
  (Network Deployment) Optional. The value nodename specifies the node that hosts the application server that you want to change. The default value is the Network Deployment managing instance.

• -embeddedjms
  (Base application server) Optional. The value specifies whether the server should contain an embedded JMS configuration. If this parameter is not specified, the JMS configuration for the application server is unchanged. If the value is yes, an embedded JMS configuration is created if the server does not have one. If the value is no, the JMS configuration is deleted from the server if it has one.

• -portblock
  Optional. The value portblock specifies the first number of a block of port numbers that your instance uses. If you specify this parameter, the script changes all of the port numbers for your application server. If you do not specify this parameter, the port numbers for your application server are not changed, unless you specify a port parameter to change (see port parameters below). Use the Work with TCP/IP Network Status (NETSTAT *CNN) command to display a list of port numbers that are currently being used.

  Note:

  1. A WebSphere Application Server instance uses several ports for various functions. When you change an application server's properties, ports are assigned based on the following ordered conditions:

     1. Specific port parameters
        If you specify values for specific port parameters, the script uses those values. Specific port parameters are -inthttp (Base application server), -admin, -jmsqueued (Base application server), -jmsdirect (Base application server), -jmssecure (Base application server), -soap, -orblistener (Network Deployment), -nameservice, -drsclient, and -celldiscovery (Network Deployment).
     2. The -portblock parameter
        Services for which you have not specified a port number are assigned ports sequentually starting with the value of the -portblock parameter. If a script encounters a port that is in use, it skips that port number and continues with the next unused port.
     3. Current values
        If -portblock is not specified, any services for which you have not specified a port parameter retain their current value.

  2. For the -portblock parameter, the script checks only a master index of all instances of WebSphere Application Server, V5.0 and WebSphere Application Server Network Deployment, V5.0. The script is not able to detect port usage by other applications, including previous versions of WebSphere Application Server.

• -transport
  Optional set. The value oldvalue specifies the port number of the Web container transport that you want to change. The value newvalue specifies the new port number that you want to assign to the Web container transport. If the Web Container transport is also specified in the host alias for a virtual host, the port for the host alias is also updated.

  Note: Use the -transport parameter set instead of the -admin, -adminssl, -inthttp or -inthttpssl parameters. These parameters are deprecated.

• -inthttp
  Optional. The value inthttpport specifies the port number on which the Web container listens for requests from the Web server. If neither the -portblock parameter nor the -inthttp parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

  Note: This parameter is deprecated. Use the -transport -oldport oldvalue -newport newvalue parameter set to change this value. For exapmle, to change the internal HTTP server port for the default WebSphere Application Server instance from 9080 to 9081, run this command at the Qshell prompt:

  chgwassvr -server server1 -transport -oldport 9080 -newport 9081

• -inthttpssl
  Optional. The value inthttpsslport specifies the port number that your application server uses for secure communications with internal HTTP server. If neither the -portblock parameter nor the -inthttpssl parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

  Note: This parameter is deprecated. Use the -transport -oldport oldvalue -newport newvalue parameter set to change this value. For exapmle, to change the internal HTTP server SSL-enabled port for the default WebSphere Application Server instance from 9443 to 9444, run this command at the Qshell prompt:

  chgwassvr -server server1 -transport -oldport 9443 -newport 9444

• -admin
  Optional. The value adminport specifies the port number to use for the administrative console. If neither the -portblock parameter nor the -admin parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

  Note: This parameter is deprecated. Use the -transport -oldport oldvalue -newport newvalue parameter set to change this value. For exapmle, to change the administrative console port for the default WebSphere Application Server instance from 9090 to 9091, run this command at the Qshell prompt:

  chgwassvr -server server1 -transport -oldport 9090 -newport 9091

• -adminssl
  Optional. The value adminportssl specifies the port number to use for the secure communications with administrative console. If neither the -portblock parameter nor the -adminssl parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

  Note: This parameter is deprecated. Use the -transport -oldport oldvalue -newport newvalue parameter set to change this value. For exapmle, to change the administrative console SSL-enabled port for the default WebSphere Application Server instance from 9043 to 9044, run this command at the Qshell prompt:

  chgwassvr -server server1 -transport -oldport 9043 -newport 9044

• -jmsqueued
  Optional. The value jmsqueuedport specifies the port number that the internal JMS provider's WebSphere MQ listener uses. This listener is used by JMS connections to communicate with the internal JMS provider. If neither the -portblock parameter nor the -jmsqueued parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

• -jmsdirect
  Optional. The value jmsdirectport specifies the port that the internal JMS provider uses to communicate with the internal JMS provider for JMS publish/subscribe connections when the WebSphere Topic Connection Factory resource port is set to DIRECT. If neither the -portblock parameter nor the -jmsdirect parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

• -jmssecure
  Optional. The value jmssecureport specifies the port that the internal JMS provider uses to communicate with the internal JMS provider to verify authorizations to resources when WebSphere Application Server security is enabled. If neither the -portblock parameter nor the -jmssecure parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

• -soap
  Optional. The value soapport specifies the port number to use for Simple Object Access Protocol (SOAP). If neither the -portblock parameter nor the -soap parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

• -orblistener
  (Network Deployment) Optional. The value orblistenerport specifies the port number to use for the orb listener port. If neither the -portblock or -orblistener parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

• -nameservice
  Optional. The value nameserviceport specifies the port number to use for name service (or RMI connector) port. If neither the -portblock parameter nor the -nameservice parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

• -drsclient
  Optional. The value drsclientport specifies the port number to use for the Data Replication Service (DRS) client. If neither the -portblock parameter nor the -drsclient parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

• -celldiscovery
  (Network Deployment) Optional. The value celldiscoveryport specifies the port on which the Network Deployment instance listens for a node attempting to find the cell to which the node belongs. If neither the -portblock parameter nor the -celldiscovery parameter is specified, this port is not changed. See the Note on the -portblock parameter for more information.

• -sas
  Optional. The value sasserverport specifies the port on which the Secure Association Services (SAS) listen for inbound authentication requests. If the -sas parameter is not specified, this port is not changed. This port is specified by the SAS_SSL_SERVERAUTH_LISTENER_ADDRESS property in serverindex.xml.

• -csiv2server
  Optional. The value csiv2serverauthport specifies the port on which the Common Secure Interoperability Version 2 (CSIV2) Service listens for inbound server authentication requests. If the -csiv2server parameter is not specified, this port is not changed. This port is specified by the CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS property in serverindex.xml.

• -csiv2client
  Optional. The value csiv2clientauthport specifies the port on which the Common Secure Interoperability Version 2 (CSIV2) Service listens for inbound client authentication requests. If the -csiv2client parameter is not specified, this port is not changed. This port is specified by the CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS property in serverindex.xml.

• -nodediscovery
  Optional. The value nodediscport specifies the port on which the node agent's node discovery service listens.

• -nodemulti
  Optional. The value nodemultidiscport specifies the port on which the node agent's multicast discovery service listens.

• -verbose
  This optional parameter turns on verbose messages, which can be helpful if you need to debug the script.

• -help
  This optional parameter displays the help message. If you specify this parameter, the script ignores all other parameters.