SAP products discovery

ITOM Visibility can discover SAP applications, SAP HANA Database, and SAP HANA DB Catalog. Discovering some of these resources may require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.

Request new or enhanced Patterns on the ServiceNow® Store

Visit the ServiceNow Store to view all the available updates and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.

To learn about the SAP components and their versions that you can discover, refer to Detailed information on products discovered by ITOM Visibility.

Prerequisites

• Verify that the applications are up to date

  Discovery and Service Mapping Patterns

  Visibility Content

  CMDB CI Class Models

• Verify the configuration of the credentials

  • (If hosted on a UNIX server) On the ServiceNow AI Platform, configure applicative credentials and SSH credentials. The SSH credentials are used to create connections from SAP Central Instance (CI) to other applications and devices. In addition, provide the user elevated rights to be able to run commands requiring a privileged user: Service Mapping commands requiring a privileged user.
  • (If hosted on a Windows server) On the ServiceNow AI Platform, configure Windows credentials to create connections from SAP CI to other applications and devices.
  • (Optional) For discovering using the WinRM protocol, see Configure WinRM trusted hosts on MID Server.
  • (Optional for top-down discovery by Service Mapping) Provide a user with permissions to run SOAP on RFC read table function.
  • (Optional for top-down discovery by Service Mapping) If your organization deploys SAP Digital Business Services using web services and you want to map all connected services, perform the following actions:
    • Configure applicative credentials for a user with permissions to access the following tables: CVERS, DBCONS, and RFCDES.
    • Ensure that you have the web service URL. For information on how to create web services, see https://blogs.sap.com/2012/10/24/how-to-create-web-services-abap-based/.

• SAP HANA 2.0 DB Catalog on UNIX

  Verify that the Applicative Credentials for SAP HANA DB App Creds are configured with SAP Hana Db [cmdb_ci_appl_sap_hana_db] as CI type.

• Verify the permissions to run Service Mapping commands

  Service Mapping commands not requiring a privileged user

• Verify the user has the permissions to run the Patterns queries

  The following commands are executed when running the SAP HANA DB and SAP HANA DB Catalog Patterns.

  • select * from schemas;
  • select * from M_HOST_INFORMATION where upper(KEY) like '%TIMEZONE%';
  • select SCHEMA_NAME, round(sum(TABLE_SIZE) /1024/1024) from M_TABLES GROUP BY SCHEMA_NAME

• Verify the configuration of the Discovery schedule

  For more information, see Running discoveries in your network

Data collected by Discovery during horizontal discovery

Data collected by the SAP HANA DB Catalog on UNIX pattern during horizontal discovery

CI Relationships

The SAP SID shared library pattern creates CI relationships between all major CI applications and SAP System ID.

• SAP HANA DB Catalog on UNIX CI relationships

  CI	Relationship	CI
  SAP HANA DB [cmdb_ci_appl_sap_hana_db]	Contains::Contained by	SAP HANA DB Catalog [cmdb_ci_db_hana_catalog]

Limitations

Service Mapping can map only one instance of ASCS per deployment.

The SAP HANA DB Catalog pattern can only run on UNIX.

Parent Topic:Software discovery

Map application services containing SAP applications

Map a service instance containing an SAP application and verify that Service Mapping discovered all SAP components correctly.

Before you begin

Role required: service_mapping_admin

Procedure

1. Create a service instance.

   1. Navigate to All > Service Mapping > Service Instances.

   2. Select New.

      The Discoverable by Service Mapping option is selected by default.

   3. In the Name field, enter a descriptive name for the service instance.

2. Define the entry point for this application service:

   1. Select the SAP application tile.

      The Discoverable by Service Mapping option is selected by default.

   2. Define the entry point as follows:

      • A URL to any SAP module
      • A TCP connection to any SAP module

      • To discover environments with connected services, provide the URL to the web service in the following format:

         http://<hostname>:<port>/sap/bc/srt/scs/sap/z_servicenow_read?sap-client=003
        

   3. Select Add.

   4. Select Save.

3. Select Additional Info on the left and clear the Traffic based discovery check box.

4. Select Update.

5. Verify that the mapping result is satisfactory:

   1. Select View Map and wait until the mapping is complete.

      It may take a few minutes.

   2. Review the application service map and make sure that the service layout is as in the following examples.

If the SAP environment integrates SAP components with Tibco services, you can expect this mapping result:

Troubleshoot application services containing SAP applications

Fix basic discovery issues based on the symptoms and discovery messages.

Symptom

The application service map in Service Mapping displays the following message Failed to discover <SAP component name>.

Cause

The CI failed to identify, and process detection retrieves the process attributes.

Solution

Perform the following steps:

1. Open the failed pattern step in Debug mode:

   1. On the business service or service instance map, right-click the error message and select Show discovery log.

      The Discovery Log window opens.

   2. In the right pane, locate the failed identification section and the failed step within this section.

   3. Select this failed identification section and click Debug.

      The Debug Identification Section window opens.

   4. If necessary, fill in the required details and click Connect.

   5. Click the set variables step under Steps.
   6. Make sure that the regular expression includes SYS as shown in the following figure.

1. Click the set install_dir step under Steps.
2. Make sure that the regular expression includes sap as shown in the following graphic.

Symptom

Service Mapping fails to discover the web service your organization uses to deploy SAP digital business services.

Cause 1

The pattern fails at the EVAL function for identifying the web service.

Solution 1

1. Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
2. Verify that you configured the necessary applicative credentials as described in the mapping procedure.
3. Check that the discovery log contains the following message: GROOVE_CODE_FAILURE: No such property: com for class: Script1.

4. Open the failed pattern step in Debug mode:

   1. On the business service or service instance map, right-click the error message and select Show discovery log.

      The Discovery Log window opens.

   2. In the right pane, locate the failed identification section and the failed step within this section.

   3. Select this failed identification section and click Debug.

      The Debug Identification Section window opens.

   4. If necessary, fill in the required details and click Connect.

   5. Pattern Designer opens showing the selected identification section.
   6. Select the failed step on the right.
   7. Verify that the function running on EVAL is com.snc.sw.util.HttpInvokerUtil.post.

1. Try to map the application service again and check the result.

Cause 2

The pattern fails at the EVAL function for identifying the web service, because the web service was configured incorrectly.

Solution 2

1. Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
2. Verify that you configured the necessary applicative credentials as described in the mapping procedure.
3. Check that the discovery log contains the following message: "Debug run railed: Test step failed. GROOVE_CODE_FAILURE: All command implementations (HTTP) failed on host 10.x.x.x. Host must be down or unreachable. ()"
4. Recreate the web service as described in https://blogs.sap.com/2012/10/24/how-to-create-web-services-abap-based/.
5. Try to map the application service again and check the result.

Cause 3

The pattern fails at the EVAL function for identifying the web service, because the URL configured in the entry point is not correct or because the MID Server cannot access this URL.

Solution 3

1. Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
2. Verify that you configured the necessary applicative credentials as described in the mapping procedure.
3. Check that the discovery log contains the following message: "Debug run railed: Test step failed. GROOVE_CODE_FAILURE: All command implementations (HTTP) failed on host 10.x.x.x. Host must be down or unreachable. ()"
4. Verify that you used the correct URL for the service entry point:
   1. In the TCode SOAMANAGER, navigate to Simplified Web Service Configuration.
   2. On the Configuration tab of the Simplified Service Configuration window, search for the web service that is part of the service instance.
   3. Click the check box under User Name/Password (Basic) for this web service.
   4. Click Show Details.
   5. On the Details of the Service Definition window, verify the actual URL of the web service under WSDL URLs.
   6. If necessary, fix the URL you configure for the entry point and try to map the service instance again.

Cause 4

MID Server cannot access this URL configured in the entry point of the service instance.

Solution 4

1. Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
2. Verify that you configured the necessary applicative credentials as described in the mapping procedure.
3. Check that the discovery log contains the following message: "Debug run failed: Test step failed. GROOVE_CODE_FAILURE: All command implementations (HTTP) failed on host 10.x.x.x. Host must be down or unreachable. ()"
4. Verify that you used the MID Server that can access the URL you configured in the service entry point:
   1. Log into the MID Server host remotely.
   2. Open a browser.
   3. Paste the URL into the browser address bar and press Enter.
   4. If the page does not open, it means that there is a network issue, for example, there is a firewall that prevents the MID Server from accessing this URL.
5. Resolve the network issue and verify that the MID Server can access the URL as described in step 4.

Cause 5

MID Server cannot access this URL configured in the entry point of the service instance.

Solution 5

1. Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
2. Verify that you configured the necessary applicative credentials as described in the mapping procedure.
3. Check that the discovery log contains the following message: "Debug run railed: Test step failed. GROOVE_CODE_FAILURE: All command implementations (HTTP) failed on host 10.x.x.x. Host must be down or unreachable. ()"

4. Verify that the applicative credentials you configured on the ServiceNow AI Platform for the web service are valid:

   1. Log into the MID Server host remotely.
   2. Open a browser.
   3. Paste the URL into the browser address bar and press Enter.
   4. The browser page displays the credentials pop-up window.

   5. Enter the credentials and check that the page opens.

      The page does not open, it means that the configured applicative credentials are incorrect.

5. Find out the right credentials.

6. Verify the new credentials as described in step 4.
7. If the page opens after you use the new credentials, configure these credentials as applicative credentials on the ServiceNow AI Platform.

Cause 6

MID Server cannot access this URL configured in the entry point of the service instance.

Solution 6

1. Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
2. Check that the discovery log contains the following message: "Debug run railed: Test step failed. GROOVE_CODE_FAILURE: Missing applicative credentials for CI type <name of the CI type>".
3. Verify that you defined applicative credentials for the relevant CI according as described in Map application services containing SAP applications.