SAP Host Control Management Pack for Microsoft System Center Operations...

OZSoft Consulting Corporation

http://www.ozsoft-consulting.com

SAP Host Control Management Pack for Microsoft System Center Operations Manager Installation and User’s Guide

Version 4.3.3 October 20, 2017

SAP Management Pack for Microsoft System Center Operations Manager

Installation and User’s Guide 2

Table of Contents About this publication....................................................................................................................................................................... 4

Introduction ...................................................................................................................................................................................... 5

Architecture ...................................................................................................................................................................................... 6

Installation requirements ................................................................................................................................................................. 7

Microsoft System Center Operations Manager ........................................................................................................................... 7

SAP Host Control Agent ............................................................................................................................................................... 7

Configuring Protected Web Methods ..................................................................................................................................... 7

Web Methods Used by the Management Pack ....................................................................................................................... 8

Watcher Nodes ............................................................................................................................................................................ 8

Installing Management Pack ............................................................................................................................................................. 9

Importing Management Pack into Operations manager ............................................................................................................. 9

Configuring Management Pack ....................................................................................................................................................... 10

Define new SAP System ............................................................................................................................................................. 10

Delete SAP System ..................................................................................................................................................................... 11

Testing System Connections ...................................................................................................................................................... 12

Troubleshooting ......................................................................................................................................................................... 14

Using Management Pack ................................................................................................................................................................ 15

Discovery .................................................................................................................................................................................... 15

SAP Systems and Components Navigation ................................................................................................................................ 15

SAP Systems .......................................................................................................................................................................... 15

Application Servers ............................................................................................................................................................... 16

Java Processes ....................................................................................................................................................................... 16

J2EE Engines .......................................................................................................................................................................... 17

Databases .............................................................................................................................................................................. 17

Access Points ......................................................................................................................................................................... 18

File Systems ........................................................................................................................................................................... 18

Alerts ..................................................................................................................................................................................... 19

Monitoring ................................................................................................................................................................................. 19

Configuration ............................................................................................................................................................................. 20

Data warehouse Publishing ................................................................................................................................................... 20

Agent Log Alerts .................................................................................................................................................................... 21

Contact Information ....................................................................................................................................................................... 22



Table of Figures Figure 1. Management Pack Architecture ........................................................................................................................................ 6 Figure 2. SAP System Configurations .............................................................................................................................................. 10 Figure 3. Defining new SAP System ................................................................................................................................................ 10 Figure 4. Assigning Watcher Node .................................................................................................................................................. 11 Figure 5. Assign Watcher Node ....................................................................................................................................................... 12 Figure 6. Host Agent Connection Testing ........................................................................................................................................ 12 Figure 7. Host Agent Connection Test Success Output ................................................................................................................... 13 Figure 8. Host Agent Connection Test Failure Output .................................................................................................................... 13 Figure 9. Management Pack Windows Event Log ........................................................................................................................... 14 Figure 10. SAP Systems ................................................................................................................................................................... 15 Figure 11. App Server Properties .................................................................................................................................................... 16 Figure 12. Java Processes ................................................................................................................................................................ 16 Figure 13. J2EE Engine Properties ................................................................................................................................................... 17 Figure 14. Databases ....................................................................................................................................................................... 17 Figure 15. Access Points .................................................................................................................................................................. 18 Figure 16. File Systems .................................................................................................................................................................... 18 Figure 17. Agent Log Alerts ............................................................................................................................................................. 19 Figure 18. Agent Log Alert Rules ..................................................................................................................................................... 21 Figure 19. Agent Log Alert Rule Override........................................................................................................................................ 21



About this publication This book provides instructions for installing, configuring and operating OZSoft SAP Host Control Management Pack for

Microsoft System Center Operations Manager.



Introduction OZSoft SAP Host Control Management Pack for Microsoft System Center Operations Manager (SCOM) is an add-on to SAP

Management Pack that enables the monitoring of SAP Landscape utilizing SAP Host Control Infrastructure.

SAP Host Control Agents implement OS-level control and monitoring of local SAP Services, such as Internet Connection

Manager (ICM), J2EE Engines, Java Processes and DB Components.

The Base SAP Management Pack is required to be installed and licensed to use this Add-On Management pack.

The Management Pack does not require any additional software besides SCOM and SAP Host Control Agents.

OZSoft SAP Host Control Management Pack enhances SAP Management Pack, extending its reach beyond CCMS and supporting

non-ABAP SAP Systems without the need for Solution Manager.



Architecture The SAP Host Control Management Pack takes advantage of SAP Host Agent infrastructure and covers availability and

performance monitoring of non-ABAP SAP Services.

The diagram below illustrates how the Management Pack fits into SCOM Architecture.

Figure 1. Management Pack Architecture

SAP Host Control Management Pack is delivered as Management Pack Bundle and is imported into SCOM as a regular

Management Pack.

The Management Pack utilizes SAP Host Control Web Services interface and monitors SAP Host Agents remotely.

The Host Control Management Pack is complementary to the core SAP Management Pack and can be used to monitor SAP via

Host Control interface concurrently with CCMS or the stand-alone non-ABAP SAP Systems (such as Java AS).

Management Server

Operations Consoles

Managed Computers, Devices and Applications

SAP

Ho

st M

P

SAP Connector

Operations Manager Database & Data Warehouse

SAP

MP



Installation requirements

Microsoft System Center Operations Manager Microsoft System Center Operations Manager 2012 SP1 or R2 or 2016 RTM

SAP Host Control Agent Host Control Agent version 7.00, Patch 96 or later.

SAP Host(s) User Account(s) authorized to communicate with SAP Host Agents:

For Microsoft Windows we recommend using a single domain user for all Host agents.

The user account(s) must be a member of:

On Linux: sapinst group

On Windows: SAP_LocalAdmin group

The web services provided by the SAP host agent are protected and can only be used by an authenticated caller. To

authorize users to access SAP host agent services the following need to be performed for all hosts to be monitored:

1. Open the following file:

Under Linux: /usr/sap/hostctrl/exe/host_profile

Under Microsoft Windows: C:\Program Files\SAP\hostctrl\exe\host_profile

2. Add the following parameter: service/admin_users

3. Add admin users as parameter values separated by a blank space (for example service/admin_users =<user1>

<user2> <user3>)

On Unix : service/admin_users = <user1> <user2>

On Windows : service/admin_users = [domain\]<user1> [domain\]<user2>

Save.

4. Restart SAP Host Agent with:

On Linux: /usr/sap/hostctrl/exe/saphostexec -restart

On Windows: C:\Program Files\SAP\hostctrl\exe\saphostexec.exe -restart

5. Test access by running the following command:

a. Log in as <sid>adm

b. Open command line prompt

c. On Linux: run - sapcontrol -nr <sys nr> -prot GSOAP_HTTP -user <user name> <user

password> -function GetAccessPointList

on Windows: run - sapcontrol -nr <sys nr> -prot GSOAP_HTTP -user <[domain\]user

name> <user password> -function GetAccessPointList

Configuring Protected Web Methods

Host Agent protected methods are only allowed to be executed by the users in service/admin_users list. A successful

authentication is required.

Parameter service/protectedwebmethods in the Host Profile file controls the list of protected methods. Individual modules can

be added or removed from one of four different predefined settings:

[ALL|SDEFAULT|DEFAULT|NONE] [+/-<method1>... +/-<methodN>]

ALL- All methods are protected.

SDEFAULT - Almost all methods are protected. However, an authentication-free initial display of a system in SAP

MMC/MC is still allowed, for example.

DEFAULT - Protects all methods that change the status of the system. However, authentication-free access to traces is

permitted.



NONE - No methods are protected.

‘+’ – add a method to the protected list

‘-‘ – remove a method form the protected list

SAP recommends using SDEFAULT value.

Web Methods Used by the Management Pack

GetInstanceProperties

GetVersionInfo

GetSystemInstanceList

GetProcessList

GetQueueStatistic

GetAccessPointList

AnalyseLogFiles

J2EEGetProcessList2

J2EEGetVMHeapInfo

J2EEGetSessionList

J2EEGetWebSessionList2

J2EEGetEJBSessionList

J2EEGetComponentList

J2EEGetSharedTableInfo

J2EEGetCacheStatistic2

Watcher Nodes SCOM 2012 (R2)/2016 Management servers and Agents can be selected as watcher nodes. However, only SAP Host Control MP

Workflows can run on SCOM Agents. The core SAP MP workflows that deal with the data inserted by SAP Connector require DB

connection and can’t run on the Agents.

For SAP Host Control MP only the SCOM Agents, running on Windows Server 2012 or 2016, are supported. SCOM Agents

running on Windows Server 2008 R2 and earlier run as CRL .NET 2.0 and unable to load Host Control MP’s Managed Module

which requires .NET 4.0 or later.



Installing Management Pack

Importing Management Pack into Operations manager In the installation folder (C:\Program Files\OZSoft Consulting Corporation\SAP Management Pack) find scom sub-folder. In this

folder you will find ozsoft.host.mpb, ozsoft.host.monitoring.mp and ozsoft.host.dw.mp files.

Import these files into SCOM using Operations Console.



Configuring Management Pack

Define new SAP System 1. Log on to the Windows computer where the SAP Management Pack Connector is installed.

2. Launch the Management Pack Configuration.

3. Switch to SAP Tab to configure SAP System connections

Figure 2. SAP System Configurations

4. Add a new SAP configuration - click (New) button in SAP System tab.

Figure 3. Defining new SAP System



5. Check Host Agent Only box:

6. Fill System ID, Host Name (or IP-address) and System Number fields. You can select the host name of any of SAP

System’s Application Servers - the Management Pack will discover all other Application Servers.

7. Click OK, the Save the configuration.

8. Make sure SAP Connector Service is running and wait for a few minutes (usually 5 minutes as configured in Failover

synchronization) until the SAP Connector creates the entry in SCOM.

9. Launch Operations Console, using an Account with Administrator role assigned.

10. Verify that the newly configured system appears in SAP\SAP System view

11. Switch to Administration Panel

12. Create Run As Account

a. Choose Simple Authentication Type

b. Fill in user and password for the existing OS account as described in SAP Host Control Agent Requirements

c. Save the Run As Account

13. Assign Run As Account to Profile

a. Select Profiles and edit SAP Host Control Monitoring Account profile properties.

b. Add previously created Run As Account to the profile, selecting either an the relevant SAP System or a

Group

c. Save the profile

14. Switch to Monitoring Panel

15. Assign Watcher Node:

a. Under SAP Connector folder click on Administration view

Figure 4. Assigning Watcher Node

b. Select the SAP System from the list

c. Select Watcher Node from the drop-down. This can be either a Resource Pool or a specific SCOM

Management Server. The Watcher Node determines where all SAP System’s Workflows will be executed.

You can also use this interface to assign SAP System monitored by SAP Connector to a specific Management

Server or a resource pool

d. Click Update button

16. The configuration is now complete. The Management Pack will perform the discovery of SAP System components,

which can take up to 15 minutes depending on the system configuration.

Delete SAP System 1. Launch Operations Console, using an Account with Administrator role assigned.



2. Under SAP Connector folder click on Administration view

Figure 5. Assign Watcher Node

3. Check the box for the SAP System(s) to be deleted

4. Click on Delete button

Testing System Connections The Management Pack includes Host Agent Connection testing task:

Figure 6. Host Agent Connection Testing

Select am SAP system with previously configured Run As account. Click on Host Agent Connection Test task.



A successful test will produce output with the test results:

Figure 7. Host Agent Connection Test Success Output

If the configured user is not authorized to perform the restricted Host Agent method, the following result will show:

Figure 8. Host Agent Connection Test Failure Output



Troubleshooting The Management Pack uses Windows Event Log is used to log the errors. Look for the events in Applications and Services

Logs\Operations Manager as seen in the figure below:

Figure 9. Management Pack Windows Event Log

The events related to SAP Host Control Management Pack typically have Source name starting with “SAP…”



Using Management Pack

Discovery The Management Pack discoveries are performed automatically - no manual configuration or actions are required.

SAP Systems and Components Navigation The Host Control Management Pack re-uses SAP Management Pack folders and views. Operating this Management Pack is

completely transparent and complimentary to SAP Management Pack.

SAP Systems

The Management Pack discovers the actual Management Server the SAP System objects’ workflows are executed:

Figure 10. SAP Systems



Application Servers

The Management Pack discovers all configured Application Servers

Figure 11. App Server Properties

Java Processes

The Management Pack discovers all defined Java Processes such as J2EE Engine (server<n>), ICM, Dispatcher and SDM.

Figure 12. Java Processes



J2EE Engines

The Management Pack discovers J2EE Engines and their relationship to the java Processes:

Figure 13. J2EE Engine Properties

Databases

The Management Pack discovers SAP databases such as Oracle, SQL Server, DB2, HANA, Sybase ASE and SAP DB (MaxDB):

Figure 14. Databases



Access Points

For each Application Server the Management Pack discovers and monitors all configured Access Points:

Figure 15. Access Points

File Systems

The Management Pack discovers App Servers’ File system:

Figure 16. File Systems



Alerts

SAP Host Management Pack introduces Host Agent Log Monitoring integrates host SAP log files and traces into SCOM. The

Management Pack periodically scans all log files and generates SCOM Alerts for the new entries:

Figure 17. Agent Log Alerts

Monitoring The Management Pack includes a number of Performance and Availability monitors. Please use Health Explorer for specific

objects to view the associated monitors’ Knowledge Articles for more details. Please see objects’ Performance View for the full

list of collected Performance Counters. Custom monitors can be easily added per request.

Target Object Monitor Name Description Enabled

App Server CPU Load Average App Server CPU 5 Minutes Load Average Monitor

App Server CPU User App Server CPU Application Programs Utilization %

App Server ICM Queue Size App Server ICM Queue Size •

App Server Browser Sessions J2EE Open Browser Session Count Monitor

App Server J2EE Threads J2EE Thread Count Monitor

Application Server Performance Java AS Browser Session Count Monitor •

Application Server Performance Java AS Thread Count Monitor •

J2EE Engine Performance Active Requests per J2EE Application •

J2EE Engine Performance Total Requests (since reset) per J2EE Application •

J2EE Engine Performance Active Requests per J2EE Application

J2EE Engine Performance Total Requests (since reset) per J2EE Application

Java Process Error Count SAP J2EE Process Error Count Monitor •

Java Process Heap Status SAP J2EE Process VM Heap Status Monitor •

Java Process Cache Size SAP J2EE Cache Size Monitor •

J2EE Application Status SAP J2EE Application Status Monitor •

J2EE Service Status SAP J2EE Service Status Monitor •

DB CPU 5 Minute Load-Average DB CPU 5 Minute Load-Average Monitor

DB Status DB Availability Monitor(status Running) •

DB CPU User DB CPU Application Programs Utilization %



Table 1. Management Pack Monitors

Configuration All performance counter collection rules are enabled by default, howvere you might chose to override specific Monitors, Data

Warehouse publishing and Alert Collection rules.

Data warehouse Publishing

Please override required rules enabling the specific performance counter Data Warehouse publishing:

Target Object Name Description

Application Server J2EE BrowserSessions DW Collection Rule Writing App Server J2EE BrowserSessions Performance Counter to DW DB

Application Server J2EE Threads DW Collection Rule Writing App Server J2EE Threads Performance Counter to DW DB

J2EE Engine J2EESession EJB ResponseTime DW Collection Rule Writing EJBSession ResponseTime Performance Counter to DW DB

J2EE Engine J2EESession EJB ActiveRequests DW Collection Rule Writing EJBSession ActiveRequests Performance Counter to DW DB

J2EE Engine J2EESession EJB MaxSessionSize DW Collection Rule Writing EJBSession MaxSessionSize Performance Counter to DW DB

J2EE Engine J2EESession CorruptedSessionCount DW Collection

Rule Writing J2EESession CorruptedSessionCount Performance Counter to DW DB

J2EE Engine J2EESession TotalSessionCount DW Collection Rule Writing J2EESession TotalSessionCount Performance Counter to DW DB

J2EE Engine J2EESession WebSessionCount DW Collection Rule Writing J2EESession WebSessionCount Performance Counter to DW DB

J2EE Engine J2EESession Web Active Requests DW Collection

Rule Writing WebSession ActiveRequests Performance Counter to DW DB

J2EE Engine J2EESession Web MaxSessionSize DW Collection

Rule Writing WebSession MaxSessionSize Performance Counter to DW DB



Agent Log Alerts

Please override rules Host Log Files Alert Generator (suppressed) or Host Log Files Alert Generator in order to enable them:

Figure 18. Agent Log Alert Rules

The rules’ override-able properties also support filtering based on Log File Name and Severity:

Figure 19. Agent Log Alert Rule Override



Contact Information You can contact OZSoft Consulting at the following e-mails addresses:

Technical support: [email protected]

Sales and Marketing: [email protected]

You can also visit our web site at http://www.ozsoft-consulting.com for more information about OZSoft Consulting Corporation,

the SAP Performance Management Specialist

mailto:[email protected]

mailto:[email protected]

http://www.ozsoft-consulting.com/

SAP Host Control Management Pack for Microsoft System Center Operations...

Documents

Transcript of SAP Host Control Management Pack for Microsoft System Center Operations...