83 lines
5.0 KiB
HTML
83 lines
5.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>Regenerate the Web server plugin configuration</title>
|
||
|
|
</head>
|
||
|
|
|
||
|
|
<BODY>
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
||
|
|
|
||
|
|
<h3><a name="qshgenplgcfg"></a>Regenerate the Web server plugin configuration</h3>
|
||
|
|
|
||
|
|
<p>The GenPluginCfg script regenerates the plugin-cfg.xml file, which stores runtime configuration information for the Web server plugin. The file is stored in the /QIBM/UserData/WebASE/ASE5/<em>instance</em>/config/cells directory, where <em>instance</em> is the name of your instance. For information on running Qshell scripts, see <a href="qshadm.htm">Configure Qshell to run WebSphere Application Server - Express scripts</a>.</p>
|
||
|
|
<p>Regenerate the plugin configuration after you make changes to the application server. This list describes some, but not all, situations in which you should regenerate the plugin-cfg.xml file:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>After you install or remove an enterprise application.</li>
|
||
|
|
<li>After you add or remove servlets and mappings from an application.</li>
|
||
|
|
<li>After you change the configuration for the plugin, a virtual host, or a transport.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>The application server must be running when you run this script.</p>
|
||
|
|
|
||
|
|
<p><strong>Authority</strong></p>
|
||
|
|
<p>To run this script, your user profile must have *ALLOBJ authority.</p>
|
||
|
|
|
||
|
|
<p><strong>Usage</strong></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 GenPluginCfg script:</p>
|
||
|
|
<pre>GenPluginCfg -instance <em>instance</em></pre>
|
||
|
|
<p>where <em>instance</em> is the name of the application server instance for which you want to regenerate the plugin-cfg.xml file.</p></li>
|
||
|
|
</ol>
|
||
|
|
|
||
|
|
<p><strong>Syntax</strong></p>
|
||
|
|
<p>The syntax of the GenPluginCfg script is:</p>
|
||
|
|
|
||
|
|
<pre>GenPluginCfg -instance <em>instance</em> [ -config.root <em>cfgdirectory</em> ]
|
||
|
|
[ -cell.name <em>cellname</em> ] [ -node.name <em>nodename</em> ]
|
||
|
|
<!-- [ -server.name <em>servername</em> ] -->[ -output.file.name <em>filename</em> ]
|
||
|
|
[ -debug yes | no ]</pre>
|
||
|
|
|
||
|
|
<p><strong>Parameters</strong></p>
|
||
|
|
<p>The parameters of the GenPluginCfg script are:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><p><strong>-instance</strong><br>
|
||
|
|
This is a required parameter. The value <em>instance</em> specifies the name of your application server instance.</p></li>
|
||
|
|
|
||
|
|
<li><p><strong>-config.root</strong><br>
|
||
|
|
This is an optional parameter. The value <em>cfgdirectory</em> specifies the configuration directory that contains the plugin-cfg.xml file. The default value is /QIBM/UserData/WebASE/ASE5/<em>instance</em>/config/cells, where <em>instance</em> is the name of your instance.</p></li>
|
||
|
|
|
||
|
|
<li><p><strong>-cell.name</strong><br>
|
||
|
|
This is an optional parameter. The value <em>cellname</em> specifies the name of the cell in which your application server resides. The default is the value specified for the WAS_CELL environment variable found in the file /QIBM/UserData/WebASE/ASE5/<em>instance</em>/bin/setupCmdLine, where <em>instance</em> is the name of your instance. This value is case sensitive.</p></li>
|
||
|
|
|
||
|
|
<li><p><strong>-node.name</strong><br>
|
||
|
|
This is an optional parameter. The value <em>nodename</em> specifies the name of the node in which your application server resides. The default is the value specified for the WAS_NODE environment variable found in the file /QIBM/UserData/WebASE/ASE5/<em>instance</em>/bin/setupCmdLine, where <em>instance</em> is the name of your instance. This value is case sensitive.</p></li>
|
||
|
|
|
||
|
|
<!-- <li><p><strong>-server.name</strong><br>
|
||
|
|
This is an optional parameter. The value <em>servername</em> specifies the name of the application server for which you want to regenerate the plugin-cfg.xml file. This value is case sensitive.</p></li> -->
|
||
|
|
|
||
|
|
<li><p><strong>-output.file.name</strong><br>
|
||
|
|
This is an optional parameter. The value <em>filename</em> specifies the name of the file for the new plugin configuration. The default value is the plugin-cfg.xml file in the /QIBM/UserData/WebASE/ASE5/<em>instance</em>/config/cells/ directory, where <em>instance</em> is the name of your instance.</p></li>
|
||
|
|
|
||
|
|
<li><p><strong>-debug</strong><br>
|
||
|
|
This is an optional parameter. If you specify yes, the script generates exception trace information. If the script throws exceptions, run it with this parameter to view the trace information. The default value is no.</p></li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Example</strong></p>
|
||
|
|
|
||
|
|
<pre>GenPluginCfg -instance myAppSvr</pre>
|
||
|
|
<p>This example regenerates the plugin-cfg.xml file for the instance myAppSvr.</p>
|
||
|
|
|
||
|
|
<p>You can also regenerate the Web server plugin configuration with the administrative console and wsadmin. See <a href="plgncfgregen.htm">Regenerate the Web server plugin configuration with the console and wsadmin</a>.</p>
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|