This site will be updating to the latest content for the next few hours and may be intermittently slow.

Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.


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


DiscoverNow allows an administrator to run a CI Configuration discovery on a single IP address without requiring a schedule.

About this task

The platform automatically selects the correct MID Server to use for the discovery if one is associated with the IP address selected. If no MID Server is configured for the network in which that address appears, the administrator selects a MID Server. This feature enables an administrator to discover new devices in the network as soon as they are connected to the network, rather than waiting for a regularly scheduled discovery.


To configure the system to automatically determine which MID Server to use, set up the IP range capabilities for each MID Server in your system. Refer to Configuring a MID Server for an IP Address Range for instructions.

You can run DiscoverNow from a Discovery Schedule form or from a script.


  1. Navigate to Discovery > Discovery Schedules module.
  2. Click Quick discovery in the header.
    Quick Discovery Button

    A dialog box appears asking for an IP address and the name of the MID Server to use.

  3. Enter the target IP address for a discovery in the Target IP field.
    Note: DiscoverNow does not currently support IP network discovery. Make sure you enter a single IP address only and not an entire network, such as

    If a MID Server is assigned to the subnet containing the target IP address and currently in an operational status (Up), the MID Server name appears automatically in the MID Server field. If multiple MID servers are found, the system selects one for you. The value in the MID Server field can be overwritten if you want to select a different MID Server.

  4. If no MID Server is defined for that network, select one from the list of available MID Servers.
    Quick Discovery Dialog
  5. Click OK to run discovery.
    The status record for that discovery appears. The Schedule column is empty because no schedule is associated with this discovery.
    Quick Discovery Status List

    Run DiscoverNow from a Script

    You can run DiscoverNow from a script, such as a background job, a business rule, or web services.

    Use the following script:

    var d = new Discovery();
    var statusID = d.discoveryFromIP(TARGET_IP, TARGET_MIDSERVER);

    The discoveryFromIP method takes two arguments, IP and MID Server. The IP argument is mandatory, but the the MID Server argument is optional. To choose the MID Server, supply either the sys_id or name of the MID Server as the argument. If you do not name a MID Server, the system attempts to find a valid one automatically. A valid MID Server has a status of Up and is capable of discovering the given IP address. If the system finds a valid MID Server and runs a discovery, the discoveryFromIP method returns the sys_id of the discovery status record. If no MID Server is capable of discovering this IP address, the method returns the value undefined.

    If you manually specify the TARGET_MIDSERVER, the system validates the given value and ensures that the MID Server table contains the specified MID Server record. If the validation passes, the discoveryFromIP method returns the sys_id of the discovery status record. If the validation fails, the method return the value undefined.