Controlling discovery

You can start either an immediate or scheduled scan in BMC Atrium Discovery by clicking the Add New Run link from the Discovery status page.

You can control the discovery process using various options dependent on the type of scan you initiate.

For immediate scans, you can run a snapshot scan of a specified address range right away, whether or not the regular discovery scan is in progress. The specified addresses are scanned automatically and as soon as possible. You can also assign a discovery run to a company name.

For scheduled scans, you can:

  • Specify the IP range that is scanned during the normal discovery run.
  • Schedule a scan to occur at any time and for a specified amount of time. For example, you might want to schedule a scan during off hours to avoid the risk of touching critical applications.
  • Assign a discovery run to a company name.
  • Delete a selected range or ranges, or all IP addresses from the regular scan and the snapshot scan lists.

You can stop and restart the discovery process at any time.

In order to start the Discovery process, you must click START ALL SCANS on the Discovery Status page, as by default Discovery is off.

For general information about the discovery process, see The Discovery Engine.

Scanning IP addresses or ranges immediately

  1. Click Add New Run.
  2. Enter the information for the snapshot discovery run in the fields.

    Field Name

    Details

    Range

    Enter either a single IP address or a range in one of the following formats:
    • IP addresses, as a single address or a range, or a comma separated list, for example, 172.17.1.1 or 172.17.1.1-5 or 172.17.1.1, 172.17.1.2, 172.17.1.3
    • A subnet, for example 172.17.1.0/24
    • A * wildcard, for example 172.17.1.*

    Level

    Select the level for the discovery run. This is one of:
    Sweep Scan: This will do a sweep scan, trying to determine what is at each endpoint in the scan range. It will attempt to login to a device to determine the device type.
    Full Discovery: This will retrieve all the default info for hosts, and complete full inference.

    Label

    Enter a label for the discovery run. Where the discovery run is referred to in the UI, it is this label that is shown.

    Company

    Select the company name to assign to the discovery run. This drop-down list is only displayed if multitenancy has been set up. If (No company) is displayed, or a company names you were expecting is missing, refresh the list by clicking Lookup Companies on the CMDB Sync. See multitenancy for a full explanation of this feature.

    The default company set by default here will only be used by default in the discovery run. If you set the company to "(no company)" the CIs will be exported with no company and the default value won't be used.

  3. Click OK.
    The Currently Processing Runs tab is displayed with the new run.

Scheduling a discovery run

You can schedule a discovery run to occur daily, weekly, or monthly and can specify a start time and duration.

To schedule a scan:

  1. Click Add New Run ....

    On a consolidation appliance the link name is Add New Local Run ...

  2. Select Scheduled.
    The dialog displays Frequency, Start Time, and Duration menus.
  3. Enter the information for the scheduled scan in the fields.

    Field Name

    Details

    Range

    Enter either a single IP address or a range in one of the following formats:
    • IP addresses, as a single address or a range, or a comma separated list, for example, 172.17.1.1 or 172.17.1.1-5 or 172.17.1.1, 172.17.1.2, 172.17.1.3
    • A subnet, for example 172.17.1.0/24
    • A * wildcard, for example 172.17.1.*

    Level

    Select the level for the discovery run. This is one of:
    Sweep Scan: This will do a sweep scan, trying to determine what is at each endpoint in the scan range. It will attempt to login to a device to determine the device type.
    Full Discovery: This will retrieve all the default info for hosts, and complete full inference.

    Label

    Enter a label for the discovery run. Where the discovery run is referred to in the UI, it is this label that is shown.

    Company

    Select the company name to assign to the discovery run. This drop-down list is only displayed if multitenancy has been set up. If (No company) is displayed, or a company names you were expecting is missing, refresh the list by clicking Lookup Companies on the CMDB Sync. See multitenancy for a full explanation of this feature.

    Frequency

    Select a frequency for the discovery run to be performed. For example, this can be Daily, Weekly, or Monthly.
    For a weekly discovery run, you are provided with buttons for each day. Select the day or days that you want the run to take place.
    For a monthly discovery run, you are provided with buttons for each day in the month. Select the day or days that you want the run to take place. Alternatively, select the Scan on the radio button and choose one of:
    • First
    • Second
    • Third
    • Fourth
    • Last
    and the day that you want the scan to take place. In this way you can select the Second Tuesday of the month and so forth.

    Start Time

    Select a time for the scan to start. Discovery will need to be running at this time.

    Duration

    Select a duration in hours. This is the length of the scan window and can be from 1 to 23 hours.
    If this duration expires before the scan has completed, then the scan will be suspended until the next scheduled time for this scan occurs. At that point, the scan will resume from the point where it was previously suspended.

  4. Click OK. The Scheduled Runs tab is displayed with the new run.

To add another scan to the page, click Add New Run. To delete any existing scheduled scans, select the entry and click Delete.

Editing an existing scheduled run

You can edit an existing scheduled run. If the run is currently in progress it is automatically cancelled when you edit it. To do this, from the Scheduled Runs tab of the Discovery Status page:

  1. Click on the Scheduled Run that you want to edit.
    This screen illustrates where to edit an existing run.
    All of the fields described in the previous table can be edited.
  2. Make the required changes and click OK.

Excluding IP addresses and ranges from scanning

There may be some IP devices in your network that you never want to be scanned. For example, you may have some legacy applications which will only run on old hardware which may be regarded as fragile. You can add this device as a single IP exclude, or as an Exclude Range.

To add an Exclude Range:

  1. On the Exclude Ranges tab on the Discovery Status page, click Add New Exclude.
  2. Enter the information for the exclude range in the fields.

    Field Name

    Details

    Range

    Enter either a single IP address or a range in one of the following formats:
    • IP addresses, as a single address or a range, or a comma separated list, for example, 172.17.1.1 or 172.17.1.1-5 or 172.17.1.1, 172.17.1.2, 172.17.1.3
    • A subnet, for example 172.17.1.0/24
    • A * wildcard, for example 172.17.1.*

    Label

    Enter a label for the discovery run. Where the discovery run is referred to in the UI, it is this label that is shown.

    Description

    A free text description of the exclude range.

  3. Click OK.
    The Excluded Ranges tab is displayed with the new exclusion.

Editing an existing exclude range

You can edit an existing exclude range. To do this:

  1. From the Exclude Ranges tab of the Discovery Status page:
  2. Click on the exclude range that you want to edit.
    All of the fields are editable.
  3. Make the required changes and click OK.

Starting the discovery process

The status of the discovery process is shown at the top of the page. You can click START ALL SCANS to start the scan, any scans that are on hold or waiting to start will transition into "In progress". If a run is on hold but outside its scheduled window it will not start.

  1. Click START ALL SCANS.
    The screen is automatically refreshed to show the progress of the discovery process.

Stopping the discovery process

The status of the discovery process is shown at the top of the page. If a scan is in progress, that is "Discovery is running", you can click STOP ALL SCANS to stop the scan. Any regular scans and snapshot scans currently in progress will stop. The status changes to "Discovery is stopping" while the process closes.

  1. Click STOP ALL SCANS.
    No more scans will be started and discovery will attempt to stop all in progress commands.
    After the scan has stopped, no more scans will be performed until you restart the scan.
  2. To restart the discovery process, click START ALL SCANS.
Was this page helpful? Yes No Submitting... Thank you

Comments