Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Test connectivity to the ServiceNow instance

Test the ServiceNow DEX instance network connectivity.

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 table (sn_agent_script).

  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.

Parent Topic:Installing DEX on your local machine