The GenPluginCfg script

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/WebAS5/edition/instance/config/cells directory where edition is Base for WebSphere Application Server and ND for WebSphere Application Server Network Deployment, and instance is the name of your instance.

Regenerate the plugin configuration after you make changes to the application server. This list describes some, but not all, situations in which 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 plugin, a virtual host, or a transport.

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

Product

The GenPluginCfg script is available in WebSphere Application Server and WebSphere Application Server Network Deployment.

Authority

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

Syntax

The syntax of the GenPluginCfg script is:

GenPluginCfg [ -instance instance ] [ -config.root cfgdirectory ]
 [ -cell.name cellname ] [ -node.name nodename ]
 [ -server.name servername ] [ -output.file.name filename ]
 [ -destination.root destinationdir  ] [ -destination.operating.system destOS ]
 [ -debug yes | no ]

Parameters

The parameters of the GenPluginCfg script are:

• -instance
  Optional. The value instance specifies the name of your application server instance. The default value is default.

• -config.root
  Optional. The value cfgdirectory specifies the configuration directory that contains the plugin-cfg.xml file. The default value is the /QIBM/UserData/WebAS5/edition/instance/config/cells directory, where edition is Base for WebSphere Application Server and ND for WebSphere Application Server Network Deployment, and instance is the name of your instance.

• -cell.name
  Optional. 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 file /QIBM/UserData/WebAS5/edition/instance/bin/setupCmdLine, where edition is Base for WebSphere Application Server and ND for WebSphere Application Server Network Deployment, and instance is the name of your instance. This value is case sensitive.

• -node.name
  Optional. 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 file /QIBM/UserData/WebAS5/edition/instance/bin/setupCmdLine, where edition is Base for WebSphere Application Server and ND for WebSphere Application Server Network Deployment, and instance is the name of your instance. This value is case sensitive.

• -server.name
  Optional. The value servername specifies the name of the application server for which you want to regenerate the plugin-cfg.xml file. In a Network Deployment environment, specify this option to regenerate the configuration for a single application server in your cell. If you do not specify this parameter, the script regenerates the plugin configurations for all of the servers in the node. This value is case sensitive.

• -output.file.name
  Optional. The value filename specifies the name of the file for the new plugin configuration. The default value is the plugin-cfg.xml file in the /QIBM/UserData/WebAS5/edition/instance/config/cells directory, where edition is Base for WebSphere Application Server and ND for WebSphere Application Server Network Deployment, and instance is the name of your instance.

• -destination.root
  Optional. The value destinationdir specifies the destination root directory that the generated output file is copied to. This directory is used as a reference for generating the paths of certain files within the generated output file, such as the log file. The default value is the /QIBM/UserData/WebAS5/edition/instance directory, where edition is Base for WebSphere Application Server and ND for WebSphere Application Server Network Deployment.

• -destination.operating.system
  Optional. The value destOS specifies the operating system of the machine that the generated output file is copied to. This parameter determines the file separator that is used to form file paths in the output file. Valid values are windows or unix. If you specify windows, the file separator is a backward slash (\); if you specify unix, the file separator is a forward slash (/). The default value is unix. When the destination operating system is iSeries, use the default value.

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

Examples

GenPluginCfg

This example regenerates the plugin-cfg.xml file for all application servers contained in the default instance.

GenPluginCfg -instance myinst

This example regenerates the plugin-cfg.xml file for all application servers for instance myinst.

GenPluginCfg -instance myinst -server.name myserver

This example regenerates the plugin-cfg.xml file for server myserver in instance myinst.