This procedure will convert a standard, standalone cluster into a Composite Primary/DR cluster for a deployment that uses INI files for configuration.
Our example starting cluster has 5 nodes (1 master and 4 slaves) and uses
alpha. Our target cluster will have 6
nodes (3 per cluster) in 2 member clusters
alpha_west in composite service
This means that we will reuse the existing service name
alpha as the name of the new composite service, and
create two new serice names, one for each cluster
Below is an INI file extract example for our starting standalone cluster with 5 nodes:
[defaults] ... [alpha] connectors=db1,db2,db3,db4,db5 master=db1 members=db1,db2,db3,db4,db5 topology=clustered
To convert the above configuration to a Composite Primary/DR:
First you must stop all services on all existing nodes.
Update tungsten.ini on all nodes.
Create the two new services and put the correct information into all three stanzas.
For example, below is an INI file extract example for our target composite cluster with 6 nodes:
[defaults] start-and-report=false start=false ... [alpha_east] connectors=db1,db2,db3 master=db1 members=db1,db2,db3 topology=clustered [alpha_west] connectors=db4,db6 master=db4 members=db4,db5,db6 topology=clustered relay-source=alpha_east [alpha] composite-datasources=alpha_east,alpha_west
Invoke the conversion using the tpm command from the software extraction directory:
tpm query stagingshell>
./tools/tpm update --replace-releaseshell>
Finally, start all services on all existing nodes.