If you currently use the Staging installation method and wish to convert to using INI files, use the following procedure.
Place cluster(s) in Maintenance Mode:
set policy maintenance
Create the text file
on each node. They will normally all be the same.
sudo mkdir /etc/tungstenshell>
sudo chown -R tungsten: /etc/tungstenshell>
chmod 700 /etc/tungstenshell>
chmod 600 /etc/tungsten/tungsten.ini
Each section in the INI file replaces a single tpm configure call. The section name inside of [square brackets] is used as the service name. In the case of the [defaults] section, this will act like the tpm configure defaults command. The property names in the INI file are the same as what is used on the command line. Simply remove the leading -- characters and add it to the proper section.
tpm reverse > /etc/tungsten/tungsten.ini
Edit the new ini file and clean it up as per the rules above. For example, using vim:
:%s/tools\/^tpm configure /[/g
In the above example, you MUST manually add the trailing square bracket ] to the end of the defaults tag and to the end of every service name section. Just search for the opening square bracket [ and make sure there is a matching closing square bracket for every one.
See Section 9.4.1, “Creating an INI file” for more information.
On every node, extract the software into
Make sure you have the same release that is currently installed.
tar zxf tungsten-clustering-5.3.0-348.tar.gz
If this is a MSMM topology, make sure you extract both the clustering and replication packages.
On each node, change to the extracted directory and execute the tpm command:
Execute this step on the slaves first, then switch the master - this procedure will restart the Tungsten services so switch your master to avoid interruption of service. See Section 5.14.3, “Performing Maintenance on an Entire Dataservice” for more information.
This will read the
tungsten.ini file and apply
the settings. The tpm command will identify what
services likely need to be restarted and will just restart those. You
can manually restart the desired services if you are unsure if the new
configuration has been applied.
The tpm update command may cause a brief outage while restarting the connectors. This will occur if you are upgrading to a new version You can avoid that with:
The connectors must be updated separately on each server by running:
If you have a MSMM topology, you must also update the cross-site replicators:
On each node, change to the extracted replicator directory and execute the tpm command:
Once all steps have been completed and the cluster(s) are stable, take each cluster out of maintenance mode by setting the policy back to automatic:
set policy automatic