Distributed Vault Promotion Checklist

cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
Announcements

Welcome Idira to LIVEcommunity!

Our community just got stronger! Explore new identity security resources, connect with experts, and discover more ways to learn and collaborate.

Meet Idira

PAM Self-Hosted Articles
6 min read
L7 Applicator
No ratings
This document contains the process for configuring the distributed vault components for promotion.  Additionally, it has detailed steps to perform promotion of distributed vaults. 

Audience

Customers that have distributed vaults in place and have the desire to test the promotion from Master to Master Candidate.

Definitions

Server namesInitial roles
CyberArkMV01Master Vault
CyberArkS01Satellite vault running as Master Candidate
CyberArkS02Satellite vault 2
CyberArkS03Satellite vault 3
 

Assumptions

All vaults are in good health and capable of promotion.  Configurations are to Idira best practices or within best practice tolerance. 

Steps

Distributed Vaults – Promotion Prerequisites 

  1. Verify all satellites are up, running and replicating from the Master
  2. Configure the Master Candidate CyberArkS01 for Automatic Promotion:
***Master Candidate can only be set on 1 satellite vault at a time
  1. On CyberArkS01:
____  Check the DBParm.ini file DRIVE:\Program Files (x86)\PrivateArk\Server\conf
____  Verify DistributedVaultsMode=Yes
____  Check the PADR.ini file DRIVE:\Program Files (x86)\PrivateArk\PADR\conf
____  Set EnableFailover=Yes
____  Restart the Idira Vault Disaster Recovery service
____  Wait for two full replications before doing any promotion testing!

ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOG.png
 

Testing Promotion from CyberArkMV01 to CyberArkS01

  1. Verify the PADR.ini file on CyberArkS01 is set to the following:
               ____  Verify DistributedVaultsMode=Yes
               ____  Verify EnableFailover=Yes
If values are not set, please refer to Distributed Vaults – Promotion Prerequisites
  1. Stop the Private Ark Server service on CyberArkMV01

____  From the PrivateArk Server GUI on CyberArkMV01, ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOH.png stop the service
____  Check the italog on the satellite servers for the following:
           ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOI.png
____  Check the padr.log on CyberArkS01; it should start reporting errors with communication to the Master Vault:
     ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOJ.png
After 5 failed attempts CyberArkS01 will initiate automatic promotion and become the Master
____  Verify the padr.log file
      ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOK.png
     ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOL.png

____  Check the italog on CyberArkS01:

ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOM.png
____  Check the italog on other satellites

ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuON.png

 

Set CyberArkMV01 to New Master Candidate

  1. On CyberArkMV01, verify the following services are stopped:
ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuN3.png
ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuN8.png
 
  1. Start the PrivateArk Database Service
  2. Set CyberArkMV01 to Replicate data from CyberArkS01:
    1. On CyberArkMV01:
____  Edit the PADR.ini file DRIVE:\Program Files (x86)\PrivateArk\PADR\Conf\PADR.ini
____  Remove the ‘LastDataReplicationTimestamp=XXXXXXX’ field
____  Remove the ‘NextBinaryLogNumberToStartAt=’ field
____  Change the value on ‘EnableFailover=’ to Yes
____  Save and close the file
____  Edit the Vault.ini DRIVE:\Program Files (x86)\PrivateArk\PADR\conf
____  Change the IP in the ‘ADDRESS=’ field to the Master Candidate IP
____  Save and Close the File
____  Open a command prompt as Admin and browse to DRIVE:\Program Files (x86)\PrivateArk\Server
           Run the following command:
____  CaVaultManager ConfigureAsSatellite /ResetMasterAddress
***NOTE: When the above command is executed, a full DR replication must be run by deleting the ‘LastDataReplicationTimestamp=XXXXXXX’ field and ‘NextBinaryLogNumberToStartAt=’ field in the PADR.ini file.
Type yes to agree to make the vault read only
Type yes to agree to other vaults in the system connecting to this IP address
**** STOP if it doesn’t match the IP that is intended for communication******
ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOO.png
                              ____  Verify the PADR.ini and Vault.ini are the same as when edited above
  1. Verify replication from CyberArkS01 to CyberArkMV01:
    1. On CyberArkMV01:

____  Check the following services have started:
          ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOP.png
          ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOQ.png
____  Check that CyberArkMV01 is reporting as Satellite in Idira italog and                                                    can contact the CyberArkS01:
           ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOR.png
____  Check replication has been successful in the PADR.log file:
           ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOS.png
____  Replicate a 2nd time:
           (R&D recommends to wait 5 minutes)
           ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOT.png

Promoting back from CyberArkS01 to CyberArkMV01

              

Testing Promotion from CyberArkS01 to CyberArkMV01

  1. Verify the PADR.ini file on CyberArkMV01 is set to the following:
               ____  Verify DistributedVaultsMode=Yes
               ____  Verify EnableFailover=Yes
If values are not set, please refer to Distributed Vaults – Promotion Prerequisites, replacing CyberArkS01 for CyberArkMV01
  1. Stop the Private Ark Server service on CyberArkS01:
____  From the PrivateArk Server GUI on the CyberArkS01, ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOU.png stop the service
____  Check the italog on CyberArkMV01 for the following:
           ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOV.png
____  Check the padr.log on CyberArkMV01; it should start reporting errors with communication to CyberArkS01:
     ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOW.png
After 5 failed attempts CyberArkMV01 will initiate auto promotion and become the Master
____  Verify the padr.log file:
            ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOX.png
  1. Check the Idira italog on CyberArkMV01:
               ____  Promoting Vault to Master Role
____  Vault is set to Master Role
                         ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOY.png
  1. Check the Idira italog on the Satellites
                        ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOZ.png
 

Revert CyberArkS01 to its original state (Master Candidate)

 

Set CyberArkS01 to New Master Candidate

  1. On CyberArkS01, verify the following services are stopped;
ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuNN.png
ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuNS.png
 
  1. Start the PrivateArk Database Service
  2. Set CyberArkS01 to Replicate Data from CyberArkMV01:
    1. On CyberArkS01:
____  Edit the PADR.ini file DRIVE:\Program Files (x86)\PrivateArk\PADR\Conf\PADR.ini
____  Remove the ‘LastDataReplicationTimestamp=XXXXXXX’ field
____  Remove the ‘NextBinaryLogNumberToStartAt=’ field
____  Change the value on ‘EnableFailover=’ to Yes
____  Save and close the file
____  Edit the Vault.ini DRIVE:\Program Files (x86)\PrivateArk\PADR\conf
 ____ Change the IP in the ‘ADDRESS=’ field to the Master Candidate IP
____  Save and Close the File
____  Open a command prompt as Admin browse to DRIVE:\Program Files (x86)\PrivateArk\Server
           Run the following command:
____  CaVaultManager ConfigureAsSatellite /ResetMasterAddress
***NOTE: When the above command is executed, a full DR replication must be run by deleting the ‘LastDataReplicationTimestamp=XXXXXXX’ field and ‘NextBinaryLogNumberToStartAt=’ field in the PADR.ini file.
Type yes to agree to make the vault read only
Type yes to agree to other vaults in the system connecting to this IP address
**** STOP if it doesn’t match the IP that is intended for communication******
ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOa.png
                              ____  Verify the PADR.ini and Vault.ini are the same as when edited above
 
  1. Verify replication from CyberArkMV01 to CyberArkS01
    1. On CyberArkS01:
____  Check the following services have started:
          ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOb.png
          ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOc.png
____  Check that CyberArkS01 is reporting as Satellite in Idira Server log and                                                    can contact CyberArkMV01:
           ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOd.png
____  Check replication has been successful in the PADR.log file on CyberArkS01:
           ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOe.png
____  Replicate a 2nd time on CyberArkS01:
           (R&D recommends wait 5 minutes)
           ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOf.png
 

Appendix  A

 
  1. Specify Vault as a satellite:

____  Open a command prompt as Admin browse to DRIVE:\Program Files (x86)\PrivateArk\Server
           Run the following command:
____  CaVaultManager ConfigureAsSatellite
Type yes to agree to Make the vault read only
Type yes to agree to other vaults in the system connecting to this IP address
**** STOP if it doesn’t match the IP that is intended for communication******

ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOg_1.png
  1. Restart the Idira Vault Disaster Recovery Service on the Satellite Vault to trigger a replication between Master & Satellite:
____  Verify replication is taking place on the Satellite Vault by checking the PADR.log DRIVE:\Program
           Files (x86)\PrivateArk\PADR\PADR.log
ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOh_1.png
____  Verify the following services are running:
ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOi_1.png
ka3Ht0000009UQIIA2__eid=ka3Ht0000009UQI&feoid=00N2J000009R3kv&refid=0EM2J000003JuOj_1.png




 
Rate this article:
  • 3686 Views
  • 0 comments
  • 0 Likes
Article Dashboard
Version history
Last Updated:
‎11-05-2026 12:00 PM
Updated by: