238
Sun Cluster 3.0-3.1 Release Notes Supplement Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054 U.S.A. Part No: 816–3381–24 April 2006, Revision A Composed March 29, 2006

SC30 31 Supplement

Embed Size (px)

DESCRIPTION

SC30 31 Supplement

Citation preview

  • SunCluster 3.0-3.1 ReleaseNotesSupplement

    SunMicrosystems, Inc.4150Network CircleSanta Clara, CA95054U.S.A.

    Part No: 816338124April 2006, RevisionA

    ComposedMarch 29, 2006

  • Copyright 2006 SunMicrosystems, Inc. 4150Network Circle, Santa Clara, CA95054U.S.A. All rights reserved.

    SunMicrosystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and withoutlimitation, these intellectual property rights may include one ormore U.S. patents or pending patent applications in the U.S. and in other countries.

    U.S. Government Rights Commercial software. Government users are subject to the SunMicrosystems, Inc. standard license agreement and applicable provisionsof the FAR and its supplements.

    This distributionmay includematerials developed by third parties.

    Parts of the product may be derived fromBerkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and othercountries, exclusively licensed through X/Open Company, Ltd.

    Sun, SunMicrosystems, the Sun logo, the Solaris logo, the Java Coffee Cup logo, docs.sun.com, Java, and Solaris are trademarks or registered trademarks of SunMicrosystems, Inc. in the U.S. and other countries.All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARCInternational, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by SunMicrosystems, Inc. Thisproduct includes software developed by theApache Software Foundation (http://www.apache.org/).

    The OPEN LOOK and SunGraphical User Interface was developed by SunMicrosystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts ofXerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license fromXerox to theXerox Graphical User Interface, which license also covers Suns licensees who implement OPEN LOOKGUIs and otherwise comply with Suns written licenseagreements.

    Products covered by and information contained in this publication are controlled by U.S. Export Control laws andmay be subject to the export or import laws inother countries. Nuclear, missile, chemical or biological weapons or nuclearmaritime end uses or end users, whether direct or indirect, are strictly prohibited. Exportor reexport to countries subject to U.S. embargo or to entities identied onU.S. export exclusion lists, including, but not limited to, the denied persons and speciallydesignated nationals lists is strictly prohibited.

    DOCUMENTATION IS PROVIDED AS ISANDALLEXPRESSOR IMPLIEDCONDITIONS, REPRESENTATIONSANDWARRANTIES, INCLUDINGANYIMPLIEDWARRANTYOFMERCHANTABILITY, FITNESS FORAPARTICULAR PURPOSEORNON-INFRINGEMENT,AREDISCLAIMED, EXCEPTTOTHE EXTENTTHAT SUCHDISCLAIMERSAREHELDTOBE LEGALLY INVALID.

    Copyright 2006 SunMicrosystems, Inc. 4150Network Circle, Santa Clara, CA95054U.S.A. Tous droits rservs.

    SunMicrosystems, Inc. dtient les droits de proprit intellectuelle relatifs la technologie incorpore dans le produit qui est dcrit dans ce document. En particulier,et ce sans limitation, ces droits de proprit intellectuelle peuvent inclure un ou plusieurs brevets amricains ou des applications de brevet en attente aux Etats-Unis etdans dautres pays.

    Cette distribution peut comprendre des composants dvelopps par des tierces personnes.

    Certaines composants de ce produit peuvent tre drives du logiciel Berkeley BSD, licencis par lUniversit de Californie. UNIX est unemarque dpose auxEtats-Unis et dans dautres pays; elle est licencie exclusivement par X/Open Company, Ltd.

    Sun, SunMicrosystems, le logo Sun, le logo Solaris, le logo Java Coffee Cup, docs.sun.com, Java et Solaris sont desmarques de fabrique ou desmarques dposes deSunMicrosystems, Inc. aux Etats-Unis et dans dautres pays. Toutes les marques SPARC sont utilises sous licence et sont desmarques de fabrique ou desmarquesdposes de SPARC International, Inc. aux Etats-Unis et dans dautres pays. Les produits portant les marques SPARC sont bass sur une architecture dveloppe parSunMicrosystems, Inc. Ce produit inclut le logiciel dvelopp par la base deApache Software Foundation (http://www.apache.org/).

    Linterface dutilisation graphique OPEN LOOK et Sun a t dveloppe par SunMicrosystems, Inc. pour ses utilisateurs et licencis. Sun reconnat les efforts depionniers de Xerox pour la recherche et le dveloppement du concept des interfaces dutilisation visuelle ou graphique pour lindustrie de linformatique. Sun dtientune licence non exclusive de Xerox sur linterface dutilisation graphique Xerox, cette licence couvrant galement les licencis de Sun quimettent en place linterfacedutilisation graphique OPEN LOOK et qui, en outre, se conforment aux licences crites de Sun.

    Les produits qui font lobjet de cette publication et les informations quil contient sont rgis par la legislation amricaine enmatire de contrle des exportations etpeuvent tre soumis au droit dautres pays dans le domaine des exportations et importations. Les utilisations nales, ou utilisateurs naux, pour des armes nuclaires,desmissiles, des armes chimiques ou biologiques ou pour le nuclairemaritime, directement ou indirectement, sont strictement interdites. Les exportations ourexportations vers des pays sous embargo des Etats-Unis, ou vers des entits gurant sur les listes dexclusion dexportation amricaines, y compris, mais demanirenon exclusive, la liste de personnes qui font objet dun ordre de ne pas participer, dune faon directe ou indirecte, aux exportations des produits ou des services quisont rgis par la legislation amricaine enmatire de contrle des exportations et la liste de ressortissants spciquement designs, sont rigoureusement interdites.

    LADOCUMENTATIONEST FOURNIE "EN LETAT" ET TOUTESAUTRES CONDITIONS, DECLARATIONS ETGARANTIES EXPRESSESOUTACITESSONT FORMELLEMENTEXCLUES, DANS LAMESUREAUTORISEE PAR LALOIAPPLICABLE, YCOMPRISNOTAMMENTTOUTEGARANTIEIMPLICITE RELATIVEALAQUALITEMARCHANDE,ALAPTITUDEAUNEUTILISATIONPARTICULIEREOUALABSENCEDECONTREFACON.

    060329@14558

    ComposedMarch 29, 2006

  • Contents

    1 Sun Cluster 3.1 8/05 Release Notes Supplement ...................................................................................13Revision Record ............................................................................................................................................13New Features .................................................................................................................................................15

    Required Patches ...................................................................................................................................15Support for Oracle 10g R2 RealApplication Clusters on the x64 Platform ...................................16Support for SunMultipathing Software on Solaris 10 x86 Based Congurations ........................16Support for InniBandAdapters on the Cluster Interconnect .......................................................16Support for the Sun StorEdge QFS Shared File SystemWith Solaris VolumeManager for SunCluster ....................................................................................................................................................17Support for Oracle 10g R1 and 10g R2 RealApplication Clusters on the SPARC Platform ........19

    How toDisable the Oracle GSD .............................................................................................20Support for Oracle 10g on the x64 PlatformWith the Solaris 10 OS ..............................................20Support for Version SAPVersion 6.40 ................................................................................................20Support forMaxDBVersion 7.5 ..........................................................................................................21Support for SAP liveCache Version 7.5 ..............................................................................................21

    How to Congure the SAP liveCacheAdministrator User .................................................21How to ConrmThat the SAP liveCacheAdministrator User Can Run the lcinitCommand ......................................................................................................................................22

    Support for Oracle 10g on the x86 Platform ......................................................................................22Restrictions and Requirements ...................................................................................................................23Fixed Problems .............................................................................................................................................23Known Problems ..........................................................................................................................................23

    Cluster ProblemsWhenUsing the ipge3 Port as Interconnect ......................................................23Must Congure Runtime Linking Environment on SAPUnicode Systems (4996643) ...............24Use of the Console as ttya on a V440 Causes Unresponsiveness ofWebLogic Server (6182519) ..24Solaris Operating System 10 Patch 11882218 and Later CanNegatively Impact Cluster StabilityWhen Run on SPARC Platformwith PxFS (6335093) .....................................................................25Java ES 4 Installer Fails to Install on Solaris 10 EndUser Cluster (6363536) .................................25Localization Packages For Sun JavaWeb Console DoNot Exist in the Sun Cluster Standalone

    3

    ComposedMarch 29, 2006

  • Distribution (6299614) ........................................................................................................................26How toUpgrade Sun JavaWeb Console Localization Packages ........................................26

    IPv6 Scalable Service Support is Not Enabled by Default (6332656) ..............................................27How toManually Enable IPv6 Scalable Service Support .....................................................27

    KnownDocumentation Problems .............................................................................................................28Sun Cluster Concepts Guide for Solaris OS .......................................................................................28Software Installation Guide .................................................................................................................28Sun Cluster Data Service for Solaris Containers Guide ...................................................................29

    How to Install a Zone and Perform the Initial Internal Zone Conguration ...................30How to Patch to the Global Zone and Local Zones ..............................................................31

    Sun Cluster Data Service for SAPGuide for Solaris OS ...................................................................31Sun Cluster Data Service for SAPDBGuide for Solaris OS .............................................................32Sun Cluster Data Service for SAP liveCache Guide for Solaris OS .................................................32Sun Cluster Data Service for SAPWebApplication Server Guide for Solaris OS .........................33Release Notes .........................................................................................................................................35

    2 Sun Cluster 3.1 9/04 Release Notes Supplement ...................................................................................37Revision Record ............................................................................................................................................37New Features .................................................................................................................................................39

    SPARC: Support for VxVM4.1 andVxFS 4.1 ...................................................................................39Mirroring Internal Disks on Servers that Use Internal Hardware DiskMirroring or IntegratedMirroring ...............................................................................................................................................39

    Conguring Internal DiskMirroring During Installation ..................................................40How to Congure Internal DiskMirroringAfter the Cluster is Established ....................40How to Remove an Internal DiskMirror ..............................................................................42

    SPARC: Support for Sun StorEdge QFSWithOracle 10g RealApplication Clusters ...................43Support forAutomatic StorageManagement (ASM)WithOracle 10g RealApplication Clusterson the SPARC Platform ........................................................................................................................45

    How toUseASMwithOracle 10g RealApplication Clusters .............................................46Restrictions and Requirements ...................................................................................................................46

    Restriction on SCI Card Placement ....................................................................................................46Storage-Based Data Replication andQuorumDevices ....................................................................47

    Known Problems ..........................................................................................................................................47Bug ID 4333241 .....................................................................................................................................47Bug ID 4804696 .....................................................................................................................................47Bug ID 5107076 .....................................................................................................................................48

    Contents

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA4

    ComposedMarch 29, 2006

  • How to Replace the Sun Cluster Support Packages for Oracle RealApplication Clusters ..48

    Bug ID 5109935 .....................................................................................................................................49Bug ID 6196936 .....................................................................................................................................49Bug ID 6198608 .....................................................................................................................................49Bug ID 6210418 .....................................................................................................................................50Bug ID 6220218 .....................................................................................................................................50Bug ID 6252555 .....................................................................................................................................50

    KnownDocumentation Problems .............................................................................................................51SystemAdministration Guide .............................................................................................................51Software Installation Guide .................................................................................................................51Man Pages ..............................................................................................................................................52

    3 Sun Cluster 3.1 4/04 Release Notes Supplement ...................................................................................55Revision Record ............................................................................................................................................55New Features .................................................................................................................................................57

    SPARC: Support for VxVM4.0 andVxFS 4.0 ...................................................................................57Support for the Sun StorEdge QFS File System .................................................................................57Support for Oracle 10g RealApplication Clusters on the SPARC Platform ..................................57

    Restrictions and Requirements ...................................................................................................................59Compiling Data Services ThatAreWritten in C++ ..........................................................................59

    Known Problems ..........................................................................................................................................60Bug ID 5095543 .....................................................................................................................................60Bug ID 5066167 .....................................................................................................................................60

    KnownDocumentation Problems .............................................................................................................61Software Installation Guide .................................................................................................................61

    4 Sun Cluster 3.1 10/03 Release Notes Supplement .................................................................................63Revision Record ............................................................................................................................................63New Features .................................................................................................................................................65Restrictions and Requirements ...................................................................................................................65

    Compiling Data Services ThatAreWritten in C++ ..........................................................................65Upgrading Sun Cluster 3.1 10/03 Software on Clusters That Run Sun StorEdgeAvailability Suite3.1 Software ............................................................................................................................................66Restriction on Rolling Upgrade andVxVM ......................................................................................66

    Known Problems ..........................................................................................................................................67

    Contents

    5

    ComposedMarch 29, 2006

  • Bug ID 4848612 .....................................................................................................................................67Bug ID 4983696 .....................................................................................................................................67

    KnownDocumentation Problems .............................................................................................................67Software Installation Guide .................................................................................................................67

    5 Sun Cluster Data Services 3.1 10/03 Release Notes Supplement ........................................................71Revision Record ............................................................................................................................................71New Features .................................................................................................................................................72

    Support for Oracle 10g .........................................................................................................................72WebLogic Server Version 8.x ...............................................................................................................73

    Restrictions and Requirements ...................................................................................................................73Known Problems ..........................................................................................................................................74

    SomeData Services Cannot be Upgraded byUsing the scinstallUtility ...................................74How toUpgrade Data Services That Cannot be Upgraded byUsing scinstall .................74

    Sun Cluster HAfor liveCache nsswitch.conf requirements for passwdmakeNIS unusable(4904975) ...............................................................................................................................................75

    KnownDocumentation Problems .............................................................................................................75

    6 Sun Cluster 3.1 Release Notes Supplement ............................................................................................77Revision Record ............................................................................................................................................77New Features .................................................................................................................................................80

    Sun Cluster Support for Oracle RealApplication Clusters on a Subset of Cluster Nodes ...........80Restrictions and Requirements ...................................................................................................................81

    Compiling Data Services ThatAreWritten in C++ ..........................................................................81Reserved RPC ProgramNumbers ......................................................................................................81ChangingQuorumDevice Connectivity ...........................................................................................81Required VxFSDefault Stack Size Increase .......................................................................................81Clarication of the IPv6 Restriction ...................................................................................................82

    Fixed Problems .............................................................................................................................................82Bug ID 4840853 .....................................................................................................................................82Bug ID 4867584 .....................................................................................................................................82

    Known Problems ..........................................................................................................................................82Bug ID 4781666 .....................................................................................................................................82Bug ID 4863254 .....................................................................................................................................83Bug ID 4867560 .....................................................................................................................................83Bug ID 4920156 .....................................................................................................................................83

    Contents

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA6

    ComposedMarch 29, 2006

  • KnownDocumentation Problems .............................................................................................................83Software Installation Guide .................................................................................................................83

    7 Sun Cluster Data Services 3.1 5/03 Release Notes Supplement ..........................................................87Revision Record ............................................................................................................................................87New Features .................................................................................................................................................88

    Support for Oracle 10g .........................................................................................................................88Sun Cluster Support for Oracle RealApplication Clusters on a Subset of Cluster Nodes ...........89

    Restrictions and Requirements ...................................................................................................................90Known Problems ..........................................................................................................................................91KnownDocumentation Problems .............................................................................................................91

    Sun Cluster 3.1 Data Service for NetBackup ......................................................................................91Sun Cluster 3.1 Data Service for SunONEApplication Server .......................................................91Release Notes .........................................................................................................................................91

    8 Sun Cluster 3.0 5/02 Release Notes Supplement ...................................................................................93Revision Record ............................................................................................................................................93New Features ...............................................................................................................................................102

    SPARC: Support for VxVM4.0 andVxFS 4.0 .................................................................................103Support for Oracle 10g .......................................................................................................................103Sun Cluster Support for Oracle RealApplication Clusters on a Subset of Cluster Nodes .........104Support for VERITASNetBackup 4.5 ..............................................................................................104Security Hardening for Solaris 9 .......................................................................................................108Failover File System (HAStoragePlus) .............................................................................................108RAID 5 on Sun StorEdge 99x0 StorageArrays ................................................................................109Apache 2.0 ...........................................................................................................................................109NewGuidelines for the swap Partition .............................................................................................109Support for Oracle RealApplication Clusters on the Cluster File System ...................................109

    How to Install Sun Cluster Support for Oracle RealApplication Clusters PackagesWiththe Cluster File System ............................................................................................................... 110

    Restrictions and Requirements ................................................................................................................. 111Compiling Data Services ThatAreWritten in C++ ........................................................................ 111Reserved RPC ProgramNumbers .................................................................................................... 111DynamicMultipathing (DMP) ......................................................................................................... 111ChangingQuorumDevice Connectivity ......................................................................................... 112Storage Topologies Replaced byNewRequirements ...................................................................... 112

    Contents

    7

    ComposedMarch 29, 2006

  • Shared Storage Restriction Relaxed .................................................................................................. 112EMC Storage Restriction ................................................................................................................... 112Framework Restrictions and Requirements .................................................................................... 113Oracle UDLMRequirement .............................................................................................................. 113

    Fixed Problems ........................................................................................................................................... 114BugId 4818874 ..................................................................................................................................... 114

    Known Problems ........................................................................................................................................ 114Bug ID 4346123 ................................................................................................................................... 114Bug ID 4662264 ................................................................................................................................... 115Bug ID 4665886 ................................................................................................................................... 115Bug ID 4668496 ................................................................................................................................... 115Bug ID 4680862 ................................................................................................................................... 115Bug ID 4779686 ................................................................................................................................... 115BugId 4836405 ..................................................................................................................................... 116BugID 4838619 .................................................................................................................................... 116

    KnownDocumentation Problems ........................................................................................................... 117SystemAdministration Guide ........................................................................................................... 117Hardware Guide .................................................................................................................................. 117Software Installation Guide ............................................................................................................... 119

    How toUpgrade to the Sun Cluster 3.0 5/02 Software Update Release ........................... 119Data Services Installation and Conguration Guide ......................................................................126Supplement ..........................................................................................................................................134Release Notes .......................................................................................................................................134Man Pages ............................................................................................................................................135

    A Scalable Cluster Topology ........................................................................................................................139Overview of Scalable Topology .................................................................................................................139Adding or Removing a Cluster Node .......................................................................................................140

    Adding a Cluster Node .......................................................................................................................140Removing a Cluster Node ..................................................................................................................140How to Remove Connectivity Between anArray and a Single Node, in a ClusterWith GreaterThan Two-Node Connectivity ..........................................................................................................142

    B Installing and Conguring Sun Cluster HA for SAP liveCache ...........................................................145Sun Cluster HAfor SAP liveCache Overview ..........................................................................................145Installing and Conguring Sun Cluster HAfor SAP liveCache ............................................................147

    Contents

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA8

    ComposedMarch 29, 2006

  • Planning the Sun Cluster HAfor SAP liveCache Installation and Conguration ..............................148Conguration Requirements ............................................................................................................148Standard Data Service Congurations .............................................................................................149Conguration Considerations ..........................................................................................................149Conguration PlanningQuestions ..................................................................................................149

    Preparing the Nodes andDisks .................................................................................................................150How to Prepare the Nodes ............................................................................................................150

    Installing and Conguring SAP liveCache ..............................................................................................151How to Install and Congure SAP liveCache .............................................................................151How to Enable SAP liveCache to Run in a Cluster .....................................................................151

    Verifying the SAP liveCache Installation and Conguration ................................................................152How to Verify the SAP liveCache Installation and Conguration ...........................................152

    Installing the Sun Cluster HAfor SAP liveCache Packages ...................................................................153How to Install the Sun Cluster HAfor SAP liveCache Packages ..............................................153

    Registering and Conguring the Sun Cluster HAfor SAP liveCache ..................................................154Sun Cluster HAfor SAP liveCache Extension Properties ..............................................................154How to Register and Congure Sun Cluster HAfor SAP liveCache ........................................156

    Verifying the Sun Cluster HAfor SAP liveCache Installation and Conguration ..............................159How to Verify the Sun Cluster HAfor SAP liveCache Installation and Conguration .........159

    Understanding Sun Cluster HAfor SAP liveCache FaultMonitors .....................................................160Extension Properties ..........................................................................................................................160Monitor CheckMethod .....................................................................................................................160ProbingAlgorithm and Functionality ..............................................................................................161

    C Installing and Conguring Sun Cluster HA for SybaseASE ................................................................163Installing and Conguring Sun Cluster HAfor SybaseASE .................................................................163Preparing to Install Sun Cluster HAfor SybaseASE ..............................................................................164Installing the SybaseASE 12.0 Software ...................................................................................................164

    How to Prepare the Nodes ............................................................................................................165How to Install the Sybase Software ..............................................................................................166How to Verify the SybaseASE Installation ..................................................................................168

    Creating the SybaseASEDatabase Environment ...................................................................................168How to Congure SybaseASEDatabaseAccessWith Solstice DiskSuite/Solaris VolumeManager ...............................................................................................................................................168How to Congure SybaseASEDatabaseAccessWith VERITASVolumeManager ..............169How to Create the SybaseASEDatabase Environment .............................................................170

    Installing the Sun Cluster HAfor SybaseASE Package ..........................................................................171

    Contents

    9

    ComposedMarch 29, 2006

  • How to Install Sun Cluster HAfor SybaseASE Packages ..........................................................172Registering and Conguring Sun Cluster HAfor SybaseASE ..............................................................172

    How to Register and Congure Sun Cluster HAfor SybaseASE .............................................172Verifying the Sun Cluster HAfor SybaseASE Installation ....................................................................175

    How to Verify the Sun Cluster HAfor SybaseASE Installation ................................................175Understanding Sun Cluster HAfor SybaseASE Logging and Security Issues ....................................176

    Sun Cluster HAfor SybaseASE Logging ..........................................................................................176Important Security Issues ..................................................................................................................177

    Conguring Sun Cluster HAfor SybaseASE Extension Properties .....................................................177Sun Cluster HAfor SybaseASE FaultMonitor .......................................................................................180

    Main FaultMonitor Process ..............................................................................................................180Database-Client Fault Probe .............................................................................................................181Extension Properties ..........................................................................................................................181

    D RSM Phase II: RSMRDT Driver Installation ............................................................................................183Overview of the RSMRDTDriver .............................................................................................................183

    Installing the RSMRDTDriver .........................................................................................................183Restrictions ..........................................................................................................................................184How to Install the SUNWscrdt Package ........................................................................................184How toUninstall the SUNWscrdt Package ...................................................................................184How toUnload the RSMRDTDriverManually .........................................................................185

    E Installing and Conguring Sun Cluster HA for SAP ..............................................................................187Sun Cluster HAfor SAPOverview ...........................................................................................................188Installing and Conguring Sun Cluster HAfor SAP ..............................................................................188Planning the Sun Cluster HAfor SAP Installation and Conguration ................................................190

    Conguration Restrictions ................................................................................................................190Conguration Requirements ............................................................................................................190Standard Data Service Congurations .............................................................................................191Conguration Considerations ..........................................................................................................192Conguration PlanningQuestions ..................................................................................................194Packages and Support ........................................................................................................................194

    Upgrading Sun Cluster HAfor SAP .........................................................................................................195How toUpgrade a Resource Type or Convert a FailoverApplication Resource to a ScalableApplication Resource .........................................................................................................................195

    Preparing the Nodes andDisks .................................................................................................................196

    Contents

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA10

    ComposedMarch 29, 2006

  • How to Prepare the Nodes ............................................................................................................196Installing and Conguring SAP andDatabase ........................................................................................197

    How to Install SAP and the Database ..........................................................................................197How to Install an SAP ScalableApplication Server ....................................................................197How to Enable Failover SAP Instances to Run in a Cluster ......................................................200

    Conguring Sun Cluster HAfor DBMS ..................................................................................................201Where to Go FromHere ....................................................................................................................202

    Verifying the SAP Installation ...................................................................................................................202How to Verify SAP and the Database Installation with Central Instance ................................202How to Verify an SAPFailoverApplication Server ....................................................................203How to Verify an SAP ScalableApplication Server .........................................................................204

    Installing the Sun Cluster HAfor SAPPackages .....................................................................................204How to Install the Sun Cluster HAfor SAPPackages ................................................................204

    Registering and Conguring Sun Cluster HAfor SAP ...........................................................................205Sun Cluster HAfor SAPExtension Properties ................................................................................205How to Register and Congure Sun Cluster HAfor SAPwith Central Instance ................... 211How to Register and Congure Sun Cluster HAfor SAP as a Failover Data Service .............212How to Register and Congure Sun Cluster HAfor SAP as a Scalable Data Service .............213

    Setting Up a Lock File .................................................................................................................................214How to Set Up a Lock File for Central Instance or the FailoverApplication Server ..............215How to Set Up a Lock File for ScalableApplication Server .......................................................215

    Verifying the Sun Cluster HAfor SAP Installation and Conguration ................................................216How to Verify Sun Cluster HAfor SAP Installation and Conguration and Central Instance ..216How to Verify the Installation and Conguration of Sun Cluster HAfor SAP as a FailoverData Service .........................................................................................................................................217How to Verify Sun Cluster HAfor SAP Installation and Conguration of as a Scalable DataService ..................................................................................................................................................217

    Understanding Sun Cluster HAfor SAPFaultMonitor ........................................................................218Sun Cluster HAfor SAPFault Probes for Central Instance ...........................................................218Sun Cluster HAfor SAPFault Probes forApplication Server .......................................................219

    F Upgrading Sun Cluster Software From Solaris 8 to Solaris 9 Software ............................................221Upgrading to Sun Cluster 3.1 04/04 Software .........................................................................................221

    Upgrade Requirements and Restrictions .........................................................................................222How to Prepare the Cluster for Upgrade .....................................................................................223How toUpgrade the Solaris Operating Environment ...............................................................225

    Contents

    11

    ComposedMarch 29, 2006

  • How toUpgrade to Sun Cluster 3.1 04/04 Software ...................................................................227How toUpgrade Sun Cluster-Module Software for SunManagement Center ......................233How to Finish Upgrading to Sun Cluster 3.1 04/04 Software ...................................................234

    Recovering From Storage Conguration Changes During Upgrade ...................................................235How toHandle Storage RecongurationDuring anUpgrade .................................................235How to ResolveMistaken Storage Changes During anUpgrade .............................................236

    Contents

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA12

    ComposedMarch 29, 2006

  • Sun Cluster 3.1 8/05 Release Notes Supplement

    This chapter supplements the standard user documentation, including the Sun Cluster 3.1 8/05Release Notes for Solaris OS that shipped with the Sun Cluster 3.1 8/05 product. These onlinerelease notes provide themost current information on the Sun Cluster 3.1 8/05 product. Thischapter includes the following information.

    Revision Record on page 13 New Features on page 15 Restrictions and Requirements on page 23 Known Problems on page 23 KnownDocumentation Problems on page 28

    RevisionRecordThe following tables list the information contained in this chapter and provides the revision date forthis information.

    TABLE 11 SunCluster 3.1 8/05 ReleaseNotes Supplement Revision Record 2006

    RevisionDate New Information

    April 2006 Incorrect Release Date for the First Update of the Solaris 10 OS on page 28

    Support for Oracle 10g R2 RealApplication Clusters on the x64 Platform on page 16

    March 2006 Support for SunMultipathing Software on Solaris 10 x86 Based Congurationson page 16

    1C H A P T E R 1

    13

    ComposedMarch 29, 2006

  • TABLE 11 SunCluster 3.1 8/05 ReleaseNotes Supplement Revision Record 2006 (Continued)RevisionDate New Information

    January 2006 Use of the Console as ttya on a V440 Causes Unresponsiveness ofWebLogic Server(6182519) on page 24

    Cluster ProblemsWhenUsing the ipge3 Port as Interconnect on page 23

    Must Congure Runtime Linking Environment on SAPUnicode Systems (4996643)on page 24

    Java ES 4 Installer Fails to Install on Solaris 10 EndUser Cluster (6363536) on page 25

    Package Dependency Change from 1.0 to 1.1 Causes Installation Problems (6316676)on page 29

    TABLE 12 SunCluster 3.1 8/05 ReleaseNotes Supplement Revision Record 2005

    RevisionDate New Information

    November 2005

    Required Patches onpage 15

    Support for InniBandAdapters on the Cluster Interconnect onpage 16

    Support for the Sun StorEdgeQFS Shared File SystemWith Solaris VolumeManager for SunClusteronpage 17

    Support for Oracle 10gR1 and10gR2Real Application Clusters on the SPARCPlatform onpage 19

    Support for Oracle 10gon the x64 PlatformWith the Solaris 10OS onpage 20

    Support for Version SAPVersion 6.40 onpage 20

    Support forMaxDBVersion 7.5 onpage 21

    Support for SAP liveCacheVersion 7.5 onpage 21

    October 2005 Claried ambiguous statement about support of 16 node clusters in Sun ClusterConcepts Guide for Solaris OS on page 28.

    Clarication of the Restriction Concerning Solaris 10 Non-Global Zones on page 29

    Corrected errors in procedures for installing, conguring, and patching zones for usewith Sun Cluster HAfor Solaris Containers. See Sun Cluster Data Service for SolarisContainers Guide on page 29

    Manual steps are required to enable IPv6 support for scalable services. See IPv6Scalable Service Support is Not Enabled by Default (6332656) on page 27

    September 2005 Support for Oracle 10g on the x86 Platform on page 22

    Correction to Release Notes support matrices for VxVM andVxFS. See IncorrectClaim That VxVM4.0 Is Supported on Solaris 10 OS (CR 6315895) on page 35

    Revision Record

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA14

    ComposedMarch 29, 2006

  • TABLE 12 SunCluster 3.1 8/05 ReleaseNotes Supplement Revision Record 2005 (Continued)RevisionDate New Information

    November 2005

    Required Patches onpage 15

    Support for InniBandAdapters on the Cluster Interconnect onpage 16

    Support for the Sun StorEdgeQFS Shared File SystemWith Solaris VolumeManager for SunClusteronpage 17

    Support for Oracle 10gR1 and10gR2Real Application Clusters on the SPARCPlatform onpage 19

    Support for Oracle 10gon the x64 PlatformWith the Solaris 10OS onpage 20

    Support for Version SAPVersion 6.40 onpage 20

    Support forMaxDBVersion 7.5 onpage 21

    Support for SAP liveCacheVersion 7.5 onpage 21

    Localization Packages For Sun JavaWeb Console DoNot Exist in the Sun ClusterStandalone Distribution (6299614) on page 26

    NewFeaturesIn addition to features documented in the Sun Cluster 3.1 8/05 Release Notes for Solaris OS, thisrelease now includes support for the following features.

    RequiredPatchesPatches are required to run Sun Cluster 3.1 8/05 on certain operating system congurations. See tothe following table to determine if your operating system conguration requires a patch.

    Solaris Operating SystemVersion Conguration PatchNumber

    Solaris 9 SPARC 11794919

    Solaris 9 x86 11790919

    Solaris 10With Kernel Jumbo Patch118822-15 or greater

    SCI adapter 12054502

    Solaris 10 x64 12050103

    Solaris 10With Kernel Jumbo Patch118822-18 or greater

    SPARC using PxFsWith workaround for bug 6335093

    12050003

    NewFeatures

    Chapter 1 Sun Cluster 3.1 8/05 Release Notes Supplement 15

    ComposedMarch 29, 2006

  • Support forOracle 10gR2RealApplicationClusters onthe x64PlatformSun Cluster Support for Oracle RealApplication Clusters supports Oracle 10g R2 RealApplicationClusters on the x64 platformwith version 10 of the Solaris OS. For information about Sun ClusterSupport for Oracle RealApplication Clusters, see Sun Cluster Data Service for Oracle RealApplication Clusters Guide for Solaris OS.

    If you are using Sun Cluster Support for Oracle RealApplication Clusters with Oracle 10g R2 RealApplication Clusters on the x64 platform, the following patches are required: Sun Cluster patch 120498-02 Solaris patch 119964-05

    If you are using a storage area network (SAN) to provide access to shared storage and I/Omultipathing is enabled, the following Solaris patches are also required: 119375-13 119716-10

    Without these patches, a node can lose access to all shared storage if a physical link that providesaccess to storage is disconnected or fails.

    Support for SunMultipathing Software onSolaris 10x86BasedCongurationsThe procedure How to Install SunMultipathing Software in Sun Cluster Software InstallationGuide for Solaris OS is now also valid for x86 based congurations on the Solaris 10 operating system(OS). Contact your Sun sales representative for details.

    Sun TrafcManager is not supported on x86 based congurations that run the Solaris 9 OS.However, it is still supported on SPARC based congurations that run the Solaris 8 or Solaris 9 OS.

    Support for InniBandAdapters on theClusterInterconnectThe following requirements and guidelines apply to Sun Cluster congurations that use InniBandadapters: Atwo-node cluster must use InniBand switches. You cannot directly connect the InniBand

    adapters to each other. Asingle Sun InniBand switch, which has nine ports, can support up to nine nodes in a cluster. Jumbo frames are not supported on a cluster that uses InniBand adapters.

    NewFeatures

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA16

    ComposedMarch 29, 2006

  • VLANs are not supported on a cluster that uses InniBand adapters. If only one InniBand adapter is installed on a cluster node, each of its two ports must be

    connected to a different InniBand switch. If two InniBand adapters are installed in a cluster node, leave the second port on each adapter

    unused. For example, connect port 1 onHCA1 to switch 1 and connect port 1 onHCA2 toswitch 2.

    Support for the SunStorEdgeQFSShared File SystemWith Solaris VolumeManager for SunClusterSun Cluster Support for Oracle RealApplication Clusters supports the use of the Sun StorEdge QFSshared le systemwith Solaris VolumeManager for Sun Cluster on the Solaris 10 OS. Formoreinformation, see Sun Cluster Data Service for Oracle Real Application Clusters Guide for Solaris OS.

    Note Sun StorEdgeQFS shared le systemwith Solaris VolumeManager for SunCluster issupported only on the SPARC platform.

    Additional information that you require if you are using this conguration is provided in thesubsections that follow.

    Required SolarisOSPatchesTo use Sun Cluster Support for Oracle RealApplication Clusters with the Sun StorEdge QFS sharedle system and Solaris VolumeManager for Sun Cluster, install these patches in the following order:

    1. 120809-012. 120807-013. 118822-214. 120537-04

    Note Ensure that you install the stated revision or a higher revision of each patch in the precedinglist.

    StorageManagementRequirements forOracle FilesStorageManagement Requirements for Oracle Files in Sun Cluster Data Service for Oracle RealApplication Clusters Guide for Solaris OS states that you can use the Sun StorEdge QFS shared lesystem only with hardware redundant array of independent disks (RAID) support. Ignore thisstatement.

    NewFeatures

    Chapter 1 Sun Cluster 3.1 8/05 Release Notes Supplement 17

    ComposedMarch 29, 2006

  • Using SunStorEdgeQFSShared File SystemHow toUse Sun StorEdge QFS Shared File System in Sun Cluster Data Service for Oracle RealApplication Clusters Guide for Solaris OS states that youmust use the Sun StorEdge QFS shared lesystemwith hardware RAID support. Ignore this statement.

    Youmight use Solaris VolumeManagermetadevices as devices for the shared le systems. In thissituation, ensure that themetaset and its metadevices are created and available on all nodes beforeconguring the shared le systems.

    For optimumperformance, use Solaris VolumeManager for Sun Cluster tomirror the logical unitnumbers (LUNs) of your disk arrays. If you require striping, congure the striping with the lesystems.

    Mirroring the LUNs of your disk arrays involves the following operations: Creating RAID0metadevices Using the RAID0metadevices or Solaris VolumeManager soft partitions of suchmetadevices as

    Sun StorEdge QFS devices

    Installing SunCluster Support forOracle RealApplicationClustersPackagesIn Step 5 of the procedure How to Install Sun Cluster Support for Oracle RealApplication ClustersPackages in Sun Cluster Data Service for Oracle Real Application Clusters Guide for Solaris OS, runthe command for users of Solaris VolumeManager for Sun Cluster:

    # cd /cdrom/cdrom0/components/SunCluster_Oracle_RAC_SVM_3.1/Solaris_N/Packages

    N is the version number of the Solaris OS that you are using. For example, if you are using the Solaris10 OS,N is 10.

    InstallingOracle RealApplicationClusters SoftwareFor instructions, see Installing Oracle RealApplication Clusters Software in Sun Cluster DataService for Oracle Real Application Clusters Guide for Solaris OS.

    If you are installing the Oracle binary les andOracle conguration les on a shared le system,specify the absolute paths to the le systemwhen the Oracle installation tool requests thisinformation. Do not use a symbolic link whose target is the shared le system. Examples of shared lesystems are the Sun StorEdge QFS shared le system and the cluster le system.

    Removing SunCluster Support forOracle RealApplicationClustersFromaClusterBefore you begin: If you are using Sun StorEdge QFS shared le systems on Solaris VolumeManagermetadevices, remove these items in the following order:

    1. The resource groups that contain resources for the Sun StorEdge QFSmetadata servers of theseles systems

    NewFeatures

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA18

    ComposedMarch 29, 2006

  • 2. The Sun StorEdge QFS shared le systems

    In Step 5 of the procedure How to Remove Sun Cluster Support for Oracle RealApplicationClusters From a Cluster in Sun Cluster Data Service for Oracle Real Application Clusters Guide forSolaris OS, run the command for users of Solaris VolumeManager for Sun Cluster:

    # pkgrm SUNWscucm SUNWudlm SUNWudlmr SUNWscmd

    Removing SunCluster Support forOracle RealApplicationClustersFromSelectedNodesBefore you begin: If you are using Sun StorEdge QFS shared le systems on Solaris VolumeManagermetadevices, remove these items in the following order:

    1. Each affected node from the node list of the resource groups that contain resources for the SunStorEdge QFSmetadata servers of these les systemsFor instructions for removing a node from a resource groups node list, see Removing a NodeFrom a Resource Group in Sun Cluster Data Services Planning and Administration Guide forSolaris OS.

    2. The conguration of the Sun StorEdge QFS shared le systems from each affected node

    In Step 4 of the procedure How to Remove Sun Cluster Support for Oracle RealApplicationClusters From Selected Nodes in Sun Cluster Data Service for Oracle Real Application Clusters Guidefor Solaris OS, run the command for users of Solaris VolumeManager for Sun Cluster:

    # pkgrm SUNWscucm SUNWudlm SUNWudlmr SUNWscmd

    Support forOracle 10gR1and10gR2RealApplicationClusters on the SPARCPlatformSun Cluster Support for Oracle RealApplication Clusters supports Oracle 10g R1 and 10g R2 RealApplication Clusters on the SPARC platformwith versions 8, 9, and 10 of the Solaris OS.

    If you are using Oracle 10.1.0.4 throughOracle 10g R2 RealApplication Clusters with Sun ClusterSupport for Oracle RealApplication Clusters, youmust disable the Oracle Global Services Daemon(GSD).

    Note Disabling theOracle GSD does not enable Oracle 10g R1 orOracle 10g R2 to coexist withOracle 9.2.

    NewFeatures

    Chapter 1 Sun Cluster 3.1 8/05 Release Notes Supplement 19

    ComposedMarch 29, 2006

  • How toDisable theOracleGSDPerform this task on each node of the cluster.

    Stop theOracle GSD.# crs-home/bin/crs_stop ora.nodename.gsd

    crs-home The home directory for Oracle Cluster Ready Services (CRS)

    nodename The name of the node where you are disabling the GSD

    Prevent theOracle GSD frombeing started if the node is rebooted.# crs-home/bin/crs_unregister ora.nodename.gsd

    crs-home The home directory for Oracle CRS

    nodename The name of the node where you are disabling the GSD

    Support forOracle 10gon the x64PlatformWith theSolaris 10OSSun Cluster HAfor Oracle supports version 10g of Oracle with the Solaris 10 OS on the x64 platform.Formore information, see Sun Cluster Data Service for Oracle Guide for Solaris OS.

    If you are using Sun Cluster HAfor Oracle with version 10g of Oracle on the x64 platform, youmustinstall the Oracle application les on a highly available local le system. Do not install these les onthe cluster le system.

    Support for Version SAPVersion6.40Sun Cluster HAfor SAP supports version 6.40 of SAP. Formore information, see Sun Cluster DataService for SAPGuide for Solaris OS.

    Steps in this guide that apply specically to SAP 6.10 and SAP 6.20 also apply to SAP 6.40.

    When planning Sun Cluster HAfor SAP installation and conguration or performing the followingprocedures, consult http://service.sap.com/ha for information about updates to SAPproles. How to Install an SAP ScalableApplication Server on page 197 How to Enable Failover SAP Instances to Run in a Cluster on page 200

    When performing How to Enable Failover SAP Instances to Run in a Cluster on page 200, add thefollowing Step 9 to this procedure:

    9.As user sapsidadm, add the following entries for enq in the DEFAULT.PFL prole le under the/sapmnt/SAPSID/profile directory.

    1

    2

    NewFeatures

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA20

    ComposedMarch 29, 2006

  • rdisp/enqname=_sapsid_NRrdisp/myname=_sapsid_NR

    Support forMaxDBVersion7.5Sun Cluster HAforMaxDB supports version 7.5 ofMaxDB. Formore information, see Sun ClusterData Service forMaxDBGuide for Solaris OS.

    Note From version 7.5 of this product, the product name SAPDB has becomeMaxDB byMySQL(MaxDB).

    If you are usingMaxDB 7.5, the UNIX user identity of the OS user who administers theMaxDBdatabasemust be sdb. Otherwise, theMaxDB fault monitor cannot probe theMaxDB database.

    You are required to specify this user identity when you perform the tasks that are explained in thefollowing sections: How to Install and CongureMaxDB in Sun Cluster Data Service forMaxDBGuide for Solaris

    OS How to VerifyMaxDB Installation and Conguration on EachNode in Sun Cluster Data

    Service forMaxDBGuide for Solaris OS How to Register and Congure aMaxDBResource in Sun Cluster Data Service forMaxDB

    Guide for Solaris OS How to Verify the Operation of theMaxDB FaultMonitor in Sun Cluster Data Service for

    MaxDBGuide for Solaris OS

    Support for SAP liveCacheVersion7.5Sun Cluster HAfor SAP liveCache supports version 7.5 of SAP liveCache. Formore information, seeSun Cluster Data Service for SAP liveCache Guide for Solaris OS.

    If you are using SAP liveCache 7.5, the following additional conguration tasks are required: Conguring the SAP liveCache administrator user Conrming that the SAP liveCache administrator user can run the lcinit command

    How toCongure the SAP liveCacheAdministratorUserIf you are using SAP liveCache 7.5, congure the SAP liveCache administrator user immediatelyafter you perform the step to install SAP liveCache in How to Install and Congure SAP liveCacheon page 151.

    NewFeatures

    Chapter 1 Sun Cluster 3.1 8/05 Release Notes Supplement 21

    ComposedMarch 29, 2006

  • Ensure that the SAP liveCache administrator user is in the sdbauser group.

    The format of the SAP liveCache administrator users user ID is lc-nameadm.

    If you are creating the SAP liveCache administrator usermanually, add the following entry to the/etc/group le:sdba::group-id:lc-nameadm

    group-id The groups unique numerical ID (GID) within the system

    lc-name Lowercase name of SAP liveCache database instance

    Formore information about the /etc/group le, see the group(4) man page.

    If the SCMand SAP liveCache are installed ondifferentmachines, ensure that the SAP liveCacheadministrator users user ID is identical andbelongs to the sdbagroupon eachmachine.

    Tomeet these requirements, ensure that the entry for the SAP liveCache administrator user in the/etc/group le on eachmachine is identical. The required format of this entry is given in Step 1.

    How toConrmThat the SAP liveCacheAdministratorUser CanRun thelcinitCommandIf you are using SAP liveCache 7.5, conrm that the SAP liveCache administrator user can runlcinit immediately after you perform the task How to Verify the SAP liveCache Installation andConguration on page 152.

    Become the SAP liveCache administrator user.# su - lc-nameadm

    lc-name Lowercase name of SAP liveCache database instance

    Run the lcinit command.

    $ lcinit

    Support forOracle 10gon the x86PlatformSun Cluster HAfor Oracle supports version 10g of Oracle with the Solaris 9 OS on the x86 platform.Formore information, see Sun Cluster Data Service for Oracle Guide for Solaris OS.

    1

    2

    1

    2

    NewFeatures

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA22

    ComposedMarch 29, 2006

  • Restrictions andRequirementsNo restrictions or requirements have been added or updated since the Sun Cluster 3.1 8/05 release.

    FixedProblemsThere are no xed problems at this time.

    KnownProblemsIn addition to known problems that are documented in Sun Cluster 3.1 8/05 Release Notes for SolarisOS, the following known problems affect the operation of the Sun Cluster 3.1 8/05 release.

    Cluster ProblemsWhenUsing the ipge3Port asInterconnectProblem Summary:Various problems occur when using the ipge3 port for the cluster interconnect.These issues include the following: The cluster interconnect goes down intermittently (CR 6328986). The rsh/telnet/rlogin process hangs when connecting over the cluster interconnect (CR

    6352333). Network devices based on the Intel Ophir chip are unreliable in a back-to-back conguration

    (CR 6331252).

    Workaround:To avoid these problems, perform the following steps:

    1. Set the /etc/system variable for ipge as follows:

    set ipge:ipge_taskq_disable=1

    2. Use an Ethernet switch with your cluster interconnect cables for all ipge onboard interfaces.Direct-connect onboard interfaces are not supported by Sun Cluster software at this time.

    Known Problems

    Chapter 1 Sun Cluster 3.1 8/05 Release Notes Supplement 23

    ComposedMarch 29, 2006

  • Must CongureRuntimeLinking Environment onSAPUnicode Systems (4996643)Problem Summary:On SAPunicode systems, cleanpic binary needs User_env parameter forLD_LIBRARY_PATH

    sap_ci and sap_as start methods dump core unable to start SAP unicode systems.

    Workaround:To avoid this problems, if you are using a SAPUnicode system, youmust perform thefollowing steps before you perform Step 6 of How to Register and Congure Sun Cluster HAforSAPwith Central Instance on page 211 as the Solaris root user congure the runtime linkingenvironment to include the SAP exe and load library directories as follows:

    1. Congure the runtime linking environment for 32 bit applications.

    # crle -u -l /sapmnt/SAPSID/exe2. Verify that this modication has been applied for 32 bit applications.

    # crle

    3. Congure the runtime linking environment for 64 bit applications.

    # crle -64 -u -l /sapmnt/SAPSID/exe4. Verify that this modication has been applied for 64 bit applications.

    # crle -64

    You need only perform these steps once. If you have not performed these steps, you will not be ableto: Enable the failover resource group that includes the SAP central instance as described in How to

    Register and Congure Sun Cluster HAfor SAPwith Central Instance on page 211 Enable the failover resource group that includes the SAP application server resource group, step 6

    of How to Register and Congure Sun Cluster HAfor SAP as a Failover Data Service on page212

    Enable the scalable resource group that includes the SAP application server resource, as describedin How to Register and Congure Sun Cluster HAfor SAP as a Scalable Data Service on page213

    Useof theConsole as ttyaonaV440CausesUnresponsiveness ofWebLogic Server (6182519)Problem Summary: In a Sun Cluster 3.1 environment, when using the console as a ttya on a V440server,WebLogic Server can become extremely slow and unresponsive.

    Known Problems

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA24

    ComposedMarch 29, 2006

  • Workaround:Avoiding this problem involves steps specic to theWebLogic Server and itsconguration les. These steps are kept in a single location to ensure that they are kept up to date aswork to x the problem progresses. To see these workaround steps, go tohttp://www.sunsolve.sun.com and search on change request 6182519.

    SolarisOperating System10Patch 11882218andLater CanNegatively Impact Cluster StabilityWhenRunonSPARCPlatformwithPxFS (6335093)Problem Summary:The Solaris Operating System 10 patch 11882218 and later can cause node andcluster panics when run on a SPARCwith PxFS. The workaround for this bug is to disable segkpm onall nodes of the cluster. This workaround can cause severe performance degradation when comparedto an existing Solaris 10 installation. There is no performance degradation when compared to aSolaris 9 installation. The performance degradation is directly proportional to the number of CPUson each node. Nodes withmoderate numbers of CPUs (less than 20) will not be affected signicantly.This problem does not affect x86/x64 systems on Solaris 8, Solaris 9, and Solaris 10 and SPARCSolaris 8 and Solaris 9 installations. This problem also does not affect clusters running UFS, QFS, andVxFS.

    Workaround:Disable segkpm. On each node, add the following entry to the /etc/system le.

    set segmap_kpm=0

    Java ES 4 Installer Fails to Install on Solaris 10 EndUserCluster (6363536)Problem Summary: In the Sun Java Enterprise System 2005Q4 distribution, Sun Cluster softwarehas a dependency on Sun JavaWeb Console. The Solaris 10 version of Java ES no longer installs SunJavaWeb Console. Instead, Sun JavaWeb Console is expected to be installed as part of the Solaris 10OS.

    Sun JavaWeb Console is only available in the Developer software group of Solaris 10 software andhigher. If you install the EndUser software group of the Solaris 10 OS, Sun JavaWeb Console is notinstalled. Therefore, the Java ES installer will not install Sun Cluster software because this requiredsoftware is missing.

    Workaround:After you install the Solaris 10 EndUser software group but before you start the JavaES installer, use the pkgadd command to install the following Sun JavaWeb Console software and itsdependency packages from the Solaris 10media:

    SUNWmctag

    SUNWmconr

    SUNWmcon

    Known Problems

    Chapter 1 Sun Cluster 3.1 8/05 Release Notes Supplement 25

    ComposedMarch 29, 2006

  • SUNWtcatu

    SUNWmcosx

    SUNWmcos

    SUNWj3dev

    SUNWjato

    SUNWjhdev

    After all packages are installed, start the Java ES installer and proceed with Sun Cluster softwareinstallation.

    LocalizationPackages For Sun JavaWebConsoleDoNot Exist in the SunCluster StandaloneDistribution(6299614)Problem Summary: In the standalone distribution of Sun Cluster 3.1 8/05 software, the Sun JavaWeb Console packages on the Sun Cluster 2 of 2 CD-ROMdo not include localization packages. Thelack of packages prevents SunPlexManager from displaying the correct localized version after SunCluster software is upgraded to the Sun Cluster 3.1 8/05 release.

    Workaround:During upgrade to the Sun Cluster 3.1 8/05 release, upgrade Sun JavaWeb Consolepackages from the Sun Java Enterprise System (Java ES) distribution instead of from the Sun Clusterdistribution.When following the Sun Cluster procedures for upgrading dependency software,substitute the following instructions to install or upgrade Sun JavaWeb Console.

    How toUpgrade Sun JavaWebConsole LocalizationPackages

    Remove any Sun JavaWebConsole localization packages that are installed on the node.# pkgrm SUNWcmctg SUNWdmctg SUNWemctg SUNWfmctg SUNWhmctg SUNWkmctg SUNWjmctg

    # pkgrm SUNWcmcon SUNWdmcon SUNWemcon SUNWfmcon SUNWhmcon SUNWkmcon SUNWjmcon

    Insert the Java ES 2 of 2 CD-ROM in the CD-ROMdrive of the node.

    Install the base Sun JavaWebConsole packageby using the setuputility.# Product/sunwebconsole/setup

    Change to a directory that does not reside on the CD-ROMandeject the CD-ROM.# cd /

    # eject cdrom

    Insert the Java ES 1 of 2 CD-ROM in the CD-ROMdrive of the node.

    1

    2

    3

    4

    5

    Known Problems

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA26

    ComposedMarch 29, 2006

  • Change to the directory that contains the Sun JavaWebConsole localization packages for thelanguage that youwant.# cd Product/shared_components/Packages/locale/lang/

    Each language package is located in the Product/shared_components/Packages/locale/lang/directory where lang is the locale name of a particular language. For example, the locale name forJapanese is ja.

    Install the packagesmanually from the lang/directory.# pkgadd -d . localization-packages

    Change to a directory that does not reside on the CD-ROMandeject the CD-ROM.

    Continue the SunCluster 3.1 8/05 software upgradeprocedures.

    See Upgrading Sun Cluster Software in Sun Cluster Software Installation Guide.

    IPv6 Scalable Service Support is Not EnabledbyDefault (6332656)Problem Summary: IPv6 plumbing on the interconnects, which is required for forwarding of IPv6scalable service packets, will no longer be enabled by default. The IPv6 interfaces, as seen when usingthe ifconfig command, will no longer be plumbed on the interconnect adapters by default.

    Workaround:Manually enable IPv6 scalable service support.

    How toManually Enable IPv6 Scalable Service SupportEnsure that you have prepared all cluster nodes to run IPv6 services. These tasks include properconguration of network interfaces, server/client application software, name services, and routinginfrastructure. Failure to do somight result in unexpected failures of network applications. Formoreinformation, see your Solaris system-administration documentation for IPv6 services.

    Oneachnode, add the following entry to the /etc/system le.set cl_comm:ifk_disable_v6=0

    Oneachnode, enable IPv6 plumbing on the interconnect adapters.# /usr/cluster/lib/sc/config_ipv6

    The config_ipv6 utility brings up an IPv6 interface on all cluster interconnect adapters that have alink-local address. The utility enables proper forwarding of IPv6 scalable service packets over theinterconnects.

    Alternately, you can reboot each cluster node to activate the conguration change.

    6

    7

    8

    9

    BeforeYouBegin

    1

    2

    Known Problems

    Chapter 1 Sun Cluster 3.1 8/05 Release Notes Supplement 27

    ComposedMarch 29, 2006

  • KnownDocumentationProblemsThis section discusses documentation errors youmight encounter and steps to correct theseproblems. This information is in addition to known documentation problems that are documentedin the Sun Cluster 3.1 8/05 Release Notes for Solaris OS.

    SunCluster ConceptsGuide for SolarisOSThe following subsection describes omissions or errors that were discovered in the Sun ClusterConcepts Guide for Solaris OS.

    Ambiguous Statement That SunCluster for SPARCSupports aMaximumof 16Nodes (CR6322262)In the section Sun Cluster Topologies for SPARC in Sun Cluster Concepts Guide for Solaris OS, thefollowing ambiguous statement appears:

    ASun Cluster environment that is composed of SPARC based systems supports amaximum ofsixteen nodes in a cluster, regardless of the storage congurations that you implement.

    The preceding statement is changed as follows:

    ASun Cluster environment that is composed of SPARC based systems supports amaximum ofsixteen nodes in a cluster.All SPARC based topologies support up to eight nodes in a cluster. SelectedSPARC based topologies support up to sixteen nodes in a cluster. Contact your Sun salesrepresentative formore information.

    Software InstallationGuideThe following subsections describe omissions or new information that will be added to the nextpublication of the Software Installation Guide.

    Incorrect ReleaseDate for the First Update of the Solaris 10OSIn Appendix F, upgrade guidelines and procedures refer to the rst update release of the Solaris 10OS as Solaris 10 10/05. The date of this release is incorrect. The correct release date is 1/06.

    Therefore, to upgrade a Sun Cluster conguration to the Solaris 10 OS, the Solaris 10 1/06 release istheminimum version that Sun Cluster 3.1 8/05 software supports.

    KnownDocumentation Problems

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA28

    ComposedMarch 29, 2006

  • Claricationof theRestrictionConcerning Solaris 10Non-Global ZonesThe section Solaris OS Restrictions in the chapter Planning the Sun Cluster Congurationcontains the following statement:

    Sun Cluster 3.1 8/05 software does not support non-global zones. All Sun Cluster software andsoftware that is managed by the cluster must be installed only on the global zone of the node. Donot install cluster-related software on a non-global zone. In addition, all cluster-related softwaremust be installed in a way that prevents propagation to a non-global zone that is later created on acluster node.

    This restriction applies specically to the installation location of Sun Cluster framework softwareand Sun Cluster data-service software. It does not restrict the creation of non-global zones on acluster node. In addition, applications can be installed in a non-global zone on a cluster node andcongured to be highly available andmanaged by Sun Cluster software. Formore information, seeSun Cluster HAfor Solaris Containers in Sun Cluster 3.1 8/05 Release Notes for Solaris OS.

    PackageDependencyChange from1.0 to 1.1 Causes InstallationProblems (6316676)The procedures to upgrade dependency software (nonrolling upgrade and rolling upgrade) arecorrect only for common agent container version 1.0, which was distributed in the initial standalonerelease of Sun Cluster 3.1 8/05 software. The Sun Java Enterprise System 2005Q4 distributioncontains common agent container version 1.1, which now has a package order dependency.

    To install common agent container 1.1 software from the Java ES 2005Q4 distribution, specify thepackage names explicitly and in the following order, to satisfy the new package dependencies:

    SUNWcacaocfg SUNWcacao

    SunClusterData Service for Solaris ContainersGuideThe following sections in Sun Cluster Data Service for Solaris Containers Guide are incorrect: How to Install and Congure a Zone in Sun Cluster Data Service for Solaris Containers Guide

    Replace this incorrect section with How to Install a Zone and Perform the Initial Internal ZoneConguration on page 30

    Patching the Global Zone and Local Zones in Sun Cluster Data Service for Solaris ContainersGuideReplace this incorrect section with How to Patch to the Global Zone and Local Zones on page31.

    KnownDocumentation Problems

    Chapter 1 Sun Cluster 3.1 8/05 Release Notes Supplement 29

    ComposedMarch 29, 2006

  • How to Install a Zone andPerform the Initial Internal ZoneCongurationPerform this task on each node that is to host the zone.

    Note For complete information about installing a zone, see SystemAdministration Guide: SolarisContainers-ResourceManagement and Solaris Zones.

    Determine the following requirements for the deployment of the zone with Sun Cluster: The number of Solaris Zone instances that are to be deployed. The cluster le system that is to be used by each Solaris Zone instance.

    Ensure that the zone is congured.

    If the zone that you are installing is to run in a failover conguration, congure the zones zone pathto specify a highly available local le system. The le systemmust bemanaged by theSUNW.HAStoragePlus resource that you created in How to Enable a Zone to Run in a FailoverConguration in Sun Cluster Data Service for Solaris Containers Guide.

    For detailed information about conguring a zone before installation of the zone, see the followingdocumentation: Chapter 17, Non-Global Zone Conguration (Overview), in SystemAdministration Guide:

    Solaris Containers-ResourceManagement and Solaris Zones Chapter 18, Planning and Conguring Non-Global Zones (Tasks), in SystemAdministration

    Guide: Solaris Containers-ResourceManagement and Solaris Zones

    If the zone is to run in a failover conguration, ensure that the zones zonepath canbe created on thezones disk storage.

    If the zone is to run in amultiple-masters conguration, omit this step.

    a. On the nodewhere you are installing the zone, bring online the resource group that contains theresource for the zones disk storage.# scswitch -z -g solaris-zone-resource-group -h node

    b. If the zones zonepath exists on the zones disk storage, remove the zonepath.

    The zones zone path exists on the zones disk storage if you have already installed the zone onanother node.

    Install the zone.# zoneadm -z zone install

    BeforeYouBegin

    1

    2

    KnownDocumentation Problems

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA30

    ComposedMarch 29, 2006

  • Formore detailed information about installing a zone, see How to Install a Congured Zone inSystemAdministration Guide: Solaris Containers-ResourceManagement and Solaris Zones.

    Perform the initial internal zone conguration.

    a. Log in to the zones console.# zlogin -C zone

    You are prompted to congure the zone.

    b. Follow the prompts to congure the zone.

    c. Disconnect from the zones console.

    Use the escape sequence that you dened for the zone. If you did not dene an escape sequence,use the default escape sequence as follows:# ~.

    How toPatch to theGlobal Zone andLocal ZonesThis task is required only if you are applying a patch to the global zone and to local zones. If you areapplying a patch to only the global zone, follow the instructions in Chapter 8, Patching Sun ClusterSoftware and Firmware, in Sun Cluster SystemAdministration Guide for Solaris OS.

    This task applies to both nonrebooting patches and rebooting patches.

    Perform this task on all nodes in the cluster.

    Ensure that the node that you are patching can access the zonepaths of all zones that are conguredon the node.

    Some zonesmight be congured to run in a failover conguration. In this situation, bring online onthe node that you are patching the resource group that contains the resources for the zones diskstorage.# sscswitch -z -g solaris-zone-resource-group -h node

    Apply the patch to the node.

    For detailed instructions, see Chapter 8, Patching Sun Cluster Software and Firmware, in SunCluster SystemAdministration Guide for Solaris OS in Sun Cluster SystemAdministration Guide forSolaris OS.

    SunClusterData Service for SAPGuide for SolarisOSThe following information is missing from Sun Cluster Data Service for SAPGuide for Solaris OS.

    3

    1

    2

    KnownDocumentation Problems

    Chapter 1 Sun Cluster 3.1 8/05 Release Notes Supplement 31

    ComposedMarch 29, 2006

  • Aftermodifying your SAP systems database to refer to a logical host, if you are using SAPDB orMaxDB as your database, create a .XUSER.62 le in the home directory of the sapsysadm user thatrefers to the logical host of the database. Create this .XUSER.62 le using the dbmcli or xuser tools.Test this change using R3trans -d. This step is necessary so the SAP instance can nd the databasestate while starting up.

    SunClusterData Service for SAPDBGuide for SolarisOSThe following information is missing from the Sun Cluster Data Service forMaxDBGuide for SolarisOS:

    When following the procedure How to Install and CongureMaxDB in Sun Cluster Data ServiceforMaxDBGuide for Solaris OS, add the following fth step to the procedure:

    5. Copy the /etc/opt/sdb directory and its contents from the node on which you installed SAPDBto all nodes where resources for SAPDB and SAP xserver will run.

    Ensure that the ownership of this directory and its contents is the same on all nodes:

    # tar cfB - /etc/opt/sdb | rsh destination tar xfB -

    destination Species the node to which you are copying the /etc/opt/sdb directory and itscontents

    SunClusterData Service for SAP liveCacheGuide forSolarisOSThe following information is missing from the Sun Cluster Data Service SAP liveCache Guide forSolaris OS:

    When following the procedure How to Install and Congure SAP liveCache on page 151, add thefollowing fth and sixth steps to the procedure:

    5. Copy the /etc/opt/sdb directory and it contents from the node on which you installed SAPliveCache, to all the nodes where resources for SAP liveCache will run. Ensure that the ownership ofthese les is the same on all nodes as it is on the node on which you installed SAP liveCache.

    # tar cfB - /etc/opt/sdb | rsh destination tar xfB -

    destination Species the node to which you are copying the /etc/opt/sdb directory and itscontents

    6. Create a link from the /sapdb/LCA/db/wrk directory to the /sapdb/data/wrk directory as follows:

    KnownDocumentation Problems

    Sun Cluster 3.0-3.1 Release Notes Supplement April 2006, RevisionA32

    ComposedMarch 29, 2006

  • # ln -s /sapdb/data/wrk /sapdb/LCA/db/wrk

    SunClusterData Service for SAPWebApplicationServerGuide for SolarisOSInformation is missing from the Sun Cluster Data Service for SAPWeb Application Server Guide forSolaris OS on the following topics: How to Install and Congure the Scalable SAPWebApplication Server and the SAP J2EE

    Engine on page 33 How toModify the Installation for a Scalable SAPWebApplication Server Component on page

    33 How to Create a Dependency on theWebApplication Server Database on page 34

    How to Install andCongure the Scalable SAPWebApplication Serverand the SAPJ2EE EngineWhen performing the procedure How to Install and Congure the SAPWebApplication Server andthe SAP J2EE Engine in Sun Cluster Data Service for SAPWeb Application Server Guide for SolarisOS check http://service.sap.com/ha and corresponding SAPnotes for information about any changesthat youmustmake to the SAP conguration for it to work with a logical host.

    Step 2 of How to Install and Congure the SAPWebApplication Server and the SAP J2EE Enginein Sun Cluster Data Service for SAPWeb Application Server Guide for Solaris OS is missinginformation for the J2EE user.

    2. If you are using the SAP J2EE engine, install J2EE as an addon or a standalone, following theseinstructions:

    2a. If you are conguring J2EE as a failover data service install the SAP J2EE engine software on thesame node as which you installed the SAPWebApplication Server software.

    2b. If you are conguring J2EE as a scalable data service, install the same J2EE instance using thesame instance name on each node where you want the corresponding scalable resource to run.

    How toModify the Installation for a Scalable SAPWebApplicationServer ComponentSteps 2 and 5 of procedure How toModify the Installation for a Sca