Start Liberty profile servers using the job manager

We can submit the Start Liberty profile server job to start a Liberty profile server on one or more target hosts.

Start the job manager.

The Liberty profile server to start must be installed on all job targets. See Installing Liberty profile resources using the job manager.

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, we 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.

A Liberty profile server requires a Java development kit (JDK) or Java runtime environment (JRE) to run this job. Set the JDK or JRE location by completing one of the following actions:

If JAVA_HOME is not specified in server.env or in the user environment, the job manager looks for the JDK or JRE in the user search path.

The job manager cannot access a user’s full environment. To specify additional environment variables, set the variables in the SSH exec channel.

  1. Login as root.

  2. In the /etc/ssh/sshd_config file, set PermitUserEnvironment to yes.

  3. Restart sshd. Run stopsrc -s ssh and then startsrc -s ssh.

  4. Login as the user to run the Liberty profile server.

  5. Change directory to the .ssh directory under the user home. Create a property file called environment and, in the file, set JAVA_HOME=absolute_path_to_the_Java_home.

We can use the administrative console of the job manager or the deployment manager to start Liberty profile servers on one or more target hosts. From the console, choose the Start Liberty profile server job, specify the server and job options, review the summary, and submit the job.

This topic describes how to run the Start Liberty profile server job using the job manager console or the deployment manager console. Instead of using a console, we can run the startLibertyProfileServer job script in the AdministrativeJobs command group. See the Administrative job types topic.

  1. Click Jobs > Submit from the navigation tree of the administrative console.

  2. Choose a job to start a server.

    1. Select the Start Liberty profile server job type from the list.

    2. Optionally specify a description of the job.

    3. Click Next.

  3. Choose the job targets.

    1. Select a group of targets from the list, or select Target names.

      Only groups of targets that are valid for the job type selecteded are displayed in the list of target groups.

    2. If we selected Target names, then specify a target name and click Add, or click Find and specify the chosen targets on the Find targets page.

    3. If we did not choose to save security authentication information when registering the target hosts with the job manager, specify an operating system user name and password or public-private key information for access to the target hosts. The security credentials must be valid for all the job targets.

    4. Click Next.

  4. Specify parameters for the start Liberty profile job.

    1. For Server to be started, specify the fully-qualified resource ID of the Liberty profile server to start. For example, to start the defaultServer server in the wlp runtime, specify the following resource ID:


    2. Click Next.

  5. Schedule the job.

    The times and dates that specified are relative to the job manager.

    1. Optionally specify one or more email addresses where notifications are sent when the job finishes.

      If we specify multiple email addresses, separate them with commas.

    2. Select when the job is available for submission.

    3. Select the job expiration.

    4. Optionally specify a recurring interval for the job, a start date and time for the interval, and an end date and time for the interval.

    5. Click Next.

  6. Review the summary, and click Finish to submit the job.


The targets run the job and attempt to start the server.

What to do next

On the Job status page, click the ID of the Start Liberty profile server job and view the job status. Click the status refresh icon

to refresh the displayed status.

If the job is not successful, view any error messages that result from running the job, correct the error condition, and submit the job again.

If the job is successful, the status on the Target resources page of the server is RUNNING. Click Jobs > Target resources > resource_name to see the resource status.

Related tasks

Start and stop the job manager
Install Liberty profile resources using the job manager
Stopping Liberty profile servers using the job manager
Checking job status

Related reference

Administrative job types
Find targets
Find target resources
Target resources collection