11/15/94 Considerations in Upgrading from HACMP1.1 to HACMP1.2 SPECIAL NOTICES Information in this document is correct to the best of our knowledge at the time of this writing. Please send feedback by fax to "AIXServ Information" at (512) 823-4009. Please use this information with care. IBM will not be responsible for damages of any kind resulting from its use. The use of this information is the sole responsibility of the customer and depends on the customer's ability to eval- uate and integrate this information into the customer's operational environment. +----------------------------------------------------------+ | | | NOTE: The information in this document has NOT been | | verified for AIX 4.1. | | | +----------------------------------------------------------+ PROCEDURE This document contains a general outline of the procedures for upgrading from HACMP1.1 to HACMP1.2. Since every installation is different and unique, this should be viewed as a GENERAL outline. Local considerations must always be accounted for in any software upgrade but are especially important in an HACMP/6000 cluster. The following outline applies to HACMP1.1 installations that are BOTH applied and committed. 1. Backing Up the Current Environment: On both nodes, be sure to back up the current cluster environment. To back up a node's ODM environment vari- ables to a file, run /usr/sbin/cluster/clgetenv > /tmp/clvars This file can be used for reference, after HACMP1.2 is installed and you are reconfiguring the node environ- ment. Copy /usr/sbin/cluster/cluster.cf to /tmp/cluster.cf for quick restoration after lpp.cleanup. Then archive /usr/sbin/cluster to either tape or disk, to keep a ready copy of locally configured scripts and files. 2. Cleaning up HACMP1.1: IMPORTANT: User-created customized scripts that reside in /usr/sbin/cluster or its subdirectories are removed by /usr/lpp/cluster/lpp.cleanup. Be sure that any local additions/modifications in this directory or its Considerations in Upgrading from HACMP1.1 to HACMP1.2 1 11/15/94 dependent directories have been archived before running the cleanup. Run /usr/lpp/cluster/lpp.cleanup to remove the HACMP1.1 binaries, ODM variables, and HACMP1.1 system modifica- tions. (Note: This script removes the /usr/lpp/cluster directory. Run it with your current working directory set to "/" or "/usr".) Do this on both nodes. The cleanup leaves ONLY the fol- lowing files in /usr/sbin/cluster: clinfo.rc cluster.cf netchng.rc node.servers node.vars topchng.rc 3. Installing HACMP1.2: The HACMP1.2 installation saves the files above to filename.OLD and replaces them with new stub files from the distribution. clinfo.rc is moved to clinfo.rc.OLD cluster.cf is moved to cluster.cf.OLD netchng.rc is moved to netchng.rc.OLD node.servers is moved to node.servers.OLD node.vars is moved to node.vars.OLD topchng.rc is moved to topchng.rc.OLD 4. Reconfiguring the Node Environment: Copy /tmp/cluster.cf to /usr/sbin/cluster/cluster.cf, and run: smit hacmp==>configure node environemt ==>add node enviroment Choose the appropriate node environment. This copies the new 1.2 scripts down from /usr/sbin/cluster/samples and overwrites the stubs that were placed in /usr/sbin/cluster during the install. Configure the cluster ODM environment variables, using /tmp/clvars for reference. When this has been done on both nodes, you have a generic HACMP1.2 installation. This is a good time to run some failover tests, to confirm that things are working as expected. 5. Recustomizing your HACMP/6000 Cluster: After the cluster has been successfully upgraded to 1.2, you need to re-customize appropriately. All locally created/modified scripts should be copied back into the appropriate place. The following scripts were copied down from /usr/sbin/cluster/samples during the install. They need to be examined and potentially altered to reflect local configurations: Considerations in Upgrading from HACMP1.1 to HACMP1.2 2 11/15/94 clinfo.rc cluster.cf netchng.rc node.servers node.vars topchng.rc The pre-1.2 versions have been saved in /usr/sbin/cluster with a .OLD file extension, for refer- ence recustomization. 6. Upgrading an HACMP/6000 Client: Upgrading a client is similar to upgrading a cluster node. Archive /usr/sbin/cluster to tape or disk, and then run /usr/lpp/cluster/lpp.cleanup. This leaves ONLY clinfo.rc in the /usr/sbin/cluster directory. Install HACMP1.2, which moves the 1.1 clinfo.rc to clinfo.rc.OLD, and then recustomize, if necessary. Considerations in Upgrading from HACMP1.1 to HACMP1.2 3 11/15/94 READER'S COMMENTS Please fax this form to (512) 823-4009, attention "AIXServ Informa- tion". You may also e-mail comments to: elizabet@austin.ibm.com. These comments should include the same customer information requested below. Use this form to tell us what you think about this document. If you have found errors in it, or if you want to express your opinion about it (such as organization, subject matter, appearance) or make sug- gestions for improvement, this is the form to use. If you need technical assistance, contact your local branch office, point of sale, or 1-800-CALL-AIX (for information about support offer- ings). These services may be billable. Faxes on a variety of sub- jects may be ordered free of charge from 1-800-IBM-4FAX. Outside the U.S. call 415-855-4329 using a fax machine phone. When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any way it believes appropriate without incurring any obligation to you. NOTE: If you have a problem report or item number, supplying that number may help us determine why a procedure did or did not work in your specific situation. Problem Report or Item #: Branch Office or Customer #: Be sure to print your name and fax number below if you would like a reply: Name: Fax Number: ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ ______________________________________________________________________ END OF DOCUMENT (hacmp.upgrade.ha_, 4FAX# 2270) Considerations in Upgrading from HACMP1.1 to HACMP1.2 4