Node Command

Command Purpose

The node command is used to query and control individual nodes across the JSLEE cluster.

Command Syntax

System Date

The current system date of a node can be queried using the date action:

node date [flags]

Some optional flags are available for all message types to control the manner in which the message is sent:

Flag Description
-h
-host
Send request to the specified host in the cluster. If not specified, the host that the command console is logged into will be used. If supplied, the value must match the server-name parameter of the configuration file, or the machine’s hostname if this is not configured.

Example output for the command node date might be:

node1: 2019-04-21T07:59:08.755

Stop Node

All JSLEE processes on a given node can be stopped using the stop action:

node stop [flags]

Some optional flags are available for all message types to control the manner in which the message is sent:

Flag Description
-y Allow the command to run without confirmation. Be very careful when using this flag!
-h
-host
Send request to the specified host in the cluster. If not specified, the host that the command console is logged into will be used. If supplied, the value must match the server-name parameter of the configuration file, or the machine’s hostname if this is not configured.

As this is a potentially destructive action, it must be confirmed by the user before being executed unless the -y flag is provided, as above.

List Nodes

All nodes running JSLEE processes in the cluster can be listed using the list action:

node list

Example output for the command node list might be:

node1
node2

Error Messages

Invalid Syntax

ERROR: command must be supplied.

The node command requires an action parameter to be passed to it.

ERROR: unknown command '<command>'.

The node command only accepts certain command keywords. Review the available commands and alter the input.

Command Failure

ERROR: System request was unsuccessful: <reason>

The node command failed for the given reason. Review the reason given. Contact N-Squared technical support if problems persist.

ERROR: Unable to send request to management service.

The command could not be sent to a manager process for handling. Ensure a manager process is running on the target node. Contact N-Squared technical support if problems persist.