Upload
others
View
5
Download
0
Embed Size (px)
Citation preview
Sun Cluster Data Service for SAPliveCache Guide for Solaris OS
Sun Microsystems, Inc.4150 Network CircleSanta Clara, CA 95054U.S.A.
Part No: 820–2567–10February 2008, Revision A
Copyright 2008 Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95054 U.S.A. All rights reserved.
Sun Microsystems, 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 or more 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 Sun Microsystems, Inc. standard license agreement and applicable provisionsof the FAR and its supplements.
This distribution may include materials developed by third parties.
Parts of the product may be derived from Berkeley 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, Sun Microsystems, 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 Sun Microsystems, Inc.
The OPEN LOOK and Sun Graphical User Interface was developed by Sun Microsystems, 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 from Xerox to theXerox Graphical User Interface, which license also covers Sun's licensees who implement OPEN LOOK GUIs and otherwise comply with Sun's written licenseagreements.
Products covered by and information contained in this publication are controlled by U.S. Export Control laws and may be subject to the export or import laws inother countries. Nuclear, missile, chemical or biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Exportor reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists, including, but not limited to, the denied persons and speciallydesignated nationals lists is strictly prohibited.
DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANYIMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TOTHE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
Copyright 2008 Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95054 U.S.A. Tous droits réservés.
Sun Microsystems, Inc. détient les droits de propriété intellectuelle relatifs à la technologie incorporée dans le produit qui est décrit dans ce document. En particulier,et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plusieurs brevets américains ou des applications de brevet en attente aux Etats-Uniset dans d'autres pays.
Cette distribution peut comprendre des composants développés par des tierces personnes.
Certaines composants de ce produit peuvent être dérivées du logiciel Berkeley BSD, licenciés par l'Université de Californie. UNIX est une marque déposée auxEtats-Unis et dans d'autres pays; elle est licenciée exclusivement par X/Open Company, Ltd.
Sun, Sun Microsystems, le logo Sun, le logo Solaris, le logo Java Coffee Cup, docs.sun.com, Java et Solaris sont des marques de fabrique ou des marques déposées deSun Microsystems, Inc. aux Etats-Unis et dans d'autres pays. Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marquesdéposées de SPARC International, Inc. aux Etats-Unis et dans d'autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée parSun Microsystems, Inc.
L'interface d'utilisation graphique OPEN LOOK et Sun a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les efforts depionniers de Xerox pour la recherche et le développement du concept des interfaces d'utilisation visuelle ou graphique pour l'industrie de l'informatique. Sun détientune licence non exclusive de Xerox sur l'interface d'utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l'interfaced'utilisation graphique OPEN LOOK et qui, en outre, se conforment aux licences écrites de Sun.
Les produits qui font l'objet de cette publication et les informations qu'il contient sont régis par la legislation américaine en matière de contrôle des exportations etpeuvent être soumis au droit d'autres pays dans le domaine des exportations et importations. Les utilisations finales, ou utilisateurs finaux, pour des armes nucléaires,des missiles, des armes chimiques ou biologiques ou pour le nucléaire maritime, directement ou indirectement, sont strictement interdites. Les exportations ouréexportations vers des pays sous embargo des Etats-Unis, ou vers des entités figurant sur les listes d'exclusion d'exportation américaines, y compris, mais de manièrenon exclusive, la liste de personnes qui font objet d'un ordre de ne pas participer, d'une façon directe ou indirecte, aux exportations des produits ou des services quisont régis par la legislation américaine en matière de contrôle des exportations et la liste de ressortissants spécifiquement designés, sont rigoureusement interdites.
LA DOCUMENTATION EST FOURNIE "EN L'ETAT" ET TOUTES AUTRES CONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES OU TACITESSONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT TOUTE GARANTIEIMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L'APTITUDE A UNE UTILISATION PARTICULIERE OU A L'ABSENCE DE CONTREFACON.
080328@19860
Contents
Preface .....................................................................................................................................................5
Installing and Configuring Sun Cluster HA for SAP liveCache ........................................................9Sun Cluster HA for SAP liveCache Overview .....................................................................................9Installing and Configuring Sun Cluster HA for SAP liveCache ..................................................... 11Planning the Sun Cluster HA for SAP liveCache Installation and Configuration ....................... 12
Configuration Requirements ...................................................................................................... 12Standard Data Service Configurations ...................................................................................... 13Configuration Considerations ................................................................................................... 13Configuration Planning Questions ............................................................................................ 13
Preparing the Nodes and Disks .......................................................................................................... 14▼ How to Prepare the Nodes .......................................................................................................... 14
Installing and Configuring liveCache ............................................................................................... 15▼ How to Install and Configure liveCache ................................................................................... 15▼ How to Enable liveCache to Run in a Cluster ........................................................................... 16
Verifying the liveCache Installation and Configuration ................................................................ 17▼ How to Verify the liveCache Installation and Configuration ................................................. 18
Installing the Sun Cluster HA for SAP liveCache Packages ........................................................... 18▼ How to Install the Sun Cluster HA for SAP liveCache Packages ............................................ 18
Registering and Configuring the Sun Cluster HA for SAP liveCache ........................................... 20Setting Sun Cluster HA for SAP liveCache Extension Properties .......................................... 20
▼ How to Register and Configure Sun Cluster HA for SAP liveCache ..................................... 21Verifying the Sun Cluster HA for SAP liveCache Installation and Configuration ...................... 24
▼ How to Verify the Sun Cluster HA for SAP liveCache Installation and Configuration ...... 24Tuning Sun Cluster HA for SAP liveCache Fault Monitors ........................................................... 26
Factors That Affect the Interval Between Fault Monitor Probes ............................................ 27Operations by the Sun Cluster HA for SAP liveCache Fault Monitors During a Probe ...... 27Faults Detected by the Sun Cluster HA for SAP liveCache Fault Monitors .......................... 28
3
Monitoring the Termination of liveCache by a User ............................................................... 29Upgrading the SUNW.sap_xserver Resource Type ......................................................................... 29
Information for Registering the New Resource Type Version ............................................... 29Information for Migrating Existing Instances of the Resource Type .................................... 30
A Sun Cluster HA for SAP liveCache Extension Properties ............................................................... 31SUNW.sap_livecache Extension Properties .................................................................................... 31SUNW.sap_xserver Extension Properties ........................................................................................ 32
Index ......................................................................................................................................................35
Contents
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A4
Preface
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS explains how to install andconfigure SunTM Cluster HA for SAP liveCache.
This document is intended for system administrators with extensive knowledge of Sun softwareand hardware. Do not use this document as a planning or presales guide. Before reading thisdocument, you should have already determined your system requirements and purchased theappropriate equipment and software.
The instructions in this book assume knowledge of the SolarisTM Operating System (Solaris OS)and expertise with the volume-manager software that is used with Sun Cluster software.
Using UNIX CommandsThis document contains information about commands that are specific to installing andconfiguring Sun Cluster data services. The document does not contain comprehensiveinformation about basic UNIX® commands and procedures, such as shutting down the system,booting the system, and configuring devices. Information about basic UNIX commands andprocedures is available from the following sources:
■ Online documentation for the Solaris Operating System■ Solaris Operating System man pages■ Other software documentation that you received with your system
Typographic ConventionsThe following table describes the typographic conventions that are used in this book.
5
TABLE P–1 Typographic Conventions
Typeface Meaning Example
AaBbCc123 The names of commands, files, and directories,and onscreen computer output
Edit your .login file.
Use ls -a to list all files.
machine_name% you have mail.
AaBbCc123 What you type, contrasted with onscreencomputer output
machine_name% su
Password:
aabbcc123 Placeholder: replace with a real name or value The command to remove a file is rmfilename.
AaBbCc123 Book titles, new terms, and terms to beemphasized
Read Chapter 6 in the User's Guide.
A cache is a copy that is storedlocally.
Do not save the file.
Note: Some emphasized itemsappear bold online.
Shell Prompts in Command ExamplesThe following table shows the default UNIX system prompt and superuser prompt for the Cshell, Bourne shell, and Korn shell.
TABLE P–2 Shell Prompts
Shell Prompt
C shell machine_name%
C shell for superuser machine_name#
Bourne shell and Korn shell $
Bourne shell and Korn shell for superuser #
Related DocumentationInformation about related Sun Cluster topics is available in the documentation that is listed inthe following table. All Sun Cluster documentation is available at http://docs.sun.com.
Preface
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A6
Topic Documentation
Data serviceadministration
Sun Cluster Data Services Planning and Administration Guide for Solaris OS
Individual data service guides
Concepts Sun Cluster Concepts Guide for Solaris OS
Overview Sun Cluster Overview for Solaris OS
Software installation Sun Cluster Software Installation Guide for Solaris OS
System administration Sun Cluster System Administration Guide for Solaris OS
Hardware administration Sun Cluster 3.1 - 3.2 Hardware Administration Manual for Solaris OS
Individual hardware administration guides
Data service development Sun Cluster Data Services Developer’s Guide for Solaris OS
Error messages Sun Cluster Error Messages Guide for Solaris OS
Command and functionreference
Sun Cluster Reference Manual for Solaris OS
For a complete list of Sun Cluster documentation, see the release notes for your release of SunCluster at http://docs.sun.com.
Related Third-Party Web Site ReferencesThird-party URLs that are referenced in this document provide additional related information.
Note – Sun is not responsible for the availability of third-party web sites mentioned in thisdocument. Sun does not endorse and is not responsible or liable for any content, advertising,products, or other materials that are available on or through such sites or resources. Sun will notbe responsible or liable for any actual or alleged damage or loss caused or alleged to be caused byor in connection with use of or reliance on any such content, goods, or services that are availableon or through such sites or resources.
Documentation, Support, and TrainingThe Sun web site provides information about the following additional resources:
■ Documentation (http://www.sun.com/documentation/)■ Support (http://www.sun.com/support/)■ Training (http://www.sun.com/training/)
Preface
7
Getting HelpIf you have problems installing or using Sun Cluster, contact your service provider and providethe following information:
■ Your name and email address (if available)■ Your company name, address, and phone number■ The model number and serial number of your systems■ The release number of the Solaris Operating System (for example, Solaris 10)■ The release number of Sun Cluster (for example, Sun Cluster 3.2)
Use the following commands to gather information about each node on your system for yourservice provider.
Command Function
prtconf -v Displays the size of the system memory and reportsinformation about peripheral devices
psrinfo -v Displays information about processors
showrev –p Reports which patches are installed
prtdiag -v Displays system diagnostic information
/usr/cluster/bin/clnode show-rev Displays Sun Cluster release and package versioninformation
Also have available the contents of the /var/adm/messages file.
Preface
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A8
Installing and Configuring Sun Cluster HA forSAP liveCache
This chapter contains explains how to install and configure Sun Cluster HA for SAP liveCache.
This chapter contains the following sections.■ “Sun Cluster HA for SAP liveCache Overview” on page 9■ “Installing and Configuring Sun Cluster HA for SAP liveCache” on page 11■ “Planning the Sun Cluster HA for SAP liveCache Installation and Configuration” on page 12■ “Preparing the Nodes and Disks” on page 14■ “Installing and Configuring liveCache” on page 15■ “Verifying the liveCache Installation and Configuration” on page 17■ “Installing the Sun Cluster HA for SAP liveCache Packages” on page 18■ “Registering and Configuring the Sun Cluster HA for SAP liveCache” on page 20■ “Verifying the Sun Cluster HA for SAP liveCache Installation and Configuration” on
page 24■ “Tuning Sun Cluster HA for SAP liveCache Fault Monitors” on page 26■ “Upgrading the SUNW.sap_xserver Resource Type” on page 29
Sun Cluster HA for SAP liveCache OverviewUse the information in this section to understand how Sun Cluster HA for SAP liveCachemakes liveCache highly available.
For conceptual information on scalable services, see the Sun Cluster Concepts Guide for SolarisOS.
To eliminate a single point of failure in an SAP Advanced Planner & Optimizer (APO) System,Sun Cluster HA for SAP liveCache provides fault monitoring and automatic failover forliveCache and fault monitoring and automatic restart for SAP xserver. The following table liststhe data services that best protect SAP Supply Chain Management (SCM) components in a SunCluster configuration. Figure 1 also illustrates the data services that best protect SAP SCMcomponents in a Sun Cluster configuration.
9
TABLE 1 Protection of liveCache Components
liveCache Component Protected by
SAP APO Central Instance Sun Cluster HA for SAP
The resource type is SUNW.sap_ci_v2.
For more information on this data service, see Sun Cluster DataService for SAP Guide for Solaris OS.
Sun Cluster HA for SAP Web Application Server
The resource type is SUNW.sap_webas.
For more information on this data service, see Sun Cluster DataService for SAP Web Application Server Guide for Solaris OS.
SAP APO database All highly available databases that are supported with SunCluster software and by SAP.
SAP APO Application Server Sun Cluster HA for SAP
The resource type is SUNW.sap_as_v2.
For more information on this data service, see Sun Cluster DataService for SAP Guide for Solaris OS.
Sun Cluster HA for SAP Web Application Server
The resource type is SUNW.sap_webas.
For more information on this data service, see Sun Cluster DataService for SAP Web Application Server Guide for Solaris OS.
SAP xserver Sun Cluster HA for SAP liveCache
The resource type is SUNW.sap_xserver.
SAP liveCache database Sun Cluster HA for SAP liveCache
The resource type is SUNW.sap_livecache.
NFS file system Sun Cluster HA for NFS
The resource type is SUNW.nfs.
For more information on this data service, see Sun Cluster DataService for NFS Guide for Solaris OS.
Sun Cluster HA for SAP liveCache Overview
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A10
Installing and Configuring Sun Cluster HA for SAP liveCacheTable 2 lists the tasks for installing and configuring Sun Cluster HA for SAP liveCache. Performthese tasks in the order that they are listed.
TABLE 2 Task Map: Installing and Configuring Sun Cluster HA for SAP liveCache
Task For Instructions, Go To
Plan the Sun Cluster HA for SAP liveCacheinstallation
Your SAP documentation
“Planning the Sun Cluster HA for SAP liveCache Installation andConfiguration” on page 12
Prepare the nodes and disks “How to Prepare the Nodes” on page 14
Install and configure liveCache “How to Install and Configure liveCache” on page 15
“How to Enable liveCache to Run in a Cluster” on page 16
Verify liveCache installation andconfiguration
“How to Verify the liveCache Installation and Configuration” onpage 18
Install Sun Cluster HA for SAP liveCachepackages
“Installing the Sun Cluster HA for SAP liveCache Packages” onpage 18
Register and configure Sun Cluster HA forSAP liveCache as a failover data service
“How to Register and Configure Sun Cluster HA for SAPliveCache” on page 21
liveCache
Sun ClusterHA for SAPliveCache
R/3
Sun ClusterHA for SAP
Sun Clusterdata service foryour RDBMS
RDBMS
FIGURE 1 Protection of liveCache Components
Installing and Configuring Sun Cluster HA for SAP liveCache
Installing and Configuring Sun Cluster HA for SAP liveCache 11
TABLE 2 Task Map: Installing and Configuring Sun Cluster HA for SAP liveCache (Continued)Task For Instructions, Go To
Verify Sun Cluster HA for SAP liveCacheinstallation and configuration
“Verifying the Sun Cluster HA for SAP liveCache Installationand Configuration” on page 24
Understand Sun Cluster HA for SAPliveCache Fault Monitors
“Tuning Sun Cluster HA for SAP liveCache Fault Monitors” onpage 26
(Optional) Upgrade theSUNW.sap_xserver resource type
“Upgrading the SUNW.sap_xserver Resource Type” on page 29
Planning the Sun Cluster HA for SAP liveCache Installationand Configuration
This section contains the information you need to plan your Sun Cluster HA for SAP liveCacheinstallation and configuration.
Note – If you have not already done so, read your SAP documentation before you begin planningyour Sun Cluster HA for SAP liveCache installation and configuration because your SAPdocumentation includes configuration restrictions and requirements that are not outlined inSun Cluster documentation or dictated by Sun Cluster software.
Note – Sun Cluster HA for SAP liveCache can be configured to run in a whole root or a sparseroot non-global zone, if required.
Configuration Requirements
Caution – Your data service configuration might not be supported if you do not adhere to theserequirements.
Use the requirements in this section to plan the installation and configuration of Sun ClusterHA for SAP liveCache. These requirements apply to Sun Cluster HA for SAP liveCache only.You must meet these requirements before you proceed with your Sun Cluster HA for SAPliveCache installation and configuration.
For requirements that apply to all data services, see Sun Cluster Data Services Planning andAdministration Guide for Solaris OS.■ Use SAP liveCache version 7.4 or a compatible version.
Planning the Sun Cluster HA for SAP liveCache Installation and Configuration
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A12
Standard Data Service ConfigurationsUse the standard configurations in this section to plan the installation and configuration of SunCluster HA for SAP liveCache. Sun Cluster HA for SAP liveCache supports the standardconfigurations in this section. Sun Cluster HA for SAP liveCache might support additionalconfigurations. However, you must contact your Sun service provider for information onadditional configurations.
Figure 2 illustrates a four-node cluster with SAP APO Central Instance, APO applicationservers, a database, and liveCache. APO Central Instance, the database, and liveCache areconfigured as failover data services. SAP xserver can be configured only as a scalable dataservice. APO application servers can be configured as scalable or failover data services.
Configuration ConsiderationsUse the information in this section to plan the installation and configuration of Sun Cluster HAfor SAP liveCache. The information in this section encourages you to think about the impactyour decisions have on the installation and configuration of Sun Cluster HA for SAP liveCache.
■ Install liveCache on its own global device group, separate from the global device group forthe APO Oracle database and SAP R/3 software. This separate global device group forliveCache ensures that the liveCache resource can depend on the HAStoragePlus resourcefor liveCache only.
■ If you want to run SAP xserver as any user other than user root, create that user on all nodeson which SAP xserver runs, and define this user in the Xserver_User extension property.SAP xserver starts and stops based on the user you identify in this extension property. Thedefault for this extension property is user root.
Configuration Planning QuestionsUse the questions in this section to plan the installation and configuration of Sun Cluster HAfor SAP liveCache. Insert the answers to these questions into the data service worksheets in“Configuration Worksheets” in Sun Cluster Data Services Planning and Administration Guidefor Solaris OS. See “Configuration Considerations” on page 13 for information that might applyto these questions.
APP
CI APP
DB
XServer XServer
liveCache
FIGURE 2 Four-Node Cluster
Planning the Sun Cluster HA for SAP liveCache Installation and Configuration
Installing and Configuring Sun Cluster HA for SAP liveCache 13
■ What resource groups will you use for network addresses and application resources and thedependencies between them?
■ What is the logical hostname (for liveCache resource) for clients that will access the dataservice?
■ Where will the system configuration files reside?See Sun Cluster Data Services Planning and Administration Guide for Solaris OS for theadvantages and disadvantages of placing the liveCache binaries on the local file system asopposed to the cluster file system.
Preparing the Nodes and DisksThis section contains the procedures you need to prepare the nodes and disks.
▼ How to Prepare the NodesUse this procedure to prepare for the installation and configuration of liveCache.
Become superuser on all of the nodes.
Configure the /etc/nsswitch.conf file.
a. On each node or zone that can master the liveCache resource, include one of the followingentries for group, project, an passwddatabase entries in the /etc/nsswitch.conf file.database:database: files
database: files [NOTFOUND=return] nis
database: files [NOTFOUND=return] nisplus
b. On each node or zone that can master the liveCache resource, ensure that files appearsfirst for the protocolsdatabase entry in the /etc/nsswitch.conf file.Example:protocols: files nis
Sun Cluster HA for SAP liveCache uses the su - user command and the dbmcli command tostart and stop liveCache.
The network information name service might become unavailable when a cluster node's publicnetwork fails. Implementing the preceding changes to the /etc/nsswitch.conf file ensuresthat the su(1M) command and the dbmcli command do not refer to the NIS/NIS+ nameservices.
1
2
Preparing the Nodes and Disks
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A14
If you are using liveCache version earlier than 7.6.03.09, comment out /net in/etc/auto_master file and remove nis from the automount entry in /etc/nsswitch.conf file.
Installing and Configuring liveCacheThis section contains the procedures that you need to install and configure liveCache.
▼ How to Install and Configure liveCacheUse this procedure to install and configure liveCache.
Install and configure SAP APO System.See Sun Cluster Data Service for SAP Guide for Solaris OS for the procedures on how to installand configure SAP APO System on Sun Cluster software.
Install liveCache.
Note – Install liveCache by using the physical hostname if you have not already created therequired logical host.
For more information, see your SAP documentation.
If you are using liveCache 7.5 or compatible versions, ensure that the liveCache administratoruser is in the sdbauser group.The format of the liveCache administrator user's user ID is lc-nameadm.
If you are creating the liveCache administrator user manually, add the following entry to the/etc/group file:sdba::group-id:lc-nameadm
group-id The group's unique numerical ID (GID) within the system
lc-name Lowercase name of liveCache database instance
For more information about the /etc/group file, see the group(4) man page.
Become liveCache administrator user, create the .XUSER.62file for the SAP APO administratoruser and the liveCache administrator user by using the following command.
Note – This user whose home directory contains the .XUSER.62 file is an internal database userwho has permissions to start, stop, and query the database.
$ dbmcli -uk username,passwd -d LC-NAME -n logical-hostname
3
1
2
3
4
Installing and Configuring liveCache
Installing and Configuring Sun Cluster HA for SAP liveCache 15
LC-NAME Uppercase name of liveCache database instance
logical-hostname Logical hostname that is used with the liveCache resource
Caution – Neither SAP APO transaction LC10 nor Sun Cluster HA for SAP liveCache functionsproperly if you do not create this file correctly.
Copy /usr/spool/sql from the node or zone, on which you installed liveCache, to all the nodesor zones that will run the liveCache resource. Ensure that the ownership of these files is the sameon all node or zone as it is on the node or zone on which you installed liveCache.Example:# tar cfB - /usr/spool/sql | rsh destination tar xfB -
destination Specifies the node or zone which you are copying the /usr/spool/sql directoryand its contents
Copy the /etc/opt/sdbdirectory and its contents from the node or zone on which you installedliveCache, to all the nodes or zones where resources for liveCache will run. Ensure that theownership of these files is the same on all nodes or zones as it is on the node or zone on whichyou installed liveCache.# tar cfB - /etc/opt/sdb | rsh destination tar xfB -
destination Specifies the node or zone which you are copying the /etc/opt/sdb directoryand its contents
Create a link from the /sapdb/LCA/db/wrk directory to the /sapdb/data/wrk directory asfollows:# ln -s /sapdb/data/wrk /sapdb/LCA/db/wrk
Ensure that all the required system files have been copied from the install node or zone to all thenodes or zones that will run the liveCache resource. The required files include /etc/group and/etc/passwd.
▼ How to Enable liveCache to Run in a ClusterDuring a standard SAP installation, liveCache is installed with a physical hostname. You mustmodify liveCache to use a logical hostname so that liveCache works in a Sun Clusterenvironment. Use this procedure to enable liveCache to run in a cluster.
Create the failover resource group to hold the network and liveCache resource.# clresourcegroup create [-n node-zone-list] livecache-resource-group
5
6
7
8
1
Installing and Configuring liveCache
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A16
Verify that you added all the network resources you use to your name service database.
Add a network resource (logical hostname) to the failover resource group.# clreslogicalhostname create -g livecache-resource-group \
-h lc-logical-hostname lc-logical-hostname
Note – If you require a fully qualified hostname, you must specify the fully qualified name withthe -h option and you cannot use the fully qualified form in the resource name.
Enable the failover resource group.# clresourcegroup online -M livecache-resource-group
Enable the network resource (logical hostname).# clresource enable lc-logical-hostname
Log on to the node or zone that hosts the liveCache resource group.
As the liveCache administrator user, start SAP xserver manually on the node or zone that hoststhe liveCache resource group.# su - lc-nameadm$ x_server start
lc-name Lowercase name of liveCache database instance
Log on to SAP APO System by using your SAP GUI with user DDIC.
Go to transaction LC10 and change the liveCache host to the logical hostname you defined inStep 3.liveCache host: lc-logical-hostname
Verifying the liveCache Installation and ConfigurationThis section contains the procedure that you need to verify the liveCache installation andconfiguration.
2
3
4
5
6
7
8
9
Verifying the liveCache Installation and Configuration
Installing and Configuring Sun Cluster HA for SAP liveCache 17
▼ How to Verify the liveCache Installation andConfigurationUse this procedure to verify the liveCache installation and configuration. This procedure doesnot verify that your application is highly available because you have not installed your dataservice yet.
Log on to SAP APO System by using your SAP GUI with user DDIC.
Go to transaction LC10.
Ensure that you can check the state of liveCache.
Ensure that the following dbmcli commands work as user lc-nameadm.$ dbmcli -d LC-NAME -n logical-hostname db_state
$ dbmcli -d LC-NAME -n logical-hostname db_enum
Confirm that the liveCache administrator user can run the lcinit restart command.
a. Become the liveCache administrator user.# su - lc-nameadm
lc-name Lowercase name of liveCache database instance
b. Run the lcinit restart command$ lcinit lc-name restart
Installing the Sun Cluster HA for SAP liveCache PackagesIf you did not install the Sun Cluster HA for SAP liveCache packages during your initial SunCluster installation, perform this procedure to install the packages. To install the packages, usethe Sun JavaTM Enterprise System Installation Wizard;.
▼ How to Install the Sun Cluster HA for SAP liveCachePackagesPerform this procedure on each cluster node where you are installing the Sun Cluster HA forSAP liveCache packages.
1
2
3
4
5
Installing the Sun Cluster HA for SAP liveCache Packages
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A18
You can run the Sun Java Enterprise System Installation Wizard; with a command-lineinterface (CLI) or with a graphical user interface (GUI). The content and sequence ofinstructions in the CLI and the GUI are similar.
Note – Even if you plan to configure this data service to run in non-global zones, install thepackages for this data service in the global zone. The packages are propagated to any existingnon-global zones and to any non-global zones that are created after you install the packages.
Ensure that you have the Sun Java Availability Suite DVD-ROM.
If you intend to run the Sun Java Enterprise System Installation Wizard; with a GUI, ensure thatyour DISPLAY environment variable is set.
On the cluster node where you are installing the data service packages, become superuser.
Load the Sun Java Availability Suite DVD-ROM into the DVD-ROM drive.If the Volume Management daemon vold(1M) is running and configured to manageDVD-ROM devices, the daemon automatically mounts the DVD-ROM on the /cdromdirectory.
Change to the Sun Java Enterprise System Installation Wizard; directory of the DVD-ROM.
■ If you are installing the data service packages on the SPARC® platform, type the followingcommand:# cd /cdrom/cdrom0/Solaris_sparc
Start the Sun Java Enterprise System Installation Wizard;.# ./installer
When you are prompted, accept the license agreement.If any Sun Java Enterprise System components are installed, you are prompted to select whetherto upgrade the components or install new software.
From the list of Sun Cluster agents in Availability Services, select the data service for SAPliveCache.
If you require support for languages other than English, select the option to install multilingualpackages.English language support is always installed.
Before You Begin
1
2
3
4
5
6
7
Installing the Sun Cluster HA for SAP liveCache Packages
Installing and Configuring Sun Cluster HA for SAP liveCache 19
When prompted whether to configure the data service now or later, choose Configure Later.Choose Configure Later to perform the configuration after the installation.
Follow the instructions on the screen to install the data service packages on the node.The Sun Java Enterprise System Installation Wizard; displays the status of the installation.When the installation is complete, the wizard displays an installation summary and theinstallation logs.
(GUI only) If you do not want to register the product and receive product updates, deselect theProduct Registration option.The Product Registration option is not available with the CLI. If you are running the Sun JavaEnterprise System Installation Wizard; with the CLI, omit this step.
Exit the Sun Java Enterprise System Installation Wizard;.
Unload the Sun Java Availability Suite DVD-ROM from the DVD-ROM drive.
a. To ensure that the DVD-ROM is not being used, change to a directory that does not reside onthe DVD-ROM.
b. Eject the DVD-ROM.# eject cdrom
See“Setting Sun Cluster HA for SAP liveCache Extension Properties” on page 20 to registerSun Cluster HA for SAP liveCache and to configure the cluster for the data service.
Registering and Configuring the Sun Cluster HA for SAPliveCache
This section contains the procedures that you need to configure Sun Cluster HA for SAPliveCache.
Setting Sun Cluster HA for SAP liveCache ExtensionPropertiesUse the extension properties in Appendix A, “Sun Cluster HA for SAP liveCache ExtensionProperties” to create your resources. Use the following command line to configure extensionproperties when you create your resource.
8
9
10
11
12
Next Steps
Registering and Configuring the Sun Cluster HA for SAP liveCache
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A20
clresource create -g resource-group -t resource-type -p property=value resource
Use the procedure in “Changing Resource Type, Resource Group, and Resource Properties” inSun Cluster Data Services Planning and Administration Guide for Solaris OS to configure theextension properties if you have already created your resources. You can update some extensionproperties dynamically. You can update others, however, only when you create or disable aresource. The Tunable fields in Appendix A, “Sun Cluster HA for SAP liveCache ExtensionProperties” indicate when you can update each property. See Appendix B, “StandardProperties,” in Sun Cluster Data Services Planning and Administration Guide for Solaris OS fordetails on all Sun Cluster properties.
▼ How to Register and Configure Sun Cluster HA for SAPliveCacheUse this procedure to configure Sun Cluster HA for SAP liveCache as a failover data service forthe liveCache database and SAP xserver as a scalable data service. This procedure assumes thatyou installed the data service packages. If you did not install the Sun Cluster HA for SAPliveCache packages as part of your initial Sun Cluster installation, go to “Installing the SunCluster HA for SAP liveCache Packages” on page 18 to install the data service packages.Otherwise, use this procedure to configure the Sun Cluster HA for SAP liveCache.
Caution – Do not configure more than one SAP xserver resource on the same cluster because oneSAP xserver serves multiple liveCache instances in the cluster. More than one SAP xserverresource that runs on the same cluster causes conflicts between the SAP xserver resources.These conflicts cause all SAP xserver resources to become unavailable. If you attempt to startthe SAP xserver twice, you receive an error message that says Address already in use.
Become superuser on one of the nodes or zones in the cluster that will host the liveCacheresource.
Copy the lcclusterfile to the same location as the lcinitfile.# cp /opt/SUNWsclc/livecache/bin/lccluster \
/sapdb/LC-NAME/db/sap
LC-NAME Uppercase name of liveCache database instance
Edit the lcclusterfile to substitute values for put-LC_NAME-here andput-Confdir_list-here.
Note – The put-Confidir_list-here value exists only in the Sun Cluster 3.1 and 3.2 versions.
1
2
3
Registering and Configuring the Sun Cluster HA for SAP liveCache
Installing and Configuring Sun Cluster HA for SAP liveCache 21
a. Open the lcclusterfile.# vi /sapdb/LC-NAME/db/sap/lccluster
Note – The CONFDIR_LIST=”put-Confdir_list-here entry exists only in the Sun Cluster 3.1and 3.2 versions.
b. Replace put-LC_NAME-herewith the liveCache instance name. The liveCache instance nameis the value you defined in the Livecache_Name extension property.For an example, see Step c.LC_NAME="liveCache-instance-name"
c. Replace put-Confdir_list-herewith the value of the Confidir_list extension property.
Note – This step is only for the Sun Cluster 3.1 and 3.2 versions. Skip this step if you arerunning an earlier version of Sun Cluster.
CONFDIR_LIST="liveCache-software-directory"
Example:
If the liveCache instance name is LC1 and the liveCache software directory is /sapdb, editthe lccluster script as follows.
LC_NAME="LC1"CONFDIR_LIST="/sapdb" [Sun Cluster 3.1 and 3.2 versions only]
Add the HAStoragePlus resource to the liveCache resource group.# clresourcetype register SUNW.HAStoragePlus
# clresource create -g livecache-resource-group \
-t SUNW.HAStoragePlus -p filesystemmountpoints=mountpoint,... \
-p globaldevicepaths=livecache-device-group \
-p affinityon=TRUE livecache-storage-resource
The resource is created in the enabled state.
Note – AffinityOn must be set to TRUE and the local file system must reside on global diskgroups to be failover.
For the procedure on how to set up an HAStoragePlus resource, see Sun Cluster Data ServicesPlanning and Administration Guide for Solaris OS.
4
Registering and Configuring the Sun Cluster HA for SAP liveCache
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A22
Register the resource type for liveCache database.# clresourcetype register SUNW.sap_Livecache
Register the resource type for SAP xserver.# clresourcetype register SUNW.sap_xserver
Create a scalable resource group for SAP xserver. Configure SAP xserver to run on all thepotential nodes or zones that liveCache will run on.
Note – Configure SAP xserver so that SAP xserver starts on all nodes or zones that the liveCacheresources can fail over to. To implement this configuration, ensure that the node-zone-listparameter of the SAP xserver resource group contains all the nodes or zones listed in theliveCache resource groups' node-zone-list. Also, the value of desired_primaries andmaximum_primaries of the SAP xserver resource group must be equal to each other.
# clresourcegroup create -S -n node-zone-list \
-p Maximum_primaries=value \
-p Desired_primaries=value xserver-resource-group
Add the HAStoragePlus resource to the SAP xserver resource group.# clresource create \
-g xserver-resource-group \
-t SUNW.HAStoragePlus \
-p filesystemmountpoints=mountpoints \
-p affinityon=false xserver-storage-resource
The resource is created in the enabled state.
For more information about setting up an HAStoragePlus resource, see “Enabling HighlyAvailable Local File Systems” in Sun Cluster Data Services Planning and Administration Guidefor Solaris OS.
Create an SAP xserver resource in this scalable resource group.# clresource create \
-g xserver-resource-group -t SUNW.sap_xserver \
-p resource_dependencies=xserver-storage-resource xserver-resource
The resource is created in the enabled state.
See “Setting Sun Cluster HA for SAP liveCache Extension Properties” on page 20 for a list ofextension properties.
5
6
7
8
9
Registering and Configuring the Sun Cluster HA for SAP liveCache
Installing and Configuring Sun Cluster HA for SAP liveCache 23
Create the liveCache resource.# clresource create -g livecache-resource-group \
-t SUNW.sap_livecache -p livecache_name=LC-NAME \
-p resource_dependencies=livecache-storage-resource,xserver-resource livecache-resource
The resource is created in the enabled state.
Ensure that the liveCache resource group is brought online only on the node or zone where theSAP xserver resource group is online.To meet this requirement, create on the liveCache resource group a strong positive affinity forthe SAP xserver resource group.# clresourcegroup set \
-p rg_affinities=++xserver-resource-group livecache-resource-group
Enable the liveCache failover resource group.# clresourcegroup online -M livecache-resource-group
(Optional) Consider configuring your cluster to prevent the APO application server resourcegroup from being brought online on the same node or zone as the liveCache resource group.You might plan to run the APO application server on a node or zone to which the liveCacheresource can fail over. In this situation, consider using resource group affinities to shut downthe APO application server when the liveCache resource fails over to the node or zone.
To specify this behavior, create on the APO application server resource group a strong negativeaffinity for the liveCache resource group.# clresourcegroup set \
-p rg_affinities=--liveCache-resource-group apo-resource-group
Verifying the Sun Cluster HA for SAP liveCache Installationand Configuration
This section contains the procedure you need to verify that you installed and configured yourdata service correctly.
▼ How to Verify the Sun Cluster HA for SAP liveCacheInstallation and ConfigurationUse this procedure to verify that you installed and configured Sun Cluster HA for SAPliveCache correctly. You need the information in the following table to understand the variousstates of the liveCache database.
10
11
12
13
Verifying the Sun Cluster HA for SAP liveCache Installation and Configuration
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A24
State Description
OFFLINE liveCache is not running.
COLD liveCache is available for administrator tasks.
WARM liveCache is online.
STOPPED INCORRECTLY liveCache stopped incorrectly. This is also one of the interim states whileliveCache starts or stops.
ERROR Cannot determine the current state. This is also one of the interim stateswhile liveCache starts or stops.
UNKNOWN This is one of the interim states while liveCache starts or stops.
Log on to the node or zone that hosts the resource group that contains the liveCache resource,and verify that the fault monitor functionality works correctly.
a. Terminate liveCache abnormally by stopping all liveCache processes.Sun Cluster software restarts liveCache.
If you do not see this behavior, you might not have correctly performed Step 2 and Step 3 in“How to Register and Configure Sun Cluster HA for SAP liveCache” on page 21.# ps -ef|grep sap|grep kernel
# kill -9 livecache-processes
b. Terminate liveCache by using the Stop liveCache button in LC10 or by running the lcinitcommand.Sun Cluster software does not restart liveCache. However, the liveCache resource statusmessage reflects that liveCache stopped outside of Sun Cluster software through the use ofthe Stop liveCache button in LC10 or the lcinit command. The state of the liveCacheresource is UNKNOWN. When the user successfully restarts liveCache by using the StartliveCache button in LC10 or the lcinit command, the Sun Cluster HA for SAP liveCacheFault Monitor updates the resource state and status message to indicate that liveCache isrunning under the control of Sun Cluster software.
If you do not see this behavior, you might not have correctly performed Step 2 and Step 3 in“How to Register and Configure Sun Cluster HA for SAP liveCache” on page 21.
Log on to SAP APO by using your SAP GUI with user DDIC, and verify that liveCache startscorrectly by using transaction LC10.
As user root, switch the liveCache resource group to another node or zone.# clresourcegroup switch -n node2 livecache-resource-group
Repeat Step 1 through Step 3 for each potential node or zone on which the liveCache resourcecan run.
1
2
3
4
Verifying the Sun Cluster HA for SAP liveCache Installation and Configuration
Installing and Configuring Sun Cluster HA for SAP liveCache 25
Log on to the nodes or zones that host the SAP xserver resource, and verify that the faultmonitor functionality works correctly.
Terminate SAP xserver abnormally by stopping all SAP xserver processes.# ps -ef|grep xserver
# kill -9 xserver-process
Verify that the SAP xserver agent restarts the SAP xserver.
Tuning Sun Cluster HA for SAP liveCache Fault MonitorsFault monitoring for the Sun Cluster HA for SAP liveCache data service is provided by thefollowing fault monitors:
■ The SAP liveCache fault monitor■ The SAP xserver fault monitor
Each fault monitor is contained in a resource whose resource type is shown in the followingtable.
TABLE 3 Resource Types for Sun Cluster HA for SAP liveCache Fault Monitors
Fault Monitor Resource Type
SAP liveCache SUNW.sap_livecache
SAP xserver SUNW.sap_xserver
System properties and extension properties of these resources control the behavior of the faultmonitors. The default values of these properties determine the preset behavior of the faultmonitors. The preset behavior should be suitable for most Sun Cluster installations. Therefore,you should tune the Sun Cluster HA for SAP liveCache fault monitors only if you need tomodify this preset behavior.
Tuning the Sun Cluster HA for SAP liveCache fault monitors involves the following tasks:
■ Setting the interval between fault monitor probes■ Setting the timeout for fault monitor probes■ Defining the criteria for persistent faults■ Specifying the failover behavior of a resource
For more information, see “Tuning Fault Monitors for Sun Cluster Data Services” in SunCluster Data Services Planning and Administration Guide for Solaris OS. Information about theSun Cluster HA for SAP liveCache fault monitors that you need to perform these tasks isprovided in the subsections that follow.
5
Tuning Sun Cluster HA for SAP liveCache Fault Monitors
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A26
Tune the Sun Cluster HA for SAP liveCache fault monitors when you register and configureSun Cluster HA for SAP liveCache. For more information, see “Registering and Configuring theSun Cluster HA for SAP liveCache” on page 20.
Factors That Affect the Interval Between Fault MonitorProbesTo determine whether SAP xserver and SAP liveCache are operating correctly, the Sun ClusterHA for SAP liveCache fault monitors probe these resources periodically. The optimum intervalbetween fault monitor probes depends on the time that is required to respond to a fault in aresource. This time depends on how the complexity of the resource affects the time that isrequired for operations such as restarting the resource.
Operations by the Sun Cluster HA for SAP liveCacheFault Monitors During a ProbeThe optimum timeout for fault monitor probes depends on the operations that a fault monitorperforms to probe the resource.
Operations by the SAP liveCache Fault Monitor During a ProbeDuring a probe, the SAP liveCache fault monitor performs the following operations:
1. The SAP liveCache fault monitor determines whether SAP liveCache is online.
2. If liveCache is online, the SAP liveCache fault monitor determines whether the liveCacheparent process is running.
3. If liveCache is not online, the SAP liveCache fault monitor determines whether a userstopped liveCache outside the control of Sun Cluster.
A user can stop liveCache by using the Stop liveCache button in LC10 or the lcinitcommand.
4. If a user did not stop liveCache outside the control of Sun Cluster, the SAP liveCache faultmonitor determines whether SAP xserver is available.
Operations by the SAP xserver Fault Monitor During a ProbeDuring a probe, the SAP xserver fault monitor determines whether SAP xserver is available.
Tuning Sun Cluster HA for SAP liveCache Fault Monitors
Installing and Configuring Sun Cluster HA for SAP liveCache 27
Faults Detected by the Sun Cluster HA for SAPliveCache Fault MonitorsFaults that each Sun Cluster HA for SAP liveCache fault monitor detects are described in thesubsections that follow.
Faults Detected by the SAP liveCache Fault MonitorThe SAP liveCache fault monitor detects the following faults in SAP liveCache:
■ Unexpected termination of liveCache
Note – The liveCache fault monitor also detects the expected termination of liveCache,which is not a fault. For more information, see “Monitoring the Termination of liveCacheby a User” on page 29.
■ Unexpected termination of the liveCache parent process■ System failures
SAP liveCache can be stopped or restarted only if SAP xserver is available. Therefore, the SAPliveCache fault monitor also detects the unavailability of SAP xserver. This fault monitoringsupplements the fault monitoring that the SAP xserver fault monitor provides. This additionalfault monitoring enforces the cross-resource group resource dependency between SAP xserverand SAP liveCache.
Faults Detected by the SAP xserver Fault MonitorThe SAP xserver fault monitor detects following faults:
■ Unavailability of SAP xserver. Unavailability of SAP xserver is also detected by the SAPliveCache fault monitor.
■ System errors. The SAP xserver fault monitor treats a system error as a partial failure.■ Persistent system errors. A persistent system error is a system error that occurs four times
within the retry interval. If a persistent system error occurs, the fault monitor restarts SAPxserver.
Recovery Actions in Response to Detected FaultsTo minimize the disruption that transient faults in a resource cause, a fault monitor restarts theresource in response to such faults. For persistent faults, more disruptive action than restartingthe resource is required:
■ For the SAP liveCache resource, the fault monitor fails over the resource to another node orzone. The SAP liveCache resource is a failover resource.
Tuning Sun Cluster HA for SAP liveCache Fault Monitors
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A28
■ For the SAP xserver resource, the fault monitor takes the resource offline. The SAP xserver isa scalable resource.
Monitoring the Termination of liveCache by a UserThe SAP liveCache fault monitor detects when a user stops liveCache outside the control of SunCluster. A user can stop liveCache by using the Stop liveCache button in LC10 or the lcinitcommand.
In this situation, the liveCache fault monitor updates the status of the liveCache resource toindicate that liveCache is stopped. However, the liveCache fault monitor performs no recoveryaction.
If a user restarts liveCache, the liveCache fault monitor updates the status of the liveCacheresource to indicate that liveCache is running again.
Upgrading the SUNW.sap_xserverResource TypeUpgrade the SUNW.sap_xserver resource type if all conditions in the following list apply:
■ You are upgrading from an earlier version of the Sun Cluster HA for SAP liveCache dataservice.
■ You need to use the new features of the SUNW.sap_xserver resource type.
For general instructions that explain how to upgrade a resource type, see “Upgrading aResource Type” in Sun Cluster Data Services Planning and Administration Guide for Solaris OS.The information that you need to complete the upgrade of the SUNW.sap_xserver resource typeis provided in the subsections that follow.
Information for Registering the New Resource TypeVersionThe relationship between a resource type version and the release of Sun Cluster data services isshown in the following table. The release of Sun Cluster data services indicates the release inwhich the version of the resource type was introduced.
Resource Type Version Sun ClusterData Services Release
1.0 3.0 5/02 asynchronous release
Upgrading the SUNW.sap_xserver Resource Type
Installing and Configuring Sun Cluster HA for SAP liveCache 29
Resource Type Version Sun ClusterData Services Release
2 3.1 4/04
3.2 3.2
To determine the version of the resource type that is registered, use one command from thefollowing list:
■ clresourcetype show
■ clresourcetype show -v
The resource type registration (RTR) file for this resource type is/opt/SUNWsclc/xserver/etc/SUNW.sap_xserver.
Information for Migrating Existing Instances of theResource TypeThe information that you need to migrate instances of the SUNW.sap_xserver resource type isas follows:
■ You can perform the migration only when the resource is unmonitored.■ If you need to use the new features of the SUNW.sap_xserver resource type, the required
value of the Type_version property is 2.■ If you need to specify the directory that contains programs and libraries for the SAP xserver
runtime environment, set the Independent_Program_Path extension property. For moreinformation, see “Setting Sun Cluster HA for SAP liveCache Extension Properties” onpage 20.
The following example shows a command for editing an instance of the SUNW.sap_xserverresource type.
EXAMPLE 1 Editing an Instance of the SUNW.sap_xserver Resource Type During Upgrade
# clresources set -p Independent_Program_Path=/sapdb/indep_prog \
-p Type_version=2 sapxserver-rs
This command edits a SUNW.sap_xserver resource as follows:
■ The SUNW.sap_xserver resource is named sapxserver-rs.■ The Type_version property of this resource is set to 2.■ The independent program path is /sapdb/indep_prog.
Upgrading the SUNW.sap_xserver Resource Type
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A30
Sun Cluster HA for SAP liveCache ExtensionProperties
Extension properties for Sun Cluster HA for SAP liveCache resource types are described in thefollowing sections.
■ “SUNW.sap_livecache Extension Properties” on page 31■ “SUNW.sap_xserver Extension Properties” on page 32
For details about system-defined properties, see the r_properties(5) man page and therg_properties(5) man page.
SUNW.sap_livecache Extension PropertiesThe SUNW.sap_livecache resource type represents the SAP liveCache application in a SunCluster configuration. The extension properties of this resource type are as follows:
Confdir_list (optional)The directory for liveCache software and the instance directory.
Data type String
Default /sapdb
Range Not applicable
Tunable At creation
Livecache_name (required)Name of liveCache database instance.
Data type String
Default None
Range Not applicable
Tunable At creation
AA P P E N D I X A
31
Monitor_retry_count
Number of PMF restarts that are allowed for the fault monitor.
Data type Integer
Default 4
Range No range defined
Tunable Any time
Monitor_retry_interval
Time interval in minutes for fault monitor restarts.
Data type Integer
Default 2
Range No range defined
Tunable Any time
Probe_timeout
Timeout value in seconds for the probes.
Data type Integer
Default 90
Range No range defined
Tunable Any time
SUNW.sap_xserver Extension PropertiesThe SUNW.sap_xserver resource type represents SAP xserver in a Sun Cluster configuration.The extension properties of this resource type are as follows:
Confdir_List
The full path to the directory that contains the SAP liveCache software and SAP liveCachedatabase instance.
Data type String
Default /sapdb
Range Not applicable
Tunable At creation
SUNW.sap_xserver Extension Properties
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A32
Independent_Program_Path
The full path to the directory that contains the following programs and libraries for SAPxserver:■ Programs that are independent of the database software version■ Libraries for the client runtime environment
Sun Cluster HA for SAP liveCache determines the path to the x_server command from thevalue of this property. The x_server command resides in the bin subdirectory of thedirectory that this property specifies.
Data type String
Default No default defined
Range Not applicable
Tunable When disabled
Introduced in release 3.1 4/04
Monitor_retry_count
The maximum number of restarts by the PMF that are allowed for the fault monitor.
Data type Integer
Default 4
Range No range defined
Tunable Any time
Monitor_retry_interval
The period of time in minutes during which the PMF counts restarts of the fault monitor.
Data type Integer
Default 2
Range No range defined
Tunable Any time
Probe_timeout
The timeout value in seconds for fault monitor probes.
Data type Integer
Default 120
Range No range defined
Tunable Any time
SUNW.sap_xserver Extension Properties
Appendix A • Sun Cluster HA for SAP liveCache Extension Properties 33
Soft_Stop_Pct
The percentage of the Stop method timeout that is used to stop SAP xserver by using theSAP utility x_server stop. If this timeout is exceeded, the SIGKILL signal is used to stop allSAP xserver processes.
Data type Integer
Default 50
Range 1–100
Tunable When disabled
Xserver_User
The UNIX user identity of the OS user who administers SAP xserver.
Data type String
Default root
Range Not applicable
Tunable At creation
SUNW.sap_xserver Extension Properties
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A34
Index
Cclnode command, 8commands, node information, 8Confdir_List extension property
SUNW.sap_livecache resource type, 31SUNW.sap_xserver resource type, 32
configuring, Sun Cluster HA for SAP liveCache, 21-24
Eediting, resource type instances, 30error messages, cluster, 8extension properties
SUNW.sap_livecache resource type, 31-32SUNW.sap_xserver resource type, 32-34
Ffault monitors
faults detected by, 28-29probe interval, 27probe timeout, 27response to faults, 28-29SAP liveCache
faults detected, 28resource type for, 26
SAP xserverfaults detected, 28resource type for, 26
tuning, 26-29
faultsrecovery actions, 28responses to, 28-29
files, RTR, 30
Gglobal zone, 19
Hhelp, 8
IIndependent_Program_Path extension property,
SUNW.sap_xserver resource type, 32installing
SAP liveCache, 15-16Sun Cluster HA for SAP liveCache, 18-20
intervals, fault monitor probes, 27
Llibraries
SAP liveCacheSUNW.sap_xserver resource type, 32
SAP xserver, 33
35
liveCacheSee SAP liveCache applicationSee Sun Cluster HA for SAP liveCache
Livecache_Name extension property, 31local zones, See non-global zones
Mmaximum values
restartsSUNW.sap_livecache resource type, 32SUNW.sap_xserver resource type, 33
messages file, 8migrating, resource type instances, 30Monitor_retry_count extension property
SUNW.sap_livecache resource type, 31SUNW.sap_xserver resource type, 33
Monitor_retry_interval extension propertySUNW.sap_livecache resource type, 32SUNW.sap_xserver resource type, 33
Nnon-global zones, 19
Ooperating system users
of SAP xserverextension property for, 34
Ppackages, 18-20paths
SAP liveCache programs and librariesSUNW.sap_xserver resource type, 32
SAP xserver programs and libraries, 33x_server command, 33
persistent faults, recovery actions, 28
Probe_timeout extension propertySUNW.sap_livecache resource type, 32SUNW.sap_xserver resource type, 33
programsSAP liveCache
SUNW.sap_xserver resource type, 32SAP xserver, 33
propertiesSee also extension propertiesType_version, 30
prtconf -v command, 8prtdiag -v command, 8psrinfo -v command, 8
Rrecovery actions, after faults, 28registering
Sun Cluster HA for SAP liveCache, 21-24SUNW.sap_xserver resource type
during initial set up, 23during upgrade, 29-30
resource type registration (RTR) file, 30resource types
fault monitors, 26migrating instances of, 30SUNW.sap_livecache
extension properties, 31-32SUNW.sap_xserver
extension properties, 32-34responses, to faults, 28-29restarts
interval betweenSUNW.sap_livecache resource type, 32SUNW.sap_xserver resource type, 33
maximum allowedSUNW.sap_livecache resource type, 32SUNW.sap_xserver resource type, 33
restrictions, zones, 19RTR (resource type registration) file, 30
Index
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A36
SSAP liveCache application
enabling to run in cluster, 16-17fault monitor, 26installing, 15-16paths to programs and libraries
SUNW.sap_xserver resource type, 32preparing the nodes, 14-15verifying installation and configuration, 18
SAP xserverfault monitor, 26operating system user, 34paths to programs and libraries, 33stopping
time allowed for, 34upgrading, 29-30
show-rev subcommand, 8showrev –p command, 8SIGKILL signal, 34Soft_Stop_Pct extension property, 33software packages, 18-20stopping
SAP xservertime allowed for, 34
Sun Cluster HA for SAP liveCacheSee also SAP liveCache applicationconfiguration
considerations, 13planning, 12-14requirements, 12
extension propertiessetting, 20-21
fault monitors, 26-29installing, 18-20
planning, 12-14overview, 9-10protection of SAP liveCache components, 10registering and configuring, 21-24software packages
installing, 18-20standard configurations, 13verifying installation, 24-26
SUNW.sap_livecache resource type, extensionproperties, 31-32
SUNW.sap_xserver resource typeextension properties, 32-34resource type versions, 29
system properties, effect on fault monitors, 26
Ttechnical support, 8timeouts
fault monitorguidelines for setting, 27SUNW.sap_livecache resource type, 32SUNW.sap_xserver resource type, 33
stop method, 34transient faults, recovery actions, 28tuning, fault monitors, 26-29Type_version property, 30
Uupgrading, SAP xserver, 29-30users, of SAP xserver, 34
V/var/adm/messages file, 8verifying
SAP liveCache installation and configuration, 18Sun Cluster HA for SAP liveCache, 24-26
versions, resource types, 29
Xx_server command, path to, 33Xserver_User extension property, SUNW.sap_xserver
resource type, 34
Index
37
Zzones, 19
Index
Sun Cluster Data Service for SAP liveCache Guide for Solaris OS • February 2008, Revision A38