This documentation relates to the latest released version of BMC Discovery.
See the information on this topic for versions 11.2 or 11.1.

A Discovery Run is a scan of one or more Discovery endpoints, specified as an IP address or addresses or ranges which are scanned as an entity. These ranges might be being scanned locally on from the appliance, or be the result of appliance consolidation.

For each Discovery Run, a Discovery Run node is created which records information such as the user who started the run, the start and end time, and so on. A Discovery Run contains a number of Discovery Access nodes. In turn, Discovery Access nodes contain all other non-integration DDD nodes.

Additionally a Discovery Run node can also contain Provider Access nodes. A Provider Access node is created for a particular IP address as a result of a SQL Discovery access. In turn, Provider Access nodes contain all other Integration related DDD nodes.

Discovery Run lifecycle

The following section describes the scenarios in which a Discovery Run is created or destroyed. DDD nodes are never updated.

Creation

A Discovery Run node is created when a Discovery Run starts; when a range that has been configured to be scanned starts actually scanning or, if the appliance is a Consolidation Appliance, when a Scanning Appliance's scan starts to be consolidated. The Discovery Run remains open until all of the endpoints (IP addresses) in the range have been scanned or consolidated.

Removal

Discovery Runs are removed when all of their contained Discovery Access have been destroyed through the Aging process. When the Discovery Run node is destroyed any linked Integration Access nodes and their associated DDD nodes are also destroyed.

Discovery Run node attributes

The attributes of a Discovery Run node are as described in the following table below:

UI Name
Attribute Name and Type

Description

Key
key string

Unique identity string for DiscoveryRun.

Label
label string

Label.

User
user string

User who created the run.

Range Prefix
range_prefix string

Distinguish overlapping address spaces.

Total Number of IPs
total int

Number of addresses in run.

Number of IPs being Pre-scanned
pre_scanning int

Number of addresses being pre-scanned.

Number of IPs being Scanned
scanning int

Number of addresses being scanned.

Number of IPs waiting on Exclude Ranges
waiting int

Number of addresses waiting for end of exclude range.

Blocked Waiting on Exclude Ranges
blocked boolean

Blocked waiting for end of exclude range.

Number of IPs Scanned
done _int

Number of completed addresses.

Cancelled
cancelled string

If present reason why run was cancelled.

Consolidation Cancelled
consolidation_cancelled string

If present reason why consolidation run was cancelled.

Scan Type
scan_type string

Type of scan.

Scan Level
scan_level string

Scan level.

Start Time
starttime date

Date and time the run started.

End Time
endtime date

Date and time the run ended.

Discovery Start Time
discovery_starttime date

Date and time the discovery started.

Discovery End Time
discovery_endtime date

Date and time the discovery ended.

ECA Error
has_eca_error boolean

True if there have been any ECA Errors for this Discovery Run.

Hard Failure
hard_failure boolean

True if there have been hard failures for this Discovery Run.

Not displayed in UI
__inprogress boolean

True if Discovery Run still executing.

Not displayed in UI
__remote_inprogress boolean

True if Discovery Run still executing on the discovery appliance.

Number of IPs Consolidated
consolidation_done_count int

Number of completed consolidation endpoints.

Not displayed in UI
_consolidation_source string

Identifier for the discovery appliance which provided the info for this run.

Consolidated From Appliance
_consolidation_source_name string

Name of the discovery appliance which provided the info for this run.

Consolidated From System
_consolidation_source_system string

If the discovery system is a cluster name of the discovery cluster otherwise name of the discovery appliance which provided the info for this run. The discovery system needs to be as least version 11.1 for this attribute to be present.

Consolidation Data Last Received
_consolidation_last_received date

Date and time last received consolidation data.

Not displayed in UI
_consolidation list:
string

List of the consolidation appliance identifiers this run needs to be sent to.

Not displayed in UI
_consolidation_done list:
string

List of the consolidation appliance identifiers this run has been sent to.

Multi-tenant company
cdm_company string

Multi-tenant company name.

Explicit Ranges
valid_ranges string

Valid IP address ranges in the run.

Number of Explicit IPs
explicit_ip_count int

Number of user provided addresses in run.

Number of Implicit IPs
implicit_ip_count int

Number of system provided addresses in run.

Starting from v10.0 the Discovery Run node has no run_type attribute.

Discovery Run node relationships

The relationships of a Discovery Run node are as described in the following table:

UI name

Relationship

Description

Endpoints

DiscoveryRun:
List:
List:
Member:
DiscoveryAccess

Discovered Accesses made within this run

Provider Accesses

DiscoveryRun:
List:
List:
Member:
ProviderAccess

Accesses to provider types within this run

Not displayed in UI

DiscoveryRun:
EndpointRange:
EndpointRange:
IPRange

IP Range used by this run

Dropped IPs

DiscoveryRun:
EndpointRange:
EndpointRange:
DroppedEndpoints

Endpoints which were not scanned.


Was this page helpful? Yes No Submitting... Thank you
© Copyright 2004 - 2019 BMC Software, Inc.
Legal notices