Install enterprise application files
As part of deploying an application, we install application files on a server configured to hold installable modules.
Before installing Java EE application files on an application server, assemble modules as needed.
Before installing the files, configure the target application server. As part of configuring the server, determine whether the application files can be installed to the deployment targets.
Installation of new Java EE specification levels are not allowed on deployment targets that do not support the specified Java EE level. For example, if an application contains modules with an EJB deployment descriptor level of 3.1 (part of Java EE 6), the application cannot be installed on an application server that does not support Java EE 6, such as application server versions prior to v8. Further, if an application contains Java EE 6 annotations, the application cannot be installed on an application server that does not support the Java EE 6 specification level, even if the application contains an EJB deployment descriptor for a previous version of the supported Java EE specification level; for example, EJB 3.0 which is part of Java EE 5.
We can install the following enterprise modules on a server:
- Enterprise archive (EAR)
- Enterprise bean (EJB)
- Web archive (WAR)
- SIP module (SAR)
- Resource adapter (connector or RAR)
- Application client modules
Application client files can be installed in a WebSphere Application Server configuration but cannot be run on a server.
Tasks
- Determine which method to use to install the application files. WAS v9 provides several ways to install modules.
- Install the application files using
- Administrative console
- Drag and drop to a monitored directory
- wsadmin scripts
- Java administrative programs that use JMX APIs
- Start the deployed application files using
- Administrative console
- wsadmin startApplication
- Java programs that use ApplicationManager or AppManagement MBeans
What to do next
Save the changes to the administrative configuration.
When saving the configuration in multiple-server environments, synchronize the configuration with the nodes where the application is expected to run.
- Use either the administrative console or wsadmin scripting to synchronization a node. Of these two options, using the administrative console is the best way to perform this operation. The Nodes panel in the administrative console includes the Synchronize operation.
To use wsadmin scripting to synchronize a node, use the NodeSync mbean's sync() command.
- Do not restart the node agent as part of the synchronize node process. Administration operations, such as node synchronization for application deployment, or updates that take place while the node agent is starting, initiated through the node agent, and affect the application servers, fail until the node agent has a chance to discover the application servers.
After any change to application deployment or mapping, you may need to generate and propagate the plugin-cfg.xml.
To test the application, point a web browser at http://hostname:9060/web_module_name.
If the application contains many classes with annotations and takes a long time to deploy, we can reduce annotation searches to speed up deployment.
Assemble applications Install enterprise application files with the console Example: Installing an EAR file using the default bindings Example: Installing a web services sample with the console Install enterprise application files by adding them to a monitored directory Install enterprise application files by adding properties files to a monitored directory Use application properties files to install, update, and delete enterprise application files Restart enterprise applications Configure enterprise application files Deploy and administer enterprise applications Install enterprise applications Starting applications Use administrative programs (JMX) Reducing annotation searches during application deployment Troubleshoot deployment