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
- 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
The query type Fallback commands executed in order Schemas Info $hdbsql_path + " -n " + $entry_point.ip_address + ":" + $query_port + " -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select * from schemas;\""$hdbsql_path + " -n " + $ip_address + ":" + $query_port + " -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select * from schemas;\""$hdbsql_path + " -n " + $server_name + ":" + $query_port + " -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select * from schemas;\""$hdbsql_path + " -n localhost -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select * from schemas;\""
Time Zone: $hdbsql_path + " -n " + $entry_point.ip_address + ":" + $query_port + " -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select * from M_HOST_INFORMATION where upper(KEY) like '%TIMEZONE%';\""$hdbsql_path + " -n " + $ip_address + ":" + $query_port + " -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select * from M_HOST_INFORMATION where upper(KEY) like '%TIMEZONE%';\""$hdbsql_path + " -n " + $server_name + ":" + $query_port + " -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select * from M_HOST_INFORMATION where upper(KEY) like '%TIMEZONE%';\""$hdbsql_path + " -n localhost -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select * from M_HOST_INFORMATION where upper(KEY) like '%TIMEZONE%';\""
Disk Size $hdbsql_path + " -n " + $entry_point.ip_address + ":" + $query_port + " -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select SCHEMA_NAME, round(sum(TABLE_SIZE) /1024/1024) from M_TABLES GROUP BY SCHEMA_NAME;\""$hdbsql_path + " -n " + $ip_address + ":" + $query_port + " -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select SCHEMA_NAME, round(sum(TABLE_SIZE) /1024/1024) from M_TABLES GROUP BY SCHEMA_NAME;\""$hdbsql_path + " -n " + $server_name + ":" + $query_port + " -i " + $digits + " -u '$$username$$' -p '$$password$$' \"select SCHEMA_NAME, round(sum(TABLE_SIZE) /1024/1024) from M_TABLES GROUP BY SCHEMA_NAME;\""$hdbsql_path + " -n localhost -i " + $digits + " -u '$$username$$' -p '$$password$$' \"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
| Table and field | Description |
|---|---|
| SAP ASCS [cmdb_ci_appl_sap_ascs] | |
| Name [name] | Data collected for SAP ABAP Central Services (ASCS) |
| Version [version] | |
| Installation directory [install_directory] | |
| Configuration directory [config_directory] | |
| Configuration file [confi_file] | |
| Instance name [instance_name] | |
| Instance number [instance_number] | |
| System ID [sid] | |
| System directory [system_directory ] | |
| System type [system_type] | |
| Transport domain [transport_domain] | |
| SAP Business Objects CMS server [cmdb_ci_appl_sap_bo] | |
| Name [name] | Data collected for SAP Business Objects CMS Server |
| Server Name [server_name] | |
| Version [version] | |
| Installation directory [install_directory] | |
| SAP SCS Application [cmdb_ci_appl_sap_scs] | |
| Name [name] | Data collected for SAP Central Services (SCS) |
| Version [version] | |
| Installation directory [install_directory] | |
| Configuration directory [config_directory] | |
| Configuration file [config_file] | |
| Instance name [instance_name] | |
| Instance number [instance_number] | |
| System ID [sid] | |
| System directory [system_directory] | |
| System type [system_type] | |
| Transport domain [transport_domain] | |
| SAP CI Application [cmdb_ci_appl_sap_ci] | |
| Name [name] | Data collected for SAP CI |
| Version [version] | |
| Installation directory [install_directory] | |
| Configuration directory [config_directory] | |
| Configuration file [config_file] | |
| Instance name [instance_name] | |
| Instance number [instance_number] | |
| System ID [sid] | |
| System directory [system_directory] | |
| System type [system_type] | |
| Transport domain [transport_domain] | |
| SAP DI Applications [cmdb_ci_appl_sap_di] | |
| Name [name] | Data collected for SAP Dialog Instance (DI) |
| Version [version] | |
| Installation directory [install_directory] | |
| Configuration directory [config_directory] | |
| Configuration file [config_file] | |
| Instance name [instance_name] | |
| Instance number [instance_number] | |
| System ID [sid] | |
| System directory [system_directory] | |
| System type [system_type] | |
| Transport domain [transport_domain] | |
| SAP ERS Application [cmdb_ci_appl_sap_ers] | |
| Name [name] | Data collected for SAP Enqueue Replication Server (ERS) |
| Version [version] | |
| Installation directory [install_directory] | |
| Configuration directory [config_directory] | |
| Configuration file [config_file] | |
| Instance name [instance_name] | |
| Instance number [instance_number] | |
| System ID [sid] | |
| System directory [system_directory] | |
| System type [system_type] | |
| Transport domain [transport_domain] | |
| HANA Database [cmdb_ci_appl_sap_hana_db] | |
| Name [name] | Data collected for SAP HANA Database |
| IP Address [id_address] | |
| Class [sys_class_name] | |
| Fully qualified domain name [fqdn] | |
| Version [version] | |
| Installation directory [install_directory] | |
| SAP SID [cmdb_ci_sap_sid] | |
| Name [name] | Data collected for the SAP System Identification (SID) code is a unique identification code for an SAP R/3 installation. An SID is a three-character code like D10, PRD, or E56. An R/3 installation consists of a database server plus several application servers. ITOM Visibility uses the SAP SID shared library pattern to discover SIDs for SAP applications. |
| Version [version] | |
| Patch Level Info [sap_patch_info] | |
Data collected by the SAP HANA DB Catalog on UNIX pattern during horizontal discovery
| Field | Description |
|---|---|
| Catalog Owner [catalog_owner] | The user ID of the schema owner. |
| Catalog Create Time [catalog_create_time] | The catalog creation time. |
| Disk Allocated Size (MB) [disk_allocated_size_mb] | The allocated Disk size in MB. |
| Database Reference [database_instance] | The reference to the SAP HANA DB. |
CI Relationships
| CI | Relationship | CI |
|---|---|---|
| SAP ERS Application [cmdb_ci_appl_sap_ers] | Uses::Used by | SAP SID [cmdb_ci_sap_sid] |
| SAP DI Applications [cmdb_ci_appl_sap_di] | Uses::Used by | SAP SID [cmdb_ci_sap_sid] |
| SAP ASCS [cmdb_ci_appl_sap_ascs] | Uses::Used by | SAP SID [cmdb_ci_sap_sid] |
| SAP CI Application [cmdb_ci_appl_sap_ci] | Uses::Used by | SAP SID [cmdb_ci_sap_sid] |
| SAP SCS Application [cmdb_ci_appl_sap_scs] | Uses::Used by | SAP SID [cmdb_ci_sap_sid] |
| SAP JC Application [cmdb_ci_appl_sap_jc] | Uses::Used by | SAP SID [cmdb_ci_sap_sid] |
- 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.
Map application services containing SAP applications
Map an service instance containing an SAP applications and verify that Service Mapping discovered all SAP components correctly.
Antes de Iniciar
Procedimento
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
- Open the failed pattern step in Debug mode:
- On the business service or service instance map, right-click the error message and select Show discovery log.
The Discovery Log window opens.
- In the right pane, locate the failed identification section and the failed step within this section.
- Select this failed identification section and click Debug.
The Debug Identification Section window opens.
- If necessary, fill in the required details and click Connect.
- On the business service or service instance map, right-click the error message and select Show discovery log.
- Click the set variables step under Steps.
- Make sure that the regular expression includes
SYSas shown in the following figure. - Click the set install_dir step under Steps.
- Make sure that the regular expression includes
sapas 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
- Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
- Verify that you configured the necessary applicative credentials as described in the mapping procedure.
- Check that the discovery log contains the following message: GROOVE_CODE_FAILURE: No such property: com for class: Script1.
- Open the failed pattern step in Debug mode:
- On the business service or service instance map, right-click the error message and select Show discovery log.
The Discovery Log window opens.
- In the right pane, locate the failed identification section and the failed step within this section.
- Select this failed identification section and click Debug.
The Debug Identification Section window opens.
- If necessary, fill in the required details and click Connect.
- On the business service or service instance map, right-click the error message and select Show discovery log.
- Pattern Designer opens showing the selected identification section.
- Select the failed step on the right.
- Verify that the function running on EVAL is
com.snc.sw.util.HttpInvokerUtil.post. - 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
- Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
- Verify that you configured the necessary applicative credentials as described in the mapping procedure.
- 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. ()"
- Recreate the web service as described in https://blogs.sap.com/2012/10/24/how-to-create-web-services-abap-based/.
- 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
- Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
- Verify that you configured the necessary applicative credentials as described in the mapping procedure.
- 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. ()"
- Verify that you used the correct URL for the service entry point:
- In the TCode SOAMANAGER, navigate to Simplified Web Service Configuration.
- On the Configuration tab of the Simplified Service Configuration window, search for the web service that is part of the service instance.
- Click the check box under User Name/Password (Basic) for this web service.
- Click Show Details.
- On the Details of the Service Definition window, verify the actual URL of the web service under WSDL URLs.
- 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
- Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
- Verify that you configured the necessary applicative credentials as described in the mapping procedure.
- 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. ()"
- Verify that you used the MID Server that can access the URL
you configured in the service entry point:
- Log into the MID Server host remotely.
- Open a browser.
- Paste the URL into the browser address bar and press Enter.
- 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.
- 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
- Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
- Verify that you configured the necessary applicative credentials as described in the mapping procedure.
- 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. ()"
- Verify that the applicative credentials you
configured on the ServiceNow AI Platform for
the web service are valid:
- Log into the MID Server host remotely.
- Open a browser.
- Paste the URL into the browser address bar and press Enter.
- The browser page displays the credentials pop-up window.
- Enter the credentials and check that the page opens.
The page does not open, it means that the configured applicative credentials are incorrect.
- Find out the right credentials.
- Verify the new credentials as described in step 4.
- 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
- Verify that the format of the entry point is the URL to the web service as described in the mapping procedure.
- 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>".
- Verify that you defined applicative credentials for the relevant CI according as described in Map application services containing SAP applications.