Skip to main content

High Availability

PK Protect has the option to set up failover recovery for the controller. In the case of controller failure, all saved data will transfer to the secondary controller. Detection and protection tasks that are running when the primary agent or controller goes down may have to be re-run.

However, HDFS tasks that are running when the primary controller goes down will continue to run once the secondary controller comes online.

To implement the single node recoverability in both the controller and IDP side, Configure the following properties:

  1. Enable the EnableHDFSAgentHighAvailability=Y in file. If the Controller goes down, on coming up, it will remember all the tasks it submitted to various IDPs, and ping them to get their statuses.

  2. Enable the HA.enabled=Y property in file. If any IDP goes down, upon coming up, it will remember all the tasks which were in the middle of the execution. Also, it will try to restart or get statuses for those tasks.

Perform the following steps to set up high availability:

  1. Install the first instance of PK Protect and once the installation is complete, stop the Tomcat service of this instance.

  2. Install the second instance of PK Protect on a different machine using the same metadata repository of the first instance. Once the installation is complete, stop the Tomcat service of this instance.

  3. Start Tomcat from any of the above two PK Protect instances but make sure Tomcat service is running only for one instance at any given time.

  4. Login to Admin for the instance on which the Tomcat service was started.

HA Management

You can manage the High Availability (HA) feature through the HA Management screen. Access the HA Management screen by clicking the HA option in the left side pane. The HA Management screen is depicted below:

Perform the following steps to manage high availability:

  1. Select the HA option from the dropdown. The options are:

    1. None: The High Availability feature will not be set.

    2. Warm Standby: You can run two instances with only one active instance. In case the primary instance goes down, you need to make the secondary instance active. Refer Warm Standby for more details.

  2. Click Save.

Warm Standby

The main component of PK Protect is the DG controller which is backed up by another controller in warm standby mode. The other controller is activated when the primary controller goes down.


Warm Standby configuration enables two PK Protect Instances to point at the same backend database (metadata repository). One important condition for Warm Standby to work is that only one of the Tomcat Services should be up at any time.

When warm standby is enabled by selecting Warm Standby as the HA option. You can select which instance should be considered active. Select the passphrase that will be used when switching active instances.

Switching Active Instance

  1. When the user tries to bring up the Secondary Instance, the user will see the following screen:

  2. When PK Protect is starting up, it checks the DBMS table in the metadata repository to verify if the Warm Standby option is selected.

  3. Then checks if another instance is Active. If another instance is Active, PK Protect gives the below warning.

  4. Click Override Active Instance.

  5. A message is displayed asking the user to confirm the instance is not running. Click Yes.

  6. PK Protect asks for another verification that the user wants to switch active instances. Click Yes.

  7. Enter the Passphrase. It needs to be set from the Admin HA screen when the user configures Warm Standby.

  8. After authenticating, switch the Active Instance and user will be redirected to login screen.

  9. If Active Instance is switched, PK Protect invalidates all the active sessions to avoid multiple login sessions from both instances.

User should not be able to log into main UI of Inactive PK Protect Instance. Instead, they will get an error message “Please configure this instance as the Active one in Admin.”

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.