Oracle^® Solaris Cluster Data Service for SAP MaxDB Guide

How to Register and Configure an SAP xserver Resource

1. Assume the root role on a cluster node.
2. Register the SUNW.sap_xserver resource type.

   # clresourcetype register SUNW.sap_xserver

3. Create a scalable resource group for the SAP xserver resource.

   Configure SAP xserver so that SAP xserver starts on all nodes to which the SAP MaxDB resource can fail over. To implement this configuration, ensure that the node list of the SAP xserver resource group contains all nodes that are in the node list of the SAP MaxDB resource group. This resource group is created when the procedure How to Enable SAP MaxDB to Run in a Cluster is performed.

   # clresourcegroup create \
   -p Maximum_primaries=nodes-in-sapdb-rg \
   -p Desired_primaries=nodes-in-sapdb-rg xserver-rg

   -p Maximum_primaries=nodes-in-sapdb-rg

   Specifies the maximum number of nodes on which the SAP xserver resource can start. This number is equal to the number of nodes that are in the node list of the SAP MaxDB resource group. You must specify the same number as the value of the Desired_primaries property.

   -p Desired_primaries=nodes-in-sapdb-rg

   Specifies the desired number of nodes on which the SAP xserver resource can start. This number is equal to the number of nodes that are in the node list of the SAP MaxDB resource group. You must specify the same number as the value of the Maximum_primaries property.

   xserver-rg

   Specifies that the resource group that you are creating is named xserver-rg.

4. Add the HAStoragePlus resource to the SAP xserver resource group.

   # clresource create -g xserver-rg \
   -t SUNW.HAStoragePlus \
   -p FileSystemMountPoints=mountpoints \
   -p AffinityOn=false xserver-storage-resource

   -g xserver-rg

   Specifies that the resource that you are creating is added to the resource group xserver-rg.

   -t SUNW.HAStoragePlus

   Specifies that the resource type of the resource you are creating is SUNW.HAStoragePlus.

   -p FileSystemMountPoints=mountpoint,...

   Specifies the mount points for the resource group you are creating.

   -p AffinityOn=false

   Indicates that the SAP xserver resource does not have to be colocated with the device group.

   xserver-storage-resource

   Specifies that the resource that you are creating is named xserver-storage-resource.

   For more details on how to set up an HAStoragePlus resource, see Enabling Highly Available Local File Systems in Oracle Solaris Cluster 4.3 Data Services Planning and Administration Guide .

5. Create an SAP xserver resource in the resource group that you created in Step 3.

   # clresource create -d -g xserver-rg \
   -t SUNW.sap_xserver \
   -p Resource_dependencies_offline_restart=storage-resource \
   -p Resource_dependencies=rest-of-the-tree

   -g xserver-rg

   Specifies that the resource is to be added to the resource group that you created in Step 3

   -t SUNW.sap_xserver

   Specifies that the resource is an instance of the SUNW.sap_xserver resource type

   -p Resource_dependencies_offline_restart=storage-resource

   Sets a resource dependency between storage-resource and the HAStoragePlus resource we created in Step 4.

   storage-resource

   Specifies that the resource that you are creating is named storage-resource.

6. Enable the resource group that you created in Step 3.

   # clresourcegroup online -eM xserver-rg

   -eM

   Enables the resource group and moves it to the MANAGED state.

   xserver-rg

   Specifies the name of the resource group.

This example shows the sequence of commands that are required to configure an SAP xserver resource. The commands are run on only one cluster node.

1. The following command creates a multiple-master resource group to contain an SAP xserver resource for a four-node cluster. The resource group is named xsrvrrg. The xsrvrrg resource group can be brought online on all cluster nodes.

   # clresourcegroup create \
   -p Maximum_primaries=4 \
   -p Desired_primaries=4 xsrvrrg

2. The following command adds the HAStoragePlus resource to the SAP xserver resource group. The xserver-storage-resource is called xsstorrs and the mount point, mtp1.

   # clresource create -d -g xsrvrrg \
   -t SUNW.HAStoragePlus \
   -p filesystemmountpoints=mtp1 \
   -p affinityon=false xsstorrs

3. The following command creates an SAP xserver resource that is named xsrvrrs in the xsrvrrg resource group. The SAP xserver resource is an instance of the SUNW.sap_xserver resource type. The registration of this resource type is not shown in this example.

   # clresource create -d -g xsrvrrg -t SUNW.sap_xserver \
   -p resource_dependencies_offline_restart=storage-resource \
   -p resource_dependencies=rest-of-the-tree

4. The following command moves the xsrvrrg resource group to the MANAGED state and brings the resource group online.

   # clresourcegroup online -eM xsrvrrg