Run Quick Discovery

Quick Discovery, or 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 when 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. An administrator can discover new devices in the network when they are connected, 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 Configure an IP address range for the MID Server for instructions.

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

Procedure

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

    A dialog box appears asking for an IP address and the name of the MID Server to use. Only Up and Validated MID Servers are available.

  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 that you enter a single IP address only and not an entire network, such as 10.105.37.0/24.

    When a MID Server is assigned to the subnet containing the target IP address and currently in an operational status (Up), the 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.
    Figure 1. 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.
    Figure 2. 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 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 can discover 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 can discover 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.