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^!"
![[16.0.0.3 and later]](../ng_v16003.gif)
Reference topic