Agents Administration - Tests
 

Default Parameters for SapWasComponentTest

This test automatically discovers the applications and services on a target SAP WAS, and reports the current health and operational state of each application and service.

This page depicts the default parameters that need to be configured for the SapWasComponentTest test.

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

  • 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.

  • 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 the OS PASSWORD by retyping it in the CONFIRM PASSWORD text box.

  • Set the SSL 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.

  • Startup modes determine how your application is started on the J2EE Engine. By default, this test monitors only those applications that automatically start whenever the J2EE engine is restarted – i.e., those applications for which the startup mode is set to Always. This is why, the STARTUP MODE flag is set to Always by default. Alternatively, you can set this flag to Manual. In this case, the test will monitor only those applications for which the startup mode is set to Manual - i.e., all applications that will require a manual start whenever the J2EE engine is restarted. You can also set this flag to Lazy, so that the test monitors only those applications for which the startup mode is set to Lazy. These are applications that will be stopped upon restart of the J2EE engine, and which will start only when another application requests a resource from it.

  • Provide a comma-separated list of applications and/or services that you want the test to monitor in the INCLUDE APPS/SERVICES tet box. Note that you can provide the whole/part of an application/service name here. When providing the complete application/service name, make sure that the exact application/service name is provided here. If a part of an application/service name is provided, then all applications and services that embed that string will be monitored.

  • Provide a comma-separated list of applications and/or services that you want the test to exclude from monitoring in the EXCLIDE APPS/SERVICES text box. Note that you can provide the whole/part of an application/service name here. When providing the complete application/service name, make sure that the exact application/service name is provided here. If a part of an application/service name is provided, then all applications and services that embed that string will be excluded from monitoring.

  • Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.

When changing default configurations of tests, the values with “$” indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to “xyz” and $port will be changed to “80” when configuring a test.