backup_cm_set

Use this command, on a central manager only, to define a backup, or secondary, central manager.

This API is available in Guardium V11.2 and later.

Note: Switching to a backup central manager interrupts communication with collectors and may generate the following message: "Central manager experienced failed data transfer from collector." The issue is visible in the Scheduled Jobs Exceptions report and should clear within 24-hours.

REST API syntax

This API is available as a REST service with the PUT method. Call this API as follows:

PUT https://[Guardium hostname or IP address]:8443/restAPI/backup_cm

GuardAPI syntax

backup_cm_set parameter=value

Parameters

Parameter	Value type	Description
ip	String	Required. The IP of the backup central manager. For valid values, call backup_cm_set from the command line with `--help=true`. Enter this parameter with no IP value to delete the current secondary central manager.

GuardAPI example

To set the backup central manager to 9.142.10.100, enter this command on the primary central manager:

grdapi backup_cm_set ip=9.142.10.100
Backup CM designated

Output if the IP is invalid or not one of the allowed candidates:

Wrong value: "ip" must be one of 
<ip> (<hostname>)
<ip> (<hostname>)
<ip> 
...
ERR=23
Value not in constant list.

REST API example

To set the backup central manager to 9.142.10.100:

curl \
-k --header "Authorization:Bearer d51c41d0-a6b1-4aa3-90bc-5232a44e8b0d" \
--include --header "Content-Type: application/json" \
-X PUT --data '{"ip":"9.142.10.100"}' https://<CM-hostname>:8443/restAPI/backup_cm