Starting Liberty servers using the job manager (deprecated)

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

Before you begin

Start the job manager.

The Liberty server that you want to start must be installed on all job targets. See Installing Liberty 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, 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.

A Liberty 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:

• Set the JAVA_HOME property to the JDK or JRE location in the server.env file, which is located in the server directory. The job reads the JAVA_HOME property and sets it on the target environment before running the command to start the server. However, this property is not used by the Liberty server command if you start the server manually.

  The server.env file must be in EBCDIC encoding.

• 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.

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

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 that you selected are displayed in the list of target groups.

   2. If you 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 you 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 job.
   1. For Server to be started, specify the fully-qualified resource ID of the Liberty server to start.
      For example, if you want to start the defaultServer server in the wlp runtime, specify the following resource ID:

      runtime/wlp/liberty_server/defaultServer

   2. Click Next.
5. Schedule the job.

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

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

      If you 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.