Cluster Server 7.3.1 Configuration Guide for SAP Web Application Server - Windows

Last Published:
Product(s): InfoScale & Storage Foundation (7.3.1)
  1. Section I. Getting Started
    1. Introducing the Veritas High Availability Agent for SAP Web Application Server
      1. About the Veritas High Availability agent for SAP Web Application Server
        1.  
          Typical SAP Web Application Server configuration in a VCS cluster
      2.  
        How application availability is achieved in a physical environment
      3. How does the Veritas High Availability solution work
        1.  
          How the VMwareDisks agent communicates with the vCenter Server instead of the ESX/ESXi host
        2.  
          Typical VCS cluster configuration in a virtual environment
      4. Agent functions
        1.  
          Online
        2.  
          Offline
        3.  
          Monitor
        4.  
          Clean
        5.  
          Online
        6.  
          Offline
        7.  
          Monitor
        8.  
          Clean
      5.  
        Agent attributes for SAP Web Application Server
      6.  
        Installing the agent for SAP Web Application Server
    2. Installing and configuring the SAP Web Application Server for high availability
      1.  
        Monitoring an SAP instance
      2.  
        About installing SAP Web Application Server for high availability
      3.  
        About configuring SAP Web Application Server for high availability
      4. Setting up SAP systems for clustering
        1.  
          Installing SAP systems using a virtual hostname
        2.  
          Installing SAP systems using a virtual hostname
      5.  
        Installing SAP system using Virtual Hostname
      6.  
        Configuring the agent for message server restart
      7. Configuring the Enqueue Replication Server
        1.  
          Configuring the Enqueue Replication Server manually
        2.  
          Configuring the Enqueue Replication Server using SAPInst
        3.  
          Configuring the Enqueue Replication Server manually
        4.  
          Configuring the Enqueue Replication Server using SAPInst
      8. Clustering an SAP instance
        1.  
          Configuring the first node in the cluster
        2.  
          Configuring all other nodes in the cluster
        3. Creating and adding domain groups and users
          1.  
            User accounts
          2.  
            Groups
          3.  
            Adding new domain groups and users
          4.  
            Creating SAP system users, sapsidadm and SAPServiceSAPSID
          5.  
            Adding the sapsidadm user to the SAP_SAPSID_GlobalAdmin Group
          6.  
            To add the SAPServiceSAPSID user to the SAP_SAPSID_GlobalAdmin Group
        4.  
          Creating and adding local groups and users
        5.  
          Creating and adding local groups and users
        6.  
          Creating sapmnt and saploc share directories
        7.  
          Configuring the first node in the cluster
        8.  
          Configuring all other nodes in the cluster
        9. Creating and adding domain groups and users
          1.  
            User accounts
          2.  
            Groups
          3.  
            Adding new domain groups and users
          4.  
            Creating SAP system users, sapsidadm and SAPServiceSAPSID
          5.  
            Adding the sapsidadm user to the SAP_SAPSID_GlobalAdmin Group
          6.  
            To add the SAPServiceSAPSID user to the SAP_SAPSID_GlobalAdmin Group
          7.  
            User accounts
          8.  
            Groups
          9.  
            Adding new domain groups and users
          10.  
            Creating SAP system users, sapsidadm and SAPServiceSAPSID
          11.  
            Adding the sapsidadm user to the SAP_SAPSID_GlobalAdmin Group
          12.  
            To add the SAPServiceSAPSID user to the SAP_SAPSID_GlobalAdmin Group
        10.  
          Creating and adding local groups and users
        11.  
          Creating and adding local groups and users
        12.  
          Creating sapmnt and saploc share directories
      9.  
        Configuring the SAP systems on Windows Server 2008/2012
  2. Section II. Configuring the application for high availability
    1. Configuring the application in a physical environment
      1.  
        Overview
      2.  
        Before configuring the service groups for SAP Web Application Server
      3.  
        Configuring service groups with the SAP Web Application Server agent
      4.  
        Configuring the SAPWebAS preonline script
    2. Configuring the application in a VMware environment
      1.  
        About configuring application monitoring with Veritas High Availability solution for VMware
      2. Configuring application monitoring for SAP Web Application Server
        1.  
          Configuring the VCS cluster
        2.  
          Configuring the application
    3. Optional configuration tasks for the SAP Web Application Server agent
      1.  
        Setting the SAPMonHome attribute
      2.  
        Configuring the execution period for agent functions
      3.  
        Executing a custom monitor program
      4.  
        Preventing early faulting of Java and Add-In instances
  3. Section III. Troubleshooting the Agent
    1. Troubleshooting the agent for SAP Web Application Server
      1.  
        Starting the SAP Web Application Server outside a cluster
      2. Troubleshooting common problems
        1.  
          Unable to install the Veritas High Availability agent for SAP Web Application Server
        2.  
          Unable to see an entry in the SAP MMC for an SAP instance
        3.  
          The agent for SAP Web Application Server fails to bring online an SAP instance resource through VCS
        4.  
          SAP instance does not come online, and the startsap.exe command exits with exit code -1
        5.  
          In case of an Enqueue server failure, the Enqueue server instance fails to take over the lock table from the Enqueue Replication server instance
        6.  
          The ensmon.exe command returns exit code 4 for a Enqueue server instance
        7.  
          The return code of the ensmon.exe command is 8 for an Enqueue Replication server instance
        8.  
          The Enqueue server instance does not fail over to the correct Enqueue Replication server instance
        9.  
          In case of a resource fault, the Service Group does not fail over
        10.  
          Unable to see an entry in the SAP MMC for an SAP instance
        11.  
          The agent for SAP Web Application Server fails to bring online an SAP instance resource through VCS
        12.  
          SAP instance does not come online, and the startsap.exe command exits with exit code -1
        13.  
          In case of an Enqueue server failure, the Enqueue server instance fails to take over the lock table from the Enqueue Replication server instance
        14.  
          The ensmon.exe command returns exit code 4 for a Enqueue server instance
        15.  
          The return code of the ensmon.exe command is 8 for an Enqueue Replication server instance
        16.  
          The Enqueue server instance does not fail over to the correct Enqueue Replication server instance
        17.  
          In case of a resource fault, the Service Group does not fail over
      3. Reviewing SAP Web Application Server agent log files
        1.  
          Using SAP instance log files
        2.  
          Using SAP log files
        3.  
          Using SAP instance log files
        4.  
          Using SAP log files
      4. Reviewing error log files
        1.  
          Using SAP NetWeaver instance files
        2.  
          Reviewing cluster log files
        3.  
          Using trace level logging
        4.  
          Using SAP NetWeaver instance files
        5.  
          Reviewing cluster log files
        6.  
          Using trace level logging
      5.  
        Checks for an SAP Add-In Usage Types
  4. Appendix A. Sample Configurations
    1.  
      About the sample configuration for the agent for SAP Web Application Server
    2.  
      Sample agent type definition for SAP WebAS
    3. Sample SAP resource configuration in a physical environment
      1.  
        Sample SAP primary application server instance
      2.  
        Sample SAP additional application server instance
      3.  
        Sample SAP Central Services instance
      4.  
        Sample SAP Enqueue Replication server instance
      5.  
        Sample SAP primary application server instance
      6.  
        Sample SAP additional application server instance
      7.  
        Sample SAP Central Services instance
      8.  
        Sample SAP Enqueue Replication server instance
    4. Sample service group configurations in a physical environment
      1.  
        Sample service group configuration for ABAP and Java Usage types
      2. Sample service group configurations for SAP systems on Windows Server 2008/2012
        1.  
          Sample configuration for SAP Central Services Instances service group for Add-In installation Usage Type
        2.  
          Sample resource dependency for SAP Central Services Instances service group for Add-In installation usage type
        3.  
          Sample configuration for SAP Enqueue Replication Server Instances service group for Add-In installation Usage Type
        4.  
          Sample resource dependency for SAP Enqueue Replication Server Instances service group for Add-In installation Usage Type
        5.  
          Sample configuration for SAP Central Services Instances service group for Add-In installation Usage Type
        6.  
          Sample resource dependency for SAP Central Services Instances service group for Add-In installation usage type
        7.  
          Sample configuration for SAP Enqueue Replication Server Instances service group for Add-In installation Usage Type
        8.  
          Sample resource dependency for SAP Enqueue Replication Server Instances service group for Add-In installation Usage Type
      3.  
        Sample service group dependency for SAP Web Application Server
    5.  
      Sample configuration in a virtual environment

Configuring service groups with the SAP Web Application Server agent

While setting up a cluster, you must always ensure that the cluster has some spare capacity to handle the SAP NetWeaver failover scenarios. For example, in case of a back-end database failure, the cluster must be able to run another database instance in conjunction with other running applications. Review the information about data protection.

The cluster should thus be able to provide application failover by encapsulating the resources required for an application into a service group. A service group is a virtualized application that can switch between the cluster nodes. It contains a set of dependent resources, such as disk groups, disk volumes, file systems, IP addresses, NIC cards, and dependent application processes. It also includes logic about the dependencies between the application components.

These service groups should thus be configured such that the cluster can start, stop, monitor, and switch the service groups between the nodes, depending upon the server or resource faults. An administrator should also be pro-actively able to move a service group between cluster nodes to perform preventative maintenance or apply patches.

To configure the service groups

  1. Change the cluster configuration to read/write mode.

    C:\> haconf -makerw

  2. Create a service group for SAP NetWeaver

    C:\> hagrp -add SAP710-PI1SCS

  3. Modify the SystemList attribute for the group, to add systems.

    C:\> hagrp -modify SAP710-PI1SCS SystemList vcswin74 0 vcswin75 1

  4. Create resources for NIC, IP, Lanman,VMDg, and MountV in the service group.
    C:\> hares -add SAP710-PI1SCS_nic NIC SAP710-PI1SCS
    C:\> hares -add SAP710-PI1SCS_ip IP SAP710-PI1SCS
    C:\> hares -add SAP710-PI1SCS_lanman Lanman SAP710-PI1SCS
    C:\> hares -add SAP710-PI1SCS_mnt MountV SAP710-PI1SCS
    C:\> hares -add SAP710-PI1SCS_vmdg VMDg SAP710-PI1SCS

    For more details on creating and modifying resource attributes for NIC, IP, Lanman, VMDg and MountV refer to Cluster Server Bundled Agents Reference Guide.

  5. Create links between the resources.
    C:\> hares -link SAP710-PI1SCS_ip SAP710-PI1SCS_nic
    C:\> hares -link SAP710-PI1SCS_lanman SAP710-PI1SCS_ip
    C:\> hares -link SAP710-PI1SCS_mnt SAP710-PI1SCS_vmdg
  6. Create SAPWebAS resource for applications based on SAP NetWeaver

    C:\> hares -add SAP710-PI1SCS_scs SAPWebAS SAP710-PI1SCS

    Based on the SAP instance you are clustering, modify the resource attributes.

    See Agent attributes for SAP Web Application Server.

  7. Create resource dependencies for SAPWebAS resource.

    The SAPWebAS resource depends on the Lanman and MountV resources.

    C:\> hares -link SAP710-PI1SCS_scs SAP710-PI1SCS_lanman
    C:\> hares -link SAP710-PI1SCS_scs SAP710-PI1SCS_mnt
  8. Verify the final resource dependencies for SAP server group.
       Group 			         Parent 		             Child
SAP710-PI1SCS 		SAP710-PI1SCS_scs    	SAP710-PI1SCS_lanman
SAP710-PI1SCS 		SAP710-PI1SCS_scs    	SAP710-PI1SCS_mnt
SAP710-PI1SCS 		SAP710-PI1SCS_ip 	    SAP710-PI1SCS_nic
SAP710-PI1SCS 		SAP710-PI1SCS_lanman  SAP710-PI1SCS_ip
SAP710-PI1SCS 		SAP710-PI1SCS_mnt 	   SAP710-PI1SCS_vmdg
  9. Save the cluster configuration.

    C:\> haconf -dump -makero