If you currently use the Staging installation method and wish to convert to using INI files, use the following procedure.
You can also try using the script in
Section 10.3.1, “Using the translatetoini.pl Script”.
Place cluster(s) in MAINTENANCE Mode:
shell>cctrlcctrl>set policy maintenance
Create the text file /etc/tungsten/tungsten.ini
on each node. They should all be the same, therefore it is advised
to create the file on one host and then copy it to all other
hosts.
shell>sudo mkdir /etc/tungstenshell>sudo chown -R tungsten: /etc/tungstenshell>chmod 700 /etc/tungstenshell>touch /etc/tungsten/tungsten.inishell>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.
For example, to seed the /etc/tungsten/tungsten.ini file, use
the output of tpm reverse:
shell> tpm reverse > /etc/tungsten/tungsten.iniEdit the new ini file and clean it up as per the rules above. For example, using vi:
shell>vi /etc/tungsten/tungsten.ini:%s/tools\/^tpm configure /[/g:%s/^--//g:%s/\s*\\$//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 10.2.1, “Creating an INI file” for more information.
On every node, extract the software into
/opt/continuent/software/{extracted_dir}
Make sure you have the same release that is currently installed.
shell>cd /opt/continuent/softwareshell>tar zxf tungsten-clustering-8.0.1-305.tar.gz
If this is an Multi-Site/Active-Active 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 Replicas first, then switch the Primary - this procedure will restart the Tungsten services so switch your Primary to avoid interruption of service. See Section 6.16.3, “Performing Maintenance on an Entire Dataservice” for more information.
shell>cd /opt/continuent/software/tungsten-clustering-8.0.1-305shell>./tools/tpm update --replace-release
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:
shell> ./tools/tpm update --replace-release --no-connectorsAfterwards, the connectors must still be restarted on each server to pick up the new version or any changes, this can be done when convenient, by running:
shell> tpm promote-connectorIf you have an Multi-Site/Active-Active topology, you must also update the cross-site replicators:
On each node, change to the extracted replicator directory and execute the tpm command:
shell>cd /opt/continuent/software/tungsten-replicator-8.0.1-305shell>./tools/tpm update --replace-release
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:
shell>cctrlcctrl>set policy automatic