Issue
If your MID Server has started, but it didn't connect to your ServiceNow instance, check the agent log for MID Server errors.
Find the agent log by going to your MidServer agent folder and then to the logs subfolder.
Before you begin
Review the following product documentation to see if this addresses your issue: MID Server Installation
Video Tutorial: How to Troubleshoot MID Server Issues
Release
Resolution
To review the agent log in your MID Server for errors:
- Locate the logs in the logs folder inside your MID Server files.
- Locate the agent0.log file inside the logs folder. This is where the MID Servers logs are recorded.
The MID Server has already tried and failed several times to complete the startup sequence, which is why this information is repeated in the log when there is an error.
Look for the first error in the startup sequence, which is this warning:
Could not authenticate user ‘USERNAMEHERE’ on the ServiceNow instance.
This error indicates that there is an issue with the user account.
- Check if the user exists.
- If not, create the user and verify that the user name and password exactly match those in the config XML file.
- If a matching user already exists, check that it is Active and not Locked out.
- Restart the service and go into your instance to see if the MID Server connected.
If your MID Server is still not connected, go back to the agent log to find the first error after the restart.
You may see a different error:
Warning: SOAP Server error reported by ServiceNow instance, user ‘USERNAMEHERE’ may be missing the ‘soap_script’ role.
This indicates that there’s a problem with the user’s role.
To fix this:
- Assign the mid_server role to the user, which inherits all other required roles, including the missing soap_script role.
- Restart the service.
- Go into your instance to see if the MID Server connected.
- If it’s listed with a Status of Up, the issue is resolved.