pluginUtility command

The Liberty server generates the plug-in configuration file automatically during the server startup and application deployment or undeployment. The pluginUtility command-line utility helps further to collect the automatically generated plug-in files and merge them. The pluginUtility command provides the following command-line actions.

Syntax

The command syntax is as follows:

pluginUtility action [options]
where action can take one of the following values:
help
Display help information for a specified action.
merge
Merge multiple web server plug-in configuration files into a single file.

Options

The following options are available for the pluginUtility merge command:
--sourcePath=directory|comma-separated list
Required. Specify the location of the source directory that has all the plug-in configuration files. Or, to identify plug-in files to merge, specify a comma-separated list of source plug-in file names with the full file path.
--targetPath=directory|full path name
Optional. By default, the merged plug-in configuration file is generated in the current directory and named merged-plugin-cfg.xml. You can either specify the target directory name for the merged-plugin-cfg.xml file or a fully qualified file name. If a file named merged-plugin-cfg.xml or the specified file name exists, then the contents of the file is overwritten.

Usage

The following examples demonstrate correct syntax:

pluginUtility help
pluginUtility help merge
pluginUtility merge --sourcePath=C:/plugins
pluginUtility merge --sourcePath=C:/plugins/pluginA.jar,C:/plugins/pluginB.jar,C:/other/pluginC.jar
pluginUtility merge --sourcePath=C:/plugins --targetPath=C:/targetDir
pluginUtility merge --sourcePath=C:/plugins --targetPath=C:/targetDir/myMergedPluginCfg.xml
Tip: If your option value has spaces, you must enclose it in double quotation marks ("). For example, if the file path for the --sourcePath option is C:\Program Files\myFiles\myPlugin.jar, specify --sourcePath="C:/Program Files/myFiles/myPlugin.jar" in the command.
CAUTION:
Different operating system might treat some characters differently. For the Windows environment, if you have ! in your input string, it needs to be escaped by the ^ character. For example,
D:\Liberty\wlp\bin>pluginUtility merge="C:/a^!" 

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rwlp_pluginutility_cmd
File name: rwlp_pluginutility_cmd.html