Procedure E.1. Preparing your SUSE Linux Enterprise Server 10 SP4 Cluster¶

1. Log in to the cluster.

2. Review the Heartbeat configuration file /etc/ha.d/ha.cf and check that all communication media support multicasting.

3. Make sure the following files are equal on all nodes: /etc/ha.d/ha.cf and /var/lib/heartbeat/crm/cib.xml.

4. Take all nodes offline by executing rcheartbeat stop on each node.

5. In addition to the general system backup recommended before updating to the latest version, back up the following files, as you need them for running the conversion script after the upgrade to SUSE Linux Enterprise Server 11:

   • /var/lib/heartbeat/crm/cib.xml

   • /var/lib/heartbeat/hostcache

   • /etc/ha.d/ha.cf

   • /etc/logd.cf

6. If you have EVMS2 resources, convert non-LVM EVMS2 volumes to compatibility volumes on SUSE Linux Enterprise Server 10. During the conversion process (see Section E.2.1.3, “Data Conversion”), these are then turned into LVM2 volume groups. After conversion, make sure to mark each volume group as a member of the High Availability cluster with vgchange -c y.

Procedure E.2. Upgrading to SUSE Linux Enterprise 11¶

1. Freshly install SUSE Linux Enterprise Server 11 on all cluster nodes.

2. On all cluster nodes, install SUSE Linux Enterprise High Availability Extension 11 as add-on on top of SUSE Linux Enterprise Server. For detailed information, see Section 3.3, “Installation as Add-on”.

Procedure E.3. Testing the Conversion¶

1. On one of the nodes, create a test directory and copy the backup files to the test directory:

   $ mkdir /tmp/hb2openais-testdir
   $ cp /etc/ha.d/ha.cf /tmp/hb2openais-testdir
   $ cp /var/lib/heartbeat/hostcache /tmp/hb2openais-testdir
   $ cp /etc/logd.cf /tmp/hb2openais-testdir
   $ sudo cp /var/lib/heartbeat/crm/cib.xml /tmp/hb2openais-testdir

2. Start the test run with

   $ /usr/lib/heartbeat/hb2openais.sh -T /tmp/hb2openais-testdir -U

   or with the following command, if you are using a 64-bit system:

   $ /usr/lib64/heartbeat/hb2openais.sh -T /tmp/hb2openais-testdir -U

3. Read and verify the resulting openais.conf and cib-out.xml files:

   $ cd  /tmp/hb2openais-testdir 
   $ less openais.conf 
   $ crm_verify -V -x cib-out.xml

Procedure E.4. Converting the Data¶

After doing a test run and checking the output, you can now start with the data conversion. You only need to run the conversion on one node. The main cluster configuration (the CIB) is automatically replicated to the other nodes. All other files that need to be replicated are automatically copied by the conversion script.

1. Make sure that sshd is running on all nodes with access allowed for root in order for the conversion script to successfully copy the files to the other cluster nodes.

2. Make sure that all ocfs2 file systems are unmounted.

3. The High Availability Extension ships with a default OpenAIS configuration file. If you want to prevent the default configuration from being overwritten during the following steps, make a copy of the /etc/ais/openais.conf configuration file.

4. Start the conversion script as root. If using sudo, specify the privileged user using the -u option:

   $ /usr/lib/heartbeat/hb2openais.sh -u root

   Based on the configuration stored in /etc/ha.d/ha.cf, the script will generate a new configuration file for the OpenAIS cluster stack, /etc/ais/openais.conf. It will also analyze the CIB configuration and let you know if your cluster configuration requires changes, due to the change from Heartbeat to OpenAIS. All file processing is done on the node where conversion runs and replicated to the other nodes.

5. Follow the instructions on the screen.