What's New in Sun Cluster 3.1 Software

This section provides information related to new features, functionality, and supported products in Sun Cluster 3.1 software.

New Features and Functionality

Support for Solaris (x86 Platform Edition)

Sun Cluster is now available for use on Solaris^TM Operating System (x86 Platform Edition). You can now use Sun Cluster 3.1 4/04 software on a Sun Fire^TM V65x server that is running Update 6 of Solaris 9 Operating System (x86 Platform Edition).

Enhancements to Resource Types

The following resource types are enhanced in Sun Cluster 3.1:

• SUNW.oracle_listener (see Sun Cluster Data Service for Oracle Guide for Solaris OS)

• SUNW.sap_xserver (see Sun Cluster Data Service for SAP liveCache Guide for Solaris OS)

For general information about upgrading a resource type, see “Upgrading a Resource Type” in Sun Cluster Data Services Planning and Administration Guide for Solaris OS

New Supported Data Services (SPARC Platform Edition)

Sun Cluster 3.1 4/04 (SPARC Platform Edition) supports the following data services:

• HA Java System Application Server EE 7.0

• HA SAP DB 7.4

• HA Oracle 10G

New Supported Data Services (Solaris x86 Platform Edition)

Sun Cluster 3.1 4/04 (x86 Platform Edition) supports the following data services:

• HA NFS (Solaris 9 12/03)

• HA DNS (Solaris 9 12/03)

• HA Samba 2.2.8a and 3.0

• HA Java System Directory Server 5.2.1 Agent

• HA Java System Web Server 6.1

• HA Java System Application Server EE 7.0 U3

• HA Java System Message Queue 3.5

• HA DHCP

• HA MySQL

• Scalable Java System Web Server

Supported Products

This section describes the supported software and memory requirements for Sun Cluster 3.1 software.

• Operating environment and patches – Supported Solaris versions and patches are available at the following URL:

  http://sunsolve.sun.com

  For more details, see Patches and Required Firmware Levels.

• Volume managers

  • On Solaris 8 – Solstice DiskSuite^TM 4.2.1 and VERITAS Volume Manager 3.5.

  • On Solaris 9 – Solaris Volume Manager and VERITAS Volume Manager 3.5.

• File systems

  • On Solaris 8 – Solaris UFS and VERITAS File System 3.4 and 3.5.

  • On Solaris 9 – Solaris UFS and VERITAS File System 3.5.

• Data services (agents) – Contact your Sun sales representative for the complete list of supported data services and application versions. Specify the resource type names when you install the data services by using the scinstall(1M) utility. You should also specify the resource type names when you register the resource types associated with the data service using the scsetup(1M) utility.

  ---

  Note –

  Procedures for the version of Sun Cluster HA for Sun Java System Directory Server that uses Sun Java System Directory Server 5.0 and 5.1 (plus Netscape HTTP, versions 4.11, 4.12, 4.13, and 4.16) are located in the Sun Cluster 3.1 Data Service for Sun ONE Directory Server Guide. For later versions of Sun Java System Directory Server, previously known as Sun^TM Open Net Environment (Sun ONE) Directory Server, see the Sun Java System Directory Server product documentation.

  ---

  ---

  Note –

  All occurrences of "Sun One" in the names and descriptions of the data services for the JES applications should be read as "Sun Java System." Example: "Sun Cluster Data Service for Sun One Application Server" should read "Sun Cluster Data Service for Sun Java System Application Server."

  ---

  Table 1–1 Supported Data Services for Sun Cluster 3.1 Software

  Data Service	Sun Cluster Resource Type
  Sun Cluster HA for Apache	SUNW.apache
  Sun Cluster HA for Apache Tomcat	SUNW.sctomcat
  Sun Cluster HA for BroadVision One-To-One Enterprise	SUNW.bv
  Sun Cluster HA for DHCP	SUNW.gds
  Sun Cluster HA for DNS	SUNW.dns
  Sun Cluster HA for MySQL	SUNW.gds
  Sun Cluster HA for NetBackup	SUNW.netbackup_master
  Sun Cluster HA for NFS	SUNW.nfs
  Sun Cluster HA for Oracle E-Business Suite	SUNW.gds
  Sun Cluster HA for Oracle	SUNW.oracle_server SUNW.oracle_listener
  Sun Cluster Support for Oracle Parallel Server/Real Application Clusters	SUNW.rac_framework SUNW.rac_udlm SUNW.rac_cvm SUNW.rac_hwraid
  Sun Cluster HA for SAP	SUNW.sap_ci SUNW.sap_ci_v2 SUNW.sap_as SUNW.sap_as_v2
  Sun Cluster HA for SAP liveCache	SUNW.sap_livecache SUNW.sap_xserver
  Sun Cluster HA for SAP DB	SUNW.sapdb SUNW.sap_xserver
  Sun Cluster HA for SWIFTAlliance Access	SUNW.gds
  Sun Cluster HA for Samba	SUNW.gds
  Sun Cluster HA for Siebel	SUNW.sblgtwy SUNW.sblsrvr
  Sun Cluster HA for Sun Java System Application Server	SUNW.s1as
  Sun Cluster HA for Sun Java System HADB	SUNW.hadb
  Sun Cluster HA for Sun Java System Message Queue	SUNW.s1mq
  Sun Cluster HA for Sun Java System Web Server (This data service was formerly known as Sun Cluster HA for Sun ONE Web Server)	SUNW.iws
  Sun Cluster HA for Sybase ASE	SUNW.sybase
  Sun Cluster HA for WebLogic Server	SUNW.wls
  Sun Cluster HA for WebSphere MQ	SUNW.gds
  Sun Cluster HA for WebSphere MQ Integrator	SUNW.gds

• Memory Requirements – Sun Cluster 3.1 software requires extra memory beyond what is configured for a node under a normal workload. The extra memory equals 128 Mbytes plus ten percent. For example, if a standalone node normally requires 1 Gbyte of memory, you need an extra 256 Mbytes to meet memory requirements.

• RSMAPI – Sun Cluster 3.1 software supports the Remote Shared Memory Application Programming Interface (RSMAPI) on RSM-capable interconnects, such as PCI-SCI.

Sun Cluster Security Hardening

Sun Cluster Security Hardening uses the Solaris Operating Environment hardening techniques recommended by the Sun BluePrints^TM program to achieve basic security hardening for clusters. The Solaris Security Toolkit automates the implementation of Sun Cluster Security Hardening.

The Sun Cluster Security Hardening documentation is available at http://www.sun.com/blueprints/0203/817–1079.pdf. You can also access the article from http://wwws.sun.com/software/security/blueprints. From this URL, scroll down to the Architecture heading to locate the article “Securing the Sun Cluster 3.x Software.” The documentation describes how to secure Sun Cluster 3.1 deployments in a Solaris 8 and Solaris 9 environment. The description includes the use of the Solaris Security Toolkit and other best-practice security techniques recommended by Sun security experts.

Restrictions

The following restrictions apply to the Sun Cluster 3.1 release:

• Hardware Restrictions

• Network Restrictions

• Volume-Manager Restrictions

• Cluster File System Restrictions

• VxFS Restrictions

• Internet Protocol (IP) Network Multipathing Restrictions

• Service and Application Restrictions

• Data Service Restrictions

• Using Sun Cluster HA for Oracle With Oracle 10g

• Running Sun Cluster HA for Oracle 3.0 on Sun Cluster 3.1 Software

For other known problems or restrictions, see Known Issues and Bugs.

Hardware Restrictions

• Multihost tape, CD-ROM, and DVD-ROM are not supported.

• Alternate Pathing (AP) is not supported.

• Storage devices with more than a single path from a given cluster node to the enclosure are not supported except on the following storage devices:

  • Sun StorEdge^TM A3500, for which two paths are supported to each of two nodes

  • Any device that supports Sun StorEdge Traffic Manager

  • EMC storage devices that use EMC PowerPath software

• If you are using a Sun Enterprise^TM 420R server with a PCI card in slot J4701, the motherboard must be at dash-level 15 or higher (501-5168-15 or higher). To find the motherboard part number and revision level, look at the edge of the board closest to PCI slot 1.

• System panics have been observed in clusters when UDWIS I/O cards are used in slot 0 of a board in a Sun Enterprise 10000 server; do not install UDWIS I/O cards in slot 0 of a board in this server.

• When you increase or decrease the number of node attachments to a quorum device, the quorum vote count is not automatically recalculated. You can reestablish the correct quorum vote if you remove all quorum devices and then add them back into the configuration.

• SunVTS^TM is not supported.

Network Restrictions

• IPv6 is not supported.

• Remote Shared Memory (RSM) transport types are mentioned in the documentation, but are not supported. If you use the RSMAPI, specify dlpi as the transport type.

• The SBus Scalable Coherent Interface (SCI) is not supported as a cluster interconnect. However, the PCI-SCI interface is supported.

• Logical network interfaces are reserved for use by Sun Cluster software.

• Client applications that run on cluster nodes should not map to logical IP addresses of an HA data service. During failover, these logical IP addresses might go away, leaving the client without a connection.

Volume-Manager Restrictions

• If you are upgrading from VERITAS Volume Manager (VxVM) 3.2 to 3.5, the Cluster Volume Manger (CVM) feature will not be available until you install the CVM license key for version 3.5. In VxVM 3.5, the CVM license key for version 3.2 does not enable CVM and must be upgraded to the CVM license key for version 3.5.

• In Solstice DiskSuite/Solaris Volume Manager configurations that use mediators, the number of mediator hosts configured for a diskset must be exactly two.

• DiskSuite Tool (Solstice DiskSuite metatool) and the Enhanced Storage module of Solaris Management Console (Solaris Volume Manager) are not compatible with Sun Cluster 3.1 software.

• With VxVM 3.2 or later, Dynamic Multipathing (DMP) cannot be disabled with the scvxinstall command during VxVM installation. This procedure is described in the chapter,“Installing and Configuring VERITAS Volume Manager” in Sun Cluster Software Installation Guide for Solaris OS. The use of Veritas Dynamic Multipathing is supported in the following configurations.

  • A single I/O path per node to the cluster's shared storage.

  • A supported multipathing solution (Sun Traffic Manager, EMC PowerPath, Hiatchi HDLM) that manages multiple I/O paths per node to the shared cluster storage.

  The use of Dynamic Multipathing (DMP) alone to manage multiple I/O paths per node to the shared storage is not supported.

• Simple root disk groups (rootdg created on a single slice of the root disk) are not supported as disk types with VxVM on Sun Cluster 3.1 software.

• Software RAID 5 is not supported.

Cluster File System Restrictions

• Quotas are not supported on cluster file systems.

• Sun Cluster 3.1 software does not support the use of the loopback file system (LOFS) on cluster nodes.

• The command umount -f behaves in the same manner as the umount command without the -f option. It does not support forced unmounts.

• The command unlink(1M) is not supported on non-empty directories.

• The command lockfs -d is not supported. Use lockfs -n as a workaround.

• The cluster file system does not support any of the file-system features of Solaris software by which one would put a communication end-point in the file-system name space. Therefore, although you can create a UNIX domain socket whose name is a path name into the cluster file system, the socket would not survive a node failover. In addition, any fifos or named pipes you create on a cluster file system would not be globally accessible, nor should you attempt to use fattach from any node other than the local node.

• It is not supported to execute binaries off cluster file systems that are mounted by using the forcedirectio mount option.

• You cannot remount a cluster file system with the directio mount option added at remount time.

  You cannot set the directio mount option on a single file by using the directio ioctl.

VxFS Restrictions

• The following VxFS features are not supported in a Sun Cluster 3.1 configuration.

  • Quick I/O

  • Snapshots

  • Storage checkpoints

  • Cache advisories (these can be used, but the effect will be observed on the given node only)

  • VERITAS CFS (requires VERITAS cluster feature and VCS)

  All other VxFS features and options that are supported in a cluster configuration are supported by Sun Cluster 3.1 software. See VxFS documentation and man pages for details about VxFS options that are or are not supported in a cluster configuration.

• The following VxFS-specific mount options are not supported in a Sun Cluster 3.1 configuration.

  • convosync (Convert O_SYNC)

  • mincache

  • qlog, delaylog, tmplog

• For information about administering VxFS cluster file systems in a Sun Cluster configuration, see “Administering Cluster File Systems” in Sun Cluster System Administration Guide for Solaris OS.

Internet Protocol (IP) Network Multipathing Restrictions

This section identifies any restrictions on using IP Network Multipathing that apply only in a Sun Cluster 3.1 environment, or are different than information provided in the Solaris documentation for IP Network Multipathing.

• IPv6 is not supported.

• All public network adapters must be in IP Network Multipathing groups.

• In the /etc/default/mpathd file, do not change TRACK_INTERFACES_ONLY_WITH_GROUPS from yes to no.

Most procedures, guidelines, and restrictions that are identified in the Solaris documentation for IP Network Multipathing are the same in a cluster or a noncluster environment. Therefore, see the appropriate Solaris document for additional information about IP Network Multipathing restrictions.

Service and Application Restrictions

• Do not configure cluster nodes as routers (gateways). If the system goes down, the clients cannot find an alternate router and cannot recover.

• Do not configure cluster nodes as NIS or NIS+ servers. However, cluster nodes can be NIS or NIS+ clients.

• Do not use a Sun Cluster configuration to provide a highly available boot or installation service on client systems.

• Do not use a Sun Cluster configuration to provide an rarpd service.

• If you install an RPC service on the cluster, the service must not use the following program numbers: 100141, 100142, and 100248. These numbers are reserved for the Sun Cluster daemons rgmd_receptionist, fed, and pmfd, respectively. If the RPC service you install also uses one of these program numbers, you must change that RPC service to use a different program number.

• Currently, Sun StorEdge Network Data Replicator (SNDR) can only be used with HAStorage. This restriction only applies to the light weight resource group that includes the logical host that SNDR is using for replication. Application resource groups can still use HAStoragePlus with SNDR. You can use failover file system with HAStoragePlus and SNDR by using HAStorage for the SNDR resource group, and HAStoragePlus for the application resource group, where the HAStorage and HAStoragePlus resources point at the same underlying DCS device. A patch is being developed to enable SNDR to work with HAStoragePlus.

• Running high-priority process scheduling classes on cluster nodes is not supported. Processes that run in the time-sharing scheduling class with a high priority, or processes that run in the real-time scheduling class should not be run on cluster nodes. Sun Cluster software relies on kernel threads that do not run in the real-time scheduling class. Other time-sharing processes that run at higher-than-normal priority or real-time processes can prevent the Sun Cluster kernel threads from acquiring needed CPU cycles.

Data Service Restrictions

• Sun Cluster 3.1 software can only provide service for those data services that are either supplied with the Sun Cluster product or set up with the Sun Cluster data services API.

• Sun Cluster software currently does not have an HA data service for the sendmail(1M) subsystem. The sendmail subsystem can run on the individual cluster nodes, but the sendmail functionality will not be highly available, including the functionality of mail delivery and mail routing, queuing, or retry.

Using Sun Cluster HA for Oracle With Oracle 10g

If you are using Sun Cluster HA for Oracle with Oracle 10g, do not install the Oracle binary files on a highly available local file system. Sun Cluster HA for Oracle does not support such a configuration. However, you may install data files, log files, and configuration files on a highly available file system.

If you have installed Oracle 10g binary files on the cluster file system, error messages for the Oracle cssd daemon might appear on the system console during the booting of a node. When the cluster file system is mounted, these messages no longer appear.

These error messages are as follows:

INIT: Command is respawning too rapidly. Check for possible errors.
id:  h1 "/etc/init.d/init.cssd run >/dev/null 2>&1 >/dev/null"

Sun Cluster HA for Oracle does not require the Oracle cssd daemon. Therefore, you may ignore these error messages.

Running Sun Cluster HA for Oracle 3.0 on Sun Cluster 3.1 Software

The Sun Cluster HA for Oracle 3.0 data service can run on Sun Cluster 3.1 software only when used with the following versions of the Solaris operating environment:

• Solaris 8, 32-bit version

• Solaris 8, 64-bit version

• Solaris 9, 32-bit version

  ---

  Note –

  The Sun Cluster HA for Oracle 3.0 data service cannot run on Sun Cluster 3.1 software when used with the 64-bit version of Solaris 9.

  ---

Sun Cluster HA for Oracle Parallel Server/Real Application Cluster

Adhere to the documentation of Oracle Parallel Fail Safe/Real Application Clusters Guard option of Oracle Parallel Server/Real Application clusters because you cannot change hostnames after you install Sun Cluster software.

For more information on this restriction on hostnames and node names, see the Oracle Parallel Fail Safe/Real Application Clusters Guard documentation.

Sun Cluster HA for NetBackup

• If the VERITAS NetBackup client is a cluster, only one logical host can be configured as the client because there is only one bp.conf file.

• If the NetBackup client is a cluster and if one of the logical hosts on the cluster is configured as the NetBackup client, NetBackup cannot back up the physical hosts.

• On the cluster running the master server, the master server is the only logical host that can be backed up.

• Backup media cannot be attached to the master server, so one or more media servers are required.

• In a Sun Cluster environment, robotic control is only supported on media servers and not on the NetBackup master server running on Sun Cluster.

Sun Cluster HA for NFS

• No Sun Cluster node may be an NFS client of a Sun Cluster HA for NFS-exported file system being mastered on a node in the same cluster. Such cross-mounting of Sun Cluster HA for NFS is prohibited. Use the cluster file system to share files among cluster nodes.

• Applications running locally on the cluster must not lock files on a file system exported via NFS. Otherwise, local blocking (for example, flock(3UCB) or fcntl(2)) might interfere with the ability to restart the lock manager (lockd). During restart, a blocked local process may be granted a lock which may be intended to be reclaimed by a remote client. This would cause unpredictable behavior.

• Sun Cluster HA for NFS requires that all NFS client mounts be “hard” mounts.

• Sun Cluster 3.1 software does not support Secure NFS or the use of Kerberos with NFS, in particular, the secure and kerberos options to the share_nfs(1M) subsystem. However, Sun Cluster 3.1 software does support the use of secure ports for NFS by adding the entry set nfssrv:nfs_portmon=1 to the /etc/system file on cluster nodes.

Sun Cluster HA for SAP liveCache

Do not use NIS for naming services in a cluster running Sun Cluster HA for SAP liveCache because the NIS entry is only used if files are not available.

For more procedural information about the nssswitch.conf password requirements related to this restriction, see “Preparing the Nodes and Disks” in Sun Cluster Data Service for SAP liveCache Guide for Solaris OS.