81 lines
4.7 KiB
HTML
81 lines
4.7 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>Start an application server with the startServer script</title>
|
|
</head>
|
|
|
|
<BODY>
|
|
<!-- Java sync-link -->
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
|
|
|
<h3><a name="qshstrsvr"></a>Start an application server with the startServer script</h3>
|
|
|
|
<p>The startServer script reads the configuration file for the specified server process and starts the server.</p>
|
|
For information on running Qshell scripts, see <a href="qshadm.htm">Configure Qshell to run WebSphere Application Server - Express scripts</a>.
|
|
|
|
<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 start an application server with the startServer 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/WebASE/ASE5/bin</pre></li>
|
|
<li><p>Run the startServer script:</p>
|
|
<pre>startServer -instance <em>instance</em> <em>server</em></pre>
|
|
<p>where <em>instance</em> is the name of the instance that you want to start and <em>server</em> is the name of the server that you want to start.</p></li>
|
|
</ol>
|
|
|
|
<p>When the application server is running, the script displays this message:</p>
|
|
<pre>ASE6123: Application server started.
|
|
Cause . . . . . : Application server <em>instance</em> in ASE5 instance <em>instance</em> has
|
|
started and is ready to accept connections on admin port <em>admin_port</em></pre>
|
|
<p>where <em>instance</em> is the name of your instance and <em>admin_port</em> is the port number for the WebSphere administrative console.</p>
|
|
<p><strong>Note:</strong> If you specify the -nowait parameter, the script does not display this message. You must <a href="appsvrvrfy.htm">verify that the application server has started</a> before you continue.</p>
|
|
|
|
<p><strong>Syntax</strong></p>
|
|
<p>The syntax of the startServer script is:</p>
|
|
|
|
<pre>startServer <em>server</em> -instance <em>instance</em>
|
|
[ -nowait ] [ -timeout <em>seconds</em> ] [ -trace ] [ -help | -? ]</pre>
|
|
|
|
<p>where <em>server</em> is the name of the configuration directory of the server you want to start.</p>
|
|
|
|
<p><strong>Parameters</strong></p>
|
|
<p>The parameters of the startServer script are:</p>
|
|
|
|
<ul>
|
|
<li><p><strong><em>server</em></strong><br>
|
|
This required parameter specifies the name of the server that you want to start. If <em>server</em> is not specified, the server name defaults to the value specified for the -instance parameter. 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 start.</p>
|
|
|
|
<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 successful initialization of the server. The default is to wait for successful initialization.</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 successful initialization of the server. The script returns control to the user at the end of the timeout value. The default is to wait until the server initialization is complete.</p></li>
|
|
|
|
<li><p><strong>-trace</strong><br>
|
|
This is an optional parameter. If you specify this parameter, the trace function is turned on. The trace output is written to the JOBNAME.JOBUSER.JOBNUMBER file in the /QIBM/UserData/WebASE/ASE5/service/trace directory, where JOBNAME, JOBUSER, and JOBNUMBER are taken from the application server job. The job name is output when the job is submitted by the script.</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>Examples</strong></p>
|
|
<pre>startServer -instance myinst</pre>
|
|
<p>This example starts the myinst application server in the myinst instance.</p>
|
|
|
|
<pre>startServer devinst -instance devinst -nowait</pre>
|
|
<p>This example starts the devinst application server in the devinst instance and returns control immediately to the user.</p>
|
|
|
|
</body>
|
|
</html>
|