Test connectivity to the ServiceNow instance

task australia Updated Sep 10, 2026 1 min read test-connectivity-to-instance.md
Raw file servicenow.com

Test network connectivity from a device to your ServiceNow instance to confirm that the device can download the agent installation script for DEX.

Before you begin

  • On Windows, download the curl utility with the latest binaries to support mutual Transport Layer Security (mTLS) authentication.

    1. From https://curl.se/windows/, download the latest curl zip file and extract it to your local drive.

    2. Open a command prompt and set the path to the downloaded curl binary.

      For example, SET PATH=C:\curl-8.12.1_1-win64-mingw\bin;%PATH%.

    Note: The curl utility downloaded from the website doesn't replace the existing utility version on your local machine. The new version is applicable to the current CMD session only.

  • On macOS, use the curl utility version already installed.

Role required: agent_client_collector_admin

Procedure

  1. From the command line, download the install_script.sh by running one of the following curl commands:

    • Without a proxy: curl –verbose -L https://<servicenow instance>/api/sn_agent/agents/install_agent -o install_script.sh
    • With a proxy: curl --verbose –-proxy <HOST_NAME>:<PORT> -L https://<servicenow instance>/api/sn_agent/agents/install_agent -o install_script.sh The command downloads a script written into install_script.sh.
  2. From the All menu, navigate to the Agent scripts [sn_agent_script] table.

  3. Select the install_script record and confirm that its content matches the content of the install_script.sh file.

Result

The match confirms that the connection is established with the ServiceNow instance.

If there’s no match, fix your network connection issues.

Keywords test instance connectivitynetwork connectivitycurl testmtlsmutual transport layer security \(mtls\)test connection to instance
Search documentation
Search document titles and file paths on the australia branch