GenPluginCfg command

This topic describes the command-line syntax for the GenPluginCfg command. This command is used to regenerate the WebSphere Web server plug-in configuration file, plugin-cfg.xml. For more information about where to run this command, see the Using command tools article. CAUTION: Regenerating the plug-in configuration can overwrite manual configuration changes that you might want to preserve. Before performing this task, understand its implications as described in Communicating with Web servers.

To regenerate the plug-in configuration, one can either click on Servers > Web Servers in the administrative console, select a Web server and then click Generate Plug-in, or one can issue the following command

GenPluginCfg.sh|bat

Both methods for regenerating the plug-in configuration create a plugin-cfg.xml file in ASCII format, which is the proper format for execution in a distributed environment.

Use the -profileName option to define the profile of the Application Server process in a multi-profile installation. The -profileName option is not required for running in a single profile environment. The default for this option is the default profile.

 

Syntax

The command syntax is as follows

GenPluginCfg [[-option.name optionValue]...]

When the GenPluginCfg command is issued with the option -webserver.name webservrName, wsadmin generates a plug-in configuration file for the Web server. This settings in this generated configuration file are based on the list of applications that are deployed on the Web server. When this command is issued without the option -webserver.name webservrName, the plug-in configuration file is generated based on topology.

 

Parameters

The following options are available for the GenPluginCfg command:

-config.root configroot_dir

Defaults to environment variable CONFIG_ROOT.

-profileName

Defines the profile of the Application Server process in a multi-profile installation. The -profileName option is not required for running in a single profile environment. The default for this option is the default profile.

-cell.name cell

Defaults to environment variable WAS_CELL.

-node.name node

Defaults to environment variable WAS_NODE.

-webserver.name webserver1

Required for creating plug-in configuration file for a given Web server.

-propagate yes/no

Applicable only when the option webserver.name is specified. Defaults to no.

-cluster.name cluster1,cluster2 | ALL

Optional list of clusters. Ignored when the option webserver.name is specified.

-server.name server1,server2

Optional list of servers. Required for single server plug-in generation. Ignored when the option webserver.name is specified.

-output.file.name file_name

Defaults to the configroot_dir/plugin-cfg.xml file. Ignored when the option webserver.name is specified.

-destination.root root

Installation root of the machine configuration is used on. Ignored when the option webserver.name is specified.

-destination.operating.system windows/unix

Operating system of the machine configuration is used on. Ignored when the option webserver.name is specified.

-debug yes/no

Defaults to no.

-help

Prints a usage statement.

-?

Prints a usage statement.

 

Usage scenario

To generate a plug-in configuration

for all of the clusters in a cell

GenPluginCfg -cell.name NetworkDeploymentCell

To generate a plug-in configuration for a single server

GenPluginCfg -cell.name BaseApplicationServerCell -node.name appServerNode -server.name appServerName

To generate a plug-in configuration file for a Web server

GenPluginCfg -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName

 

---