Sun Cluster Upgrade Guide for Solaris OS

Chapter 1 Preparing to Upgrade Sun Cluster Software

This chapter provides the following information and procedures to prepare to upgrade a Sun Cluster configuration to Sun Cluster 3.2 1/09 software:

Upgrade Requirements and Software Support Guidelines

Observe the following requirements and software-support guidelines when you upgrade to Sun Cluster 3.2 1/09 software:

Upgrade of x86 based systems - On x86 based systems, you cannot upgrade from the Solaris 9 OS to the Solaris 10 OS. You must reinstall the cluster with a fresh installation of the Solaris 10 OS and Sun Cluster 3.2 software for x86 based systems. Follow procedures in Chapter 2, Installing Software on Global-Cluster Nodes, in Sun Cluster Software Installation Guide for Solaris OS.
Minimum Sun Cluster software version - Sun Cluster 3.2 1/09 software supports the following direct upgrade paths:
- SPARC: From version 3.0 including update releases to version 3.2 1/09 - Use the standard upgrade method only.
- SPARC: From version 3.1 including update releases to version 3.2 1/09 - Use the standard, dual-partition, or live upgrade method.
- From version 3.2 to version 3.2 1/09 - Use the standard, dual-partition, or live upgrade method.
- From version 3.2 to version 3.2 1/09 with no Solaris upgrade or Solaris upgrade only to an update release – You can also use the rolling upgrade method.
See Choosing a Sun Cluster Upgrade Method for additional requirements and restrictions for each upgrade method.
Patch requirement - The following are the minimum Sun Cluster patch levels that are required. Apply the appropriate patch to your cluster before you start to upgrade Sun Cluster software. These patches contain versioning functionality that is necessary for Sun Cluster upgrade:
- Solaris 9 OS - 125510–02
- Solaris 10 OS on SPARC - 125511–02
- Solaris 10 OS on x86 - 125512–02
Minimum Solaris OS - The cluster must run on or be upgraded to at least Solaris 9 9/05 software or Solaris 10 5/08 software, including the most current required patches. The Solaris 9 OS is supported only on SPARC based platforms.
Supported hardware - The cluster hardware must be a supported configuration for Sun Cluster 3.2 1/09 software. Contact your Sun representative for information about current supported Sun Cluster configurations.
Architecture changes during upgrade - Sun Cluster 3.2 1/09 software does not support upgrade between architectures.
Software migration - Do not migrate from one type of software product to another product during Sun Cluster upgrade. For example, migration from Solaris Volume Manager disk sets to VxVM disk groups or from UFS file systems to VxFS file systems is not supported during Sun Cluster upgrade. Perform only software configuration changes that are specified by upgrade procedures of an installed software product.
Global-devices partition size - If the size of your /global/.devices/node@nodeid partition is less than 512 Mbytes but it provides sufficient space for existing device nodes, you do not need to change the file-system size. The 512-Mbyte minimum applies to new installations of Sun Cluster 3.2 1/09 software.

However, you must still ensure that the global-devices file system has ample space and ample inode capacity for existing devices and for any new devices that you intend to configure. Certain configuration changes, such as adding disks, disk volumes, or metadevices, might require increasing the partition size to provide sufficient additional inodes.
Data services - Sun Cluster 3.0 data services are not supported on Sun Cluster 3.2 software. You must upgrade all Sun Cluster 3.0 data service software to a supported version and migrate resources to the new resource-type version. However, you can continue to use data service software from Sun Cluster 3.1 or 3.2 releases after you upgrade the cluster to the Sun Cluster 3.2 1/09 release.
Upgrading to compatible versions - You must upgrade all software on the cluster nodes to a version that is supported by Sun Cluster 3.2 1/09 software. For example, if a version of an application is supported on Sun Cluster 3.1 software but is not supported on Sun Cluster 3.2 1/09 software, you must upgrade that application to the version that is supported on Sun Cluster 3.2 1/09 software, if such a version exists. See Supported Products in Sun Cluster Release Notes for information about supported products.
Converting from NAFO to IPMP groups - For upgrade from a Sun Cluster 3.0 release, have available the test IP addresses to use with your public-network adapters when NAFO groups are converted to IP network multipathing groups. The scinstall upgrade utility prompts you for a test IP address for each public-network adapter in the cluster. A test IP address must be on the same subnet as the primary IP address for the adapter.

See System Administration Guide: IP Services (Solaris 9) or Chapter 31, Administering IPMP (Tasks), in System Administration Guide: IP Services (Solaris 10) for information about test IP addresses for IPMP groups.
Downgrade - Sun Cluster 3.2 1/09 software does not support any downgrade of Sun Cluster software.
Limitation of scinstall for data-service upgrades - The scinstall upgrade utility only upgrades those data services that are provided with Sun Cluster 3.2 1/09 software. You must manually upgrade any custom or third-party data services.

Choosing a Sun Cluster Upgrade Method

The following matrixes summarize the supported upgrade methods for each Solaris OS version and platform, provided that all other requirements for any supported method are met:

Table 1–1 Upgrade From Sun Cluster 3.0 Software


Method	Solaris 8	Solaris 9
Method	SPARC	SPARC
Standard upgrade	X	X
Dual-partition upgrade	-	–
Live upgrade	–	–
Rolling upgrade	–	–

Table 1–2 Upgrade From Sun Cluster 3.1 Through 3.1 9/04 Software


Method	Solaris 8		Solaris 9
Method	SPARC	x86	SPARC	x86
Standard upgrade	X	Direct upgrade is not permitted. You must perform a fresh installation of Solaris 10 OS for x86.	X	Direct upgrade is not permitted. You must perform a fresh installation of Solaris 10 OS for x86.
Dual-partition upgrade	X		X
Live upgrade	*		X
Rolling upgrade	-		-
* Direct upgrade from the Solaris 8 OS to the Solaris 10 5/08 OS is not supported by Solaris Live Upgrade. See Solaris Live Upgrade Restrictions in Solaris 10 5/08 Installation Guide: Solaris Live Upgrade and Upgrade Planning for more information and upgrade alternatives. Direct upgrade from the Solaris 8 OS to the Solaris 9 OS is supported by Solaris Live Upgrade.

Table 1–3 Upgrade From Sun Cluster 3.1 8/05 Through 3.2 Software, Including Solaris OS Upgrade


Method	Solaris 8		Solaris 9		Solaris 10
Method	SPARC	x86	SPARC	x86	SPARC	x86
Standard upgrade	X	Direct upgrade is not permitted. You must perform a fresh installation of Solaris 10 OS for x86.	X	Direct upgrade is not permitted. You must perform a fresh installation of Solaris 10 OS for x86.	X	X
Dual-partition upgrade	X		X		X	X
Live upgrade	*		X		X	X
Rolling upgrade	-		-		-	-
* Direct upgrade from the Solaris 8 OS to the Solaris 10 5/08 OS is not supported by Solaris Live Upgrade. See Solaris Live Upgrade Restrictions in Solaris 10 5/08 Installation Guide: Solaris Live Upgrade and Upgrade Planning for more information and upgrade alternatives. Direct upgrade from the Solaris 8 OS to the Solaris 9 OS is supported by Solaris Live Upgrade.

Table 1–4 Upgrade From Sun Cluster 3.2 Software, With Solaris OS Update Only


Method	Solaris 9		Solaris 10
Method	SPARC	x86	SPARC	x86
Standard upgrade	X	X	X	X
Dual-partition upgrade	X	X	X	X
Live upgrade	X	X	X	X
Rolling upgrade	X	X	X	X

Choose from the following methods to upgrade your cluster to Sun Cluster 3.2 1/09 software:

Standard upgrade – In a standard upgrade, you shut down the cluster before you upgrade the cluster nodes. You return the cluster to production after all nodes are fully upgraded. Use this method if you are upgrading from a Sun Cluster 3.0 release.
Dual-partition upgrade - In a dual-partition upgrade, you divide the cluster into two groups of nodes. You bring down one group of nodes and upgrade those nodes. The other group of nodes continues to provide services. After you complete upgrade of the first group of nodes, you switch services to those upgraded nodes. You then upgrade the remaining nodes and boot them back into the rest of the cluster. The cluster outage time is limited to the amount of time needed for the cluster to switch over services to the upgraded partition.

Observe the following additional restrictions and requirements for the dual–partition upgrade method:
- Sun Cluster HA for Sun Java^TM System Application Server EE (HADB) - If you are running the Sun Cluster HA for Sun Java System Application Server EE (HADB) data service with Sun Java System Application Server EE (HADB) software as of version 4.4, you must shut down the database before you begin the dual-partition upgrade. The HADB database does not tolerate the loss of membership that would occur when a partition of nodes is shut down for upgrade. This requirement does not apply to versions before version 4.4.
- Data format changes - Do not use the dual-partition upgrade method if you intend to upgrade an application that requires that you change its data format during the application upgrade. The dual-partition upgrade method is not compatible with the extended downtime that is needed to perform data transformation.
- Location of application software - Applications must be installed on nonshared storage. Shared storage is not accessible to a partition that is in noncluster mode. Therefore, it is not possible to upgrade application software that is located on shared storage.
- Division of storage - Each shared storage device must be connected to a node in each group.
- Single-node clusters - Dual-partition upgrade is not available to upgrade a single-node cluster. Use the standard upgrade or live upgrade method instead.
- Minimum Sun Cluster version - The cluster must be running at least a Sun Cluster 3.1 release before you begin the dual-partition upgrade.
- Configuration changes - Do not make cluster configuration changes that are not documented in the upgrade procedures. Such changes might not be propagated to the final cluster configuration. Also, validation attempts of such changes would fail because not all nodes are reachable during a dual-partition upgrade.
Live upgrade - A live upgrade maintains your previous cluster configuration until you have upgraded all nodes and you commit to the upgrade. If the upgraded configuration causes a problem, you can revert to your previous cluster configuration until you can rectify the problem.

Observe the following additional restrictions and requirements for the live upgrade method:
- Minimum Solaris OS patch level - The following are the minimum Solaris OS patch levels that are required to use Solaris Live Upgrade.
  - Solaris 10 OS on SPARC — 137321–01
  - Solaris 10 OS on x86 — 137322 —01
  - Solaris 9 OS on SPARC — 137477–01
  - Solaris 9 OS on x86 — 137478–01
- Minimum Sun Cluster version - The cluster must be running at least a Sun Cluster 3.1 release before you begin the live upgrade.
- Minimum version of Live Upgrade software - To use the live upgrade method, you must use the Solaris Live Upgrade packages from at least the Solaris 9 9/04 or Solaris 10 release. This requirement applies to clusters running on all Solaris OS versions, including Solaris 8 software. The live upgrade procedures provide instructions for upgrading these packages.
- Dual-partition upgrade - The live upgrade method cannot be used in conjunction with a dual-partition upgrade.
- Disk space - To use the live upgrade method, you must have enough spare disk space available to make a copy of each node's boot environment. You reclaim this disk space after the upgrade is complete and you have verified and committed the upgrade. For information about space requirements for an inactive boot environment, refer to Solaris Live Upgrade Disk Space Requirements in Solaris 9 9/04 Installation Guide orAllocating Disk and Swap Space in Solaris 10 5/08 Installation Guide: Planning for Installation and Upgrade.
Rolling upgrade - In a rolling upgrade, you upgrade software to an update release on one node at a time. Services continue on the other nodes except for the time it takes to switch services from a node to be upgraded to a node that will remain in service.

Observe the following additional restrictions and requirements for the rolling upgrade method:
- Minimum Sun Cluster version - The cluster must be running a Sun Cluster 3.2 release.
- Required patch - The cluster must be running at least level 02 of one of the following patches, depending on the platform:
  - Solaris 9 OS - 125510–02
  - Solaris 10 OS on SPARC - 125511–02
  - Solaris 10 OS on x86 - 125512–02
- Solaris upgrade paths - You can upgrade the Solaris OS only to another update version of the same release. For example, you perform a rolling upgrade from Solaris 9 9/04 to Solaris 9 9/05, or from Solaris 10 11/06 to Solaris 10 7/07. But you cannot perform a rolling upgrade to upgrade from a version of Solaris 9 to a version of Solaris 10.
- Hardware configuration changes - Do not make any changes to the cluster configuration during a rolling upgrade. For example, do not add to or change the cluster interconnect or quorum devices. If you need to make such a change, do so before you start the rolling upgrade procedure or wait until after all nodes are upgraded and the cluster is committed to the new software version.
- Duration of the upgrade - Limit the amount of time that you take to complete a rolling upgrade of all cluster nodes. After a node is upgraded, begin the upgrade of the next cluster node as soon as possible. You can experience performance penalties and other penalties when you run a mixed-version cluster for an extended period of time.
- Software configuration changes - Avoid installing new data services or issuing any administrative configuration commands during the upgrade.
- New-feature availability - Until all nodes of the cluster are successfully upgraded and the upgrade is committed, new features that are introduced by the new release might not be available.

For overview information about planning your Sun Cluster 3.2 1/09 configuration, see Chapter 1, Planning the Sun Cluster Configuration, in Sun Cluster Software Installation Guide for Solaris OS.