Registering and Configuring HA for SAP Web Application Server

To enable the HA for SAP Web Application Server data service to make SAP Web Application Server 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 HAStoragePlus resources.
Register and configure the SAP central services resources. The SAP central services consist of the following components:
- SAP enqueue server
- SAP replica server
- SAP message server
Register and configure resources for the SAP web application server component.
Register and configure the SAP J2EE engine.

The resource groups were created in How to Enable the SAP Web Application Server to Run in a Cluster and in How to Enable the Stand-Alone SAP J2EE Engine to Run in a Cluster.

Before You Begin

Before performing these procedures, ensure that the HA for SAP Web Application Server 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.

If you are using SAP DB as the database, configure the Oracle Solaris Cluster HA for MaxDB data service before continuing. See Oracle Solaris Cluster Data Service for MaxDB Guide.
If you are using Oracle as the database, configure the Oracle Solaris Cluster HA for Oracle data service before continuing. See Oracle Solaris Cluster Data Service for Oracle Guide.

Perform these procedures as superuser on a cluster node.

Setting HA for SAP Web Application Server Extension Properties

The extension properties for HA for SAP Web Application Server are described in Appendix A, HA for SAP Web Application Server 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 Web Application Server requires you to set.

To set an extension property of a resource, include the following option in the clresource(1CL) 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.

You can also use the procedures in Chapter 2, Administering Data Service Resources, in Oracle Solaris Cluster Data Services Planning and Administration Guide to configure resources after the resources are created.

Tip - As of SAP 7.1, some changes in behavior might prevent Oracle Solaris Cluster from killing necessary SAP processes, resulting in a STOP_FAILED state. To avoid this condition, set the Failover_mode property to HARD for the SAP Web Application Server primary instances resource and the SAP Message Server resources. This setting will cause the RGM to reboot the affected node, causing a failover.

Bear in mind that any other services that are configured on the node will also be affected if a node is rebooted because of the Failover_mode=HARD setting.

Tools for Registering and Configuring HA for SAP Web Application Server

Oracle Solaris Cluster provides the following tools for registering and configuring HA for SAP Web Application Server:

The clsetup(1CL) utility. For more information, see How to Register and Configure the HA for SAP Web Application Server by Using clsetup.
Oracle Solaris Cluster Manager. For more information, see the Oracle Solaris Cluster Manager online help.
Oracle Solaris Cluster maintenance commands. For more information, see Registering and Configuring the HA for SAP Web Application Server by using Oracle Solaris Cluster Command Line Interface (CLI).

The clsetup utility and Oracle Solaris Cluster Manager each provide a wizard for configuring HA for SAP Web Application Server. The wizards reduce the possibility for configuration errors that might result from command syntax errors or omissions. These wizards also ensure that all required resources are created and that all required dependencies between resources are set.

How to Register and Configure the HA for SAP Web Application Server by Using `clsetup`

The procedures in this section describe the registration and configuration of the following components of the SAP Web Application Server by using clsetup utility.

SAP central services, which include these services:
- SAP enqueue server
- SAP replica server
- SAP message server

Note - If you have already created the logical hosts for the SAP central services and SAP replica server resource groups, select those logical hosts when you run clsetup. The clsetup utility will then add SAP central services and SAP replica server resources to the existing resource groups containing these logical hosts.

Perform this procedure during your initial set up of HA for SAP Web Application Server. Perform this procedure from one node only.

Note - The following instructions explain how to perform this operation by using the clsetup utility.

For the ABAP+J2EE configurations, you need to run the clsetup utility twice. For instance, in the first run you may choose to create resources for ABAP and in the second run you may choose to create resources for J2EE. While creating the ABAP+J2EE configurations, the wizard allows you to create two sets of resource groups when you choose separate logical hosts for ABAP and J2EE resources. If you require the resources of the second run to be grouped with the existing resources created in the first run, you need to choose logical hosts that resources from the first run are using.

Before You Begin

Before you start the HA for SAP Web Application Server wizard, ensure that the following prerequisites are met:

The prerequisites for configuring a logical hostname resource are met.
The prerequisites for configuring a highly available storage resource are met.
All the required SAP components are installed, configured, and able to run under the control of Oracle Solaris Cluster.
A highly available database for SAP is configured.
The HA for SAP Web Application Server packages are installed.

Become superuser on any cluster node.
Start the clsetup utility.
```
# clsetup
```
The clsetup main menu is displayed.
Type the number that corresponds to the option for data services and press Return.
The Data Services menu is displayed.
Type the number that corresponds to the option for configuring HA for SAP Web Application Server and press Return.
The clsetup utility displays the list of prerequisites for HA for SAP Web Application Server.
Press Return to continue.
The clsetup utility displays a list of available nodes.
Select the nodes where you require SAP Web Application Server to run.
- To accept the default selection of all listed nodes in an arbitrary order, type a and press Return.
- To select a subset of the listed nodes, type a comma-separated or space-separated list of the numbers that correspond to the nodes and press Return.
  Ensure that the nodes are listed in the order in which the nodes are to appear in the resource group's node list. The first node in the list is the primary node of this resource group.
- To select all nodes in a particular order, type a comma-separated or space-separated ordered list of the numbers that correspond to the nodes and press Return.
  Ensure that the nodes are listed in the order in which the nodes are to appear in the resource group's node list. The first node in the list is the primary node of this resource group.
To confirm your selection of nodes, type d and press Return.
The clsetup utility displays a screen where you can specify the SAP system identifier.
Type the numbers that correspond to required identifier and press Return.
The clsetup utility displays a screen where you can configure additional SAP components.
Select the required option.
- To configure SAP replica server component with the help of the wizard, type yes and press Return.
- To configure SAP replica server component manually, type no and press Return.
The clsetup utility displays a screen where you can configure the SAP enqueue server and prompts you for the SAP user name.
Type the SAP user name and press Return.
The clsetup utility prompts you for the SAP enqueue server executable filename.
Type the SAP enqueue server executable filename and press Return.
The clsetup utility prompts you for the instance number of the SAP enqueue server.
Type the instance number of the SAP enqueue server and press Return.
The clsetup utility prompts you for the SAP enqueue server profile information.
Type the SAP enqueue server profile information and press Return.
The clsetup utility displays a screen where you can configure the SAP message server and prompts you for the instance number of the SAP message server.
Type the instance number of the SAP message server and press Return.
The clsetup utility prompts you for the instance name of the SAP message server.
Type the instance name of the SAP message server and press Return.
The clsetup utility displays a screen where you can configure the HAStorage resources.
To confirm your selection of the existing HAStorage resource, type d and press Return.
Note - You can also create the required HAStorage resource on your own.

The clsetup utility displays a screen where you can configure the logical hostname resource.
To confirm your selection of the logical hostname resource, type d and press Return.
Note - You can also create the required logical hostname resource on your own.
If you want to configure the SAP replica server component, go to the next step, otherwise, go to Step 22.
Type the SAP replica server executable filename and press Return.
The clsetup utility prompts you for the SAP replica server profile information.
Type the SAP replica server profile information and press Return.
The clsetup utility displays a screen where you can configure the HAStorage resources.
To confirm your selection of the configuration, type d and press Return.
The clsetup utility displays a screen where you can configure the logical hostname resource.
To confirm your selection of the configuration, type d and press Return.
The clsetup utility displays a list of database resources.
Select the required database resource and press Return.
The clsetup utility displays information about the Oracle Solaris Cluster objects that the utility will create.
To confirm your selection of the configuration, type c and press Return.
To create the configuration, press Return.
The clsetup utility displays a progress message to indicate that the utility is running commands to create the configuration. When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.

Note - The clsetup utility will rollback the changes if it fails to complete the SAP web application server configuration process.
Press Return to continue.
The clsetup utility returns you to the main menu.
(Optional) Type q and press Return repeatedly until you quit the clsetup utility.

Setting Up the SAP Web Application Server on Non-Global Zones for `HAStoragePlus` Configuration

Use the following procedure to configure a HAStoragePlus resource for non-global zones.

Note -

The entries in the /etc/vfstab file for cluster file systems should contain the global keyword in the mount options.
The SAP binaries that will be made highly available using the HAStoragePlus resource should be accessible from the non-global zones.
In non-global zones, file systems that are used by different resources in different resource groups must reside in a single HAStoragePlus resource that resides in a scalable resource group. The nodelist of the scalable HAStoragePlus resource group must be a superset of the nodelists of the application resource groups that have resources which depend on the file systems. These application resources that depend on the file systems must have a strong resource dependency set to the HAStoragePlus resource. In addition, the dependent application resource group must have a strong positive resource group affinity set to the scalable HAStoragePlus resource group.

How to Set Up the SAP Web Application Server on Non-Global Zones for `HAStoragePlus` Configuration

On any node in the cluster, become superuser or assume a role that provides solaris.cluster.modify RBAC authorization.
Create the scalable resource group with non-global zones that contain the HAStoragePlus resource.
```
# clresourcegroup create \
-p Maximum_primaries=m \
-p Desired_primaries=n \
[-n node-zone-list] hasp-resource-group
```
-p Maximum_primaries=m

Specifies the maximum number of active primaries for the resource group.

-p Desired_primaries=n

Specifies the number of active primaries on which the resource group should attempt to start.

-n node-zone-list

In the node list of a HAStoragePlus resource group, specifies the list of nodename:zonename pairs as the node list of the HAStoragePlus resource group, where the SAP instances can come online.

hasp-resource-group

Specifies the name of the scalable resource group to be added. This name must begin with an ASCII character.
Register the resource type for the HAStoragePlus resource.
```
# clresourcetype register HAStoragePlus
```
Create the HAStoragePlus resource hasp-resource and define the SAP filesystem mount points and global device paths.
```
# clresource create -g hasp-resource-group \
-t SUNW.HAStoragePlus \
-p GlobalDevicePaths=/dev/global/dsk/d5s2,dsk/d6 \
-p affinityon=false \
-p FilesystemMountPoints=/sapmnt/JSC,/usr/sap/trans,/usr/sap/JSC \
hasp-resource
```
-g hasp-resource-group

Specifies the resource group name.

GlobalDevicePaths
Contains the following values:
- Global device group names, such as sap-dg, dsk/d5
- Paths to global devices, such as /dev/global/dsk/d5s2, /dev/md/sap-dg/dsk/d6
FilesystemMountPoints
Contains the following values:
- Mount points of local or cluster file systems, such as /local/mirrlogA,/local/mirrlogB,/sapmnt/JSC,/usr/sap/JSC
The HAStoragePlus resource is created in the enabled state.
Register the resource type for the SAP application.
```
# clresourcetype register resource-type
```
resource-type

Specifies the name of the resource type to be added. For more information, see the release notes for your release of Oracle Solaris Cluster.

Create a SAP resource group.

# clresourcegroup create [-n node-zone-list] \
-p RG_affinities=++hastorageplus-rg \
resource-group-1

resource-group-1: Specifies the SAP services resource group.

Add the SAP application resource to resource-group-1 and set the dependency to hastorageplus-1.

# clresource create -g resource-group-1 \
-t SUNW.application \
[-p "extension-property[{node-specifier}]"=value, ?] \
-p Resource_dependencies_offline_restart=hastorageplus-1 \
resource

Bring the failover resource group online.

# clresourcegroup online resource-group-1

Registering and Configuring the HA for SAP Web Application Server 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 Web Application Server by using Oracle Solaris Cluster CLI.

SAP central services, which include these services:
- SAP enqueue server
- SAP replica server
- SAP message server
SAP web application server component
SAP J2EE engine

How to Register and Configure `HAStoragePlus` Resources for the SAP Central Services Components

An HAStoragePlus resource is created to ensure the high availability of the global device groups where the components are installed.

Register the SUNW.HAStoragePlus resource type.

# clresourcetype register SUNW.HAStoragePlus

Create an HAStoragePlus resource for the global device group on which the SAP enqueue server and the SAP message server are installed.
Create this resource in the SAP central services resource group, which is the resource group to which the SAP enqueue server and the SAP message server resources belong.
```
# clresource create -g central-rg -t SUNW.HAStoragePlus \
-p filesystemmountpoints="mountpoint-list" \
-p affinityon=false hsp-central-rs
```
-g central-rg

Specifies that the resource is to be added to the SAP central services resource group.

-t SUNW.HAStoragePlus

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

-p filesystemmountpoints="mountpoint-list"

Specifies a list of valid mount points for the file system. For more information, see the SUNW.HAStoragePlus(5) man page.

hsp-central-rs

Specifies the name of the resource that you are creating.

The resource is created in the enabled state.
Create an HAStoragePlus resource for the global device group on which SAP replica server is installed.
Create this resource in the SAP replica server resource group.
```
# clresource create -g repl-rg -t SUNW.HAStoragePlus \
-p filesystemmountpoints="mountpoint-list" \
-p affinityon=false hsp-repl-rs
```
-g repl-rg

Specifies that the resource is to be added to the SAP replica server resource group.

-t SUNW.HAStoragePlus

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

-p filesystemmountpoints="mountpoint-list"

Specifies a list of valid mount points for the file system. For more information, see the SUNW.HAStoragePlus(5) man page.

hsp-repl-rs

Specifies the name of the resource that you are creating.

The resource is created in the enabled state.

How to Register and Configure an SAP Enqueue Server Resource

The SAP enqueue server resource and the SAP message server resource must be in the same failover resource group because they fail over together.

The SAP enqueue server resource is configured to depend on its associated HAStoragePlus resource. This dependency ensures that the SAP enqueue server does not attempt to start until its associated HAStoragePlus resource is online.

Register SUNW.sapenq, the resource type for the SAP enqueue server.
```
# clresourcetype register SUNW.sapenq
```
register

Specifies that a new resource type is to be added.

SUNW.sapenq

Specifies the name of the resource type to be added. This name is predefined for the SAP enqueue server.
Create an SAP enqueue server resource in the SAP central services resource group.
```
# clresource create -d -gcentral-rg \
-t SUNW.sapenq \
-p enqueue_profile=path-to-enq-profile \
-p enqueue_server=path-to-enq-server-binary \
-p sap_user=enq-user \
-p enqueue_instance_number=enq-instance \
-p resource_dependencies_offline_restart=hsp-central-rs \
-p resource_dependencies=db-resource \
enq-rs
```
-g central-rg

Specifies the resource group to which the resource is to be added. The SAP central services resource group is configured as a failover resource group.

-t SUNW.sapenq

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

-p enqueue_profile=path-to-enq-profile

Specifies the full path to the SAP enqueue server profile.

-p enqueue_server=path-to-enq-server-binary

Specifies the full path to the SAP enqueue server executable.

-p sap_user=enq-user

Specifies the administration user for the SAP enqueue server.

-p enqueue_instance_number=enq-instance

Specifies the two-digit instance number for the SAP enqueue server. This number is the value of SAPSYSTEM in the SAP profile for SAP enqueue server.

-p resource_dependencies_offline_restart=hsp-central-rs

Specifies that the HAStoragePlus resource for the global device group on which the SAP enqueue server is installed must be online in order for the SAP enqueue server to be online. If any resource in the offline-restart dependency list is stopped, this resource is stopped. If that resource in the offline-restart dependency list is subsequently restarted, this resource is restarted.

-p resource_dependencies=db-resource

Specifies that the database resource must be online in order for the SAP enqueue server to be online.

enq-rs

Specifies the name of the resource to be added.

The resource is created in the enabled state.
Verify that the default values for the SAP enqueue server extension properties are acceptable.
Refer to SUNW.sapenq Extension Properties.
Ensure that SAP enqueue server is not already running on the cluster.
If SAP enqueue server is already running on any node of the cluster, you risk the simultaneous running of multiple SAP enqueue server processes.
Enable the SAP enqueue server resource.
```
#  clresource enable enq-rs
```
enable

Specifies that the specified resource is to be enabled.

enq-rs

Specifies the name of the resource to be enabled.

How to Register and Configure an SAP Replica Server Resource

The SAP replica server resource must be in a different failover resource group from the SAP enqueue server resource, because the SAP replica server resource must not fail over with the SAP enqueue server resource.

The SAP replica server resource is configured to depend on its associated HAStoragePlus resource being online. The SAP replica server resource also depends on the SAP enqueue server resource. These dependencies ensure that the SAP replica server does not attempt to start until both its associated HAStoragePlus resource and the SAP enqueue server are online.

Register SUNW.saprepl, the resource type for the SAP replica server.
```
# clresourcetype register SUNW.saprepl
```
register

Specifies that a new resource type is to be registered.

SUNW.saprepl

Specifies the name of the resource type to be added. This name is predefined for the SAP replica server.
Create an SAP replica server resource in the SAP replica server resource group.
```
# clresource create -d -g repl-rg \
-t SUNW.saprepl \
-p replica_profile=path-to-repl-profile \
-p replica_server=path-to-repl-server-binary \
-p sap_user=repl-user \
-p resource_dependencies_offline_restart=hsp-repl-rs \
-p resource_dependencies=enq-rs \
repl-rs
```
-g repl-rg

Specifies the resource group to which the resource is to be added. The SAP replica server resource group is configured as a failover resource group.

-t SUNW.saprepl

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

-p replica_profile=path-to-repl-profile

Specifies the full path to the SAP replica server profile.

-p replica_server=path-to-repl-server-binary

Specifies the full path to the SAP replica server executable.

-p sap_user=repl-user

Specifies the administration user for the SAP replica server.

-p resource_dependencies_offline_restart=hsp-repl-rs

Specifies that the HAStoragePlus resource for the global device group on which the SAP replica server is installed must be online before the SAP replica server resource can be online:
If any resource in the offline-restart dependency list is stopped, this resource is stopped. If that resource in the offline-restart dependency list is subsequently restarted, this resource is restarted.

-p resource_dependencies=enq-rs

Specifies that the SAP enqueue server resource must be online before the SAP replica server resource can be online:

repl-rs

Specifies the name of the resource to be added.

The resource is created in the enabled state.
Verify that the default values for the SAP replica server extension properties are acceptable.
Refer to SUNW.saprepl Extension Properties.
Enable the SAP replica server resource.
```
# clresource enable repl-rs
```
enable

Specifies that the specified resource is to be enabled.

repl-rs

Specifies the name of the resource to be enabled.

How to Register and Configure an SAP Message Server Resource

The SAP enqueue server resource and the SAP message server resource must be in the same failover resource group because they fail over together.

The SAP message server resource is configured to depend on its associated HAStoragePlus resource. This dependency ensures that the SAP message server does not attempt to start until its associated HAStoragePlus resource is online.

Register SUNW.sapscs, the resource type for the SAP message server.
```
# clresourcetype register SUNW.sapscs
```
register

Specifies that a new resource type is to be added.

SUNW.sapscs

Specifies the name of the resource type to be added. This name is predefined for the SAP message server.
Create an SAP message server resource in the SAP central services resource group.
```
# clresource create -d -g central-rg \
-t SUNW.sapscs \
-p sap_sid=scs-system-ID \
-p sap_instance_number=scs-instance-number \
-p sap_instance_name=scs-instance-name \
-p msg_server_port=msg-server-port \
-p scs_startup_script=scs-server-startup-script \
-p scs_shutdown_script=scs-server-shutdown-script \
-p resource_dependencies_offline_restart=hsp-central-rs \
-p resource_dependencies=db-resource \
msg-rs
```
-g central-rg

Specifies the resource group to which the resource is to be added. The SAP central services resource group is configured as a failover resource group.

-t SUNW.sapscs

Specifies that the SAP message server resource is an instance of the resource type that is named SUNW.sapscs.

-p sap_sid=scs-system-ID

Specifies the SAP system ID for the SAP message server. This ID is SAPSYSTEMNAME in the SAP profile.

-p sap_instance_number=scs-instance-number

Specifies the instance number for the SAP message server. This number is SAPSYSTEM in the SAP profile.

-p sap_instance_name=scs-instance-name

Specifies the instance name for the SAP message server. This name is INSTANCE_NAME in the SAP profile.

-p msg_server_port=msg-server-port

Specifies the listen port for the SAP message server.

-p scs_startup_script=scs-server-startup-script

Specifies the full path to the startup script for the SAP message server instance.

-p scs_shutdown_script=scs-server-shutdown-script

Specifies the full path to the shutdown script for the SAP message server instance.

-p resource_dependencies_offline_restart=hsp-central-rs

Specifies that the HAStoragePlus resource for the global device group on which the SAP message server is installed must be online in order for the SAP message server to be online. If any resource in the offline-restart dependency list is stopped, this resource is stopped. If that resource in the offline-restart dependency list is subsequently restarted, this resource is restarted.

-p resource_dependencies=db-resource

Specifies that the database resource must be online in order for the SAP message server to be online.

msg-rs

Specifies the name of the resource to be added.

The resource is created in the enabled state.
Verify that the default values for the SAP message server extension properties are acceptable.
Refer to SUNW.sapscs Extension Properties.
Enable the SAP message server resource.
```
# clresource enable msg-rs
```
enable

Specifies that the specified resource is to be enabled.

msg-rs

Specifies the name of the resource to be enabled.

How to Register and Configure an SAP Web Application Server Component

An HAStoragePlus resource is created to ensure the high availability of the global device groups where the components are installed.

The resource for the SAP web application server component is configured to depend on its associated HAStoragePlus resource. The resource for the SAP web application server component also depends on the database resource, as well as the SAP message server resource. These dependencies ensure that the resource for the SAP web application server component does not attempt to start until its associated HAStoragePlus resource, the database, and the SAP message server resource are all online.

Note - The SAP web application server component can be configured to run under PMF or not to run under PMF. See the extension property Webas_Use_Pmf in SUNW.sapwebas Extension Properties. If the component is configured to run under PMF control, and if the network is not available, PMF stops the resource in such a way that no data is lost. However, if the component is configured not to run under PMF, and if the network is not available, the resource and the resource group for the SAP web application server component are in the stop_failed state and user intervention is required. Because no SAP utility is available to stop all SAP processes, in order to prevent possible data corruption, the data service does not automatically restart the processes.

The following procedure applies to both failover and scalable configurations of SAP web application server component.

Create an HAStoragePlus resource for the global device group on which SAP web application server component is installed.
Create this resource in the SAP web application server resource group.
```
# clresource create -g webas-rg -t SUNW.HAStoragePlus \
-p filesystemmountpoints="mountpoint-list" \
-p affinityon=false hsp-webas-rs
```
-g webas-rg

Specifies that the resource is to be added to the SAP web application server resource group. This resource group can be failover or scalable.

-t SUNW.HAStoragePlus

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

-p filesystemmountpoints="mountpoint-list"

Specifies a list of valid mount points for the file system. For more information, see the SUNW.HAStoragePlus(5) man page.

hsp-webas-rs

Specifies the name of the resource that you are creating.

The resource is created in the enabled state.
Register SUNW.sapwebas, the resource type for the SAP web application server component.
```
# clresourcetype register SUNW.sapwebas
```
register

Specifies that a new resource type is to be added.

SUNW.sapwebas

Specifies the name of the resource type to be added. This name is predefined for the SAP web application server component.
Create a resource for the SAP web application server component.
The SAP web application server component can be configured either as a failover resource or as a scalable resource by adding the resource to a resource group that was created as a failover or a scalable resource group.
```
# clresource create -d -g webas-rg \
-t SUNW.sapwebas \
-p sap_sid=webas-system-ID \
-p sap_instance_number=webas-instance-number \
-p sap_instance_name=webas-instance-name \
-p sap_instance_type=ABAP_J2EE \
-p webas_startup_script=sap_startup_script \
-p webas_shutdown_script=sap_shutdown_script \
-p resource_dependencies_offline_restart=hsp-webas-rs \
-p resource_dependencies=db-webas-rs,msg-rs \
-p start_timeout=600 \
webas-rs
```
-g webas-rg

Specifies the resource group to which the resource is to be added. The SAP web application server resource group can be configured as a failover or a scalable resource group.

-t SUNW.sapwebas

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

-p sap_sid=webas-system-ID

Specifies the SAP system ID for the SAP web application server component. This ID is SAPSYSTEMNAME in the SAP profile.

-p sap_instance_number=webas-instance-number

Specifies the two-digit SAP system number for the SAP web application server component instance. This number is SAPSYSTEM in the SAP profile.

-p sap_instance_name=webas-instance-name

Specifies the instance name for the SAP web application server component. This name is INSTANCE_NAME in the SAP profile.

-p sap_instance_type=ABAP_J2EE

Specifies that both the ABAP and J2EE components are included. This property must be set to ABAP_J2EE when both the ABAP central instance and SAP J2EE engine are present. The default value is ABAP. It takes the value J2EE when only a standalone SAP J2EE engine is configured.

-p webas_startup_script=sap_startup_script

Specifies the startup script for the SAP web application server instance.

-p webas_shutdown_script=sap_shutdown_script

Specifies the shutdown script for the SAP web application server instance.

-p resource_dependencies_offline_restart=hsp-webas-rs

Specifies that the HAStoragePlus resource for the global device group on which the SAP web application server component is installed must be online before the resource for the SAP web application server component can be online:
If any resource in the offline-restart dependency list is stopped, this resource is stopped. If that resource in the offline-restart dependency list is subsequently restarted, this resource is restarted.

-p resource_dependencies=db-webas-rs,msg-rs
Specifies that the following resources must be online before the resource for the SAP web application server component can be online:
- Database resource. The database resource is created by the relevant data service.
- SAP message server resource.
webas-rs

Specifies the name of the resource to be added.
The resource is created in the enabled state.
Verify that the default values for the SAP web application server component extension properties are acceptable.
Refer to SUNW.sapwebas Extension Properties.
Enable the SAP web application server component resource.
```
# clresource enable webas-rs
```
enable

Specifies that the specified resource is to be enabled.

webas-rs

Specifies the name of the resource to be enabled.

Examples of Configuring the SAP Web Application Server

The following examples show how the SAP Web Application Server can be configured to be highly available in Oracle Solaris Cluster. The examples assume that the resource groups have been created, the resource groups are online, and the resource types have been registered.

Configuring the SAP central services, which consist of the following components:
- SAP enqueue server
- SAP replica server
- SAP message server
Configuring the SAP web application server component

Example 1-3 Configuring the SAP Central Services Components

In this example the SAP central services resource group is called centralrg, and the SAP replica server resource group is called replrg.

To create an HAStoragePlus resource called hspcentralrs for the global device group enqdg in the resource group centralrg, the following command is run. The group centraldg is the global device group on which the SAP enqueue server is installed, and centralrg is the resource group to which the SAP enqueue server resource and the SAP message server resource belong.
```
# clrsource create  -g centralrg \
-t SUNW.HAStoragePlus \
-p filesystemmountpoints="/global/sapdata" \
-p affinityon=false \
hspcentralrs
```
To create an HAStoragePlus resource called hspreplrs for the global device group repldg in the resource group replrg, the following command is run. The group repldg is the global device group on which SAP replica server is installed, and replrg is the resource group to which the SAP replica server resource belongs.
```
# clresource create -g replrg \
-t SUNW.HAStoragePlus \
-p filesystemmountpoints="/global/sapdata" \
-p affinityon=false \
hspreplrs
```
The resource is created in the enabled state.

To create an SAP enqueue server resource called enqrs in the resource group centralrg, the following command is run. This resource is dependent on the hspcentralrs and dbwebasrs resource.

# clresource create -g centralrg \
-t SUNW.sapenq \
-p enqueue_profile=/usr/sap/SC3/SYS/profile/SC3_ASCS07_central-lh \
-p enqueue_server=/sapmnt/SC3/exe/enserver \
-p sap_user=sc3adm \
-p enqueue_instance_number=07 \
-p resource_dependencies_offline_restart=hspcentralrs \
-p resource_dependencies=db-resource \
enqrs

The resource is created in the enabled state.

To create an SAP replica server resource called replrs in the resource group replrg, the following command is run. This resource is dependent on the hspreplrs resource and the enqrs resource.

# clresource create  -g replrg \
-t SUNW.saprepl \
-p replica_profile=/usr/sap/SC3/SYS/profile/SC3_REP07 \
-p replica_server=/sapmnt/SC3/exe/enrepserver \
-p sap_user=sc3adm \
-p resource_dependencies_offline_restart=hspreplrs \
-p resource_dependencies=enqrs \
replrs

The resource is created in the enabled state.

To create an SAP message server resource called msgrs in the resource group centralrg, the following command is run. This resource is dependent on the hspcentralrs resource. The SAP message server resource is an instance of the resource type that is named SUNW.sapscs.

# clresource create  -g centralrg \
-t SUNW.sapscs \
-p sap_sid=SC3 \
-p sap_instance_number=07 \
-p sap_instance_name=ASCS07 \
-p msg_server_port=3607 \
-p scs_startup_script=/usr/sap/SC3/SYS/exe/run/my_startsap \
-p scs_shutdown_script=/usr/sap/SC3/SYS/exe/run/my_stopsap \
-p resource_dependencies_offline_restart=hspcentralrs \
-p resource_dependencies=db-resource \
msgrs

The resource is created in the enabled state.

Example 1-4 Configuring the SAP Web Application Server Component

In this example the resource group for the SAP web application server component is called webasrg.

To create an HAStoragePlus resource called hspwebasrs for the global device group webasdg in the resource group webasrg, the following command is run. The group webasdg is the device group on which the SAP web application server component is installed, and webasrg is the resource group to which the SAP web application server resource belongs.
```
# clresource create   -g webasrg \
-t SUNW.HAStoragePlus \ 
-p filesystemmountpoints="/global/sapdata" \ 
-p affinityon=false \
hspwebasrs
```
The resource is created in the enabled state.
To create a resource called webasrs for the SAP web application server component, the following command is run. This resource is created in the failover resource group webasrg. This resource is dependent on the hspwebasrs resource. The webasrs resource is also dependent on the database resource dbwebasrs, which has already been created by the relevant data service. In addition, this resource is dependent on the SAP message server resource, which is called msgrs in the previous example.
```
# clresource create -g webasrg \
-t SUNW.sapwebas \
-p sap_sid=SC3 \
-p sap_instance_number=08 \
-p sap_instance_name=D08 \
-p sap_instance_type=ABAP \
-p resource_dependencies_offline_restart=hspwebasrs \
-p resource_dependencies=dbwebasrs,msgrs \ 
-p start_timeout=600 \
webasrs
```
The resource is created in the enabled state.

Skip Navigation Links
Exit Print View
	Oracle Solaris Cluster Data Service for SAP Web Application Server Guide Oracle Solaris Cluster