This chapter provides information to assist you in troubleshooting integration issues with the ServiceNow Connector. The connector cannot function unless the appropriate components have been installed and configured.
Note:
Refer to the OMS logs to identify the exact error ID, if needed.Before you start the troubleshooting process, ensure that you have done the following:
Installed the ServiceNow Connector as specified in Installing the Connector.
Configured the ServiceNow Connector as specified in Configuring the ServiceNow Connector
Set up one or more notification rules as specified in Automatically Creating a Ticket.
This chapter covers the following common problems:
If you do not include the BASICAuth
script described in Configuring ServiceNow to Support the Enterprise Manager ServiceNow Connector, the following error will occur:
In Enterprise Manager: Connection test failed, check oms
log file for details. The configuration was saved.
In ServiceNow: No messages are displayed in the logs. It does not accept the SOAP message because it lacks the BASICAuth
and thus, no record of it exists.
Solution: Add the BASICAuth
script to Script Includes in ServiceNow as described in Configuring ServiceNow to Support the Enterprise Manager ServiceNow Connector
If your ServiceNow user account does not have the correct permissions for the out-of-the-box templates, the following error will occur:
In Enterprise Manager: Failed to create a ticket on the external system through connector ServiceNow Connector.
In ServiceNow: Insufficient rights for creating new records: com.glide.processors.soap.SOAPProcessingException
: Insufficient rights for creating new records
Solution: Ensure that the ServiceNow account you are using to integrate with Enterprise Manager has the appropriate permissions as mentioned in Table 5-1, "Default ServiceNow Templates".
If SSL was not enabled for your ServiceNow Connector instance, the following error will occur:
In Enterprise Manager: Connection test failed, check the OMS log files for details. The configuration was saved. The entry in the OMS log should look like this:
oracle.sysman.emSDK.webservices.outbound.WSInvokeException: caught WebServiceException : javax.xml.soap.SOAPException: javax.xml.soap.SOAPException: Message send failed: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
In ServiceNow: No error is displayed.
Solution: Add the Root Certificate as describe in Enabling SSL for HTTPS.
This section provides cause and solution information on troubleshooting common error messages. Find the error message in Table 7-1 that matches your error message, then refer to the corresponding section(s) indicated under Possible Cause for instructions to diagnose and correct the problem.
Table 7-1 Enterprise Manager Error Messages
Error Message | Possible Cause |
---|---|
javax.xml.soap.SOAPException: javax.xml.soap.SOAPException: Bad response: 403 Forbidden from url … |
|
javax.xml.soap.SOAPException: javax.xml.soap.SOAPException: Message send failed: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target |
|
javax.xml.soap.SOAPException: javax.xml.soap.SOAPException: Message send failed: No route to host |
|
javax.xml.soap.SOAPException: javax.xml.soap.SOAPException: Bad response: 404 Not Found from url … |
|
javax.xml.soap.SOAPException: javax.xml.soap.SOAPException: Message send failed: Connection timed out |
|
javax.xml.soap.SOAPException: javax.xml.soap.SOAPException: Message send failed: hostname |
|
javax.xml.transform.TransformerConfigurationException: Could not compile stylesheet |
The following errors are described:
Cause: The user name or password for accessing the ServiceNow web service is incorrect.
Solution
Log in to the Oracle Enterprise Manager console with an account that has Super Administrator privileges.
From the Enterprise Manager console, click Setup menu, then select Extensibility, and finally select Self Update.
On the Self Update page, select Management Connectors from the menu. This will display the Management Connectors page.
Click the name of the appropriate ServiceNow connector.
This invokes edit mode, enabling you to configure the connector.
Correct the ServiceNow Web Service Username and ServiceNow Web Service Password fields, then click OK.
Cause: The IP address specified in the URL is invalid or the network is down.
Solution: Verify that the hostname/IP address configured for the connector is correct:
Log in to the Oracle Enterprise Manager console with an account that has Super Administrator privileges.
From the Enterprise Manager console, click the Setup menu, then select Extensibility, and finally select Self Update.
On the Self Update page, select Management Connectors from the menu. This will display the Management Connectors page.
Click the name of the appropriate ServiceNow connector.
This invokes edit mode, enabling you to configure the connector.
Verify that the hostname/IP address specified in the URL for the createEvent and updateEvent operations are correct.
If the hostname/IP address is incorrect, provide the correct value, then click OK.
If the URLs specify a host name, make sure that the host name resolves to the correct IP address. To determine the IP address of the host name, issue the ping <hostname> command, where <hostname> is the actual host name. This lists the IP address that was resolved for the host name. If this is incorrect, the system administrator needs to investigate why it is incorrect.
If the hostname/IP address appears to be correct, try to ping the system where the SCOM web service is installed using the hostname/IP address. If the ping fails, the system administrator needs to investigate why there is no connectivity.
Cause: The port number specified in the URL is invalid.
Solution: Verify that the port number configured for the connector is correct:
Log in to the Oracle Enterprise Manager console with an account that has Super Administrator privileges.
From the Enterprise Manager console, click the Setup menu, select Extensibility, and finally select Self Update.
On the Self Update page, select Management Connectors from the menu. This will display the Management Connectors page.
Click the name of the ServiceNow connector.
This invokes edit mode, enabling you to configure the connector.
Verify that the port number specified in the URL for the createEvent
, updateEvent
, setup, initialize, and uninitialize operations are correct.
If the port number is incorrect, provide the correct value and click OK.
Cause: A firewall is blocking access to the system where the ServiceNow web service is installed.
Solution: Contact your IT department to give Enterprise Manager access to the port used by the ServiceNow web service.
Cause: The system does not recognize the host name specified in the URL.
Solution: You can use the following options to address this issue:
Coordinate with the system administrator to change the system configuration to recognize the host name.
Specify the IP address in the URL instead of the host name. To do this, perform the following steps:
Determine the IP address of the system where the ServiceNow web service is installed.
Log in to the Oracle Enterprise Manager console by entering a user name with a Super Administrator role, entering the appropriate password, then click Login.
From the Enterprise Manager console, click Setup, then Extensibility, and finally Management Connectors. The Management Connectors page appears, which shows the installed connectors.
Click on the Configure icon associated with the ServiceNow connector. This invokes edit mode, enabling you to configure the connector.
Change the host name to the IP address in the URL specified for the createEvent
, initialize, setup, uninitialize, and updateEvent
operations.
Click OK.
Cause: The connector framework could not process the request because the XSL file was formatted incorrectly. This problem should not occur unless the connector has been customized.
Solution: Examine any changes made to the XSL template files for mistakes that could have caused the problem. If you cannot find the problem manually, load the XSL in a utility that performs XML validation.