ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatz_5.4.0.1/51/admin/qshstopsvr.htm

94 lines
6.0 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>Stop an application server with the stopServer script</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h3><a name="qshstopsvr"></a>Stop an application server with the stopServer script</h3>
<p>The stopServer script stops the specified server. For information on running Qshell scripts, 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. For information on setting explicit authorities for a user profile that does not have *ALLOBJ authority, see <a href="qshsetauth.htm">Set explicit authorities for the startServer and stopServer scripts</a>.</p>
<p><strong>Usage</strong></p>
<p>To stop an instance with the stopServer 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 stopServer script:</p>
<pre>stopServer -instance <em>instance</em> <em>server</em></pre>
<p>where <em>instance</em> is the name of the instance you want to stop and <em>server</em> is the name of the application server that you want to stop.</p></li>
</ol>
<p><strong>Syntax</strong></p>
<p>The syntax of the stopServer script is:</p>
<pre>stopServer <em>server</em> -instance <em>instance</em> [ -nowait ] [ -quiet ]
[ -logfile <em>filename</em> ] [ -replacelog ] [ -trace ] [ -timeout <em>seconds</em> ]
[ -statusport <em>statusportnumber</em> ] [ -port <em>portnumber</em> ]
[ -username <em>username</em> ] [ -password <em>password</em> ] [ -conntype SOAP | RMI ]
[ -help | -? ]</pre>
<p><strong>Parameters</strong></p>
<p>The parameters of the stopServer script are:</p>
<ul>
<li><p><strong><em>server</em></strong><br>
This is a required parameter. The value <em>server</em> specifies the name of the server that you want to stop. This value is case sensitive.</p></li>
<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 server that you want to stop.</p></li>
<li><p><strong>-nowait</strong><br>
This is an optional parameter. If you specify this parameter, the script returns control to the user without waiting for the server to stop successfully. The default is to wait for the server to stop successfully.</p></li>
<li><p><strong>-quiet</strong><br>
This is an optional parameter. If you specify this parameter, the script does not display informational messages. The default is to display informational messages while the script runs.</p></li>
<li><p><strong>-logfile</strong><br>
This is an optional parameter. The value <em>filename</em> specifies the location and name of the log file for the script. The default value is /QIBM/UserData/WebASE51/ASE/<em>instance</em>/logs/<em>server</em>/stopServer.log where <em>instance</em> is the name of the instance that contains the server that you want to stop, and <em>server</em> is the name of the server that you want to stop.</p></li>
<li><p><strong>-replacelog</strong><br>
This is an optional parameter. If you specify this parameter, the script replaces the log file if it exists. By default the script appends to the log file if it exists.</p></li>
<li><p><strong>-trace</strong><br>
This is an optional parameter. If you specify this parameter, the script outputs additional trace information to the log file for the script. You should only specify this parameter if errors occur when you try to stop a server. The default is to not log additional trace information.</p></li>
<li><p><strong>-timeout</strong><br>
This is an optional parameter. The value <em>seconds</em> specifies the amount of time in seconds to wait for the server to stop before returning control to the caller. The default is to wait until the server has stopped successfully.</p></li>
<li><p><strong>-statusport</strong><br>
This is an optional parameter. The value <em>statusportnumber</em> specifies the port on which to listen for the status of the server while it is stopping. The default is to use the next available port.</p></li>
<li><p><strong>-port</strong><br>
This is an optional parameter. The value <em>portnumber</em> specifies the SOAP or RMI port for the server. If you specify this parameter, the stopServer script sends the stop command directly to server. If you specify the RMI port value for this parameter, you must also specify the -conntype parameter. By default, the script reads the configuration files to obtain the information that is necessary to stop the server.</p></li>
<li><p><strong>-conntype</strong><br>
This is an optional parameter. If you specify the -port parameter, the -conntype parameter specifies the connector type to use. Valid values are SOAP or RMI. The default value is SOAP.</p></li>
<li><p><strong>-username</strong><br>
This parameter is required if security is enabled for the server. The value <em>username</em> specifies the user name for authentication.</p></li>
<li><p><strong>-password</strong><br>
This parameter is required if security is enabled for the server. The value <em>password</em> specifies the password for authentication.</p></li>
<li><p><strong>-help</strong> or <strong>-?</strong><br>
This optional paramter prints the usage statement for the script.</p></li></ul>
<p><strong>Example</strong></p>
<pre>stopServer myserver -instance myserver -port 10380</pre>
<p>This example uses port 10380 to stop the myserver application server in the myserver instance.</p>
</body>
</html>