Install Liberty resources using the job manager

Use the Install Liberty profile job to remotely install the resources in multiple-host Liberty server environments. The resources, which must be stored in one or more compressed (.zip) file before installation, are extracted by the job manager to destination directories relative to a specified root directory.

Before running the Install Liberty profile resources job, the following conditions must exist:

• The job manager must be running.

• At least one target host computer must be registered with the job manager.

• The compressed (.zip) file must contain Liberty resources in a directory structure that satisfies job manager rules. See Packaging Liberty resources.

• The root directory to install the resources on the target hosts must be defined. Before attempting to install working resources, set the WLP_WORKING_DIR WebSphere variable to a directory path that is valid for the target hosts. Similarly, before attempting to install shared resources, set the WLP_SHARED_DIR WebSphere variable to a valid directory path. We can define global defaults for these variables and override the values on specific hosts as needed. See "Setting variables for Liberty servers."

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 submitting a job to one or more targets for which security information has not been saved, 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.

Status from Liberty servers is automatically sent to the STATUS_LISTENER_ADDRESS port. To change the STATUS_LISTENER_ADDRESS port number, use the Ports page of a deployment manager console (System administration > Deployment manager > Ports) or job manager console (System administration > Job manager > Ports). If we change the STATUS_LISTENER_ADDRESS port number after installing Liberty server resources, we will no longer receive automatic status from the previously installed Liberty resources.

Use the administrative console of the job manager or the deployment manager to install Liberty resources on one or more host targets. From the console, choose the Install Liberty profile resources job, specify the location of the compressed file and other job options, review the summary, and submit the job.

Instead of using a console, we can run the installLibertyProfileResources job script in the AdministrativeJobs command group. See the Administrative job types topic.

Tasks

1. From the navigation tree of the administrative console, click...
   Jobs > Submit

2. Choose a job to install Liberty resources.

   1. Select the Install Liberty profile resources job type from the list.

   2. Optionally specify a description of the job.

   3. Click Next.

3. Choose the job targets on which to add the Liberty resources.

   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 we selected 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 install Liberty resources job.

   1. If the compressed file containing the Liberty resources resides on the job manager server, for Path of the Liberty profile resources compressed file, specify the full path name for the compressed (.zip) file.

      If the compressed file does not reside on the job manager server, skip this step and specify a URL path for the compressed file.

      For example, suppose Liberty resources exist in the /resources/my_liberty_server.zip compressed file. Specify the full path name for the compressed file:

      (UNIX)

      /resources/my_liberty_server.zip
      

      (Windows)

      c:/resources/my_liberty_server.zip
      

   2. If the compressed file containing the Liberty resources does not reside on the job manager server, for URL path of the Liberty profile resources compressed file, specify the URL path for the compressed file.

      Supported scheme names for the universal resource locator (URL) include http, https, ftp, and file.

      Restriction: To use URL path of the Liberty profile resources compressed file with a protocol other than file, the target host must have a wget utility. Select an http, https, or ftp remote download protocol that the wget utility on the target host supports. If the wget utility does not support your selected protocol, then the job cannot install the resources.

      For example, specify one of the following URLs for the Liberty resources file, my_liberty_server.zip.

      If the Liberty resources reside on an HTTP or HTTPS server:

      http://www.mycompany.com/resources/my_liberty_server.zip
      
      https://www.mycompany.com/resources/my_liberty_server.zip
      

      If the Liberty resources reside on an FTP server:

      ftp://www.mycompany.com/resources/my_liberty_server.zip
      

      If the Liberty resources reside on the target host computer, the URL can use the file scheme to describe the path and name of the compressed file:

      (UNIX)

      file:///resources/my_liberty_server.zip
      

      (Windows)

      file://c:/resources/my_liberty_server.zip
      

   3. If the compressed file containing the Liberty resources does not reside on the job manager server and the URL is password-protected, specify a user name and password.

      1. For User name required to access URL, specify a user name that can access the URL specified for step 4(b).

      2. For Password required to access URL and Confirm password, specify a password that enables the user to access the URL.

   4. To install Liberty resources that can be shared across servers, select Install to shared location.

      By default, this option is not selected and the job installs resources to the location set by the WLP_WORKING_DIR WebSphere variable. When this option is selected, the job install resources to the location set by the WLP_SHARED_DIR WebSphere variable.

   5. To run optional iSeries scripts that authorize the Liberty installation and its embedded servers, select Run optional installation scripts on IBM i targets.

      When selected, the following command is run for each Liberty that the job manager is installing on IBM i targets:

      liberty_home/bin/iAdmin POSTINSTALL
      

      When installing one or more servers in a shared topology, the following command is run:

      liberty_home_of_server/bin/iAdmin GRANTAUTH --rolename server
       --userprofilename QEJBSVR --userdir server_area_root
      

      server_area_root is the grandparent of the server directory. For example, if the server is installed to the /usr/servers/myserver directory, then server_area_root is /usr and the command is:

      liberty_home_of_server/bin/iAdmin GRANTAUTH --rolename server
       --userprofilename QEJBSVR --userdir /usr
      

      When uninstalling a Liberty installation, the following command is run on IBM i targets:

      liberty_home/bin/iAdmin PREUNINSTALL
      

   6. Click Next.

5. Schedule the job.

   The times and dates 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 job manager server runs the job and attempts to add the Liberty resources to the target hosts.

The job extracts the image on a target host by trying the following methods in sequence:

• Use the unzip utility on the host.

• Use the jar utility on the host, including the jar utility from a SDK found by an inventory job.
• (Windows) Use the unzip utility that is copied to the remote host for the duration of the job, if not specifically disabled by the administrator. The unzip utility is deleted after the job is completed.
• Unzip the zip file on the job manager and copy files one at a time to the destination host. This method applies only if the image resides on the job manager.

What to do next

On the Job status page, click the ID of the install Liberty resource 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 fails with the message Undefined variable WLP_WORKING_DIR, click Environment > WebSphere variables, select the scope, and click New. Create a variable with the name WLP_WORKING_DIR and a value that specifies a directory path to which to install Liberty resources, such as /liberty/working. If the job fails with the message Undefined variable WLP_SHARED_DIR, create a variable with the name WLP_SHARED_DIR and specify a directory path to which to install shared Liberty resources, such as /liberty/shared. Then, submit the job again.

If the job is successful, click Jobs > Target resources to see Liberty resources in the list of resources.

Restart the job manager

Packaging Liberty resources

Set variables for Liberty servers

Checking job status

Administrative job types

Find targets

Find target resources

Target resources collection