Node Management Commands

This section describes commands related to node management. A node refers to a single JEUS instance installed on a single machine. These commands can be used only when connected to the DAS, as they are intended for the remote server management of the DAS. For more information about nodes, refer to JEUS Node Manager Guide.

The following is a list of node management commands.

Command Description

add-java-node

Dynamically adds a Java node.

add-ssh-node

Dynamically adds an SSH node.

apply-patch

Applies a patch to the node.

check-jeus-installed

Checks whether JEUS is installed on the node.

check-ssh-node

Verifies that SSH is properly configured on the SSH node.

install-jeus

Installs JEUS on the node, including the current domain configuration.

list-nodes

Displays the list of nodes.

modify-java-node

Modifies a saved Java node.

modify-node

Modifies a saved node.

modify-ssh-node

Modifies a saved SSH node.

patch-info

Displays information about patches applied to the node.

remove-node

Removes a saved node.

remove-patch

Removes a patch applied to the node.

show-node

Displays the configuration of the node.

uninstall-jeus

Uninstalls JEUS from the node.

1. add-java-node

Dynamically adds a new Java node. Enter appropriate values for each option to ensure a proper connection to the Java NodeManager configured for the node.

  • Alias

    addjavanode

  • Usage

    add-java-node <node-name>
              -host <host-name>
              [-port <port-number>]
              [-ssl]
              [-truststore <truststore-path>]
              [-truststorepassword <truststore-password>]

  • Parameters

    Parameter Description

    <node-name>

    Name of the node to add. This value must be unique as it is used as an ID.

    -host <host-name>

    Host address used by the node manager of the corresponding node.

    [-port <port-number>]

    Port number used by the node manager of the corresponding node. (Default: 7730)

    [-ssl]

    Specifies whether to use SSL.

    [-truststore <truststore-path>]

    Path to the truststore file.

    [-truststorepassword <truststore-password>]

    Password for the truststore file.

  • Example

    [MASTER]domain1.adminServer> add-java-node node1 -host 192.168.34.55 -port 7730
The node [node1] was successfully added.

2. add-ssh-node

Dynamically adds a new SSH node. Enter appropriate values for each option to ensure SSH accessibility. You can check SSH accessibility using the check-ssh-node command, and modify a created SSH node with the modify-ssh-node command.

  • Alias

    addsshnode

  • Usage

    add-ssh-node <node-name> 
             -host <host-name> 
             [-dir <install-dir>]
             [-port <port-number>]
             [-user <user-name>]
             [-privatekey <file-path>]

  • Parameters

    Parameter Description

    <node-name>

    Name of the remote node to add. This value must be unique as it is used as an ID.

    -host <host-name>

    Host address of the remote node.

    [-dir <install-dir>]

    JEUS installation directory of the remote node.

    [-port <port-number>]

    SSH connection port number. (Default: 22)

    [-user <user-name>]

    User name for SSH connection.

    [-privatekey <file-path>]

    Path to the private key file for the SSH connection.

  • Example

    [MASTER]domain1.adminServer> add-ssh-node node1 -host 192.168.34.55 -dir /home/sshUser/jeus -user sshUser
The node [node1] was successfully added.

3. apply-patch

Applies a patch to the node.

  • Alias

    applypatch

  • Usage

    apply-patch [<file-name>]
            [-nodes <node-name>]
            [-rolling]
            [-nomaster]
            [-action <action-on-error>]

  • Parameters

    Parameter Description

    [<file-name>]

    Patch file to apply. If not specified, the entire contents of the JEUS_HOME/lib/jext directory are transferred.

    [-nodes <node-name>]

    List of nodes to which the patch will be applied. If not specified, the patch is applied to all nodes within the domain.

    [-rolling]

    Specifies whether to restart the server after transferring the patch file in order to apply it.

    [-nomaster]

    Specifies not to reboot MASTER.

    [-action <action-on-error>]

    Action to take if the patch file application fails. Specify one of the following options:

    • CONTINUE

    • ROLLBACK

    • STOP

  • Example

    [MASTER]domain1.adminServer>apply-patch -nodes node2 jext.jar
The patch was successfully applied to the nodes [node1].

4. check-jeus-installed

Checks whether JEUS is installed on a specific node. The result displays the JEUS version information for the node.

  • Alias

    checkjeusinstalled, isjeusinstalled

  • Usage

    check-jeus-installed <node-name>

  • Parameters

    Parameter Description

    <node-name>

    Name of the node.

  • Example

    [MASTER]domain1.adminServer> check-jeus-installed node1
The JEUS version on the node [node1]: JEUS 9.1

5. check-ssh-node

Verifies that SSH is properly configured on a specific SSH node by executing the Java command.

  • Alias

    checksshnode, checknode

  • Usage

    check-ssh-node <node-name>

  • Parameters

    Parameter Description

    <node-name>

    Name of the node.

  • Example

    [MASTER]domain1.adminServer> check-ssh-node node1
The Domain Administration Server can execute the "java" process via SSH.

6. install-jeus

Installs JEUS on a specific node, including the current domain configuration. The installation process may take some time depending on your environment, as it involves file compression and copying.

  • Alias

    installjeus

  • Usage

    install-jeus <node-name>

  • Parameters

    Parameter Description

    <node-name>

    Name of the node.

  • Example

    [MASTER]domain1.adminServer> install-jeus node1
JEUS was successfully installed on the node [node1].

7. list-nodes

Displays a list of currently configured nodes. The information includes each node’s name, type, controllability status, and JEUS installation version.

  • Alias

    listnodes, nodelist

  • Usage

    list-nodes [-onlyname]

  • Parameters

    Parameter Description

    [-onlyname]

    Displays only the node names.

  • Example

    [MASTER]domain1.adminServer> list-nodes
========================================================================
+-------------+-----+---------------------+----------------------------+
|  Node name  | Type|    Under control    |        JEUS version        |
+-------------+-----+---------------------+----------------------------+
| node1       | SSH | Y                   | -                          |
| node2       | SSH | Y                   | JEUS 9.1                   |
| node3       | JAVA| N                   | -                          |
+-------------+-----+---------------------+----------------------------+
========================================================================

8. modify-java-node

Modifies configuration of a specific Java node.

  • Alias

    modifyjavanode

  • Usage

    modify-java-node <node-name>
                [-host <host-name>]
                [-port <port-number>]
                [-ssl <enable-SSL>]
                [-truststore <truststore-path>]
                [-truststorepassword <truststore-password>]

  • Parameters

    Parameter Description

    <node-name>

    Name of the node.

    [-host <host-name>]

    Host address used by the node manager of the corresponding node.

    [-port <port-number>]

    Port number used by the node manager of the corresponding node. (Default: 7736)

    [-ssl <enable-SSL>]

    Specifies whether to use SSL.

    [-truststore <truststore-path>]

    Path to the truststore file.

    [-truststorepassword <truststore-password>]

    Password for the truststore file.

  • Example

    [MASTER]domain1.adminServer> modify-java-node node1 -port 7731
The node [node1] was modified successfully. Check the results using "show-node"

9. modify-node

Modifies the configuration of a specific node. The node manager type can also be changed.

  • Usage

    modify-node <node-name>
            [-type <node-type>]
            [-host <host-name>]
            [-port <port-number>]
            [-ssl <enable-ssl>]
            [-truststore <truststore-path>]
            [-truststorepassword <truststore-password>]
            [-dir <install-dir>]
            [-user <user-name>]
            [-privatekey <file-path>]

  • Parameters

    Parameter Description

    <node-name>

    Name of the node.

    [-type <node-type>]

    Modifies the node type. Specify either java or ssh.

    [-host <host-name>]

    Host address used by the node manager of the corresponding node.

    [-port <port-number>]

    Port number used by the node manager of the corresponding node.

    (Default: 7730 for Java type, 22 for SSH type)

    [-ssl <enable-ssl>]

    Specifies whether to use SSL.

    [-truststore <truststore-path>]

    Path to the Truststore file.

    [-truststorepassword <truststore-password>]

    Password for the truststore file.

    [-dir <install-dir>]

    Path to the JEUS installation directory on the node.

    [-user <user-name>]

    User name for the SSH connection.

    [-privatekey <file-path>]

    Path to the private key file used for the SSH connection.

  • Example

    [MASTER]domain1.adminServer> modify-node node1 -type ssh -port 23
The node [node1] was modified successfully. Check the results using "show-node"

10. modify-ssh-node

Modifies the configuration of a specific SSH node.

  • Alias

    modifysshnode, modifynode

  • Usage

    modify-ssh-node <node-name>
               [-host <host-name>]
               [-dir <install-dir>]
               [-port <port-number>]
               [-user <user-name>]
               [-privatekey <file-path>]

  • Parameters

    Parameter Description

    <node-name>

    Name of the node.

    [-host <host-name>]

    Host address of the remote node.

    [-dir <install-dir>]

    JEUS installation directory on the remote node.

    [-port <port-number>]

    SSH connection port number. (Default: 22)

    [-user <user-name>]

    User name for the SSH connection.

    [-privatekey <file-path>]

    Path to the private key file used for the SSH connection.

  • Example

    [MASTER]domain1.adminServer> modify-ssh-node node1 -port 23
The node [node1] was modified successfully. Check the results using "show-node"

11. patch-info

Displays information about patches applied to the node.

  • Alias

    patchinfo, patch-list, patchlist, list-patch, listpatch

  • Usage

    patch-info [<node-names>]

  • Parameters

    Parameter Description

    [<node-names>]

    Name of the node. For multiple nodes, separate them with commas (,).

  • Example

    [MASTER]domain1.adminServer>patch-info
Successfully got patch information for the nodes.
==========================================================
Node Name[node1]

+---------------------------------------+----------------+
|            Patch File Name            | Patch Contents |
+---------------------------------------+----------------+
(No data available)

Unable to get patch information to SSH NodeManager
==========================================================

===============================================================
Node Name[node2]

+--------------------------------------------+----------------+
|               Patch File Name              | Patch Contents |
+--------------------------------------------+----------------+
| jext_patch_test.jar                        | patch test     |
+--------------------------------------------+----------------+
===============================================================

12. remove-node

Removes a specific node.

  • Alias

    removenode, rmnode, rm-node

  • Usage

    remove-node <node-name>

  • Parameters

    Parameter Description

    <node-name>

    Name of the node.

  • Example

    [MASTER]domain1.adminServer>remove-node node1
The node [node1] was successfully removed.

13. remove-patch

Removes the patch file applied to the specified node.

  • Alias

    removepatch, rmpatch, rm-patch

  • Usage

    remove-patch [<file-name>]
             [-nodes <node-name>]
             [-rolling]
             [-nomaster]
             [-action <action-on-error>]

  • Parameters

    Parameter Description

    [<file-name>]

    Patch file to remove. If not specified, the entire contents of JEUS_HOME/lib/jext directory will be removed.

    [-nodes <node-name>]

    List of nodes from which the patch will be removed. If not specified, the patch will be removed from all nodes within the domain.

    [-rolling]

    Specifies whether to apply the changes when restarting the server after removing the patch file.

    [-nomaster]

    Specifies not to reboot the MASTER.

    [-action <action-on-error>]

    Action to take when the patch removal fails. Specify one of the following options:

    • CONTINUE

    • STOP

    • ROLLBACK

  • Example

    [MASTER]domain1.adminServer>remove-patch -nodes node2 jext.jar
The nodes [node2] have successfully removed patch file.

14. show-node

Displays information about a specific node. In addition to the node’s basic information, it also retrieves information about the server mapped to that node.

The basic information of an SSH node can be modified using the modify-ssh-node command. Mapped server information can be modified using the modify-server command.

  • Alias

    shownode, nodeinfo

  • Usage

    show-node <node-name>

  • Parameters

    Parameter Description

    <node-name>

    Name of the node.

  • Example

    [MASTER]domain1.adminServer> show-node node1
================================================================================
+------------------+-----------------------------------------------------------+
|     Property     |                           Value                           |
+------------------+-----------------------------------------------------------+
| Node Name        | node1                                                     |
| Host             | 192.168.34.55                                             |
| Mapped Servers   | adminServer server1                                       |
| Node Type        | JAVA                                                      |
| NodeManager Port |                                                      7730 |
| Use SSL          | false                                                     |
+------------------+-----------------------------------------------------------+
================================================================================

15. uninstall-jeus

Uninstalls JEUS from a specific node.

  • Alias

    uninstalljeus

  • Usage

    uninstall-jeus <node-name>

  • Parameters

    Parameter Description

    <node-name>

    Name of the node.

  • Example

    [MASTER]domain1.adminServer> uninstall-jeus node1
JEUS was successfully uninstalled from the node [node1].