Migrating a Delphix Engine to Another Network (KBA10471)

Issue

This article describes how to migrate a Delphix Engine to a new network.

Applicable Delphix Versions

Click here to view the versions of the Delphix engine to which this article applies

Date	Release
Sep 21, 2023	15.0.0.0
Aug 24, 2023	14.0.0.0
Jul 24, 2023	13.0.0.0
Jun 21, 2023	12.0.0.0
May 25, 2023	11.0.0.0
Apr 13, 2023	10.0.0.0 | 10.0.0.1
Mar 13, 2023 | Mar 20, 2023	9.0.0.0 | 9.0.0.1
Feb 13, 2023	8.0.0.0
Jan 12, 2023	7.0.0.0
Releases Prior to 2023
Major Release	All Sub Releases
6.0	6.0.0.0, 6.0.1.0, 6.0.1.1, 6.0.2.0, 6.0.2.1, 6.0.3.0, 6.0.3.1, 6.0.4.0, 6.0.4.1, 6.0.4.2, 6.0.5.0, 6.0.6.0, 6.0.6.1, 6.0.7.0, 6.0.8.0, 6.0.8.1, 6.0.9.0, 6.0.10.0, 6.0.10.1, 6.0.11.0, 6.0.12.0, 6.0.12.1, 6.0.13.0, 6.0.13.1, 6.0.14.0, 6.0.15.0, 6.0.16.0, 6.0.17.0, 6.0.17.1, 6.0.17.2
5.3	5.3.0.0, 5.3.0.1, 5.3.0.2, 5.3.0.3, 5.3.1.0, 5.3.1.1, 5.3.1.2, 5.3.2.0, 5.3.3.0, 5.3.3.1, 5.3.4.0, 5.3.5.0, 5.3.6.0, 5.3.7.0, 5.3.7.1, 5.3.8.0, 5.3.8.1, 5.3.9.0

How to migrate your Delphix Engine from one network to another:

Complete the following procedure to migrate your engine:

1. Stop all running VDBs by clicking the Stop button on the VDB card.
2. Disable all dSources.
3. Make sure that replication is not in progress or about to start (primary engine only). If the replication happens via the scheduler, you can also disable the automatic replication.
4. Log into the Delphix Engine as sysadmin user via the Vmware console (preferred) or via SSH (CLI). If you perform the steps via SSH, please make sure you also have Vmware console available in case of issues.
5. List and save the current configuration:

   delphix> network setup
   delphix  network setup> ls
   
   Properties
          defaultRoute: 10.145.0.1
          dhcp: false
          dnsDomain: delphix-dev
          dnsServers: 10.145.0.100
          hostname: delphix
          primaryAddress: 10.145.0.10/22
   Operations
   update
   

6. Perform the required changes (changing the settings as required):

   delphix> network setup update
   delphix network setup update *> set defaultRoute=10.143.0.1
   delphix network setup update *> set dnsDomain=delphix-dev
   delphix network setup update *> set dnsServers=10.143.0.100
   delphix network setup update *> set primaryAddress=10.143.0.10/22
   delphix network setup update *> ls
   Properties
       defaultRoute: 10.143.0.1 (*)
       dhcp: false
       dnsDomain: delphix-dev (*)
       dnsServers: 10.143.0.100 (*)
       hostname: delphix
       primaryAddress: 10.143.0.10/22 (*)
   delphix network setup update *> commit
   

7. Verify the new settings:

   delphix network setup> ls
   Properties
       defaultRoute: 10.143.0.1
       dhcp: false
       dnsDomain: delphix-dev
       dnsServers: 10.143.0.100
       hostname: delphix
       primaryAddress: 10.143.0.10/22
   
   Operations
   update
   delphix network setup>

8. Re-enable the VDBs and dSources running from the engine.
9. Re-enable the replication schedule, if it was previously disabled at point 3