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 targets of the job manager.
Before you begin
Before running
the job, do the following:
- Start the job manager
and the targets. Each server on which you
are updating an application must be running. If a target 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
or the deployment manager to submit a job that updates a deployed
application file on selected targets. From the 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 a console, you can run the updateApplication
job script in the AdministrativeJobs command group to deploy the application
file to targets. See the Administrative job types topic.
Procedure
- Click from the navigation tree
of the 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 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.
- 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.
- If user authentication
is required, specify a user name,
password, or any other authentication values as needed.
- 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 target 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 managed target. 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 email addresses where
notifications are sent when the job finishes.
If you
specify multiple email 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 targets 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 Target 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.