Upgrading the Red Hat Cluster suite to version 2.0
This document describes how to upgrade a Red Hat Cluster from version 1.03 (as shipped in etch) to version 2.0.
The upgrade procedure consists of stopping the cluster, removing the old cluster suite, adding node IDs to the cluster.conf, installing and booting a new kernel, and finally installing the new cluster suite packages.
The upgrade procedure is as follows:
* Stop client access to the clustered services.
* On each cluster node:
- Stop all applications using the cluster infrastructure, like the shared storage
- Stop the rgmanager, if installed:
- Umount all gfs shares:
umount -a -t gfsif a gfs share is still blocked by another process, run
lsof -n | grep <mountpoint>to identify the process in order to terminate it.
- Stop the cluster lvm daemon:
- Stop fencing:
- Stop the cluster manager:
- Stop the cluster configuration service:
- Remove the old Red Hat Cluster software:
dpkg --purge ccs libccs-dev cman libcman1 libcman-dev libdlm1 libdlm-dev fence gfs-tools gnbd-client gnbd-server gulm libgulm1 libgulm-dev libiddev-dev libmagma1 libmagma-dev magma-plugin-gulm magma-plugin-sm redhat-cluster-sourceNote: not all packages might be installed, just ignore the warnings dpkg will issue about it.
- Update the cluster.conf file to contain nodeids:
Open the file /etc/cluster/cluster.conf in your favorite editor. In each <clusternode> element, insert nodeid="number" after name="name". This should look this way:
[...] <clusternode name="node1" nodeid="1"> [...]Note: the nodeid parameter was optional in the old Red Had Clustersuite, but is now mandatory. If you have already nodeid parameters in your cluster.conf, skip this step. After saving your changes to the cluster.conf file, copy it to all the other nodes in the cluster.
- Update the kernel, and reboot the Node in order to activate the new kernel. You might of course upgrade the other parts of the system before rebooting.
- Install the new version of the Red Hat Cluster suite:
apt-get install redhat-cluster-suite redhat-cluster-modulesNote: existing GFS version 1 filesystems are fully supported. The new GFS2 filesystem format is not production-ready and usage is recommended only for experimental setups.
- custom kernels: patch required
- cluster.conf changes
- filesystem locking table changes
- handling changes
- double-check with real upgrade