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

Last Published:
Product(s): InfoScale & Storage Foundation (8.0)
Platform: Windows
  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.  
        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
      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
      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
  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 see an entry in the SAP MMC for an SAP instance
        2.  
          The agent for SAP Web Application Server fails to bring online an SAP instance resource through VCS
        3.  
          SAP instance does not come online, and the startsap.exe command exits with exit code -1
        4.  
          In case of an Enqueue server failure, the Enqueue server instance fails to take over the lock table from the Enqueue Replication server instance
        5.  
          The ensmon.exe command returns exit code 4 for a Enqueue server instance
        6.  
          The return code of the ensmon.exe command is 8 for an Enqueue Replication server instance
        7.  
          The Enqueue server instance does not fail over to the correct Enqueue Replication server instance
        8.  
          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
      4. Reviewing error log files
        1.  
          Using SAP NetWeaver instance files
        2.  
          Reviewing cluster log files
        3.  
          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
    4. Sample service group configurations in a physical environment
      1.  
        Sample service group configuration for ABAP and Java Usage types
      2.  
        Sample service group dependency for SAP Web Application Server
    5.  
      Sample configuration in a virtual environment

Configuring the Enqueue Replication Server manually

To manually configure the Enqueue Replication Server for SAP Web Application Server

  1. Enable replication in the (A)SCS instance by adding the following parameter to the instance profile of (A)SCS instance:

    (SAPSID_InstName_VirtualHostname).

    enque/server/replication = true

    Restart the (A)SCS instance to make the change effective.

    Let us assume a two-node software failover cluster, running on the physical hosts - host A and host B, and a clustered (A) SCS instance with the following parameters.

    • SCS SAPSID = PLL

    • SCS INSTNO = 01

    • SCS HOST = sapscshost (virtual host name)

    This instance (that is, the Enqueue Server's lock table) must be protected with an ERS instance as follows:

    • ERS SAPSID = PLL

    • ERS INSTNO = 11 (a free instance number)

    • ERS HOST = sapershost (virtual hostname)

  2. On one of the physical hosts ( host A or host B) perform the following steps as user sidadm or domain administrator:

    Create the directory structure as follows:

    drive:\usr\sap\PLL\ERS11\exe

    drive:\usr\sap\PLL\ERS11\log

    drive:\usr\sap\PLL\ERS11\data

    drive:\usr\sap\PLL\ERS11\work

  3. Copy all the binaries from (A)SCS instance exe directory into the ERS instance exe directory.
  4. Create a new ERS instance profile in drive:\usr\sap\PLL\SYS\profile.
    SAPSYSTEMNAME = PLL
    SAPSYSTEM = 11
    INSTANCE_NAME = ERS11
    
    DIR_CT_RUN = $(DIR_EXE_ROOT)\$(OS_UNICODE)\NTAMD64
    DIR_INSTANCE = <drive>:\usr\sap\$(SAPSYSTEMNAME)\$(INSTANCE_NAME)
    DIR_EXECUTABLE = $(DIR_INSTANCE)\exe
    DIR_PROFILE = $(DIR_INSTALL)/profile
    _PF = $(DIR_PROFILE)\PLL_ERS11_sapershost
    
    SAPGLOBALHOST = sapscshost
    SAPLOCALHOST = sapershost
    
    #----------------------------------------------------------------
    # Copy SAP Executables
    #----------------------------------------------------------------
    _CPARG0 = list:$(DIR_CT_RUN)/scs.lst
    Start_Program_01 = immediate $(DIR_CT_RUN)\sapcpe$(FT_EXE) pf=$(_PF)
    $(_CPARG0)
    #-----------------------------------------------------------------
    # Settings for enqueue monitoring tools (enqt, ensmon)
    #-----------------------------------------------------------------
    enque/process_location = REMOTESA
    rdisp/enqname = $(rdisp/myname)
    
    #-----------------------------------------------------------------
    # standalone enqueue details from (A)SCS instance
    #-----------------------------------------------------------------
    SCSID = 01
    SCSHOST = sapscshost
    enque/serverinst = $(SCSID)
    enque/serverhost = $(SCSHOST)
    enque/serverport = 32$(SCSID)
    
    enque/enrep/poll_interval = 0
    enque/enrep/poll_timeout = 120
    enque/enrep/inactive_action = sleep
    
    #-----------------------------------------------------------------
    # Start enqueue replication server
    #-----------------------------------------------------------------
    _ER = $(DIR_EXECUTABLE)\enrepserver$(FT_EXE)
    Start_Program_02 = local $(_ER) pf=$(_PFL) NR=$(SCSID)
    

    For DIR_CT_RUN in this ERS profile, take the value DIR_CT_RUN from the (A)SCS instance profile. If the (A)SCS instance has not configured DIR_CT_RUN in its profiles, take the value specified for DIR_EXECUTABLE from the (A)SCS instance profile.

    It is essential that the binaries from (A)SCS and ERS instance are from the same binary set.

  5. Use the sapstartsrv.exe command to create an SAP Windows Service for the Enqueue Replication Server instance.
  6. Start the SAP instance for the Enqueue Replication Server. Ensure that the instance starts successfully.

    The SAP instance is now ready for clustering and to control the life time of Enqueue Replication Server using VCS.