Installing applications using the job manager

In a flexible management environment, you can submit the Install application job to deploy an enterprise application on managed application server targets of the job manager. An enterprise application is an enterprise archive (EAR) file that conforms to Java Platform, Enterprise Edition (Java EE) specifications.

Before you begin

Before installing an enterprise application on an application server, do the following:

About this task

You can use the administrative console of the job manager or the deployment manager to submit a job that deploys an enterprise application file on selected targets. From the console, choose the Install application job, specify the file to install, specify job options, schedule the job, review the summary, and submit the job.

Instead of using a console, you can run the installApplication job script in the AdministrativeJobs command group to deploy the application file to targets. See the Administrative job types topic.

Procedure

  1. Click Jobs > Submit from the navigation tree of the administrative console.
  2. Choose a job to install an application file.
    1. Select the Install application job type from the list.
    2. Optionally specify a description of the job.
    3. Click Next.
  3. Choose the job targets on which you want to deploy the application file.
    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 user authentication is required, specify a user name, password, or any other authentication values as needed.
    4. Click Next.
  4. Specify parameters for the install application job.
    1. For Application name, specify the base file name of the application file.

      By default, the job appends the .ear file extension to the application name.

      Suppose that you distributed the DynaCacheEsi.ear file as described in the topic on distributing files from the job manager to targets. To continue with the DynaCacheEsi.ear example in that topic, specify the name of the application file without the .ear extension:
      DynaCacheEsi
    2. If you specified a Destination value other than the EAR file name when distributing the application, specify that destination value for Application location.

      By default, the job searches for the application in the default destination location. If you do not specify an Application location value, then the location defaults to downloadedContent/application_name.ear of the managed target. Thus, if you specified DynaCacheEsi for Application name, the application location defaults to downloadedContent/DynaCacheEsi.ear.

      When distributing the file, if you specified a value for Destination other than the EAR file name, specify the Destination value for Application location.

      For the DynaCacheEsi.ear example, you did not specify the EAR file name, DynaCacheEsi.ear, for the destination value when distributing the EAR file. You specified dynacache_esi_sample for the destination value. Thus, the application location is downloadedContent/dynacache_esi_sample. To enable the targets to find the application, specify the destination value:

      dynacache_esi_sample
    3. If you are installing the application on a federated node of a deployment manager, specify the target server, node, or cluster names.

      For Server name, click Find and specify the target server. Based on your selection, the product fills in values for the server and node names.

      If the target is a cluster, for Cluster name, click Find and specify the target cluster.

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

Results

The targets run the job and attempt to install the file.

What to do next

On the Job status page, click the ID of the install application job and view the job status. Click the status refresh icon Specifies the refresh view icon for job status 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 installation is successful, the application name is shown in the list of target resources. Click Jobs > Target resources to see the list of resources.

After application installation, you can run jobs that administer the application or file:




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jan 30, 2014 9:17:32 AM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-iseries&topic=tagt_jobmgr_install_app
File name: tagt_jobmgr_install_app.html