Controller: CommandQueue

API Controller /nodeworx/command/queue
Required Permissions ["LOGIN"]
Action Description
isRunning Checks if the service is running or not.
isRunningOnNode Checks if the service is running on a specific node (Clustering only).
listGeneralName Lists the "normal" name - ie "web server" instead of "httpd".
listPortNumbers Lists a string of the port numbers that this service uses, comma-seperated.
listPortNumbersArray Lists array of port numbers and ranges that this service uses.
listRequiredPermissions Lists an array of permissions required to control the service.
listServiceInfo Lists the service name, ports, page, and status.
listServiceName Lists the service name - ie "httpd" instead of "web server".
listServicePage Lists the page that controls the service.
queryCommandHistory View history of the command queue.
queryQueuedCommands Query the command queue on a node.
restart Restarts the service.
restartOnNode Restarts the service on a specific node (Clustering only).
start Starts the service.
startOnNode Starts the service on a specific node (Clustering only).
stop Stops the service.
stopOnNode Stops the service on a specific node (Clustering only).

Action: isRunning (Added in version 4.3.0-290)

Checks if the service is running or not.

Example Output

array (
  'status' => 0,
  'payload' => false,
)

Action: isRunningOnNode (Added in version 4.3.0-290)

Checks if the service is running on a specific node (Clustering only).

Input Parameters

Name Type Notes Required?
node_id string No*
* indicates that it's actually required, but probably already has a valid default value

Action: listGeneralName (Added in version 4.3.0-290)

Lists the "normal" name - ie "web server" instead of "httpd".

Example Output

array (
  'status' => 0,
  'payload' => '##LG_COMMAND_QUEUE##',
)

Action: listPortNumbers (Added in version 4.3.0-290)

Lists a string of the port numbers that this service uses, comma-seperated.

Example Output

array (
  'status' => 0,
  'payload' => 'N/A',
)

Action: listPortNumbersArray (Added in version 4.3.0-290)

Lists array of port numbers and ranges that this service uses.

Example Output

array (
  'status' => 0,
  'payload' => 
  array (
    0 => 'N/A',
  ),
)

Action: listRequiredPermissions (Added in version 4.3.0-290)

Lists an array of permissions required to control the service.

Example Output

array (
  'status' => 0,
  'payload' => 
  array (
    0 => 'LOGIN',
  ),
)

Action: listServiceInfo (Added in version 4.3.0-290)

Lists the service name, ports, page, and status.

Example Output

array (
  'status' => 0,
  'payload' => 
  array (
    'id' => 'iworx-queue-d',
    'name' => '##LG_COMMAND_QUEUE##',
    'ports' => 'N/A',
    'page' => '/nodeworx/command/queue',
    'ctrl' => '/nodeworx/command/queue',
    'is_running' => 0,
  ),
)

Action: listServiceName (Added in version 4.3.0-290)

Lists the service name - ie "httpd" instead of "web server".

Example Output

array (
  'status' => 0,
  'payload' => 'iworx-queue-d',
)

Action: listServicePage (Added in version 4.3.0-290)

Lists the page that controls the service.

Example Output

array (
  'status' => 0,
  'payload' => '/nodeworx/command/queue',
)

Action: queryCommandHistory (Added in version 4.3.0-290)

View history of the command queue.

Input Parameters

Name Type Notes Required?
count integer
Example Default Value
20
No*
node_id string No*
* indicates that it's actually required, but probably already has a valid default value

Action: queryQueuedCommands (Added in version 4.3.0-290)

Query the command queue on a node.

Input Parameters

Name Type Notes Required?
node_id string No*
* indicates that it's actually required, but probably already has a valid default value

Action: restart (Added in version 4.3.0-290)

Restarts the service.

Action: restartOnNode (Added in version 4.3.0-290)

Restarts the service on a specific node (Clustering only).

Input Parameters

Name Type Notes Required?
node_id string No*
* indicates that it's actually required, but probably already has a valid default value

Action: start (Added in version 4.3.0-290)

Starts the service.

Action: startOnNode (Added in version 4.3.0-290)

Starts the service on a specific node (Clustering only).

Input Parameters

Name Type Notes Required?
node_id string No*
* indicates that it's actually required, but probably already has a valid default value

Action: stop (Added in version 4.3.0-290)

Stops the service.

Action: stopOnNode (Added in version 4.3.0-290)

Stops the service on a specific node (Clustering only).

Input Parameters

Name Type Notes Required?
node_id string No*
* indicates that it's actually required, but probably already has a valid default value