There are two additional tasks required to complete the failover process. The first (if applicable) is to add the SSH key to the replicated engine, and the second task is to enable the objects on the CD engine that received a replica.

SSH keys - custom key pairs

If using custom key pairs, you will not need to add them to the source, staging, and target environments because the public and private keys are already replicated. Proceed to the Enabling replicated objects section for further instructions on how to enable the replicated objects.

SSH keys - engine public key

If using an engine public key, you will need to add the key to the source, staging, and target environments. This additional step is required because the replication process does not automatically copy engine public SSH keys to the source, staging, and target environments.

To add the now primary engine's public key: - Note: The following steps are performed on the CD engine. You can access connected engines from DCT via Data Infrastructure > Data Engines.

  1. Click Manage.

  2. Select Environments.

  3. Select any environment.

  4. Under Environment Users, click the edit icon () next to the defined user.

  5. Click View Public Key to display the public key for the Delphix Engine.

  6. Highlight the public key string (starts with “ssh-rsa”) and copy the key to your clipboard (Ctrl+C in Windows).

  7. On each source and target host within your defined environments, paste the engine public key into the environment user's authorized_keys file, which is normally located in the user’s ~/.ssh/ directory.

Enable replicated objects

When you have copied the engine public key (if applicable), the final stage is to ensure the replication is successful and the configuration of each object is correct. To do this, you must first enable environments, and then you can enable dSources and VDBs.

Before enabling failed-over environments, dSources, and VDBs, add to the target engine's TrustStore the CA certificates from the source engine's TrustStore that are required by the configurations you are enabling, including replication client authentication and CD engine-level certificate-based password vault integrations. See TrustStore settings for the certificate installation procedure.

Enable environments

  1. Log in to the Delphix Management application.

  2. Click Manage.

  3. Select Environments.

  4. Select an environmentthat you want to enable.

  5. From the Actions menu (...) select Enable. This will initiate jobs that will refresh and enable the environment.

  6. Repeat steps 1 to 5 for any additional environments that you want to enable.

Enable dSources and VDBs

  1. Log in to the Delphix Management application.

  2. Click Manage.

  3. Select Datasets.

  4. Click the dSource or VDB you want to enable.

  5. From the Actions menu (...) select Enable.

  6. Click Enable to confirm.

The failover process is now completed. All objects should now be running off the target CD engine and visible in DCT's unified cross-engine view.

Last updated
Oct 14, 2026