Skip to content

Upgrade dSource

Upgrades

Periodically Production and Lower environments are upgraded for various reasons like

  • To be in compliance
  • To mitigate bugs
  • Security concerns
  • To meet compatibility with other software.

Upgrading the Source database to a higher version will impact dSource snapsyncs if the version upgraded is not compatible with version of staging database. Delphix can handle the upgrade of the databases by updating the configuration in dSource.

Upgrade dSource to a higher version. (Until 1.0.2 MongoDB Plugin)

  • Step 1: Install the same version of Mongo software on the staging host.[ same version as source ].
  • Step 2: Update repoconfig file. Please refer Discovery Section.
  • Step 3: Refresh Staging Environment in Delphix.
  • Step 4: Verify new Mongo home is discovered in the environment with entry PY EDSI MongoDB (vMONGO_VERSION).
  • Step 5: Disable dSource [ Manage Datasets → Select dSource → disable ].
  • Step 6: Log in to Delphix engine via CLI (ssh) interface and execute the following commands. 
cd sourceconfig  
select <dSource_Name>  
update  
set repository = <New Mongo Home discovered in Step 4 >  
commit;
  • Step 7: Enable dSource [ Manage Datasets → Select dSource → enable ]
  • Step 8: Take a new snapshot to validate that snapsync works as expected.

Note: You may need to resync dSource depending on mongo version compatability.

Upgrade to v1.2.1 MongoDB Plugin (If the dSource Type is onlinemongodump)

  • Step 1: Make sure that the Source MongoDB Host Connect String contains Replica Set PRIMARY as a first node in the connection string.
    • For example, If Source MongoDB Host Connect String is set to “mongohost1.com:28501,mongohost2.com:28502,mongohost3.com:28503”, the “mongohost1.com:28501” must refers to the PRIMARY node of Replica Set.
  • Step 2: If the Source Database is SSL/TLS enabled, modify the Source MongoDB Host Connect String using the following rules
    • –ssl should be replaced with –tls
    • –sslPEMKeyFile should be replaced with –tlsCertificateKeyFile
    • –sslCAFile should be replaced with –tlsCAFile