Security Synchronisation Between Pulse Servers

Security Synchronisation Between Pulse Servers

Security Synchronisation allows a Pulse Administrator to unify security settings (users, groups, and memberships) across multiple Pulse servers by designating one as the Master Server and one or more as Dependent Servers. The Master Server acts as the single source of truth for all security definitions.

Access the Synchronisation Manager via Administration → Synchronisation Manager (on the Dependent Server for most operations).

Synchronisation Modes

Automatic Synchronisation

Pulls security settings from the Master Server on a scheduled frequency.

  1. Go to Administration → Synchronisation Manager on the Dependent Server.

  2. Enter the Master Server URL (e.g. http://yourserver:8099).

  3. Set the synchronisation frequency.

  4. Click Save Job and wait for confirmation.

Pulse will now synchronise security automatically at the configured interval.

Synchronisation on the Fly

Imports security from the Master Server immediately, on demand.

  1. Go to Administration → Synchronisation Manager on the Dependent Server.

  2. Ensure the job details (Master Server URL) are configured.

  3. Click Synchronise, confirm the prompt, and wait for the Security Imported message.

Deactivating a Sync Job

  1. Go to Administration → Synchronisation Manager on the Dependent Server.

  2. Set the Job Frequency to 0.

  3. Click Deactivate Sync and confirm. The sync will not run again until a frequency greater than zero is set and saved.

Manual Synchronisation (Export/Import via Files)

On the Master Server:

  1. Log in as Administrator and go to Administration → Synchronisation Manager.

  2. Under Manual Synchronisation, click Export Security and confirm.

  3. Three files are created in the <Pulse Installation Path>\Backup folder: Users.csv, Groups.csv, and GroupMembers.csv.

On the Dependent Server:

  1. Copy the three files into the Dependent Server's Backup folder.

  2. Log in as Administrator and go to Administration → Synchronisation Manager.

  3. Click Import Security and confirm.

  4. Users, groups, and group memberships are loaded from the files.

Post-Sync Behaviour

After synchronisation, all synced users on the Dependent Server(s) are attributed to the Master Server name. Modifications or deletions of synced users, groups, and roles must be made on the Master Server — they cannot be edited on Dependent Servers.

Common Issues

Issue

Cause

Resolution

Issue

Cause

Resolution

Server URL not reachable

Master Server is unavailable

Ensure the Master Server is running and accessible before saving the sync job

Missing files on import

One or more of the three CSV files is absent from the Backup folder

Ensure all three files (Users.csv, Groups.csv, GroupMembers.csv) are present

Version incompatibility

The two Pulse servers are on different versions

Upgrade both servers to the same version before synchronising