11.2. Deploying EAR and WAR Files
- Search for the JBoss server instance to which to deploy the EAR or WAR.
- On the details page for the selected JBoss server instance, open the Inventory tab.
- In the Create New menu at the bottom, select the item for or , as appropriate.
- Enter the version number.
This is not used for the resource. The actual version number is calculated based on the spec version and implementation version inMANIFEST.MF, if any are given, or the calculated SHA-256 value for the package itself:SPEC(IMPLEMENTATION)[sha256=abcd1234]
If no version numbers are defined inMANIFEST.MF, then the SHA value is used. The SHA value is always used to identify the package version internally.Note
When the EAR or WAR file is exploded after it is deployed, theMANIFEST.MFfile is updated to include the calculated SHA version number. For example:Manifest-Version: 1.0 Created-By: Apache Maven
RHQ-Sha256: 570f196c4a1025a717269d16d11d6f37...For more information on package versioning, see "Deploying Applications and Content". - Upload the EAR/WAR file.
- Enter the information for the application to be deployed.
- Whether the file should be exploded (unzipped) when it is deployed.
- The path to the directory to which to deploy the EAR or WAR package. The destination directory is relative to the JBoss server instance installation directory; this cannot contain an absolute path or go up a parent directory.
- Whether to back up any existing file with the same name in the target directory.
- At the bottom of the wizard, set an optional timeout period. This is how long the JBoss ON server will wait during the deployment process before determining that the deployment has failed.
Note
The timeout period only applies to the server's reporting a result. If the operation continues running, it can still complete successfully, and the web application is deployed.Particularly for large application files, do not set a low timeout period, or the server will mark the deployment as having failed. If the deployment completes later, the web application must be imported into the inventory manually; it will not be discovered by the agent. - Click .
Once the EAR/WAR file is confirmed, the new child resource is listed in the Child History subtab of the Inventory tab.
Figure 11. WAR Child Resource
