SAP WAS Enqueue Replication Test

The Enqueue server keeps critical data (i.e., all locks currently in use by the users in the System) in the lock table in the main memory of the system. If the host fails, this critical data would be lost and cannot be restored even when the Enqueue server was restarted. All transactions that have held locks too should therefore be reset.

For this reason, the Enqueue Replication Server is hosted on another host which together with the Standalone Enqueue server provides a high availability situation.

In environments where critical data is maintained, it is essential for the server to be available round the clock and it is also essential for the Enqueue server to be highly available. For this, it is necessary to monitor if the Enqueue Replication server is enabled at all times and the HA polling interface is properly configured between the Enqueue Replication server and the Enqueue server. The SAP WAS Enqueue Replication test helps administrators in this regard!

This test reports whether the Enqueue Replication server is enabled and active. This test also helps administrators to determine if the HA polling interface between the Enqueue Replication Server and the Enqueue Server is configured or not.

Target of the test : A SAP Netweaver Application Server

Agent deploying the test : An internal/remote agent

Outputs of the test : One set of results for the target SAP Web Application server being monitored.

Configurable parameters for the test
Parameter Description

Test period

How often should the test be executed

Host

Specify the server for which the test is to be configured.

Port

The port number at which the specified server listens.

WSDL Port

This test uses the SAPControl web service to pull metrics on application and service status. To enable the test to communicate with the web service, you need to configure the test with the port number of the web service. Therefore, specify the port number of the SAPControl web service against WSDL Port. To determine the exact port number of the SAPControl web service, you can look up the etc/services file on the SAP WAS being monitored. If the port number is not declared in the etc/services file, you can specify the default port number of the web service against WSDL Port. If the web service is not SSL-enabled, then the default port number of the web service will be: 5<NR>13. Similarly, if the web service is SSL-enabled, then the default port number of the web service will be: 5<NR>14. <NR> in the port number refers to the system number of the SAP server being monitored. The system number is an indicator of the TCP/IP port at which the SAP server listens. For example, for a server that listens at port 3200, the system number will be ‘00’. Similarly, if the SAP server port is 3201, the system number will have to be specified as ‘01’. Accordingly, the default port number of an SSL-enabled SAPControl web service will be 50014 , if the system number is 00, or 50114, if the system number is 01.

OS Username and OS Password

To enable the test to access the SAPControl web service and determine component state, you need to configure the OS Username and OS Password parameters of the test with the credentials (i.e., name and password) of an OS user, who fulfills one of the following conditions:

  • The name of the OS user should be declared using the service\admin_users profile parameter; (OR)
  • The name of the user group to which the OS user belongs should be declared using the service\admin_groups profile parameter; (OR)
  • The OS user should have the permission to execute the sapstartsrv executable

Confirm Password

Confirm the OS Password by retyping it here.

SSL

Set this flag to Yes, if the SAPControl web service is SSL-enabled. Set this flag to No, if the SAPControl web service is not SSL-enabled.

DD Frequency

Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD Frequency. 

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Is enabled?

Indicates whether/not the Enqueue Replication Server was enabled.

 

The values reported by this measure and its numeric equivalents are mentioned in the table below:

Measure value Numeric Value
Yes 1
No 0

Note:

By default, this measure reports the Measure Values listed in the table above to indicate whether/not the Enqueue Replication Server was enabled. The graph of this measure however, is represented using the numeric equivalents only i.e., 0 or 1.

Is active?

 

Indicates whether/not the Enqueue Replication Server was active.

 

 

The values reported by this measure and its numeric equivalents are mentioned in the table below:

Measure value Numeric Value
Yes 1
No 0

Note:

By default, this measure reports the Measure Values listed in the table above to indicate whether/not the Enqueue Replication Server was active. The graph of this measure however, is represented using the numeric equivalents only i.e., 0 or 1.

is the HA polling interface configured?

Indicates whether/not the HA polling interface between the Enqueue Replication Server and the Enqueue Server was configured.

 

The values reported by this measure and its numeric equivalents are mentioned in the table below:

Measure value Numeric Value
Yes 1
No 0

Note:

By default, this measure reports the Measure Values listed in the table above to indicate whether/not the HA polling interface between the Enqueue Replication Server and the Enqueue Server was configured. The graph of this measure however, is represented using the numeric equivalents only i.e., 0 or 1.