Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.
  • Madrid
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store

Set up Discovery manually

Log in to subscribe to topics and get notified when content changes.

Set up Discovery manually

If you are not using Guided Setup, you must perform several configuration steps manually to activate the application, set up the MID Server, and then set up Discovery.

Before you begin

Role required: admin


  1. Meet prerequisites.
    1. Grant Discovery role: Verify that users who are expected to configure and execute Discovery in your network have the discovery_admin role.
      This role grants access to the tables in the Discovery application.
    2. Select a MID Server host: Designate a computer to host the MID Server.
    3. Gather credentials: Gather the login credentials that the MID server must use to access the devices it is expected to discover.
    4. Select IP Address Ranges: Determine the IP addresses that Discovery must scan.
      In a very complex network, it is good practice to group IP ranges into a Range Set, which is reusable for different schedules. Discovery will not scan anything outside of these ranges.
  2. Enable the Discovery plugin.
    For information about purchasing a subscription, see Activate Discovery.
  3. Deploy MID Servers.

    Install one or more MID Servers on physical or virtual servers that meet the minimum requirements and configure them to communicate with the appropriate ServiceNow instance.

    Install at least two MID Servers at first and assign them to different schedules and IP ranges to help complete discoveries quicker. Starting with the Istanbul release, you must make sure that the MID Server is assigned the Discovery application or the ALL application.

  4. Ensure MID Server connectivity. Open the instance and navigate to Discovery > MID Servers.

    If the new MID Servers are configured properly, they will appear in the list of MID Servers.

    If a MID Server does not appear as a choice in the instance, perform the following checks in the MID Server:
    • Ensure that the URL in the Configuration Parameters related list provided is correct.
    • If the MID Server is installed on Windows, make sure the ServiceNow MID Server service is configured properly with the correct logon credentials and is running.
    • Check the MID Server log for errors.
      • UI: Navigate to Discovery > MID Servers > [MID Server] > Logs.
      • MID Server Host: Navigate to the agent\logs\agent0.log0 directory.
    • If Basic Authentication is enabled, a username and password must be provided.
    • The MID Server might not have outbound access on port 443 (SSL) or a proxy server might be preventing TCP communication to the instance.
    • Make sure that no firewalls are blocking communication between the MID Server and the instance.
  5. Add credentials. Set the Discovery Credentials on the instance for all the devices in the network - Windows and UNIX computers, printers, and network gear.
    Credentials for Windows devices (using the WMI protocol) are provided by the logon configured for the MID Server service on the Windows server host. Credentials for UNIX, vCenter, and SNMP must be configured on the instance. Discovery will automatically figure out which credentials work for a particular computer or device.
  6. Define and run Discovery schedules.

    The Discovery Schedule is the control point for running discoveries. The schedule controls when Discovery runs, defines the MID Server to use, the type of Discovery that should run, and the IP addresses to query. Create as many schedules as necessary, using different types of discoveries, and configure them to run at any time. Let Discovery run on its configured schedule or manually execute Discovery at any time. These schedules can be set up in a variety of ways, including a single schedule for the entire network or separate schedules for each location or VLAN.

    If you do not know the IP address to scan in your network, run a Network Discovery first to discover the IP networks. Once discovered, you can convert these networks into IP address range sets that you use in a Discovery Schedule.

    Note: For advanced discoveries, such as those requiring load balancing or scanning across multiple domains, use Discovery Behaviors.

What to do next

Validate discovery results