Product version

Discovery Access node

BMC Discovery 11.3 ... Developing Node lifecycle DDD nodes

Discovery Run node

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

Last modified by Duncan Tweed on Aug 17, 2020

Comments

Log in or register to comment.

Discovery Access node

Device Info node