115 lines
10 KiB
HTML
115 lines
10 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
|
|
|
|
<title>Change application server ports with the chgwassvr script</title>
|
|
</head>
|
|
|
|
<BODY>
|
|
<!-- Java sync-link -->
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
|
|
|
<h4><a name="qshchgsvr"></a>Change application server ports with the chgwassvr script</h4>
|
|
|
|
<p>You can use the chgwassvr script in Qshell to change one or more port numbers of an application server. Unless there is a port conflict, you do not need to change these settings. If your application server is not running correctly, and you suspect that there may be a port conflict, see <a href="../trb/trb.htm">Troubleshooting</a> before you change any of the port settings. For information on running scripts in Qshell, see <a href="qshadm.htm">Configure Qshell to run WebSphere Application Server - Express scripts</a>.</p>
|
|
|
|
<p><strong>Authority</strong></p>
|
|
<p>To run this script, your user profile must have *ALLOBJ authority.</p>
|
|
|
|
<p><strong>Usage</strong></p>
|
|
<p>To run the script, follow these steps:</p>
|
|
|
|
<ol>
|
|
<li><p>On the CL command line, run the STRQSH (Start Qshell) command.</p></li>
|
|
<li><p>Run the cd command to change to the directory that contains the script:</p>
|
|
<pre>cd /QIBM/ProdData/WebASE51/ASE/bin</pre></li>
|
|
<li><p>Run the chgwassvr script:</p>
|
|
<pre>chgwassvr -instance <em>instance</em> -server <em>server</em> [<em>options</em>]</pre>
|
|
<p>where <em>instance</em> is the name of the instance that contains the server you want to change, <em>server</em> is the name of the server you want to change, and <em>options</em> specifies the changes you want to make.</p></li>
|
|
</ol>
|
|
|
|
<p><strong>Syntax</strong></p>
|
|
<p>The syntax of the script is:</p>
|
|
|
|
<pre>chgwassvr -instance <em>instance</em> -server <em>servername</em> [ -portblock <em>portblock</em> ]
|
|
[ -transport -oldport <em>oldvalue</em> -newport <em>newvalue</em> ] [ -inthttp <em>inthttpport</em> ]
|
|
[ -admin <em>adminport</em> ] [ -adminssl <em>adminsslport</em> ] [ -soap <em>soapport</em> ]
|
|
[ -nameservice <em>nameserviceport</em> ] [ -sas <em>sasserverport</em> ]
|
|
[ -csiv2server <em>csiv2serverauthport</em> ] [ -csiv2client <em>csiv2clientauthport</em> ]
|
|
[ -verbose ] [ -help ]</pre></li>
|
|
|
|
<p><strong>Parameters</strong></p>
|
|
<p>The parameters of the script are:</p>
|
|
|
|
<ul>
|
|
<li><p><strong>-instance</strong>
|
|
<br>This is a required parameter. The value <em>instance</em> specifies the name of the instance that contains the application server you want to change.</p></li>
|
|
|
|
<li><p><strong>-server</strong>
|
|
<br>This is a required parameter. The value <em>servername</em> specifies the name of the application server to change.</p></li>
|
|
|
|
<li><p><strong>-portblock</strong>
|
|
<br>This is an optional parameter. The value <em>portblock</em> 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). You can use the Work with TCP/IP Network Status (NETSTAT *CNN) command to display a list of port numbers that are currently being used.</p>
|
|
<p><strong><a name="pbnote"></a>Note:</strong> A WebSphere Application Server - Express instance uses several ports for various functions. When you change an application server's properties, ports are assigned based on these ordered conditions:</p>
|
|
<ol>
|
|
<li><strong>Specific port parameters</strong>
|
|
<br>If you specify values for specific port parameters, the script uses those values. Specific port parameters are -inthttp, -admin, -soap, and -nameservice.</li>
|
|
<li><strong>The -portblock parameter</strong>
|
|
<br>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.</li>
|
|
<li><strong>Current values</strong>
|
|
<br>If -portblock is not specified, any services for which you have not specified a port parameter retain their current value.</li>
|
|
</ol><p></p></li>
|
|
|
|
<li><p><strong>-transport</strong>
|
|
<br>This is an optional parameter set. The value <em>oldvalue</em> specifies the port number of the Web container transport that you want to change. The value <em>newvalue</em> 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.</p>
|
|
<p><strong>Note:</strong> Use the -transport parameter set instead of the -admin, -adminssl, or -inthttp parameters. These parameters are deprecated.</p></li>
|
|
|
|
<li><p><strong>-inthttp</strong>
|
|
<br>This is an optional parameter. The value <em>inthttpport</em> 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 <a href="#pbnote">Note</a> on the -portblock parameter for more information.</p>
|
|
<p><strong>Note:</strong> This parameter is deprecated. Use the -transport -oldport <em>oldvalue</em> -newport <em>newvalue</em> parameter set to change this value. For exapmle, to change the internal HTTP server port for the default WebSphere Application Server - Express instance from 9080 to 9081, run this command at the Qshell prompt:</p>
|
|
<pre>chgwassvr -server server1 -transport -oldport 9080 -newport 9081</pre></li>
|
|
|
|
<li><p><strong>-admin</strong>
|
|
<br>This is an optional parameter. The value <em>adminport</em> specifies the port number to use for the WebSphere administrative console. If neither the -portblock parameter nor the -admin parameter is specified, this port is not changed. See the <a href="#pbnote">Note</a> on the -portblock parameter for more information.</p>
|
|
<p><strong>Note:</strong> This parameter is deprecated. Use the -transport -oldport <em>oldvalue</em> -newport <em>newvalue</em> parameter set to change this value. For exapmle, to change the administrative console port for the default WebSphere Application Server - Express instance from 9090 to 9091, run this command at the Qshell prompt:</p>
|
|
<pre>chgwassvr -server server1 -transport -oldport 9090 -newport 9091</pre></li>
|
|
|
|
<li><p><strong>-adminssl</strong>
|
|
<br>This is an optional parameter. The value <em>adminportssl</em> specifies the port number to use for the secure communications with WebSphere administrative console. If neither the -portblock parameter nor the -adminssl parameter is specified, this port is not changed. See the <a href="#pbnote">Note</a> on the -portblock parameter for more information.</p>
|
|
<p><strong>Note:</strong> This parameter is deprecated. Use the -transport -oldport <em>oldvalue</em> -newport <em>newvalue</em> parameter set to change this value. For exapmle, to change the administrative console SSL-enabled port for the default WebSphere Application Server - Express instance from 9043 to 9044, run this command at the Qshell prompt:</p>
|
|
<pre>chgwassvr -server server1 -transport -oldport 9043 -newport 9044</pre></li>
|
|
|
|
<li><p><strong>-soap</strong>
|
|
<br>This is an optional parameter. The value <em>soapport</em> 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 <a href="#pbnote">Note</a> on the -portblock parameter for more information.</p></li>
|
|
|
|
<li><p><strong>-nameservice</strong>
|
|
<br>This is an optional parameter. The value <em>nameserviceport</em> 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 <a href="#pbnote">Note</a> on the -portblock parameter for more information.</p></li>
|
|
|
|
<li><p><strong>-sas</strong>
|
|
<br>This is an optional parameter. The value <em>sasserverport</em> 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.</p></li>
|
|
|
|
<li><p><strong>-csiv2server</strong>
|
|
<br>This is an optional parameter. The value <em>csiv2serverauthport</em> 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.</p></li>
|
|
|
|
<li><p><strong>-csiv2client</strong>
|
|
<br>This is an optional parameter. The value <em>csiv2clientauthport</em> 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.</p></li>
|
|
|
|
<li><p><strong>-verbose</strong>
|
|
<br>This optional parameter turns on verbose messages, which can be helpful if you need to debug the script.</p></li>
|
|
|
|
<li><p><strong>-help</strong>
|
|
<br>This optional parameter displays the help message. If you specify this parameter, the script ignores all other parameters.</p></li>
|
|
</ul>
|
|
|
|
<p><strong>Examples</strong></p>
|
|
|
|
<pre>chgwassvr -instance devinst -server devinst -portblock 11400</pre>
|
|
<p>In this example, the ports assigned to the application server devinst in the instance devinst are changed.</p>
|
|
|
|
<pre>chgwassvr -instance devinst -server devinst -transport -oldvalue 9090 -newvalue 12240</pre>
|
|
<p>In this example, the WebSphere administrative console port for the application server devinst in the instance devinst is changed from 9090 to 12240.</p>
|
|
|
|
</body>
|
|
</html> |