How to fix it

  1. First, verify the MID Server service is running on the host machine. On Windows, open Services.msc and look for your MID Server service name. On Linux, run systemctl status <mid_server_name>. Start the service if it's stopped.
  2. Navigate to MID Server > ECC Queue and filter by Agent field matching your MID Server name. Look for recent ERROR entries to identify the specific connection issue.
  3. Check the config.xml file in your MID Server installation directory. Verify the url parameter points to the correct instance (https://yourinstance.service-now.com) and mid.instance.username/mid.instance.password are correct.
  4. Test network connectivity by running telnet yourinstance.service-now.com 443 from the MID Server host. If this fails, you have a firewall or network issue blocking outbound HTTPS.
  5. If your network requires a proxy, verify the proxy configuration in config.xml. Ensure mid.proxy.use_proxy is set to true and mid.proxy.host/mid.proxy.port are correct.
  6. Verify the MID Server user account is active and not locked. Navigate to User Administration > Users and search for your MID Server username. Check the Active and Locked out fields.
  7. Check MID Server version compatibility by navigating to MID Server > Servers and comparing the Version field with your instance version. Download the latest MID Server if there's a mismatch.
  8. Verify the name parameter in config.xml exactly matches the MID Server record name in the MID Server > Servers table, including case sensitivity.
  9. Review the agent0.log.txt file in the MID Server logs directory for detailed error messages. Look for authentication failures, SSL handshake errors, or connection timeouts.
  10. If using mutual authentication, verify the keystore and truststore files are present and the mid.ssl.keystore.password is correct in config.xml.
  11. After making configuration changes, restart the MID Server service and wait 2-3 minutes for the connection to establish. Monitor the agent0.log.txt file for startup messages.
💡

Quick verification: Navigate to MID Server > Servers and refresh the list. The Status field should show 'Up' and Last Refreshed should show a recent timestamp within the last few minutes.