How to fix it
- 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. - Navigate to
MID Server > ECC Queueand filter byAgentfield matching your MID Server name. Look for recent ERROR entries to identify the specific connection issue. - Check the
config.xmlfile in your MID Server installation directory. Verify theurlparameter points to the correct instance (https://yourinstance.service-now.com) andmid.instance.username/mid.instance.passwordare correct. - Test network connectivity by running
telnet yourinstance.service-now.com 443from the MID Server host. If this fails, you have a firewall or network issue blocking outbound HTTPS. - If your network requires a proxy, verify the proxy configuration in
config.xml. Ensuremid.proxy.use_proxyis set to true andmid.proxy.host/mid.proxy.portare correct. - Verify the MID Server user account is active and not locked. Navigate to
User Administration > Usersand search for your MID Server username. Check theActiveandLocked outfields. - Check MID Server version compatibility by navigating to
MID Server > Serversand comparing theVersionfield with your instance version. Download the latest MID Server if there's a mismatch. - Verify the
nameparameter inconfig.xmlexactly matches the MID Server record name in theMID Server > Serverstable, including case sensitivity. - Review the
agent0.log.txtfile in the MID Server logs directory for detailed error messages. Look for authentication failures, SSL handshake errors, or connection timeouts. - If using mutual authentication, verify the keystore and truststore files are present and the
mid.ssl.keystore.passwordis correct inconfig.xml. - After making configuration changes, restart the MID Server service and wait 2-3 minutes for the connection to establish. Monitor the
agent0.log.txtfile 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.