Connecting to existing database domains

Overview

The following steps illustrate how to share a database domain between two separate HCL Digital Experience instances (instance1 and instance2), where instance2 is connected to an instance1 database domain. Release and JCR data cannot be shared between separate HCL DX instances.

Before starting, review...

wp_profile_root/ConfigEngine/properties/wkplc_dbomain.properties

...and verify settings are valid for the current configuration of all database domains. To connect or transfer a single database domain, modify only the database properties for that domain before running the connect-database or database-transfer tasks below. The connect-database configuration task does not preserve customizations to the data sources for the HCL DX databases. If you previously tuned data sources for the HCL DX databases, make a note of the settings, run connect-database, then reapply the tuning after you running connect-database again.

Steps

1. Verify that both HCL DX instances are operational.

2. Ensure that the database client software is installed on instance2 with the same settings as instance1, and that we can connect to the remote database.

3. Point instance2 data sources point to the instance1 database by updating wkplc_dbtype.properties and wkplc_dbdomain.properties.

   Do not use the same data source names for the domains used in the previous version of the product. Use a different data source so that the connect-database command drops the old data source and create the new one with the new connection information.

4. Reconfigure instance2 to use one or more remote database domains of instance1...
   cd wp_profile_root/ConfigEngine
   ./ConfigEngine.sh connect-database -DTransferDomainList=domain1,domain2,domain3 -DWasPassword=password

5. Restart instance2.