Upgrading the Delphix connector

The installed Delphix Connector may become outdated as newer versions of Delphix are released to improve stability or performance.

Upgrading the Delphix connector is a two-step process, which includes

• Uninstalling the Delphix connector

• Installing the Delphix connector

While the Delphix Connector is uninstalled on target/staging environments, dSource and virtual database (VDB) operations (such as validated sync, manual snapshots, and provisioning operations) initiated by the Delphix Engine against those environments will fail.

When working with target or staging environments or Delphix Engine with a large number of users to reduce the risk of confusion or failure for other users consider disabling each dSource in the environment. In the case of VDBs, there is no need to disable or shut down. If SnapSync, refresh or other VDB operations occur during the uninstall/install they can be restarted once the procedure is complete. This prevents the need to incur more downtime.

Choose how to handle the Delphix connector settings and certificates:

• Create a new certificate: To recreate the connector certificate during the upgrade, follow Regenerating self-signed end-entity and CA certificates.

• Keep the existing settings and certificates: Back up and restore the connector settings by following the procedure below.

To keep the existing configuration or certificates, complete these steps during the upgrade:

1. Before uninstalling, back up DelphixConnector.jks and the Keystore, Keypass, Storepass, and UUID properties from DelphixConnector.properties to a temporary location.

2. Uninstall the Delphix connector.
3. Install the Delphix connector.

4. Stop the Delphix connector service.

5. Restore the backed-up .jks file to the installation directory and restore the properties in DelphixConnector.properties.

6. Keep the Keystore, Keypass, Storepass, and UUID property values unchanged. Confirm that Keystore points to the correct installation directory.

   For example, if Keystore is C:\Program Files\Delphix\Delphix Connector\connector\DelphixConnector.jks, place the .jks file at that path.

After upgrading the Delphix connector, reapply certificate or host-authentication settings as applicable:

• If you use a certificate signed by a certificate authority on the Delphix connector, follow Replacing self-signed certificates on the Delphix connector.

• If you use Windows connector host authentication, follow Windows connector host authentication.