WildFly Exploded Deployments with CLI: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 11: Line 11:
=="Explode" the JEE archive==
=="Explode" the JEE archive==


Expand the JEE archive. The archive can be expanded in any local directory accessible to the application server, not necessarily under the <tt>deployments</tt> directory.
Expand the JEE archive.  


Expanding the archive in the deployment directory works but care must be taken not to interfere with the deployment scanner that monitors that directory.
The archive can be expanded in any local directory accessible to the application server, not necessarily under the <tt>deployments</tt> directory. Expanding the archive in the <tt>deployments</tt> directory works but care must be taken not to interfere with the deployment scanner that monitors that directory.


<blockquote style="background-color: Gold; border: solid thin Goldenrod;">
<blockquote style="background-color: Gold; border: solid thin Goldenrod;">

Revision as of 00:20, 1 April 2016

Internal

Overview

Exploded deployments are not deployed by default by a WildFly instance. They can be triggered by configuring the deployment scanner, using marker files or via CLI. The procedure to trigger the deployment with CLI is described below.

Procedure

"Explode" the JEE archive

Expand the JEE archive.

The archive can be expanded in any local directory accessible to the application server, not necessarily under the deployments directory. Expanding the archive in the deployments directory works but care must be taken not to interfere with the deployment scanner that monitors that directory.


The name of the exploded root directory must end in the same extension as the JEE archive it is extracted from. If test.ear is deployed, then the exploded root directory name must end in .ear.

Trigger the Deployment via CLI

Connect the CLI to the application server instance. For more details on how to connect CLI see Connect to a Controller.

Trigger the deployment with the following command, providing appropriate values to the "runtime-name" and the "path" attributes.

"runtime-name" must end with the same JEE extension as the original JEE artifact. For example, if an EAR is deployed, the runtime name must end in ".ear".

"path" must contain the absolute path of the exploded directory. As mentioned in the "Explode" the JEE archive section, the name must end with the appropriate JEE extension.

[standalone@localhost:9999 /] /deployment=test:add(runtime-name="test.ear", enabled=true, content=[{"path"=>"/Users/ovidiu/tmp/jboss-eap-6.4/profiles/msc/deployments/exploded-test-dir.ear", "archive"=>false}])

The Deployment Database

A successful deployment will update the standalone server configuration file with a section similar to:

    <deployments>
        <deployment name="my-test-deployment" runtime-name="test.ear">
            <fs-exploded path="/Users/ovidiu/tmp/test-exploded-dir.ear"/>
        </deployment>
    </deployments>

Note that the configuration will be maintained between restarts, the JEE application will be re-deployed after server restart.