Upgrade 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.

You can use either of the following ways:

1. After upgrading the Delphix connector:

   • (For self signed one): If you are using the certificate that is signed by a certificate authority on the Delphix connector, re-execute the steps of Replacing Self-signed Certificates on the Delphix Connector.

   • (For host authentication): If you are using windows connector host authentication, re-execute thesteps for Windows connector host authentication.

2. To use the existing configuration or certificates: 

   1. Before uninstalling, you must back up DelphixConnector.jks file and properties such as Keystore, Keypass, Storepass and UUID from DelphixConnector.properties file to a temporary location.

   2. Uninstall the Delphix connector 

   3. Install the Delphix connector.

   4. Stop the Delphix connector service.

   • You can now copy the backed-up .jks file and properties.

   5. Paste the backed-up .jks file inside the installation directory and the properties to the DelphixConnector.properties file.

   6. Ensure that the Keystore, Keypass, Storepass and UUID properties are kept unchanged, and Keystoreproperty must point to the correct installation directory.

      For example, if the Keystore is C:\Program Files\Delphix\Delphix Connector\connector\DelphixConnector.jks, make sure to place this .jks file is in the same path as mentioned in Keystore.