Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Data Service for SAP NetWeaver Guide Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

## Registering and Configuring HA for SAP NetWeaver

To enable the HA for SAP NetWeaver data service to make SAP NetWeaver applications highly available, configure the data service as described in the procedures in this section. These procedures perform the following tasks.

- Register and configure the SAP central services resources. The SAP central services consist of the following components:

  - SAP `sapstartsrv`

  - SAP central services

  - SAP replicated enqueue server

  - SAP replicated enqueue preempter

  - SAP dialogue instance

- Register and configure resources for the SAP NetWeaver primary application instance.

- Register and configure the SAP NetWeaver additional dialogue instance.

The resource groups and the storage resource were created in How to Enable the SAP NetWeaver to Run in a Cluster.

### Before You Begin

Before performing these procedures, ensure that the HA for SAP NetWeaver data service packages are installed.

The procedures in this section assume that the database resources have been previously created and that these resources are online.

Make your database highly available by following the instructions in the documentation for your database.

Perform these procedures assuming the `root` role on a cluster node.

### Setting HA for SAP NetWeaver Extension Properties

The extension properties for HA for SAP NetWeaver are described in Appendix A, HA for SAP NetWeaver Extension Properties.

You can update some extension properties dynamically. You can update other properties, however, only when you create or disable a resource. The Tunable entry indicates when you can update a property.

The instructions for registering and configuring resources explain how to set only extension properties that HA for SAP NetWeaver requires you to set.

To set an extension property of a resource, include the following option in the `clresource` command that creates or modifies the resource:

    -p property=value

`-p` property

  Identifies the extension property that you are setting.

value

  Specifies the value to which you are setting the extension property.

### Registering and Configuring the HA for SAP NetWeaver by using Oracle Solaris Cluster Command Line Interface (CLI)

The procedures in this section describe the registration and configuration of the following components of the SAP NetWeaver by using Oracle Solaris Cluster CLI.

- Register and configure the SAP central services resources. The SAP central services consist of the following components:

  - SAP `sapstartsrv`

  - SAP central services

  - SAP replicated enqueue server

  - SAP replicated enqueue preempter

  - SAP dialogue instance

- Register and configure resources for the SAP NetWeaver primary application instance.

- Register and configure the SAP NetWeaver additional dialogue instance.

### How to Register and Configure an SAP NetWeaver `sapstartsrv` Resource

The SAP NetWeaver `sapstartsrv` resource must be configured in the same resource group with each and every other SAP NetWeaver instance resource. These instance resources must depend on their `sapstartsrv` resource.

The `sapstartsrv` resource is to configured to depend on its storage resource. This dependency ensures that the `sapstartsrv` resource does not attempt to start until its associated storage resource is online.

1. Register the `ORCL.sapstartsrv` resource type.

       # clresourcetype register ORCL.sapstartsrv

   `register`

     Specifies that a new resource type is to be added.

   `ORCL.sapstartsrv`

     Specifies the name of the resource type to be added. This name is predefined for SAP `sapstartsrv`.

2. Create a `sapstartsrv` resource.

   Note - You can choose to create a failover resource or a multiple master resource as follows.

   - Create a failover `sapstartsrv` resource.

         # clresource create -d-g central-rg \
         -t ORCL.sapstartsrv \
         -p sid=system-id \
         -p sap_user=sidadm \
         -p instance_number=instance \
         -p instance_name=instance_number \
         -p HOST=ip-alias \
         -p timeout_return=return_code \
         -p resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE} \
         sapstartsrv-rs

   - Create a multiple master `sapstartsrv` resource.

         # clresource create -d-g central-rg \
         -t ORCL.sapstartsrv \
         -p sid=system-id \
         -p sap_user=sidadm \
         -p instance_number{node1}=instance 1 \
         -p instance_number{node2}=instance 2 \
         -p instance_name{node1}=instance_name 1 \
         -p instance_name{node2}=instance_name 2 \
         -p timeout_return=return_code \
         -p resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE} \
         sapstartsrv-rs

     `-g` central-rg

       Specifies the resource group to which the resource is to be added. The resource group is confirmed as a failover resource group.

     `-t ORCL.sapstartsrv`

       Specifies that the resource is an instance of the `ORCL.sapstartsrv` resource type.

     -p sid=system-id

       Specifies the SAP system identifier.

     -p sap_user=sidadm

       Specifies the administrator user for the SAP installation.

     -p instance_number=instance

       Specifies the SAP instance number of the instance to be controlled.

     -p instance_name=instance_name

       Specifies the name of the SAP instance to be controlled.

     -p HOST=ip-alias

       Specifies the IP alias on which the instance is configured.

     -p yellow=return_code

       Specifies the return code on which the resource probe exits by 80% of the probe timeout.

     -p resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE}

       Specifies the list of offline restart dependencies.

     `sapstartsrv-rs`

       Specifies the resource name of the `sapstartsrv` resource.

3. Verify that the default values for the SAP `sapstartsrv` extension properties are acceptable.

   Refer to `ORCL.sapstartsrv` Extension Properties.

4. Enable the SAP `sapstartsrv` resource.

       #  clresource enable sapstartsrv-rs

   `enable`

     Specifies that the specified resource is to be enabled.

   sapstartsrv-rs

     Specifies the name of the resource to be enabled.

### How to Register and Configure an SAP Central Service Resource

The SAP NetWeaver central service resource must be configured in the same resource group with its `sapstartsrv` resource. It must depend on this `sapstartsrv` resource.

The central service resource is configured to depend on its storage resource and on the logical host resource. These dependencies ensures that the central service resource does not attempt to start until its associated resources are online.

1. Register the `ORCL.sapcentr` resource type.

       # clresourcetype register ORCL.sapcentr

   `register`

     Specifies that a new resource type is to be added.

   `ORCL.sapcentr`

     Specifies the name of the resource type to be added. This name is predefined for the SAP central services.

2. Create a failover `scs-startsrv-rs` for the SAP central servicesresource.

   For information, see How to Register and Configure an SAP NetWeaver `sapstartsrv` Resource.

3. Create a failover central service resource.

       # clresource create -d-g central-rg \
       -t ORCL.sapcentr \
       -p sid=system-id \
       -p sap_user=sidadm \
       -p instance_number=instance \
       -p instance_name=instance_number \
       -p HOST=ip-alias \
       -p yellow=return_code \
       -p resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE} \
       -p resource_dependencies=db-rs,scs-startsrv-rs \
       scs-rs

   `-g` central-rg

     Specifies the resource group to which the resource is to be added. The resource group is confirmed as a failover resource group.

   `-t ORCL.sapcentr`

     Specifies that the resource is an instance of the `ORCL.sapcentr` resource type.

   -p sid=system-id

     Specifies the SAP system identifier.

   -p sap_user=sidadm

     Specifies the administrator user for the SAP installation.

   -p instance_number=instance

     Specifies the SAP instance number of the instance to be controlled.

   -p instance_name=instance_name

     Specifies the name of the SAP instance to be controlled.

   -p HOST=ip-alias

     Specifies the IP alias on which the instance is configured.

   -p yellow=return_code

     Specifies the return code on which the resource probe exits if a `sapcontrol` command reports the YELLOW state.

   -p resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE}

     Specifies the list of offline restart dependencies.

   -p resource_dependencies=db-rs,scs-startsrv-rs

     Specifies the list of dependencies.

   `scs-rs`

     Specifies the resource name of the central service resource.

4. Verify that the default values for the SAP central service resource extension properties are acceptable.

   For more information about the SAP central service resource extension properties, see `ORCL.sapcentr` Extension Properties.

5. Enable the `scs-startsrv-rs` resource.

       #  clresource enable scs-startsrv-rs

6. Enable the SAP central service resource.

       #  clresource enable scs-rs

   `enable`

     Specifies that the specified resource is to be enabled.

   scs-rs

     Specifies the name of the resource to be enabled.

### How to Register and Configure an SAP Replicated Enqueue Server Resource

The SAP replicated enqueue server resource must be configured in the same resource group with its `sapstartsrv` resource. It must depend on this `sapstartsrv` resource.

The SAP replicated enqueue server resource is to configured to depend on its storage resource and on the logical host resource, as well as on its central service resource. These dependencies ensure that the SAP replicated enqueue server resource does not attempt to start until its associated resources are online.

1. Register `ORCL.saprepenq`, the resource type for the SAP replicated enqueue server.

       # clresourcetype register ORCL.saprepenq

   `register`

     Specifies that a new resource type is to be added.

   `ORCL.saprepenq`

     Specifies the name of the resource type to be added. This name is predefined for the SAP replicated enqueue server.

2. Create a failover `rep-startsrv-rs` for the SAP replicated enqueue server resource.

   For information, see How to Register and Configure an SAP NetWeaver `sapstartsrv` Resource.

3. Create a failover SAP replicated enqueue server resource.

       # clresource create -d -g rep-rg \
       -t ORCL.saprepenq \
       -p sid=system-id \
       -p sap_user=sidadm \
       -p instance_number=instance \
       -p instance_name=instance_name \
       -p HOST=ip-alias \
       -p yellow=return_code \
       -p resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE} \
       -p resource_dependencies=scs-rs,rep-startsrv-rs \
       rep-rs

   `-g` rep-rg

     Specifies the resource group to which the resource is to be added. The resource group is confirmed as a failover resource group.

   `-t ORCL.saprepenq`

     Specifies that the resource is an instance of the ORCL.saprepenq resource type.

   -p sid=system-id

     Specifies the SAP system identifier.

   -p sap_user=sidadm

     Specifies the administrator user for the SAP installation.

   -p instance_number=instance

     Specifies the SAP instance number of the instance to be controlled.

   -p instance_name=instance_name

     Specifies the name of the SAP instance to be controlled.

   -p HOST=ip-alias

     Specifies the IP alias on which the instance is configured.

   -p yellow=return_code

     Specifies the return code on which the resource probe exits if a `sapcontrol` command reports the YELLOW state.

   `-p resource_dependencies_offline_restart=`hsp-rs{LOCAL_NODE}

     Specifies the list of offline restart dependencies.

   `-p resource_dependencies=`db-rs, rep-startsrv-rs

     Specifies the list of dependencies.

   rep-rs

     Specifies the resource name of the replicated enqueue server resource.

4. Verify that the default values for the SAP replicated enqueue server extension properties are acceptable.

   Refer to `ORCL.saprepenq` Extension Properties.

5. Enable the `rep-startsrv-rs` resource.

       #  clresource enable rep-startsrv-rs

6. Enable the SAP replicated enqueue server resource.

       #  clresource enable rep-rs

   `enable`

     Specifies that the specified resource is to be enabled.

   rep-rs

     Specifies the name of the resource to be enabled.

### How to Register and Configure an SAP Replicated Enqueue Preempter Resource

The SAP replicated enqueue preempter resource must be configured in the same resource group with its central service resource. It must depend on this central service resource with an offline restart dependency.

The SAP replicated enqueue preempter resource is to configured to depend on its storage resource and on the logical host resource, as well as on its SAP central services resource. These dependencies ensure that the SAP replicated enqueue preempter resource does not attempt to start until its associated resources are online.

1. Register `ORCL.saprepenq_preempt`, the resource type for the SAP replicated enqueue preempter.

       # clresourcetype register ORCL.saprepenq_preempt

   `register`

     Specifies that a new resource type is to be registered.

   `ORCL.saprepenq_preempt`

     Specifies the name of the resource type to be added. This name is predefined for the SAP replicated enqueue preempter.

2. Create a failover SAP replicated enqueue preempter resource.

       # clresource create -d -g central-rg \
       -t ORCL.saprepenq_preempt \
       -p sid=system-id \
       -p sap_user=sidadm \
       -p repenqres=resource_name \
       -p enq_instnr=instance_list
       -p resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE},scs-rs \
       -p resource_dependencies=db-rs \
       rep-rs

   `-g` rep-rg

     Specifies the resource group to which the resource is to be added. The resource group is confirmed as a failover resource group.

   `-t ORCL.saprepenq_preempt`

     Specifies that the resource is an instance of the `ORCL.saprepenq_preempt` resource type.

   -p sid=system-id

     Specifies the SAP system identifier.

   -p sap_user=sidadm

     Specifies the administrator user for the SAP installation.

   -p enq_instnr=instance_name

     Specifies the name of the SAP replicated enqueue server server resource.

   `-p enq_instnr=`instance_list

     Specifies the comma separated list of SAP central services instance numbers to be monitored.

   `-p resource_dependencies_offline_restart=`hsp-rs{LOCAL_NODE},scs-rs

     Specifies the list of offline restart dependencies, at least one central services resource must be present here.

   `-p resource_dependencies=`db-rs

     Specifies the list of dependencies.

   preempt-rs

     Specifies the resource name of the SAP replicated enqueue preempter resource.

3. Verify that the default values for the SAP replicated enqueue preempter resource extension properties are acceptable.

   Refer to `ORCL.saprepenq_preempt` Extension Properties.

4. Enable the SAP replicated enqueue preempter resource.

       # clresource enable preempt-rs

   `enable`

     Specifies that the specified resource is to be enabled.

   preempt-rs

     Specifies the name of the resource to be enabled.

### How to Register and Configure an SAP NetWeaver Dialogue Instance Resource

The SAP NetWeaver dialogue instance resource must be configured in the same resource group with its `sapstartsrv` resource. It must depend on this `sapstartsrv` resource.

Us the dialogue instance resource type for the following deployments:

- Primary application instance

- Additional application instance

- Combined instance containing dialogue instance and central services

Configure the dialogue instance resource such that it depends on its storage resource, the logical host resource, the database resource, as well as its central service resource. These dependencies ensure that the dialogue instance resource does not attempt to start until its associated resources are online.

Note - If you configure the dialogue instance resource as a single instance resource it must not depend on a central service resource.

1. Register `ORCL.sapdia`, the resource type for the SAP NetWeaver dialogue instance resource.

       # clresourcetype register ORCL.sapdia

   `register`

     Specifies that a new resource type is to be added.

   `ORCL.sapdia`

     Specifies the name of the resource type to be added. This name is predefined for the SAP dialogue instance.

2. Create a `diag-startsrv-rs` for the SAP NetWeaver dialogue instance resource.

   For information, see How to Register and Configure an SAP NetWeaver `sapstartsrv` Resource.

3. Create a dialogue instance resource.

   Note - Depending on the topology that you are using for your dialogue instance resource, you can create the dialogue resource using one of the following options:

   - Create a failover dialogue instance resource.

         # clresource create -d-g dia-rg \
         -t ORCL.sapdia \
         -p sid=system-id \
         -p sap_user=sidadm \
         -p instance_number=instance \
         -p instance_name=instance_number \
         -p HOST=ip-alias \
         -p yellow=return_code \
         -p resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE} \
         -p resource_dependencies=db-rs,scs-rs,diag-startsrv-rs \
         diag-rs

   - Create a multiple master dialogue instance resource.

         # clresource create -d-g dia-rg \
         -t ORCL.sapdia \
         -p sid=system-id \
         -p sap_user=sidadm \
         -p instance_number{node1}=instance_number \
         -p instance_number{node2}=instance_number \
         -p instance_name{node1}=instance_name\
         -p instance_name{node2}=instance_name \
         -p HOST{node 1}=ip-alias \
         -p HOST{node 2}=ip-alias \
         -p timeout_return=return_code \
         -p resource_dependencies=db-rs,scs-rs,diag-startsrv-rs \
         diag-rs

   - Create a failover combined dialogue instance resource.

         # clresource create -d-g dia-rg \
         -t ORCL.sapdia \
         -p sid=system-id \
         -p sap_user=sidadm \
         -p instance_number=instance \
         -p instance_name=instance_number \
         -p Architecture=comb \
         -p HOST=ip-alias \
         -p yellow=return_code \
         -p resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE} \
         -p resource_dependencies=db-rs,diag-startsrv-rs \
         diag-rs

     `-g` dia-rg

       Specifies the resource group to which the resource is to be added. The resource group is confirmed as a failover or a multiple master resource group.

     `-t ORCL.sapdia`

       Specifies that the resource is an instance of the `ORCL.sapdia` resource type.

     -p sid=system-id

       Specifies the SAP system identifier.

     -p sap_user=sidadm

       Specifies the administrator user for the SAP installation.

     -p instance_number=instance

       Specifies the SAP instance number of the instance to be controlled.

     -p instance_name=instance_name

       Specifies the name of the SAP instance to be controlled.

     -p Architecture=comb

       Specifies the flag to highlight that a combined instance is configured. In this case this value must be `comb`.

     -p HOST=ip-alias

       Specifies the IP alias on which the instance is configured.

     -p yellow=return_code

       Specifies the return code on which the resource probe exits if a `sapcontrol` command reports the YELLOW state.

     -p resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE}

       Specifies the list of offline restart dependencies.

     -p resource_dependencies_offline_restart=db-rs,logical_host,diag-startsrv-rs

       Specifies the list of dependencies.

     diag-rs

       Specifies the resource name of the dialogue instance resource.

4. Verify that the default values for the SAP dialogue instance resource extension properties are acceptable.

   Refer to `ORCL.sapdia` Extension Properties.

5. Enable the `diag-startsrv-rs` resource.

       # clresource enable diag-startsrv-rs

6. Enable the SAP dialogue instance resource.

       # clresource enable diag-rs

   `enable`

     Specifies that the specified resource is to be enabled.

   diag-rs

     Specifies the name of the resource to be enabled.

Copyright © 2012, 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices |