Failing over to a replica by promoting it to be the new primary
Safeguard for Privileged Passwords allows you to failover to a replica appliance by promoting it to be the new primary.
NOTE: You can promote a replica to be the new primary anytime the cluster has consensus (that is, the majority of the cluster nodes are online and able to communicate). If you have a quorum failure (that is, the majority of the cluster members do not achieve consensus), you must perform a cluster reset instead. For more information, see Resetting a cluster that has lost consensus.
To promote a replica to be the new primary in a cluster
- log in to a healthy cluster member as an Appliance Administrator.
- Go to Cluster Management:
- web client: Navigate to Cluster > Cluster Management.
- In the cluster view (left pane), select the replica node that is to become the new primary.
- Click Failover.
-
In the Failover confirmation dialog, enter the word Failover and click OK to proceed.
During the failover operation, all of the appliances in the cluster are placed in Maintenance mode.
Once the failover operation completes, the selected replica appliance appears as the primary with a state of online. All other appliances (including the "old" primary) in the cluster appear as replicas with a state of online.
Activating a read-only appliance
Appliances that have been unjoined from a Safeguard for Privileged Passwords cluster or restored from a backup are placed in a Read-only mode.
You can activate an appliance in Read-only mode so you can add, delete, and modify data, apply access request workflow, and so on.
The appliance in Read-only mode must be online in order to use the Activate task. If it is offline or the cluster does not have consensus (that is, the majority of the remaining members are offline/unable to communicate), you must use the Cluster Reset option to rebuild your cluster. For more information, see Resetting a cluster that has lost consensus.
|
CAUTION: Activating an appliance that is in Read-Only mode will take it out of the Read-only state and enable password and SSH key check and change for managed accounts. Ensure that no other Safeguard for Privileged Passwords Appliance is actively monitoring these accounts, otherwise access to managed accounts could be lost. |
To activate a read-only appliance
- Log in to the read-only appliance as an Appliance Administrator.
-
Go to Cluster Management where the cluster view (on the left) displays one primary appliance with a yellow warning icon indicating the appliance is in a Read-only mode.
- web client: Navigate to Cluster > Cluster Management.
- In the cluster view (on the left), select the read-only node to be activated.
- Click Activate.
-
In the Activate confirmation dialog, enter the word Activate and click OK to proceed.
The appliance's node in the cluster view (on the left) no longer displays the yellow warning icon and the state is now Online.
Diagnosing a cluster member
The diagnostic tools are available to an Appliance Administrator or Operations Administrator for the currently connected appliance and any other appliances (replicas) in the cluster.
To run diagnostics on a clustered appliance
- Go to Cluster Management:
- web client: Navigate to Cluster > Cluster Management.
- From the cluster view (on the left) select the appliance to be diagnosed.
-
Click Diagnose.
- Click Network Diagnostics.
-
Choose the type of test to perform and complete the steps.
- ARP: Use Address Resolution Protocol (ARP) to discover the Interface, Internet Address, Physical Address, and Type (dynamic or static).
- Netstat: Use netstat to display the active connection protocol, local address, foreign address, and state.
- NS Lookup: To obtain your domain name or IP address.
- Ping: To verify your network connectivity and response time.
- Show Routes: To retrieve routing table information.
- Telnet: To access remote computers over TCP/IP networks like the internet.
- Throughput: Test throughput to other appliances in the cluster.
- Trace Route: To obtain your router information; trace route determines the paths packets take from one IP address to another.
Patching cluster members
When an appliance update is released, apply the patch so all appliances in the cluster are on the same version. See About cluster patching for more information on how Safeguard for Privileged Passwords handles access requests and system failures during the cluster patching process.
Prior to installing an update patch to a cluster
To patch appliances in a cluster
- Log in to the primary appliance, as an Appliance Administrator.
- Go to the patch updates page:
- web client: Navigate to Appliance > Patch Updates.
-
Click Upload a File and browse to select an update file.
The patch will be uploaded and distributed to all of the appliances in the cluster.
NOTE: If you make changes to the cluster, such as adding a new replica, while a patch is staged, the update file must be distributed to the new cluster member before the patch install process can begin. Safeguard for Privileged Passwords will not allow the patch install process to begin until all of the cluster members report that they have the update file stored locally.
NOTE: Clicking the Cancel button during the distribution process stops the distribution of the update file to the replicas. At this point, you can click one of the following buttons:
- Remove to remove the update file from all of the appliances in the cluster.
- Distribute to Cluster to continue distributing the update file to each replica in the cluster.
-
Once the file has been successfully distributed to all of the replicas in the cluster, click the Install Now button.
The primary appliance will go into Maintenance mode to begin the update operation. Once the primary appliance is successfully updated, Safeguard for Privileged Passwords will perform the update operation on each replica, one at a time. During an update operation, the cluster will be locked so that no other cluster operations can interfere with the update operation. Once the update operation is completed on all cluster members, the cluster will automatically unlock so normal operations can resume.
The Cluster view shows that an update operation is in progress and the cluster members that are locked, awaiting to install the update file. Go to:
- web client: Navigate to Cluster > Cluster Management.
In addition, go to Patch Updates:
- web client: Navigate to Appliance > Patch Updates.