1. Maven Plugin

This section describes the JEUS Maven plugin. If the JEUS Maven plugin is used, Apache Maven can be used to start JEUS servers or to distribute applications.

This section does not describe Apache Maven in detail. User knowledge of Apache Maven and correct installation are assumed. For more information about Apache Maven, refer to http://maven.apache.org .

1.1. Installation

Before using the JEUS Maven plugin, the plugin must be installed first.

The following is the JEUS Maven plugin installation file directory.

JEUS_HOME/lib/systemapps/jeus-maven-plugin.jar

The following is the Maven plugin installation process.

  1. Copy jeus-maven-plugin.jar to a directory. Any directory name can be set.

    mkdir /home/user1/jeus-maven-plugin
cd /home/user1/jeus-maven-plugin
cp JEUS_HOME/lib/systemapps/jeus-maven-plugin.jar /home1/user/jeus-maven-plugin

  2. Go to the directory and extract pom.xml from the jeus-maven-plugin.jar file.

    jar xvf /home/user1/jeus-maven-plugin/jeus-maven-plugin META-INF/maven/com.tmax.jeus/jeus-maven-plugin/pom.xml

  3. Use the following command to install the JEUS Maven plugin in the user’s maven local repository.

    mvn install:install-file -Dfile=/home/user1/jeus-maven-plugin/jeus-maven-plugin.jar -DpomFile=META-INF/maven/com.tmax.jeus/jeus-maven-plugin/pom.xml

1.2. Maven Plugin Goals

The following are the goals provided by the JEUS Maven plugin.

1.2.1. start-master-xml

Starts the Master Server. Internally, this executes the scripts under the JEUS_HOME/bin directory.

  • Usage

    com.tmax.jeus:jeus-maven-plugin:start-master-xml

  • Parameters

    The user, password, and filename parameters are optional. However, either the user/password or filename is required.

    Parameter Property Type Description

    jeusHome

    jeus.home

    java.lang.String

    JEUS installation directory. (Required)

    host

    jeus.server.host

    java.lang.String

    Host address of the Master Server. (Required)

    port

    jeus.server.port

    java.lang.Integer

    Port number of the Master Server. (Required)

    user

    jeus.user.name

    java.lang.String

    JEUS user name.

    password

    jeus.user.password

    java.lang.String

    JEUS user password.

    domain

    jeus.domain.name

    java.lang.String

    Domain name to which the Master Server belongs. (Required)

    server

    jeus.server.name

    java.lang.String

    Master Server name. (Required)

    filename

    jeus.auth.file

    java.lang.String

    Account information file used for JEUS authentication. Same as the f option provided by the startMasterServer script.

    waitingTime

    jeus.boot.timeout

    java.lang.Integer

    After starting JEUS, the plugin waits for a specified period of time to check if the server started normally, which determines whether the goal executed successfully. This parameter specifies the wait time. (Unit: sec, Default value: 10 sec)

    cachelogin

    jeus.server.start.cachelogin

    boolean

    Option to save the authentication information used to start JEUS. (Default: false)

    force

    jeus.server.start.forced

    boolean

    Forces the server to boot even if all configured applications are not in the RUNNING state. (Default: false)

    verbose

    jeus.server.start.verbose

    boolean

    Option to use the verbose function. (Default value: false)

    standby

    jeus.server.start.standby

    boolean

    Option to use Standby booting. (Default value: false)

  • Example

    Parameters can be set in pom.xml or specified on a command line for execution.

    The following is an example of the plugin configuration in pom.xml.

    <!-- JEUS Maven Plugin - start-master-xml -->
<plugin>
    <groupId>com.tmax.jeus</groupId>
    <artifactId>jeus-maven-plugin</artifactId>
    <version>9.0.0.0</version>
    <configuration>
      <jeusHome>/home/user1/jeus</jeusHome>
    <host>host1</host>
    <port>9736</port>
    <user>administrator</user>
    <password>jeus</password>
    <domain>domain1</domain>
    <server>adminServer</server>
  </configuration>
</plugin>

    The following is the result of executing the goal.

    $ mvn com.tmax.jeus:jeus-maven-plugin:start-master-xml
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< com.tmax.jeus:jeus-maven-plugin >-------------------
[INFO] Building JEUS Maven Plugin 9.0.0.0
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- jeus-maven-plugin:9.0.0.0:start-master-xml (default-cli) @ jeus-maven-plugin ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  17.937 s
[INFO] Finished at: 2024-08-20T14:53:46+09:00
[INFO] ------------------------------------------------------------------------

1.2.2. start-ms-xml

Starts MS. Internally, this executes the script under the JEUS_HOME/bin directory.

  • Usage

    com.tmax.jeus:jeus-maven-plugin:start-ms-xml

  • Parameters

    The user, password, and filename parameters are optional. However, either the user/password or filename is required.

    Parameter Property Type Description

    jeusHome

    jeus.home

    java.lang.String

    JEUS installation directory. (Required)

    host

    jeus.server.host

    java.lang.String

    Host address of the Master Server. (Required)

    port

    jeus.server.port

    java.lang.Integer

    Port number of the Master Server. (Required)

    user

    jeus.user.name

    java.lang.String

    JEUS user name.

    password

    jeus.user.password

    java.lang.String

    JEUS user password.

    domain

    jeus.domain.name

    java.lang.String

    Domain name to which the Master Server belongs. (Required)

    server

    jeus.server.name

    java.lang.String

    Master Server name. (Required)

    filename

    jeus.auth.file

    java.lang.String

    Account information file used for JEUS authentication. Same as the f option provided by the startManagedServer script.

    waitingTime

    jeus.boot.timeout

    java.lang.Integer

    After starting JEUS, the plugin waits for a specified period of time to check if the server started normally, which determines whether the goal executed successfully. This parameter specifies the wait time. (Unit: sec, Default value: 10 sec)

    cachelogin

    jeus.server.start.cachelogin

    boolean

    Option to save the authentication information used to start JEUS. (Default: false)

    force

    jeus.server.start.forced

    boolean

    Forces the server to boot even if all configured applications are not in the RUNNING state. (Default: false)

    verbose

    jeus.server.start.verbose

    boolean

    Option to use the verbose function. (Default: false)

    standby

    jeus.server.start.standby

    boolean

    Option to use Standby booting. (Default value: false)

    masterURL

    jeus.server.start. masterurl

    java.lang.String

    DAS URL, which manages the domain to which the MS belongs. (Required)

  • Example

    Parameters can be set in pom.xml or specified on a command line for execution.

    The following is an example of the plugin configuration in pom.xml.

    <!-- JEUS Maven Plugin - start-ms -->
<plugin>
  <groupId>com.tmax.jeus</groupId>
  <artifactId>jeus-maven-plugin</artifactId>
  <version>9.0.0.0</version>
  <configuration>
    <jeusHome>/home/user1/jeus</jeusHome>
    <host>host1</host>
    <port>9736</port>
    <user>administrator</user>
    <password>jeus</password>
    <domain>domain1</domain>
    <server>server1</server>
    <masterURL>host1:9736</masterURL>
  </configuration>
</plugin>

    The following is the result of executing the goal.

    $ mvn jeus.tool:jeus-maven-plugin:start-ms
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< com.tmax.jeus:jeus-maven-plugin >-------------------
[INFO] Building JEUS Maven Plugin 9.0.0.0
[INFO] ----------------------------[ maven-plugin ]----------------------------
[INFO]
[INFO] --- jeus-maven-plugin:9.0.0.0:start-ms-xml (default-cli) @ jeus-maven-plugin ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  6.174 s
[INFO] Finished at: 2022-08-30T08:13:58+09:00
[INFO] ------------------------------------------------------------------------

1.2.3. stop-jeus

Terminates a connected server. Internally, this goal executes the local-shutdown command by using the one-step execution function provided by the console tool (jeusadmin).

  • Usage

    com.tmax.jeus:jeus-maven-plugin:stop-jeus

  • Parameters

    Parameter Property Type Description

    jeusHome

    jeus.home

    java.lang.String

    JEUS installation directory.

    (Required)

    host

    jeus.server.host

    java.lang.String

    Server address to access jeusadmin.

    (Required)

    port

    jeus.server.port

    java.lang.Integer

    Server port number to access jeusadmin. (Default: 9736) (Required)

    user

    jeus.user.name

    java.lang.String

    JEUS user name.

    (Required)

    password

    jeus.user.password

    java.lang.String

    JEUS user password.

    (Required)

    args

    None

    java.util.List

    Argument values passed when executing the command. If both arg and args are used, arg has higher priority. This parameter is recommended for use in the pom.xml file.

    arg

    jeus.jeusadmin. command.arguments

    java.lang.String

    Argument value passed when executing the command. If both arg and args are used, arg has higher priority.

  • Example

    Parameters can be set in pom.xml or specified on a command line for execution.

    The following is an example of the plugin configuration in pom.xml.

    <!-- JEUS Maven Plugin - stop-jeus -->
<plugin>
  <groupId>com.tmax.jeus</groupId>
  <artifactId>jeus-maven-plugin</artifactId>
  <version>9.0.0.0</version>
  <configuration>
    <jeusHome>/home/user1/jeus</jeusHome>
    <host>host1</host>
    <port>9736</port>
    <user>administrator</user>
    <password>jeus</password>
  </configuration>
</plugin>

    The following is the general result of executing the goal.

    $ mvn jeus.tool:jeus-maven-plugin:stop-jeus
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< com.tmax.jeus:jeus-maven-plugin >-------------------
[INFO] Building JEUS Maven Plugin 9.0.0.0
[INFO] ----------------------------[ maven-plugin ]----------------------------
[INFO]
[INFO] --- jeus-maven-plugin:9.0.0.0:stop-jeus (default-cli) @ jeus-maven-plugin ---
[INFO] jeus.home = /home/user1/jeus
[INFO] jeusadmin.path = /home/user1/jeus/bin/jeusadmin
[INFO] jeusadmin.one-step-execution-command = [local-shutdown]
[INFO] Attempting to connect to host1:9736.
[INFO] The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
[INFO] The server [adminServer] has been shut down successfully.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  4.381 s
[INFO] Finished at: 2022-08-30T08:18:08+09:00
[INFO] ------------------------------------------------------------------------

1.2.4. deploy

Deploys the application. Internally, this goal executes the deploy-application command by using the one-step execution function provided by the console tool (jeusadmin).

  • Usage

    com.tmax.jeus:jeus-maven-plugin:deploy

  • Parameters

    Parameter Property Type Description

    jeusHome

    jeus.home

    java.lang.String

    JEUS installation directory.

    (Required)

    host

    jeus.server.host

    java.lang.String

    Server address to access jeusadmin.

    (Required)

    port

    jeus.server.port

    java.lang.Integer

    Server port number to access jeusadmin. (Default: 9736) (Required)

    user

    jeus.user.name

    java.lang.String

    JEUS user name.

    (Required)

    password

    jeus.user.password

    java.lang.String

    JEUS user password.

    (Required)

    args

    None

    java.util.List

    Argument values passed when executing the command. If both arg and args are used, arg has higher priority. This parameter is recommended for use in the pom.xml file.

    arg

    jeus.jeusadmin. command.arguments

    java.lang.String

    Argument value passed when executing the command. If both arg and args are used, arg has higher priority.

  • Example

    Parameters can be set in pom.xml or specified on a command line for execution.

    The following is an example of the plugin configuration in pom.xml.

    <!-- JEUS Maven Plugin - deploy -->
<plugin>
  <groupId>com.tmax.jeus</groupId>
  <artifactId>jeus-maven-plugin</artifactId>
  <version>9.0.0.0</version>
  <configuration>
    <jeusHome>/home/user1/jeus</jeusHome>
    <host>host1</host>
    <port>9736</port>
    <user>administrator</user>
    <password>jeus</password>
    <args>
      <param>myWeb</param>
      <param>-servers adminServer</param>
    </args>
  </configuration>
</plugin>

    The following is the general result of executing the goal.

    $ mvn jeus.tool:jeus-maven-plugin:deploy
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< com.tmax.jeus:jeus-maven-plugin >-------------------
[INFO] Building JEUS Maven Plugin 9.0.0.0
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- jeus-maven-plugin:9.0.0.0:deploy (default-cli) @ jeus-maven-plugin ---
[INFO] jeus.home = /home/user1/jeus
[INFO] jeusadmin.path = /home/user1/jeus/bin/jeusadmin
[INFO] jeusadmin.one-step-execution-command = [deploy-application myWeb -servers adminServer ]
[INFO] Attempting to connect to host1:9736.
[INFO] The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
[INFO] deploy the application for the application [myWeb] succeeded.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.356 s
[INFO] Finished at: 2024-08-20T15:09:26+09:00
[INFO] ------------------------------------------------------------------------

1.2.5. undeploy

Undeploys a deployed application. Internally, this goal executes the undeploy-application command by using the one-step execution function provided by the console tool (jeusadmin).

  • Usage

    com.tmax.jeus:jeus-maven-plugin:undeploy

  • Parameters

    Parameter Property Type Description

    jeusHome

    jeus.home

    java.lang.String

    JEUS installation directory.

    (Required)

    host

    jeus.server.host

    java.lang.String

    Server address to access jeusadmin.

    (Required)

    port

    jeus.server.port

    java.lang.Integer

    Server port number to access jeusadmin.

    (Default: 9736) (Required)

    user

    jeus.user.name

    java.lang.String

    JEUS user name. (Required)

    password

    jeus.user.password

    java.lang.String

    JEUS user password.

    (Required)

    args

    None

    java.util.List

    Argument values passed when executing the command. If both arg and args are used, arg has higher priority. This parameter is recommended for use in the pom.xml file.

    arg

    jeus.jeusadmin. command.arguments

    java.lang.String

    Argument value passed when executing the command. If both arg and args are used, arg has higher priority.

  • Example

    Parameters can be set in pom.xml or specified on a command line for execution.

    The following is an example of the plugin configuration in pom.xml.

    <!-- JEUS Maven Plugin - undeploy -->
<plugin>
  <groupId>com.tmax.jeus</groupId>
  <artifactId>jeus-maven-plugin</artifactId>
  <version>9.0.0.0</version>
  <configuration>
    <jeusHome>/home/user1/jeus</jeusHome>
    <host>host1</host>
    <port>9736</port>
    <user>administrator</user>
    <password>jeus</password>
    <args>
      <param>myWeb</param>
    </args>
  </configuration>
</plugin>

    The following is the general result of executing the goal.

    $ mvn com.tmax.jeus:jeus-maven-plugin:undeploy
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< com.tmax.jeus:jeus-maven-plugin >-------------------
[INFO] Building JEUS Maven Plugin 9.0.0.0
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- jeus-maven-plugin:9.0.0.0:undeploy (default-cli) @ jeus-maven-plugin ---
[INFO] jeus.home = /home/user1/jeus
[INFO] jeusadmin.path = /home/user1/jeus/bin/jeusadmin
[INFO] jeusadmin.one-step-execution-command = [undeploy-application myWeb ]
[INFO] Attempting to connect to host1:9736.
[INFO] The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
[INFO] Undeploying [myWeb] (This may take time due to graceful undeployment) ..........
[INFO] undeploy the application for the application [myWeb] succeeded.
[INFO] successfully undeployed (elapsed = 160ms)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.256 s
[INFO] Finished at: 2024-08-20T15:12:41+09:00
[INFO] ------------------------------------------------------------------------

1.2.6. start-app

Starts the service of the deployed application. Internally, this goal executes the start-application command by using the one-step execution function provided by the console tool (jeusadmin).

  • Usage

    com.tmax.jeus:jeus-maven-plugin:start-app

  • Parameters

    Parameter Property Type Description

    jeusHome

    jeus.home

    java.lang.String

    JEUS installation directory.

    (Required)

    host

    jeus.server.host

    java.lang.String

    Server address to access jeusadmin.

    (Required)

    port

    jeus.server.port

    java.lang.Integer

    Server port number to access jeusadmin. (Default: 9736) (Required)

    user

    jeus.user.name

    java.lang.String

    JEUS user name. (Required)

    password

    jeus.user.password

    java.lang.String

    JEUS user password.

    (Required)

    args

    None

    java.util.List

    Argument values passed when executing the command. If both arg and args are used, arg has higher priority. This parameter is recommended for use in the pom.xml file.

    arg

    jeus.jeusadmin. command.arguments

    java.lang.String

    Argument value passed when executing the command. If both arg and args are used, arg has higher priority.

  • Example

    Parameters can be set in pom.xml or specified on a command line for execution.

    The following is an example of the plugin configuration in pom.xml.

    <!-- JEUS Maven Plugin - start-app -->
<plugin>
  <groupId>com.tmax.jeus</groupId>
  <artifactId>jeus-maven-plugin</artifactId>
  <version>9.0.0.0</version>
  <configuration>
    <jeusHome>/home/user1/jeus</jeusHome>
    <host>host1</host>
    <port>9736</port>
    <user>administrator</user>
    <password>jeus</password>
    <args>
      <param>myWeb</param>
    </args>
  </configuration>
</plugin>

    The following is the general result of executing the goal.

    $ mvn com.tmax.jeus:jeus-maven-plugin:start-app
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< com.tmax.jeus:jeus-maven-plugin >-------------------
[INFO] Building JEUS Maven Plugin 9.0.0.0
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- jeus-maven-plugin:9.0.0.0:start-app (default-cli) @ jeus-maven-plugin ---
[INFO] jeus.home = /home/user1/jeus
[INFO] jeusadmin.path = /home/user1/jeus/bin/jeusadmin
[INFO] jeusadmin.one-step-execution-command = [start-application myWeb ]
[INFO] Attempting to connect to host1:9736.
[INFO] The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
[INFO] start the application for the application [myWeb] succeeded.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.089 s
[INFO] Finished at: 2024-08-20T15:11:27+09:00
[INFO] ------------------------------------------------------------------------

1.2.7. stop-app

Suspends the service of the running application. Internally, this goal executes the stop-application command by using the one-step execution function provided by the console tool (jeusadmin).

  • Usage

    com.tmax.jeus:jeus-maven-plugin:stop-app

  • Parameters

    Parameter Property Type Description

    jeusHome

    jeus.home

    java.lang.String

    JEUS installation directory.

    (Required)

    host

    jeus.server.host

    java.lang.String

    Server address to access jeusadmin.

    (Required)

    port

    jeus.server.port

    java.lang.Integer

    Server port number to access jeusadmin. (Default: 9736) (Required)

    user

    jeus.user.name

    java.lang.String

    JEUS user name. (Required)

    password

    jeus.user.password

    java.lang.String

    JEUS user password.

    (Required)

    args

    None

    java.util.List

    Argument values passed when executing the command. If both arg and args are used, arg has higher priority. This parameter is recommended for use in the pom.xml file.

    arg

    jeus.jeusadmin. command.arguments

    java.lang.String

    Argument value passed when executing the command. If both arg and args are used, arg has higher priority.

  • Example

    Parameters can be set in pom.xml or specified on a command line for execution.

    The following is an example of the plugin configuration in pom.xml.

    <!-- JEUS Maven Plugin - stop-app -->
<plugin>
  <groupId>com.tmax.jeus</groupId>
  <artifactId>jeus-maven-plugin</artifactId>
  <version>9.0.0.0</version>
  <configuration>
    <jeusHome>/home/user1/jeus</jeusHome>
    <host>host1</host>
    <port>9736</port>
    <user>administrator</user>
    <password>jeus</password>
    <args>
      <param>myWeb</param>
    </args>
  </configuration>
</plugin>

    The following is the general result of executing the goal.

    $ mvn com.tmax.jeus:jeus-maven-plugin:stop-app
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< com.tmax.jeus:jeus-maven-plugin >-------------------
[INFO] Building JEUS Maven Plugin 9.0.0.0
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- jeus-maven-plugin:9.0.0.0:stop-app (default-cli) @ jeus-maven-plugin ---
[INFO] jeus.home = /home/user1/jeus
[INFO] jeusadmin.path = /home/user1/jeus/bin/jeusadmin
[INFO] jeusadmin.one-step-execution-command = [stop-application myWeb ]
[INFO] Attempting to connect to host1:9736.
[INFO] The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
[INFO] stop the application for the application [myWeb] succeeded.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.059 s
[INFO] Finished at: 2024-08-20T15:10:32+09:00
[INFO] ------------------------------------------------------------------------

1.2.8. install-app

Installs an application on DAS. Internally, this goal executes the install-application command by using the one-step execution function provided by the console tool (jeusadmin).

  • Usage

    com.tmax.jeus:jeus-maven-plugin:install-app

  • Parameters

    Parameter Property Type Description

    jeusHome

    jeus.home

    java.lang.String

    JEUS installation directory.

    (Required)

    host

    jeus.server.host

    java.lang.String

    Server address to access jeusadmin.

    (Required)

    port

    jeus.server.port

    java.lang.Integer

    Server port number to access jeusadmin. (Default: 9736) (Required)

    user

    jeus.user.name

    java.lang.String

    JEUS user name. (Required)

    password

    jeus.user.password

    java.lang.String

    JEUS user password.

    (Required)

    args

    None

    java.util.List

    Argument values passed when executing the command. If both arg and args are used, arg has higher priority. This parameter is recommended for use in the pom.xml file.

    arg

    jeus.jeusadmin. command.arguments

    java.lang.String

    Argument value passed when executing the command. If both arg and args are used, arg has higher priority.

  • Example

    Parameters can be set in pom.xml or specified on a command line for execution.

    The following is an example of the plugin configuration in pom.xml.

    <!-- JEUS Maven Plugin - install-app -->
<plugin>
  <groupId>com.tmax.jeus</groupId>
  <artifactId>jeus-maven-plugin</artifactId>
  <version>9.0.0.0</version>
  <configuration>
    <jeusHome>/home/user1/jeus</jeusHome>
    <host>host1</host>
    <port>9736</port>
    <user>administrator</user>
    <password>jeus</password>
    <args>
      <param>/home/user/myWeb.war</param>
      <param>-id myWeb</param>
    </args>
  </configuration>
</plugin>

    The following is the general result of executing the goal.

    $ mvn com.tmax.jeus:jeus-maven-plugin:install-app
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< com.tmax.jeus:jeus-maven-plugin >-------------------
[INFO] Building JEUS Maven Plugin 9.0.0.0
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- jeus-maven-plugin:9.0.0.0:install-app (default-cli) @ jeus-maven-plugin ---
[INFO] jeus.home = /home/user1/jeus
[INFO] jeusadmin.path = /home/user1/jeus/bin/jeusadmin
[INFO] jeusadmin.one-step-execution-command = [install-application /home/user1/myWeb.war -id myWeb ]
[INFO] Attempting to connect to host1:9736.
[INFO] The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
[INFO] Successfully installed the application [myWeb].
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.444 s
[INFO] Finished at: 2024-08-20T15:01:07+09:00
[INFO] ------------------------------------------------------------------------

1.2.9. uninstall-app

Removes an application installed in DAS. Internally, this goal executes the uninstall-application command by using the one-step execution function provided by the console tool (jeusadmin).

  • Usage

    com.tmax.jeus:jeus-maven-plugin:uninstall-app

  • Parameters

    Parameter Property Type Description

    jeusHome

    jeus.home

    java.lang.String

    JEUS installation directory.

    (Required)

    host

    jeus.server.host

    java.lang.String

    Server address to access jeusadmin.

    (Required)

    port

    jeus.server.port

    java.lang.Integer

    Server port number to access jeusadmin. (Default: 9736) (Required)

    user

    jeus.user.name

    java.lang.String

    JEUS user name. (Required)

    password

    jeus.user.password

    java.lang.String

    JEUS user password.

    (Required)

    args

    None

    java.util.List

    Argument values passed when executing the command. If both arg and args are used, arg has higher priority. This parameter is recommended for use in the pom.xml file.

    arg

    jeus.jeusadmin. command.arguments

    java.lang.String

    Argument value passed when executing the command. If both arg and args are used, arg has higher priority.

  • Example

    Parameters can be set in pom.xml or specified on a command line for execution.

    The following is an example of the plugin configuration in pom.xml.

    <!-- JEUS Maven Plugin - uninstall-app -->
<plugin>
  <groupId>com.tmax.jeus</groupId>
  <artifactId>jeus-maven-plugin</artifactId>
  <version>8.0.0.0</version>
  <configuration>
    <jeusHome>/home/user1/jeus</jeusHome>
    <host>host1</host>
    <port>9736</port>
    <user>administrator</user>
    <password>jeus</password>
    <args>
      <param>myWeb</param>
    </args>
  </configuration>
</plugin>

    The following is the general result of executing the goal.

    $ mvn com.tmax.jeus:jeus-maven-plugin:uninstall-app
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< com.tmax.jeus:jeus-maven-plugin >-------------------
[INFO] Building JEUS Maven Plugin 9.0.0.0
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- jeus-maven-plugin:9.0.0.0:uninstall-app (default-cli) @ jeus-maven-plugin ---
[INFO] jeus.home = /home/user1/jeus
[INFO] jeusadmin.path = /home/user1/jeus/bin/jeusadmin
[INFO] jeusadmin.one-step-execution-command = [uninstall-application myWeb ]
[INFO] Attempting to connect to host1:9736.
[INFO] The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
[INFO] uninstall the application for the application [myWeb] succeeded. : Successfully deleted [myWeb].
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.397 s
[INFO] Finished at: 2024-08-20T15:07:09+09:00
[INFO] ------------------------------------------------------------------------

1.2.10. jeusadmin

Executes the specified jeusadmin command. Internally, this goal executes the command by using the one-step execution function provided by the console tool (jeusadmin).

  • Usage

    com.tmax.jeus:jeus-maven-plugin:jeusadmin

  • Parameters

    Parameter Property Type Description

    jeusHome

    jeus.home

    java.lang.String

    JEUS installation directory.

    (Required)

    host

    jeus.server.host

    java.lang.String

    Server address to access jeusadmin.

    (Required)

    port

    jeus.server.port

    java.lang.Integer

    Server port number to access jeusadmin. (Default: 9736) (Required)

    user

    jeus.user.name

    java.lang.String

    JEUS user name. (Required)

    password

    jeus.user.password

    java.lang.String

    JEUS user password.

    (Required)

    args

    None

    java.util.List

    Argument values passed when executing the command. If both arg and args are used, arg has higher priority. This parameter is recommended for use in the pom.xml file.

    arg

    jeus.jeusadmin. command.arguments

    java.lang.String

    Argument value passed when executing the command. If both arg and args are used, arg has higher priority.

    command

    jeus.jeusadmin.command

    java.lang.String

    Name of the jeusadmin command to be executed.

    (Required)

  • Example

    Parameters can be set in pom.xml or specified on a command line for execution.

    The following is an example of the plugin configuration in pom.xml and the command is server-info -server adminServer -state.

    <!-- JEUS Maven Plugin - jeusadmin -->
<plugin>
  <groupId>com.tmax.jeus</groupId>
  <artifactId>jeus-maven-plugin</artifactId>
  <version>8.0.0.0</version>
  <configuration>
    <jeusHome>/home/user1/jeus</jeusHome>
    <host>host1</host>
    <port>9736</port>
    <user>administrator</user>
    <password>jeus</password>
    <command>server-info</command>
    <args>
      <param>-server adminServer</param>
      <param>-state</param>
    </args>
  </configuration>
</plugin>

    The following is the result of executing the goal.

    mvn com.tmax.jeus:jeus-maven-plugin:jeusadmin
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------< com.tmax.jeus:jeus-maven-plugin >-------------------
[INFO] Building JEUS Maven Plugin 9.0.0.0
[INFO]   from pom.xml
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- jeus-maven-plugin:9.0.0.0:jeusadmin (default-cli) @ jeus-maven-plugin ---
[INFO] jeus.home = /home/user1/jeus
[INFO] jeusadmin.path = /home/user1/jeus/bin/jeusadmin
[INFO] jeusadmin.one-step-execution-command = [server-info -server adminServer -state ]
[INFO] Attempting to connect to host1:9736.
[INFO] The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
[INFO] RUNNING
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.093 s
[INFO] Finished at: 2024-08-20T15:15:08+09:00
[INFO] ------------------------------------------------------------------------