Generating a merged plug-in configuration for Liberty servers using the job manager (deprecated)
You can submit the Generate merged plugin configuration for Liberty profile servers job to create a single, merged plugin-cfg.xml file that instructs a web server plug-in to redirect requests to multiple application servers residing on multiple hosts. The job first generates server-specific plugin-cfg.xml files on each target host. The job then merges the server-specific plugin-cfg.xml files into one plugin-cfg.xml file on the job manager host.
Before you begin
Start the job manager and the Liberty servers on the target hosts.
If you need to generate a web server plug-in configuration for a single instance of a Liberty server, see Liberty documentation about configuring Liberty with a web server plug-in.
Your ID at the job manager must be authorized for the administrator role or the operator role to submit jobs.
When registering a target host with the job manager, you can save operating system security information. When you submit a job to one or more targets for which security information has not been saved, you must specify an authorized operating system user name and either password or public-private key information for the user name. The security credentials must be valid for all job targets.
<featureManager>
<feature>localConnector-1.0</feature>
<feature>restConnector-1.0</feature>
...
</featureManager>
When
submitting a job, if one or more Liberty servers include
only the HTTP/REST connector feature, you must specify the user name and password of a Liberty server administrator. The job manager uses these
credentials when establishing a JMX connection to the servers. If all the servers include the local
connector feature, you do not need to specify a user name and password.For more information about defining server administrators, see Mapping the administrator role
for Liberty.
- Set the JAVA_HOME property to the JDK or JRE location in the server.env
file. The job reads the
JAVA_HOME
property and sets it on the target environment before running the command to generate a plugin-cfg.xml file for the Liberty server. - Set the JAVA_HOME property to the JDK or JRE location in the user .bashrc file.
- Append the JDK or JRE path to the PATH environment variable.
- Set the JAVA_HOME property to the JDK or JRE location as a system environment variable.
- Append the JDK or JRE path to the PATH system variable.
About this task
You can use the administrative console of the job manager or the deployment manager to generate a single, merged plugin-cfg.xml file that instructs a web server plug-in to redirect requests to multiple Liberty servers residing on multiple hosts. From the console, choose the Generate merged plugin configuration for Liberty servers job, specify the servers and job options, review the summary, and submit the job.
The steps describe how to run the Generate merged plugin configuration for Liberty profile servers job using the job manager console or the deployment manager console. Instead of using a console, you can run the generateMergedPluginConfigForLibertyProfileServers job script in the AdministrativeJobs command group. See the Administrative job types topic.
Procedure
Results
Server-specific plugin-cfg.xml files are generated on each target host. The job manager then merges the files into a single, merged plugin-cfg.xml file on the job manager host.
What to do next
On the Job status page, click the ID of the Generate merged plugin configuration for Liberty profile servers job and view the job status. Click the status refresh icon to refresh the displayed status.
If the job is successful, the product writes the merged plugin-cfg.xml file to the app_server_root/profiles/job_manager_profile/config/temp/JobManager/job_ID/_mergedPluginDir/ directory.
- A targeted Liberty server is not running.
- No JMX connector is configured for a targeted Liberty server.
- The job properties do not specify valid server administrator credentials for establishing a JMX connection to a targeted Liberty server that includes only the HTTP/REST (restConnector) feature.