Regenerate the Web server plug-in configuration

The GenPluginCfg script regenerates the plugin-cfg.xml file, which stores runtime configuration information for the Web server plug-in. The file is stored in the /QIBM/UserData/WebASE51/ASE/instance/config/cells directory, where instance is the name of your instance. For information on running Qshell scripts, see Configure Qshell to run WebSphere Application Server - Express scripts.

Regenerate the plug-in 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:

• After you install or remove an enterprise application.
• After you add or remove servlets and mappings from an application.
• After you change the configuration for the plug-in, a virtual host, or a transport.

The application server must be running when you run this script.

Authority

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

Usage

1. On the CL command line, run the STRQSH (Start Qshell) command.

2. Run the cd command to change to the directory that contains the script:

   cd /QIBM/ProdData/WebASE51/ASE/bin

3. Run the GenPluginCfg script:

   GenPluginCfg -instance instance

   where instance is the name of the application server instance for which you want to regenerate the plugin-cfg.xml file.

Syntax

The syntax of the GenPluginCfg script is:

GenPluginCfg -instance instance [ -config.root cfgdirectory ]
 [ -cell.name cellname ] [ -node.name nodename ]
 [ -output.file.name filename ] [ -debug yes | no ]

Parameters

The parameters of the GenPluginCfg script are:

• -instance
  This is a required parameter. The value instance specifies the name of your application server instance.

• -config.root
  This is an optional parameter. The value cfgdirectory specifies the configuration directory that contains the plugin-cfg.xml file. The default value is /QIBM/UserData/WebASE51/ASE/instance/config/cells, where instance is the name of your instance.

• -cell.name
  This is an optional parameter. The value cellname 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/WebASE51/ASE/instance/bin/setupCmdLine, where instance is the name of your instance. This value is case sensitive.

• -node.name
  This is an optional parameter. The value nodename 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/WebASE51/ASE/instance/bin/setupCmdLine, where instance is the name of your instance. This value is case sensitive.

• -output.file.name
  This is an optional parameter. The value filename specifies the name of the file for the new plug-in configuration. The default value is the plugin-cfg.xml file in the /QIBM/UserData/WebASE51/ASE/instance/config/cells/ directory, where instance is the name of your instance.

• -debug
  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.

Example

GenPluginCfg -instance myAppSvr

This example regenerates the plugin-cfg.xml file for the instance myAppSvr.

You can also regenerate the Web server plug-in configuration with the administrative console, wsadmin, and for a remote HTTP configuration. For more information, see these topics:

Regenerate the Web server plug-in configuration with the console and wsadmin.
Regenerate the plug-in configuration for a remote HTTP configuration.