In a flexible management environment, you can submit the Install
application job to deploy an enterprise application on
managed application server nodes 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:
- Develop and assemble the EAR file. The Install application job
does not change existing Java Naming and Directory (JNDI) and other
application bindings. If you must set binding values during deployment,
do not use the job manager to deploy the application. Instead, use
a deployment tool such as the administrative console application installation
wizard or a wsadmin script and specify managed nodes of the job manager
as deployment targets.
- Start the job manager and the target nodes. Each server on which
you are installing an application must be running. If a target node
is a stand-alone application server, also start the administrative
agent.
- Ensure that the target nodes are compatible with the application.
Version 7.0 or later nodes support EAR files that have Java 2 Platform,
Enterprise Edition (J2EE) 1.3, J2EE 1.4, or Java EE 5 modules.
- Copy the EAR file to the /config/temp/JobManager directory
of the job manager profile.
If the JobManager directory
does not exist, create the JobManager directory
in the job manager profile /config/temp directory.
To create and access the directory, you must have the appropriate
authority.
If the EAR file exists on a managed
node, you can run the Collect file job to copy
the EAR file from the managed node to the job_manager_profile/config/temp/JobManager/jobToken/nodeName directory.
See the topic on the collect file job.
- Run the Distribute file job to copy the
EAR file to managed nodes. Remember any destination value that is
specified when distributing the file.
Avoid trouble: You
must distribute an EAR file to the target nodes before you can run
the
Install application job. The distribute
file job copies the EAR file in the
/config/temp/JobManager directory
of the job manager profile to the target nodes. The name of the EAR
file on the target nodes becomes whatever value that you specify for
the destination when distributing the file. See the topic on the distribute
file job.
gotcha
About this task
You can use the administrative console of the job manager
to submit a job that deploys an enterprise application file on selected
nodes. From the job manager 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 the job manager console, you can run the
installApplication 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 install an application file.
- Select the Install 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 install 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.
Suppose that you distributed
the DynaCacheEsi.ear file as described in the
topic on distributing files from the job manager to nodes. To continue
with the DynaCacheEsi.ear example in that topic,
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 an 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.
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 target nodes to find the application, specify the destination
value:
dynacache_esi_sample
- 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.
- 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
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
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 node resources. Click to see the list
of resources.
After application installation, you can run jobs
that administer the application or file:
- Start application
- Stop application
- Update application
- Uninstall application
- Remove file