Skip to main content
Delphix

Relocating the Delphix Connector (KBA1200)

 

 

 

  • Note

Note:

This topic has been Retired and moved to Documentation. See Documentation:

Applicable Delphix Versions

  • 5.1
  • 5.0
  • 4.3
  • 4.2
  • 4.1
  • 4.0

Issue

There are times when the DelphixConnector installation requires a move to a different directory or drive. It's not a trivial relocation.  This requires disabling dSources and/or VDBs, uninstalling the current install and reinstalling to the new location. In addition to this, an upgrade to the DelphixConnector can also be achieved via the uninstall/reinstall methodology, including a change in location. These instructions cover Delphix Engine (DE) 4.0 through 5.1.  The steps are the same up to 5.1.2.0. At that version and forward it is no longer required to use the CLI to change the DelphixConnector location. All one needs to do is refresh the DelphixConnector environment and the new directory location is discovered and updated on the Delphix engine. In the steps listed below, the example is moving the connector from "C:\Program Files" to "C:\", so the new, relocated full connector path is "C:\Delphix\DelphixConnector".

Resolution

  1. When ready to move the DelphixConnector location, implying there is no activity on the dSources (if you are using this DelphixConnector on staging host) or the VDBs, stop the DelphixConnector service.
  2. Disable the dSources and/or VDBs associated to the DelphixConnector host.
    1. This will unmount the storage from the Windows host, removing the directories, the dSources represented by the staging databases, and the VDBs.
      1. dSource staging directories are in the form of "guid-staging-xx", where xx is the staging database number
      2. VDB directories are appended with "guid-vdb-xx".
  3. Backup the remaining directories as a precaution, in particular the logs directory.
  4. Uninstall the DelphixConnector, using the instructions from Uninstall the Delphix Connector.
  5. Reinstall the DelphixConnector to the new location, such as "C:\Delphix\DelphixConnector".  Check that the DelphixConnector service has started.
  6. Modify the new DelphixConnector location.
    1. On Delphix engine versions prior to 5.1.2.0, use the CLI to modify the directory
      1. de4350.dcenter host> select winhost.delphix.com
        de4350.dcenter host 'winhost.delphix.com'> update
        de4350.dcenter host 'winhost.delphix.com' update *> set toolkitPath="C:\Delphix\DelphixConnector"
        
        de4350.dcenter host 'winhost.delphix.com' update *> commit
            Dispatched job JOB-3203
            HOST_UPDATE job started for "winhost.delphix.com".
            HOST_UPDATE job for "winhost.delphix.com" completed successfully.
      2. Refresh the windows environment for the change to take affect.

    2. On engine versions 5.1.2.0 and higher, you only need to refresh the windows environment.
  7. Enable the dSources and/or VDBs.

Additional Information

 

Add context about the uninstall issue with error extracting

 

 

  • Was this article helpful?