(English) Sun Cluster Geographic Edition 3.2 2-08 Release Notes

{anchor:top}
h1. {anchor:X-1DILL} Sun Cluster Geographic Edition 3.2 2/08 Release Notes
This document provides the following information for Sun™ Cluster Geographic Edition 3.2 2/08 software.

* [New Features and Functionality|#GFUFG]
* [Supported Products|#RELNOTES-6-PRODUCTS]
* [Restrictions|#GEDMI]
* [Known Issues and Bugs|#CHDGGECB]
* [Required Patches|#CHDHEHGF]
* [Sun Cluster 3.2 Commands|#GDSXU]
* [Sun Cluster Geographic Edition 3.2 2/08 Documentation|#CHDGCEDD]
* [Localization Issues|#EYHYV]
* [Documentation Issues|#FFKUI]


[Top|#top]
h2. {anchor:GFUFG} New Features and Functionality

This section describes each of the following new features provided in the Sun Cluster Geographic Edition 3.2 2/08 software.

* *Hitachi TrueCopy on x86 Based Systems*
Hitachi TrueCopy can be used with Sun Cluster Geographic Edition 3.2 2/08 software on both x86 and SPARC™ based systems.

* *Added Oracle RAC Versions*
This release supports the following versions of Oracle RAC on the following data replication software and platforms:

|| Platform || RAC Versions || Data Replication Software ||
| SPARC | 9i, 10g, 11g | EMC Symmetrix Remote Data Facility, Hitachi TrueCopy |
| x86 | 9i, 10g | Hitachi TrueCopy |

* *Relaxed Restrictions on Resource-Group Dependencies*
To support multiple instances of Oracle RAC within a partnership, a resource within a protection group can now have dependencies on resources that are outside that protection group. Such dependencies permit the Oracle CRS framework to run independently of Sun Cluster Geographic Edition software, while individual RAC instances remain managed within protection groups.

* *Service Tags*
This release supports Sun Service Tags. For more information about Sun Service Tags, see [Sun Connection on BigAdmin (http://www.sun.com/bigadmin/hubs/connection/tasks/register.jsp)|http://www.sun.com/bigadmin/hubs/connection/tasks/register.jsp].

* *Support for Short-Term Difference in Sun Cluster and Geographic Edition Versions Between Partner Clusters*
Sun Cluster Geographic Edition 3.2 2/08 software has been tested to interoperate with Sun Cluster Geographic Edition 3.2 software, and this mixed configuration is supported. To avoid possible problems with future maintenance and management, do not use such a mixed version environment for a longer period than is necessary to complete the update of all related clusters to the current release. Also be aware that some third-party products in the configuration might at some time not support this mixed-version partnership.


[Top|#top]
h2. {anchor:RELNOTES-6-PRODUCTS} Supported Products
This section describes the supported software for Sun Cluster Geographic Edition 3.2 2/08 software.

* [Supported Software Products|#GGCIL]
* [Restrictions|#GEDMI]
* [Support for EMC Symmetrix Remote Data Facility (SRDF) Configurations|#GEDRV]

[Top|#top]
h3. {anchor:GGCIL} Supported Software Products

The following table lists the software products and versions that are supported by Sun Cluster Geographic Edition 3.2 2/08 software.

h6. {anchor:FFKTU} Supported Products and Versions

||Software||Version||
|Solaris Operating System|* *SPARC™*: Solaris 9 9/05, Solaris 9 9/05 HW; Solaris 10 11/06, Solaris 10 8/07
* *x86*: Solaris 10 11/06, Solaris 10 8/07|
|Sun Cluster|3.2 2/08|
|Volume management software|* *With Sun StorageTek™ Availability Suite 4 software*:
** Solaris Volume Manager software
** (_on Solaris 10_) Veritas Volume Manager software
* *With Sun StorEdge™ Availability Suite 3.2.1 software*:
** (_on Solaris 9_) Solaris Volume Manager software
** Veritas Volume Manager software
* *With Hitachi TrueCopy*: Veritas Volume Manager software
* *With EMC Symmetrix Remote Data Facility*: Veritas Volume Manager software|
|Data Replication|* Sun Availability Suite software
** (_on Solaris 9_) Sun StorEdge Availability Suite 3.2.1
** (_on Solaris 10_) Sun StorageTek Availability Suite 4
* Hitachi TrueCopy RAID Manager
* EMC Symmetrix Remote Data Facility


[Top|#top]
h3. {anchor:GEDMI} Restriction
As of the time of publication, the following features or products are not supported by Sun Cluster Geographic Edition 3.2 2/08 software:

* ZFS file systems are not supported as replicated storage that is managed by Sun Cluster Geographic Edition software. However, you can have a ZFS file system on a cluster node that runs Geographic Edition software as long as that file system is not part of the Geographic Edition configuration.

Contact your Sun representative to learn whether a feature or product becomes qualified with Sun Cluster Geographic Edition 3.2 2/08 software at a later date.

[Top|#top]

h3. {anchor:GEDRV} Support for EMC Symmetrix Remote Data Facility (SRDF) Configurations

Sun Cluster Geographic Edition 3.2 2/08 software currently supports the following SRDF configurations:

* Static SRDF device group
* Dynamic SRDF device group

Sun Cluster Geographic Edition 3.2 2/08 software supports SRDF configurations in Synchronous, Semi-synchronous, and Adaptive Copy modes. However, Semi-synchronous and Adaptive Copy modes are not suitable for a business-continuity solution.

{note:title=Note}Before you choose to use SRDF Semi-synchronous or Adaptive Copy modes with Sun Cluster Geographic Edition software, consult EMC documentation for any warnings or restrictions concerning the use of these modes in business-continuity configurations.
{note}

[Top|#top]

h2. {anchor:CHDGGECB} Known Issues and Bugs
The following known issues and bugs affect the operation of the Sun Cluster Geographic Edition 3.2 2/08 release.

h3. The {{geopg create}} Command Fails if the "description" Property Value Contains Multiple Words Separated by Spaces (6643519)

*Problem Summary:* When run from the command line, the {{geopg create}} command fails with an exception if the value of the {{description}} property contains multiple words that are separated by spaces. However, this problem does not occur when the GUI is used.

*Workaround:* If a multiple-word description is required, either separate the words with a nonspace character such as an underscore (_) or use the GUI to update the description after you create the protection group.

[Top|#top]

h3. Switchover Cannot Be Performed with Asynchronous SRDF (6389092)

*Problem Summary:* When Symmetrix Remote Data Facility (SRDF) data replication is used, Sun Cluster Geographic Edition software does not allow you to issue the {{geopg switchover}} command if a device group that is included in a protection group is set to Asynchronous mode.

The failback-switchover procedure that is included in the Sun Cluster Geographic Edition documentation for SRDF therefore does not work as written for device groups in Asynchronous mode because the procedure includes the geopg switchover command.

*Workaround:* To perform a failback-switchover, after you resynchronize the clusters in the partnership, temporarily change device groups from Asynchronous mode to Synchronous mode by using the following command:

{{# *smrdf -g _devicegroup_ set mode sync*}}

After you complete and verify the switchover, set the device groups back to Asynchronous mode by using the following command:

{{# *smrdf -g _devicegroup_ set mode async*}}

[Top|#top]

h3. Unable to Start Sun Cluster Geographic Edition on Any Node of the Cluster Due to Corruption in CCR Tables (6619265)

*Problem Summary:* If actions or events result in corruption in CCR tables, the Sun Cluster Geographic Edition framework cannot start on any node of the affected cluster.

*Workaround:* There is no workaround for this problem. Contact your Sun Support office for assistance to correct the errors in the CCR. Do not attempt to modify CCR tables without Sun assistance.

[Top|#top]

h3. Having Resource Groups That Have Local Zones in Their nodelist in Availability Suite Protection Groups Is Not Working (6598942)

*Problem Summary:* In this release of Sun Cluster Geographic Edition software, you cannot add resource groups to a protection group if those resource groups are configured to run in a non-global zone.

*Workaround:* If management of resources in a zone is required, use the Sun Cluster HA for Containers agent.

[Top|#top]

h3. Unable to Restart Geo on the Same Node Immediately After Start Failure (6528160)
*Problem Summary:* If an exception occurs while starting the Sun Cluster Geographic Edition control module, the module is disabled on the node.

*Workaround:* Before you restart the Sun Cluster Geographic Edition framework, restart the common agent container (CAC):
{panel}
{{# */usr/sbin/cacaoadm restart*}}
{panel}
If the Sun Cluster Geographic Edition framework still does not start, stop the CAC framework, remove the old resource groups that the {{geoadm start}} command created, and restart the CAC:
{panel}
{{# */usr/sbin/cacaoadm stop -f*}}
{{# *clrg delete -F _geo-resourcegroup_...*}}
{{# */usr/sbin/cacaoadm restart*}}
{panel}
Then restart the Sun Cluster Geographic Edition framework.

[Top|#top]

h3. CVM Disk Group Not Imported During Protection Group Start if "-n" Option Is Used (6503715)

*Problem Summary:* On a system where a VxVM cluster-feature disk group is not imported, if the user starts the protection group and uses the {{-n}} option to the {{geopg start}} command, the disk group is not imported. This failure to import in turn causes the starting of Oracle RAC database resources to fail.

*Workaround:* When a protection group is configured for Oracle RAC, do *not* use the {{-n}} (no replication) option to the {{geopg start}} command when you start the protection group.

[Top|#top]

h3. {anchor:gdvtq} Neither {{geoadm start}} Nor {{geoadm stop}} Function Properly When Sun Cluster Geographic Edition Resources Are in the {{STOP_FAILED}} State (6446765)

*Problem Summary:* Certain unusual configuration errors could leave the cluster in a state where the Sun Cluster Geographic Edition framework can neither be started ({{geoadm start}}) nor cleanly stopped ({{geoadm stop}}).

*Workaround:* It is most likely that a Sun Cluster Geographic Edition infrastructure resource is in the {{STOP_FAILED}} state. To clear the {{STOP_FAILED}} state, take the following actions:

# Use the {{cluster status -t rs,rg}} command to determine which resources and resource groups are affected.
# Clear the {{STOP_FAILED}} flag for all resources and resource groups that are in the {{STOP_FAILED}} state by using the following command for each:
{panel}{{# *clresource clear _resource_*}}{panel}
# Manually stop the application that failed to stop.
For example, if an {{ora lsnr}} failed to stop, stop it fully. Ignore this step if the affected resources are Sun Cluster Geographic Edition infrastructure only.
# If necessary, stop the resource groups.
If a resource failed to stop during a resource group stop, the resource group remains in the {{STOP_FAILED}} state and you must stop it by using the following command:
{panel}{{# *clresourcegroup offline _resourcegroup_*}}{panel}
If the resources failed to stop during a restart of the resource or while the resource was being disabled, ignore this step.
# Retry the {{geoadm stop}} command.

[Top|#top]

h3. {anchor:ganbi} Sun Cluster Manager Does Not Always Refresh Protection Group Status Change (6302217)

*Problem Summary:* Configuration and state changes of entities on a page that is displayed in Sun Cluster Manager should cause the page to be refreshed automatically. Sometimes the refresh does not occur.

*Workaround:* Use the navigation tree to navigate to a different page, then return to the original page. The original page is refreshed on reload.

[Top|#top]

h3. {anchor:gancf} Sun Cluster Manager Requires Same Root Password on Partner Clusters (6260505)

*Problem Summary:* To use the Sun Cluster Manager graphical user interface (GUI), the root password must be the same on all nodes of both clusters in the Sun Cluster Geographic Edition deployment.

*Workaround:* If you use Sun Cluster Manager to configure your clusters, ensure that the root password is the same on every node of both clusters. If you prefer not to set the root password identically on all nodes, use the command-line interface to configure your clusters.

[Top|#top]

h3. {anchor:ganbx} No RBAC Support for Sun Cluster Manager (6226493)

*Problem Summary:* Sun Cluster Manager does not support RBAC roles.

*Workaround:* Start Sun Cluster Manager as superuser on the local cluster.

[Top|#top]

h2. {anchor:CHDHEHGF} Required Patches
This section provides information about patches for Sun Cluster Geographic Edition configurations.
{info:title=Note}You must be a registered SunSolve™ user to view and download the required patches for the Sun Cluster Geographic Edition product. If you do not have a SunSolve account, contact your Sun service representative or sales engineer, or register online at [http://sunsolve.sun.com|http://sunsolve.ebay.sun.com].
{info}
You must have the following patches installed:

* Sun StorEdge Availability Suite 3.2.1 CORE: a minimum of 116466-09
* Sun StorEdge Availability Suite 3.2.1 II: a minimum of 116467-09
* Sun StorEdge Availability Suite 3.2.1 SNDR: a minimum of 116468-13
* *SPARC:* Sun StorageTek Availability Suite 4 SNDR: a minimum of 123246-03
* *x86*: Sun StorageTek Availability Suite 4 SNDR: a minimum of 123247-03

Check with a Sun service representative for the availability of these patches.

[Top|#top]
h2. {anchor:GDSXU} Sun Cluster 3.2 Commands
Starting in release 3.2, Sun Cluster software includes new object-oriented commands. The Sun Cluster Geographic Edition user documentation has been revised to refer to these commands. If you have experience with the original Sun Cluster command set, be assured that the original commands continue to be supported.

For more information about the object-oriented Sun Cluster commands, see [Appendix A, "Sun Cluster Object-Oriented Commands"|http://docs.sun.com/app/docs/doc/820-2558/6ne5de34k?a=view], in _Sun Cluster System Administration Guide for Solaris OS_.

[Top|#top]
h2. {anchor:CHDGCEDD} Sun Cluster Geographic Edition 3.2 2/08 Documentation
The Sun Cluster Geographic Edition 3.2 2/08 user documentation set consists of the following collections:

* _Sun Cluster Geographic Edition 3.2 2/08 Release Notes Collection_
* _Sun Cluster Geographic Edition 3.2 2/08 Software Collection_
* _Sun Cluster Geographic Edition 3.2 2/08 Reference Collection_

For the latest documentation, go to the docs.sun.com web site. The docs.sun.com web site enables you to access Sun Cluster Geographic Edition documentation on the Web. You can browse the {{docs.sun.com}} archive or search for a specific book title or subject at the following Web site:

bq. [http://docs.sun.com|http://docs.sun.com]

[Top|#top]
h3. {anchor:GDWAG} Sun Cluster Geographic Edition 3.2 2/08 Software Collection
The Sun Cluster Geographic Edition 3.2 2/08 Software Collection contains the following manuals.

||Part Number||Book Title||
|820-3004|[_Sun Cluster Geographic Edition Overview_|http://docs.sun.com/app/docs/doc/820-3004]|
|820-2995|[_Sun Cluster Geographic Edition Installation Guide_|http://docs.sun.com/app/docs/doc/820-2995]|
|820-2996|[_Sun Cluster Geographic Edition System Administration Guide_|http://docs.sun.com/app/docs/doc/820-2996]|
|820-2999|[_Sun Cluster Geographic Edition Data Replication Guide for Sun StorageTek Availability Suite_|http://docs.sun.com/app/docs/doc/820-2999]|
|820-2998|[_Sun Cluster Geographic Edition Data Replication Guide for Hitachi TrueCopy_|http://docs.sun.com/app/docs/doc/820-2998]|
|820-2997|[_Sun Cluster Geographic Edition Data Replication Guide for EMC Symmetrix Remote Data Facility_|http://docs.sun.com/app/docs/doc/820-2997]|


[Top|#top]
h3. {anchor:GDWBW} Sun Cluster Geographic Edition 3.2 2/08 Reference Collection
This collection contains the [_Sun Cluster Geographic Edition Reference Manual_|http://docs.sun.com/app/docs/doc/820-2992], part number 820-2992.

[Top|#top]
h2. {anchor:EYHYV} Localization Issues
No localization issues are known of at this time.

[Top|#top]
h2. {anchor:FFKUI} Documentation Issues
This section discusses known errors or omissions for man pages, documentation, or online help and steps to correct these problems.

[Top|#top]

h3. Data Replication Guides for EMC Symmetrix Remote Data Facility, Hitachi True Copy, and Sun StorageTek Availability Suite (CR 6640525)

In the procedure "How to Resynchronize a _data replication_ Protection Group" in each of these manuals, the following instruction applies to Step 1, "Log in to a cluster node":

If only one of the clusters is running release 3.2 2/08 of Sun Cluster Geographic Edition software, log in to a node of that cluster. This enables that cluster to propagate the {{External_Dependency_Allowed}} protection-group property, which is introduced in the Sun Cluster Geographic Edition 3.2 2/08 release, to the cluster that runs the 3.2 release, which does not contain this property. Otherwise, the absence of the {{External_Dependency_Allowed}} property might result in the protection group going into a synchronization-error state.

[Top|#top]

h3. {anchor:FVZOF} Sun Cluster Geographic Edition Installation Guide
This section discusses errors and omissions from the _Sun Cluster Geographic Edition Installation Guide_.

The section "Planning Required IP Addressed and Hostnames" documents that, when you configure a partnership between two clusters that are in different DNS domains, for example, {{denver.com}} and {{london.uk}}, you must include the domain when you specify a cluster name to Sun Cluster Geographic Edition commands. This topic does not make clear that, however, the cluster name itself must not be defined to the Sun Cluster software to include its domain. For example, to rename a cluster from {{denver}} to {{newyork}}, use the command {{cluster rename denver newyork}}, *not* {{cluster rename denver.com newyork.net}}.

[Top|#top]
h3. Sun Cluster Geographic Edition System Administration Guide

This section discusses errors and omissions from the _Sun Cluster Geographic Edition System Administration Guide_.

When you use the {{geops}} command to administer trust between clusters that are in different domains, append the domain to the cluster name. For example, if the cluster {{newyork}} is in the {{.usa}} domain, add trust to the cluster by using the command *{{geops add-trust -c newyork.usa}}*. This requirement is not documented in the System Administration Guide procedures.

In addition, the cluster name as it is returned by the {{cluster list}} command must *not* include the domain name, as the system might interpret such names as {{_cluster.domain.domain_}} and not be able to resolve the cluster name correctly. Do add the domain of a cluster to the {{/etc/hosts}} file.

[Top|#top]

h3. {anchor:FVZOF} Sun Cluster Geographic Edition Installation Guide

This section discusses errors and omissions from the _Sun Cluster Geographic Edition Installation Guide_.

The section "Planning Required IP Addressed and Hostnames" documents that, when you configure a partnership between two clusters that are in different DNS domains, for example, {{denver.com}} and {{london.uk}}, you must include the domain when you specify a cluster name to Sun Cluster Geographic Edition commands. This topic does not make clear that, however, the cluster name itself must not be defined to the Sun Cluster software to include its domain. For example, to rename a cluster from denver to newyork, use the command {{cluster rename denver newyork\]\], *not* {{cluster rename denver.com newyork.net}}.


\\V.29 pick up at 4/30 for l10n translation.