In a flexible management environment, you can submit the Update
application job to upgrade all or part of an enterprise
application that is deployed on managed nodes of the job manager.
Before you begin
Before running the job, do the following:
- Start the job manager and the target nodes. Each server on which
you are updating an application must be running. If a target node
is a stand-alone application server, also start the administrative
agent.
- Run the Distribute file job for the application
file that replaces or upgrades the currently installed application
file. You might specify a different destination value for this job
than the value for the currently installed file. Remember any destination
value that is specified when distributing the file.
- Run the Stop application job to stop the
currently installed application file that you want to update.
About this task
You can use the administrative console of the job manager
to submit a job that updates a deployed application file on selected
nodes. From the job manager console, choose the Update
application job, specify the file to upgrade, specify
job options, schedule the job, review the summary, and submit the
job.
Instead of using the job manager console, you can run the
updateApplication job script in the AdministrativeJobs command group
to deploy the application file to target nodes. See the Administrative
job types topic.
Procedure
- Click from the navigation tree of the job manager administrative
console.
- Choose a job to update an application file.
- Select the Update application job
type from the list.
- Optionally specify a description of the job.
- Click Next.
- Choose the job targets on which you want to deploy the
application file.
- Select a group of nodes from the list, or select Node
names.
Only groups of nodes that are valid
for the job type that you selected are displayed in the list of groups
of nodes.
- If you selected Node names, then
specify a node name and click Add, or click Find and
specify the chosen nodes on the Find nodes page.
- If user authentication is required, specify your user
name and password.
- Click Next.
- Specify parameters for the update application job.
- 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.
Click Find. On the
Find node resources page, select the application resource that upgrades
the currently installed application file.
Suppose
that you want to upgrade the DynaCacheEsi.ear file
used as an example in the topics on distributing files and installing
applications. To continue with the DynaCacheEsi.ear example,
specify the name of the application file without the .ear extension:
DynaCacheEsi
- 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 a Application
location value, then the location defaults to downloadedContent/application_name.ear of
the target managed node. Thus, if you specified DynaCacheEsi for Application
name, the application location defaults to downloadedContent/DynaCacheEsi.ear.
To continue with the DynaCacheEsi.ear example,
suppose that the destination value for the upgraded file is dynacache_esi_updated_sample.
Specify the new destination value:
dynacache_esi_updated_sample
- If you are updating 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.
- Click Next.
- Schedule the job.
The times and dates that
you specify are relative to the job manager.
- Optionally specify one or more e-mail addresses where
notifications are sent when the job finishes.
If you
specify multiple e-mail addresses, separate them with commas.
- Select when the job is available for submission.
- Select the job expiration.
- 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.
- Click Next.
- Review the summary, and click Finish to
submit the job.
Results
The target nodes run the job and attempt to install the
application.
What to do next
On the Job status page, click the job ID 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 Node resources page of the
application is UPDATED. Click to see the resource status.
After updating an
application, you can run other jobs that administer the application,
such as the start application job.