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:
After upgrading the Delphix connector, re-execute the steps of Replacing Self-signed Certificates on the Delphix Connector.
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 asKeystore, Keypass, Storepass
andUUID
fromDelphixConnector.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, andKeystore
property 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:
After upgrading the Delphix connector, re-execute the steps for windows connector host authentication.
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 asKeystore, Keypass, Storepass
andUUID
fromDelphixConnector.properties
file to a temporary location.Uninstall the Delphix connector and then
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, andKeystore
property 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.