Skip to main content
Skip table of contents

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

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.

If you are using the certificate that is signed by a certificate authority on the Delphix connector, you can use either of the following ways:

  1. After upgrading the Delphix connector, re-execute the steps of Replacing Self-signed Certificates on the Delphix Connector.

  2. If you want to use the existing certificates, make sure to follow the below steps: 

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

  • Uninstall the Delphix connector.

  • Install the Delphix connector.

  • Stop the Delphix connector service.

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

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

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

    Note : 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.

If you are using windows connector host authentication, you can use either of the following ways:

  1. After upgrading the Delphix connector, re-execute the steps for windows connector host authentication.

  2. If you want to use the existing configuration of windows connector host authentication, make sure to follow the below steps: 

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

  • Uninstall the Delphix connector and then

  • Install the Delphix connector.

  • Stop the Delphix connector service.

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

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

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

JavaScript errors detected

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

If this problem persists, please contact our support.