Chat now with support
Chat with Support

One Identity Safeguard for Privileged Passwords 2.5 - Administration Guide

Introduction System requirements Installing the One Identity Safeguard for Privileged Passwords desktop client Setting up Safeguard for Privileged Passwords for the first time Getting acquainted with the console Privileged access requests Toolbox Accounts Account Groups Assets Asset Groups Directories Entitlements Partitions Settings
Access Request settings Appliance settings Asset Management settings Backup and Retention settings Certificate settings Cluster settings External Integration settings Messaging settings Profile settings Access settings Sessions settings
Users User Groups Disaster recovery and clusters Administrator permissions Preparing systems for management Troubleshooting Frequently asked questions
How do I access the API How do I audit transaction activity How do I configure external federation authentication How do I manage accounts on unsupported platforms How do I modify the appliance configuration settings How do I prevent Safeguard for Privileged Passwords messages when making RDP connections How do I see which assets and/or accounts are governed by a profile How do I set the appliance system time How do I setup discovery jobs How do Safeguard for Privileged Passwords database servers use SSL What are the access request states What do I do when an appliance goes into quarantine What is required for One Identity Safeguard for Privileged Passwords, embedded sessions module What is required to integrate with Starling Identity Analytics & Risk Intelligence What needs to be set up to use Application to Application What role-based email notifications are generated by default When does the rules engine run for dynamic grouping and tagging Why did the password change during an open request Why join Safeguard for Privileged Passwords to One Identity Starling
Safeguard Desktop Player Appendix: Safeguard ports

Cluster Management

Navigate to Administrative Tools | Settings | Cluster | Cluster Management.

The Cluster Management page is divided into left and right panes. If you do not see the right pane, click an appliance node in the left pane.

The "health" indicators on the nodes indicate if cluster members are in an error, warning, or healthy state.

  • Cluster view pane: The left pane displays a graphical representation of the primary and replica appliances belonging to the cluster.

  • Appliance details and cluster health pane: The right pane displays details about the appliance selected in the left pane. From this pane you can run maintenance and diagnostic tasks against the selected appliance.

Navigate to Administrative Tools | Settings | Cluster | Cluster Management. Use these toolbar buttons on the Cluster Management page to manage the members of a cluster.

Table 179: Cluster Management: Toolbar
Option Description


Return to the main Settings view.

Add Replica

Join an appliance to the primary appliance as a replica. For more information, see Enrolling replicas into a cluster.


Update the list of appliances in a cluster.

Reset Cluster

Reset a cluster to recover a cluster that has lost consensus. For more information, see Resetting a cluster that has lost consensus.

Caution: Resetting a cluster should be your last resort. It is recommended that you restore from a backup rather than reset a cluster.

Enable Offline Workflow

(appliance has lost consensus)

Place the appliance in Offline Workflow mode. The appliance will run in isolation from the rest of the cluster. For more information, see Enable offline workflow.

Resume Online Operations (appliance is in Offline Workflow mode)

Reintegrate the appliance with the cluster and merge audit logs. For more information, see To resume online operations.

Cluster view pane

Navigate to Administrative Tools | Settings | Cluster | Cluster Management.

Initially, the Cluster view pane (left pane) displays a single "primary" node for the appliance you are currently logged into. As you join appliances to the cluster, replica nodes will be shown as being connected to the primary node.

The "health" indicators on the nodes and in the upper right corner of this pane provide a quick view as to whether cluster members are in an error, warning, or healthy state.

A warning icon identifies a potential issue with the cluster. An error icon indicates a definite problem impacting the functionality of the cluster. Expand the View More section to see more details.

Clicking a member of the cluster in this pane displays details about the appliance and the health of the cluster member. For more information, see Appliance details and cluster health pane.

Appliance details and cluster health pane

Cluster members periodically query other appliances in the cluster to obtain their health information. Cluster member information and health information is cached in memory, with the most recent results displayed on the Cluster settings screen.

Navigate to Administrative Tools | Settings | Cluster | Cluster Management. In the cluster view (left pane), click a member of the cluster to refresh the display of the right pane. From the right pane you can monitor the health of the selected appliance and perform operations against the appliance.

Table 180: Cluster health toolbar buttons
Option Description


Click Unjoin to remove a replica from the cluster. For more information, see Unjoining replicas from a cluster.


Click Failover to promote a replica to the primary appliance. For more information, see Failing over to a replica by promoting it to be the new primary.


Click Activate to activate a Read-only appliance so it can add, modify and delete data. For more information, see Activating a read-only appliance.

CAUTION: Activating an appliance that is in Read-Only mode will take it out of the Read-only state and enable password 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.


Click Diagnose to open the Diagnostics pane where you can perform the following:

Check Health

Click Check Health to capture and display the current state of the selected appliance.


Click Restart to restart the selected appliance.

Confirm your intentions by entering a Reason and clicking Restart.

Below the toolbar, this pane displays the following information about the appliance selected in the cluster view.

Table 181: Appliance properties
Property Description
Appliance name

The name of the appliance.

IP address

The IPv4 address (or IPv6 address) of the appliance configuration interface.

NOTE: You can modify the appliance IP address using the web client. For more information, see How do I modify the appliance configuration settings.
Appliance type

Indicates either Primary or Replica.

Appliance state

Indicates the appliance state. For a list of available states, see Appliance states.

Disk Space

The amount of used and free disk space.

Click View More to show or hide this additional information:

Property Description
Serial Number

The serial number of the appliance.


The amount of time (days, hours, and minutes) the appliance has been running.

Primary (displayed on replicas)
Property Description
Network Address

The network DNS name or the IP address of the primary appliance in the cluster.

MAC Address

The media access control address (MAC address), a unique identifier assigned to the network interface for communications.

Link Present

Displays either Yes or No to indicate if there is an open communication link.

Link Latency

The amount of time (in milliseconds) it takes for the primary to communicate with the replica. Network latency is an expression of how much time it takes for a packet of data to get from one designated point to another. Ideally latency is as close to zero as possible.

Property Description
Last Health Check

Last date and time Safeguard for Privileged Passwords obtained the selected appliance's information.

Version The appliance version number.


Errors are reported. For example, if an appliance is disconnected from the primary (no quorum), an error message may be: Request Workflow: Cluster configuration database health could not be determined.


Warnings are reported. For example, if an appliance is disconnected from the primary (no quorum), a warning message may be: Policy Data: There is a problem replicating policy data. Details: Policy database slave IO is not running. The Safeguard primary may be inaccessible from this appliance.

Managed Networks

Managed networks are named lists of network segments that can be serviced by specific Safeguard for Privileged Passwords Appliances within a clustered environment. Managed networks are used for scheduling tasks, such as password change, account discovery, and asset discovery, in a clustered environment to distribute the task load. That is, using managed networks you can distribute the load in such a way that there is minimal cluster traffic and specify to use the appliances that are closest to the target asset to perform the actual task.

Navigate to Administrative Tools | Settings | Cluster | Managed Networks. The Managed Networks page displays the following information about previously defined managed networks. Initially, this page contains the properties for the Default Managed Network, which implicitly includes all networks and is served by all appliances in the cluster.

Table 182: Managed Networks: Properties
Property Description


The name assigned to the managed network when it was added to Safeguard for Privileged Passwords.


The name of the Safeguard for Privileged Passwords user that added the managed network.

Created On

The date and time the managed network was added to Safeguard for Privileged Passwords.


A list of subnets included in the managed network.

Double-click an entry in the Managed Networks grid to display details about the subnets associated with the selected managed network.

Managed By

The name of the appliances and the MAC address assigned to manage the specified subnets.


The descriptive text entered when defining the managed network.

Use these toolbar buttons to define and maintain your managed networks.

Table 183: Managed Networks: Toolbar
Option Description
New Add a managed network. For more information, see Adding a managed network.
Delete Selected

Remove the selected managed network from Safeguard for Privileged Passwords. You cannot delete the Default Managed Network.

Refresh Update the list of managed networks.

Modify the selected managed network configuration. You can not modify the Default Managed Network.

Resolve Network

Locate an IP address in a managed network's list of subnets. For more information, see Resolving IP address.
Related Documents