Controller: MailVirus

API Controller	/nodeworx/mail/virus
Required Permissions	["EMAIL"]

Action	Description
autoRestart	Set the clamav autorestart status.
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.
options	Update clamav options.
restart	Restarts the service.
restartOnNode	Restarts the service on a specific node (Clustering only).
start	Starts the service.
startOnBoot	Set the clamav start-on-boot status.
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: autoRestart (Added in version 4.3.0-299)

Set the clamav autorestart status.

Input Parameters

Name	Type	Notes	Required?
clamav_autorestart	integer	Help Entry With this option on you can have ClamAV restarted automatically if ClamAV goes down unexpectedly. Example Values 1, 0 Example Default Value 0	No*
* indicates that it's actually required, but probably already has a valid default value

Action: isRunning (Added in version 4.2.0-260)

Checks if the service is running or not.

Example Output

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

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.2.0-260)

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

Example Output

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

Action: listPortNumbers (Added in version 4.2.0-260)

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

Example Output

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

Action: listPortNumbersArray (Added in version 4.2.0-260)

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

Example Output

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

Action: listRequiredPermissions (Added in version 4.2.0-260)

Lists an array of permissions required to control the service.

Example Output

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

Action: listServiceInfo (Added in version 4.2.0-260)

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

Example Output

array (
  'status' => 0,
  'payload' => 
  array (
    'id' => 'clamd',
    'name' => '##LG_VIRUS_FILTERING##',
    'ports' => '3310',
    'page' => '/nodeworx/mail/virus',
    'ctrl' => '/nodeworx/mail/virus',
    'is_running' => 1,
  ),
)

Action: listServiceName (Added in version 4.2.0-260)

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

Example Output

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

Action: listServicePage (Added in version 4.2.0-260)

Lists the page that controls the service.

Example Output

array (
  'status' => 0,
  'payload' => '/nodeworx/mail/virus',
)

Action: options

Update clamav options.

Input Parameters

Name	Type	Notes	Required?
clamav_smtpscanning	integer	Help Entry Use the dropdown to enable or disable email virus scanning on the server level. Example Values 1, 0 Example Default Value 0	No*
cascade_to_nodes	integer	Help Entry Selecting this option causes the action to be replayed on all nodes of the cluster automatically, as if you had logged in to each node manually Example Values 1	No
* indicates that it's actually required, but probably already has a valid default value

Action: restart (Added in version 4.2.0-260)

Restarts the service.

Input Parameters

Name	Type	Notes	Required?
cascade_to_nodes	integer	Help Entry Selecting this option causes the action to be replayed on all nodes of the cluster automatically, as if you had logged in to each node manually Example Values 1	No

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.2.0-260)

Starts the service.

Input Parameters

Name	Type	Notes	Required?
cascade_to_nodes	integer	Help Entry Selecting this option causes the action to be replayed on all nodes of the cluster automatically, as if you had logged in to each node manually Example Values 1	No

Action: startOnBoot (Added in version 4.3.0-290)

Set the clamav start-on-boot status.

Input Parameters

Name	Type	Notes	Required?
clamav_startonboot	integer	Help Entry With this option on you can have ClamAV restarted automatically if ClamAV goes down unexpectedly. Example Values 1, 0 Example Default Value 1	No*
* indicates that it's actually required, but probably already has a valid default value

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.2.0-260)

Stops the service.

Input Parameters

Name	Type	Notes	Required?
cascade_to_nodes	integer	Help Entry Selecting this option causes the action to be replayed on all nodes of the cluster automatically, as if you had logged in to each node manually Example Values 1	No

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