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

Last Published:
Product(s): InfoScale & Storage Foundation (7.4.2)
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

Sample configuration in a virtual environment

A sample main.cf configuration in a virtual environment that contains the Enqueue instance, Enqueue Replication instance, Application Server instance, and SMDA instance is as follows:

include "types.cf"

cluster Cluster_59087 (
	SecureClus = 1
	)

system SAPVM21 (
	)

system SAPVM22 (
	)

group SAP_ASCS00 (
	SystemList = { SAPVM21 = 0, SAPVM22 = 1 }
	UserAssoc = { Type = SAPWin, Name = SAP_ASCS00 }
	)

	IP SAP_ASCS00-IP (
		Address = "10.xxx.xx.189"
		SubNetMask = "255.255.252.0"
		MACAddress @SAPVM21 = "00:50:56:B7:18:36"
		MACAddress @SAPVM22 = "00:50:56:B7:21:C3"
		)

	Lanman SAP_ASCS00-Lanman-sapenq (
		VirtualName = sapenq
		IPResName = SAP_ASCS00-IP
		)

	MountV SAP_ASCS00-Mount (
		MountPath = "e:\\usr\\sap\\pi7\\ascs00"
		VolumeName = SCSVOL
		VMDGResName = SAP_ASCS00_SCSDG_VMNSDg
		)

	MountV SAP_ASCS00-Mount-1 (
		MountPath = "e:\\usr\\sap\\pi7\\sys"
		VolumeName = SYSVOL
		VMDGResName = SAP_ASCS00_SCSDG_VMNSDg
		)

	NIC SAP_ASCS00-NIC (
		MACAddress @SAPVM21 = "00:50:56:B7:18:36"
		MACAddress @SAPVM22 = "00:50:56:B7:21:C3"
		)

	SAPWebAS SAP_PI7_ASCS00_res (
		Critical = 0
		SAPAdmin = pi7adm
		SAPAdminDomain = sap-domain
		SAPAdminPassword = GUMsJUjOGmHMiMJmKMl
		SAPHome = "E:\\usr\\sap\\PI7\\ASCS00\\exe"
		SAPHost = sapenq
		SAPServiceUser = SAPServicePI7
		SAPSID = PI7
		InstName = ASCS00
		InstProfile = "\\\\sapenq\\sapmnt\\PI7\\SYS\\profile\\
  PI7_ASCS00_sapenq"
		InstType = ENQUEUE
		ProcMon = { "enserver.exe" }
		)

	VMNSDg SAP_ASCS00_SCSDG_VMNSDg (
		DiskGroupName = SCSDG
		DGGuid = b26580c2-e773-4ca8-9e62-e03e235013c0
		SkipStorageValidation = 1
		)

	VMwareDisks SAP_ASCS00-VMwareDisks (
		ESXDetails = {
			 "vcslx658.vxindia.veritas.com" = "root=GUMsJUjOGmHMiMJ" }
		DiskPaths = {
			 "6000C296-5313-69b0-63f9-f15efcf60d66:[NIMBSHARE] SAP_Win2k8_Vm1
  /SAP_Win2k8_Vm1.vmdk" = "1:8" }
		IsVMHAEnabled = 0
		)

	SAP_PI7_ASCS00_res requires SAP_ASCS00-Lanman-sapenq
	SAP_PI7_ASCS00_res requires SAP_ASCS00-Mount
	SAP_PI7_ASCS00_res requires SAP_ASCS00-Mount-1
	SAP_ASCS00-IP requires SAP_ASCS00-NIC
	SAP_ASCS00-Lanman-sapenq requires SAP_ASCS00-IP
	SAP_ASCS00-Mount requires SAP_ASCS00_SCSDG_VMNSDg
	SAP_ASCS00-Mount-1 requires SAP_ASCS00_SCSDG_VMNSDg
	SAP_ASCS00_SCSDG_VMNSDg requires SAP_ASCS00-VMwareDisks


	// resource dependency tree
	//
	//	group SAP_ASCS00
	//	{
	//	SAPWebAS SAP_PI7_ASCS00_res
	//	    {
	//	    Lanman SAP_ASCS00-Lanman-sapenq
	//	        {
	//	        IP SAP_ASCS00-IP
	//	            {
	//	            NIC SAP_ASCS00-NIC
	//	            }
	//	        }
	//	    MountV SAP_ASCS00-Mount
	//	        {
	//	        VMNSDg SAP_ASCS00_SCSDG_VMNSDg
	//	            {
	//	            VMwareDisks SAP_ASCS00-VMwareDisks
	//	            }
	//	        }
	//	    MountV SAP_ASCS00-Mount-1
	//	        {
	//	        VMNSDg SAP_ASCS00_SCSDG_VMNSDg
	//	            {
	//	            VMwareDisks SAP_ASCS00-VMwareDisks
	//	            }
	//	        }
	//	    }
	//	}


group SAP_ERS10 (
	SystemList = { SAPVM21 = 0, SAPVM22 = 1 }
	UserAssoc = { Type = SAPWin, Name = SAP_ERS10 }
	PreOnline = 1
	)

	IP SAP_ERS10-IP (
		Address = "10.209.69.193"
		SubNetMask = "255.255.252.0"
		MACAddress @SAPVM21 = "00:50:56:B7:18:36"
		MACAddress @SAPVM22 = "00:50:56:B7:21:C3"
		)

	Lanman SAP_ERS10-Lanman-sapers (
		VirtualName = sapers
		IPResName = SAP_ERS10-IP
		)

	NIC SAP_ERS10-NIC (
		MACAddress @SAPVM21 = "00:50:56:B7:18:36"
		MACAddress @SAPVM22 = "00:50:56:B7:21:C3"
		)

	SAPWebAS SAP_PI7_ERS10_res (
		SAPAdmin = pi7adm
		SAPAdminDomain = sap-domain
		SAPAdminPassword = GUMsJUjOGmHMiMJmKMl
		SAPHome = "E:\\usr\\sap\\PI7\\ERS10\\exe"
		SAPHost = sapers
		SAPServiceUser = SAPServicePI7
		SAPSID = PI7
		InstName = ERS10
		InstProfile = "E:\\usr\\sap\\PI7\\SYS\\profile\\PI7_ERS10_sapers"
		InstType = ENQREP
		ProcMon = { "enrepserver.exe" }
		EnqSrvResName = SAP_PI7_ASCS00_res
		)

	SAP_PI7_ERS10_res requires SAP_ERS10-Lanman-sapers
	SAP_ERS10-IP requires SAP_ERS10-NIC
	SAP_ERS10-Lanman-sapers requires SAP_ERS10-IP


	// resource dependency tree
	//
	//	group SAP_ERS10
	//	{
	//	SAPWebAS SAP_PI7_ERS10_res
	//	    {
	//	    Lanman SAP_ERS10-Lanman-sapers
	//	        {
	//	        IP SAP_ERS10-IP
	//	            {
	//	            NIC SAP_ERS10-NIC
	//	            }
	//	        }
	//	    }
	//	}


group SAP_SMDA97 (
	SystemList = { SAPVM21 = 0, SAPVM22 = 1 }
	UserAssoc = { Type = SAPWin, Name = SAP_SMDA97 }
	)

	IP SAP_SMDA97-IP (
		Address = "10.209.69.192"
		SubNetMask = "255.255.252.0"
		MACAddress @SAPVM21 = "00:50:56:B7:18:36"
		MACAddress @SAPVM22 = "00:50:56:B7:21:C3"
		)

	Lanman SAP_SMDA97-Lanman-sapdi (
		VirtualName = sapdi
		IPResName = SAP_SMDA97-IP
		)

	NIC SAP_SMDA97-NIC (
		MACAddress @SAPVM21 = "00:50:56:B7:18:36"
		MACAddress @SAPVM22 = "00:50:56:B7:21:C3"
		)

	SAPWebAS SAP_DAA_SMDA97_res (
		SAPAdmin = daaadm
		SAPAdminDomain = sapvm22
		SAPAdminPassword = GUMsJUjOGmHMiMJmKMl
		SAPHome = "E:\\usr\\sap\\DAA\\SMDA97\\exe"
		SAPHost = sapdi
		SAPServiceUser = SAPServiceDAA
		SAPSID = DAA
		InstName = SMDA97
		InstProfile = "E:\\usr\\sap\\DAA\\SYS\\profile\\DAA_SMDA97_sapdi"
		InstType = SMDA
		ProcMon = { "jstart.exe" }
		)

	SAP_DAA_SMDA97_res requires SAP_SMDA97-Lanman-sapdi
	SAP_SMDA97-IP requires SAP_SMDA97-NIC
	SAP_SMDA97-Lanman-sapdi requires SAP_SMDA97-IP

	// resource dependency tree
	//
	//	group SAP_SMDA97
	//	{
	//	SAPWebAS SAP_DAA_SMDA97_res
	//	    {
	//	    Lanman SAP_SMDA97-Lanman-sapdi
	//	        {
	//	        IP SAP_SMDA97-IP
	//	            {
	//	            NIC SAP_SMDA97-NIC
	//	            }
	//	        }
	//	    }
	//	}
	//	}

group SAP_DVEBMGS01 (
	SystemList = { SAPVM21 = 0 }
	UserAssoc = { Type = SAPWin, Name = SAP_DVEBMGS01, UITimeout = 300 }
	)

	IP SAP_DVEBMGS01-IP (
		Address = "10.209.69.191"
		SubNetMask = "255.255.252.0"
		MACAddress @SAPVM21 = "00:50:56:B7:18:36"
		)

	Lanman SAP_DVEBMGS01-Lanman-sapapp (
		VirtualName = sapapp
		IPResName = SAP_DVEBMGS01-IP
		)

	NIC SAP_DVEBMGS01-NIC (
		MACAddress @SAPVM21 = "00:50:56:B7:18:36"
		)

	SAPWebAS SAP_PI7_DVEBMGS01_res (
		SAPAdmin = pi7adm
		SAPAdminDomain = sap-domain
		SAPAdminPassword = gumSjuJogMhmImjMkmL
		SAPHome = "E:\\usr\\sap\\PI7\\DVEBMGS01\\exe"
		SAPHost = sapapp
		SAPServiceUser = SAPServicePI7
		SAPSID = PI7
		InstName = DVEBMGS01
		InstProfile = "\\\\sapenq\\sapmnt\\PI7\\SYS\\profile\\
  PI7_DVEBMGS01_sapapp"
		ProcMon = { "disp+work.exe" }
		)

	requires group SAP_ASCS00 online global soft
	SAP_PI7_DVEBMGS01_res requires SAP_DVEBMGS01-Lanman-sapapp
	SAP_DVEBMGS01-IP requires SAP_DVEBMGS01-NIC
	SAP_DVEBMGS01-Lanman-sapapp requires SAP_DVEBMGS01-IP


	// resource dependency tree
	//
	//	group SAP_DVEBMGS01
	//	{
	//	SAPWebAS SAP_PI7_DVEBMGS01_res
	//	    {
	//	    Lanman SAP_DVEBMGS01-Lanman-sapapp
	//	        {
	//	        IP SAP_DVEBMGS01-IP
	//	            {
	//	            NIC SAP_DVEBMGS01-NIC
	//	            }
	//	        }
	//	    }
	//	}
		

group VCSInfraSG (
	SystemList = { SAPVM21 = 0, SAPVM22 = 1 }
	UserAssoc = { Type = "vcs internal",
		 Name = "VCS Infrastructure service group" }
	Parallel = 1
	AutoStartList = { SAPVM21, SAPVM22 }
	OnlineRetryLimit = 5
	)

	Process VCSNotifySinkRes (
		StartProgram = "C:\\Program Files\\Veritas\\Cluster Server\\bin
  \\notify_sink.exe"
		StartupDirectory = "C:\\Program Files\\Veritas\\Cluster Server\\bin"
		)



	// resource dependency tree
	//
	//	group VCSInfraSG
	//	{
	//	Process VCSNotifySinkRes
	//	}