Appendix: Switching Between Databases¶
/opt/scyld/clusterware/bin/headctl tool performs the database conversion.
We suggest taking a snapshot of the virtual machine prior to performing these
and preferably making a database backup with
managedb as well.
Convert a non-etcd head node to use etcd by executing:
sudo /opt/scyld/clusterware/bin/headctl --use-etcd
which performs a series of steps:
Install the clusterware-etcd package, if not already installed.
Stop the clusterware service.
Export the database to a temporary file.
Purge any existing database.
Load the exported database from the temporary file.
Update the firewall for etcd.
Restart the clusterware service.
Once these steps complete, the head node will resume normal operations.
For a multihead cluster this same command should be performed on each head node in turn. Note that the database conversion action detaches that head node from any other cooperating head nodes. When all the head nodes have been converted, you can pick one and join the others to it.
Confirm the head nodes are again working together by executing the following on each head node:
scyld-nodectl status sudo /opt/scyld/clusterware/bin/managedb --heads
and verify that
When you sure that everything is working as expected,
then on each head node remove the clusterware-couchbase package