Node Manager Commands

This section describes commands that can be used by connecting to the node manager. A node refers to a single JEUS instance installed on a single machine. You can start a server or check its status by connecting to the Java-based node manager. For details about the Java-based node manager, refer to JEUS Node Manager Guide.

The following is a list of node management commands.

Command Description

connect-nodemanager

Connects to the Node Manager.

disconnect-nodemanager

Disconnects from the Node Manager. This command can only be used while connected to the node manager.

stop-nodemanager

Terminates the Node Manager. This command can only be used while connected to the node manager.

nm-start-server

Starts the server via the Node Manager. This command can only be used while connected to the node manager.

nm-stop-server

Terminates a server started via the Node Manager. This command can only be used while connected to the Node Manager.

nm-state-server

Displays the status of a server started via Node Manager. This command can only be used while connected to the Node Manager.

1. connect-nodemanager

Connects to the Node Manager.

  • Alias

    connect-nm, connectnm, nm-connect, nmconnect

  • Usage

    connect-nodemanager -domain <domain-name>
                        -h,--host <host-address>
                        -p,--port <port>
                        [-t,--type <connect-type>]
                        [-ts,--truststoreFile <truststore-file>]
                        [-tsp,--truststorePass <truststore-password>]
  • Parameters

    Parameter Description

    -domain <domain-name>

    Name of the domain managed by the Node Manager.

    -h,--host <host-address>

    Host address of the Node Manager to connect to.

    -p,--port <port>

    Port number of the Node Manager to connect to.

    [-t,--type <connect-type>]

    Specifies whether to use SSL when connecting to the Node Manager. Specify one of the following options:

    • ssl

    • plain (default)

    [-ts,--truststoreFile <truststore-file>]

    Path to the truststore file when using SSL.

    [-tsp,--truststorePass <truststore-password>]

    Password for the truststore file when using SSL.

  • Example

    offline>connect-nodemanager -host 192.168.34.55 -port 7730 -domain domain1
    The connection to the node manager domain1 has been established.
  • Note

    This command can be used without being connected to the server.

2. disconnect-nodemanager

Disconnects from the Node Manager.

  • Alias

    disconnect-nm, disconnectnm, disconnm, nm-disconnect, nmdisconnect

  • Usage

    disconnect-nodemanager
  • Example

    [NodeManager]domain1>disconnect-nodemanager
    disconnect to node manager.
  • Note

    This command can be used without being connected to the server.

3. stop-nodemanager

Terminates the Node Manager.

  • Alias

    stop-nm, stopnm, nm-stop, nmstop

  • Usage

    stop-nodemanager [-verbose]
                     [-p --properties <properties-file>]
                     [-host <host-address>]
                     [-port <port>]
                     [-t, --type <connect-type>]
                     [-ts, --truststoreFile <truststore-file>]
                     [-tsp, --truststorePass <truststore-password>]
                     [-stopServer]
                     [-f]
                     [-g]
                     [-to <shutdowntimeout>]
  • Parameters

    Parameter Description

    [-verbose]

    Displays detailed execution results.

    [-p --properties <properties-file>]

    File containing the settings required to execute the command.

    [-host <host-address>]

    Host address of the Node Manager to terminate.

    [-port <port>]

    Port number of the Node Manager to terminate.

    [-t,--type <connect-type>]

    Specifies whether to use SSL when connecting to the Node Manager. Specify one of the following options:

    • ssl

    • plain (default)

    [-ts,--truststoreFile <truststore-file>]

    Path to the truststore file when using SSL.

    [-tsp,--truststorePass <truststore-password>]

    Password for the truststore file when using SSL.

    [-stopServer]

    Terminates the servers managed by the Node Manager.

    [-f]

    Forces immediate termination without attempting a graceful shutdown (default).

    [-g]

    Specifies whether to gracefully terminate the process. Waits indefinitely for any pending requests to complete.

    [-to,--shutdowntimeout]

    Timeout period for graceful termination. Waits up to the specified time (in seconds) for pending requests to complete.

  • Example

    [NodeManager]domain1>stop-nodemanager
    Succeed to stop the node manager.
  • Note

    This command can be used without being connected to the server.

4. nm-start-server

Starts the server via Node Manager.

  • Alias

    nmstart, nmstartserver

  • Usage

    nm-start-server [-domain <domain-name>]
                    -server <server-name>
                    -u,--user <user-name>
                    -p,--password <password>
                    [-masterurl <masterurl>]
                    [-f,--force]
                    [-s,--standby]
                    [-host <nm-host>]
                    [-port <nm-port>]
                    [-t,--type <connect-type>]
                    [-ts,--truststoreFile <truststore-file>]
                    [-tsp,--truststorePass <truststore-password>]
  • Parameters

    Parameter Description

    [-domain <domain-name>]

    Name of the domain to which the server to start belongs.

    -server <server-name>

    Name of the server to start.

    -u,--user <user-name>

    Account name required to start the server.

    -p,--password <password>

    Password for the account required to start the server.

    [-masterurl <masterurl>]

    MASTER URL required to start MS.

    [-f, --force]

    Forces the server state to RUNNING even if application deployment fails when starting MS.

    [-s, --standby]

    Starts MS only up to the STANDBY state.

    [-host <nm-host>]

    Host address for connecting to the Node Manager to start the server when not already connected.

    [-port <nm-port>]

    Port number for connecting to the Node Manager to start the server when not already connected.

    [-t --type <connect-type>]

    Specifies whether to use SSL when connecting to the Node Manager. Specify one of the following options:

    • ssl

    • plain (default)

    [-ts,--truststoreFile <truststore-file>]

    Path to the truststore file when using SSL.

    [-tsp,--truststorePass <truststore-password>]

    Password for the truststore file when using SSL.

  • Example

    [NodeManager]domain1>nm-start-server -server server1 -u jeus -p jeus
    succeed to start server[server1].
      RUNNING
  • Note

    This command can be used without being connected to the server.

5. nm-stop-server

Terminates a server started via the Node Manager.

  • Alias

    nmstop-server, nmstopserver

  • Usage

    nm-stop-server [-domain <domain-name>]
                   -server <server-name>
                   -u,--user <user-name>
                   -p,--password <password>
                   [-to,--timeout <to>]
                   [-g,--graceful]
  • Parameters

    Parameter Description

    [-domain <domain-name>]

    Name of the domain to which the server to shut down belongs.

    -server <server-name>

    Name of the server to shut down.

    -u,--user <user-name>

    Account name required to connect to the server to shut down.

    -p,--password <password>

    Password for the account used to connect to the server to shut down.

    [-to,--timeout <to>]

    Timeout period for graceful termination. Waits up to the specified time (in seconds) for pending requests to complete.

    [-g, --graceful]

    Specifies whether to gracefully terminate the process. Waits indefinitely for any pending requests to complete.

  • Example

    [NodeManager]domain1>nm-stop-server -server server1 -u jeus -p jeus
    succeed to stop server[server1].
  • Note

    This command can be used without being connected to the server.

6. nm-state-server

Displays the status of a server started via Node Manager.

  • Alias

    nmstate-server, nmstateserver

  • Usage

    nm-state-server [-domain <domain-name>]
                    -server <server-name>
                    -u,--user <user-name>
                    -p,--password <password>
  • Parameters

    Parameter Description

    [-domain <domain-name>]

    Name of the domain to which the server whose status is being checked belongs.

    -server <server-name>

    Name of the server whose status to check.

    -u,--user <user-name>

    Account name required to connect to the server to check its status.

    -p,--password <password>

    Password for the account used to connect to the server to check its status.

  • Example

    [NodeManager]domain1>nm-state-server -server server1 -u jeus -p jeus
    server[server1] : RUNNING
  • Note

    This command can be used without being connected to the server.