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

Language:

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 application server instance
Register and configure resources for the SAP NetWeaver primary application instance.
Register and configure the SAP NetWeaver additional application server 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.

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.
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_number \
-p Instance_name=instance_name \
-p Child_mon_level=5 \
-p HOST=ip-alias \
-p Timeout_return=return_code \ 
-p Resource_dependencies=logical_host_resource \
-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_number_1 \
-p Instance_number{node2}=instance_number_2 \
-p Instance_name{node1}=instance_name 1 \
-p Instance_name{node2}=instance_name 2 \
-p Timeout_return=return_code \ 
-p Child_mon_level=5 \
-p Resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE \
sapstartsrv-rs
```
  Note - Add -p Child_mon_level=5 \ to the existing list of parameters, while creating a failover sapstartsrv resource as well as while creating a multiple master sapstartsrv resource, if you do not configure it for a resource of the resource type ORCL.sapdia, which is the primary application server and additional application server resources.
  If you configure it for either the primary application server or additional application server resources, then use the following parameter:
```
-p Child_mon_level=6 \
```
  -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_number
  
  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=logical_host_resource
  
  Specifies dependency to the logical host to make sure that a SAP NetWeaver failover resource can rely on the public IP address.
  
  -p Resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE}
  
  Specifies the list of offline restart dependencies.
  
  -p Child_mon_level=n
  
  Specifies the process tree depth to be monitored by process monitor facility (PMF).
  
  sapstartsrv-rs
  
  Specifies the resource name of the sapstartsrv resource.
Verify that the default values for the SAP sapstartsrv extension properties are acceptable.
Refer to ORCL.sapstartsrv Extension Properties.
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.

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.
Create a failover scs-startsrv-rs for the SAP central services resource.
For information, see How to Register and Configure an SAP NetWeaver sapstartsrv Resource.
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_number \
-p Instance_name=instance_name \
-p HOST=ip-alias \
-p Yellow=return_code \
-p Retry_count=0 \
-p Resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE} \
-p Resource_dependencies=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_number

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 Retry_count=0

Specifies that the central services resource must not be restarted in case of a failure. Instead, it should perform a failover.

-p Resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE}

Specifies the list of offline restart dependencies.

-p resource_dependencies=scs-startsrv-rs

Specifies the list of dependencies.

scs-rs

Specifies the resource name of the central service resource.
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.
Set the default project of the sidadm user as the resource group project for the central service resource group.
```
# clresourcegroup set -p RG_project_name=SAP project centr-rg
```
For more information, see Using Alternate Project Identification.
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.

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.
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.

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_number \
-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=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_number

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=rep-startsrv-rs

Specifies the list of dependencies.

rep-rs

Specifies the resource name of the replicated enqueue server resource.

Verify that the default values for the SAP replicated enqueue server extension properties are acceptable.
Refer to ORCL.saprepenq Extension Properties.
Set the default project of the sidadm user as the resource group project for the central service resource group.
```
# clresourcegroup set -p RG_project_name=SAP project rep-rg
```
For more information, see Using Alternate Project Identification.
Enable the rep-startsrv-rs resource.
```
# clresource enable rep-startsrv-rs
```

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 be 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.

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.

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_number_list \
-p Resource_dependencies_offline_restart=hsp-rs{LOCAL_NODE},scs-rs \
preempt-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_number_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.

preempt-rs

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

Verify that the default values for the SAP replicated enqueue preempter resource extension properties are acceptable.
Refer to ORCL.saprepenq_preempt Extension Properties.

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 Application Server Instance Resource

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

Use the application server instance resource type for the following deployments:

Primary application server instance
Additional application server instance
Instances containing application server instances and central services can be combined as central instance without the central services resources. You must add the following property:
```
-p Architecture=comb \
```

Configure the application server 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 application server instance resource does not attempt to start until its associated resources are online.

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

Register ORCL.sapdia, the resource type for the SAP NetWeaver application server 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 application server instance.
Create a diag-startsrv-rs for the SAP NetWeaver application server instance resource.
For information, see How to Register and Configure an SAP NetWeaver sapstartsrv Resource.
Create an application server instance resource.
Note - Depending on the topology that you are using for your application server instance resource, you can create the application server resource using one of the following options:
- Create a failover application server instance resource.
```
# clresource create -d-g dia-rg \
-t ORCL.sapdia \
-p Sid=system-id \
-p Sap_user=sidadm \
-p instance_number=instance_number \
-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=db-rs,scs-rs,diag-startsrv-rs \
diag-rs
```
- Create a multiple master application server 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 application server instance resource.
```
# clresource create -d-g dia-rg \
-t ORCL.sapdia \
-p Sid=system-id \
-p Sap_user=sidadm \
-p Instance_number=instance_number \
-p Instance_name=instance_name \
-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_number
  
  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=db-rs,logical_host,diag-startsrv-rs
  
  Specifies the list of dependencies.
  
  diag-rs
  
  Specifies the resource name of the application server instance resource.

Verify that the default values for the SAP application server instance resource extension properties are acceptable.
Refer to ORCL.sapdia Extension Properties.
Set the default project of the sidadm user as the resource group project for the central service resource group.
```
# clresourcegroup set -p RG_project_name=SAP project rep-rg
```
For more information, see Using Alternate Project Identification.
Enable the diag-startsrv-rs resource.
```
# clresource enable diag-startsrv-rs
```

Enable the SAP application server 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.

Oracle® Solaris Cluster Data Service for SAP NetWeaver Guide