disco.status table

Use the disco.status table to monitor the progress of the ncp_disco process during the discovery process.

Attention: The disco.status table is used and updated internally, and you must not make inserts into this table.
Table 1. disco.status database table schema

Column name

Constraints

Data type

Description

m_BlackoutState

Externally defined Boolean data type

Boolean Integer

Flag to show if the discovery process is in Blackout mode, that is, whether or not DISCO is accepting new devices from the finders in the current discovery cycle:
  • 0: False (accepting new devices)
  • 1: True (not accepting new devices)
m_CycleCount

Integer

Current rediscovery cycle, that is, the current number of cycles DISCO has been through without actually building a topology.

In rediscovery mode, DISCO only builds a topology at the end of the last cycle (the last cycle is determined by the fact that there is nothing left in finders.pending awaiting processing).

m_DiscoveryCycleRequested

Externally defined Boolean data type

Boolean Integer

Flag to indicate that a discovery has been requested by the GUI.

m_DiscoveryCycleRequestTime  

Integer

The time that the discovery was requested, in Unix time.

m_DiscoveryMode  

Integer

The present discovery mode:
  • 0: Full discovery
  • 1: Partial discovery

m_ForcedLayerRebuild

  Boolean Integer

Flag that indicates whether a 'false' value of the disco.config.m_RebuildLayers column has been overridden for the current discovery cycle. The default value is 0.

m_FullDiscovery

Externally defined Boolean data type

Boolean Integer

Flag to indicate that the FullDiscovery.stch stitcher has been called during the discovery.

If the stitcher is called, the flag is set to 1 to ensure that the FullDiscovery.stch stitcher is executed when the current discovery finishes (thus starting another full discovery).

If the flag is set to any other value, no action is taken.

m_Phase  

Integer

The current phase within the present discovery cycle. During the data collection stage, the phases are as follows:
  • 0: The discovery has not yet started.
  • 1: The main discovery phase in which device data is retrieved. Most discovery agents complete in this phase.
  • 2 - n: The phases in which the topology data is retrieved for the currently discovered objects. The number of phases required depends on how your discovery is configured. By default, in a layer 2 discovery, phase 2 consists of the retrieval of IP to MAC address translations and phase 3 consists of the retrieval of Ethernet switch topology information.

    During the data processing stage, the following phase is undertaken.

  • 3: The phase in which the collected data is processed; the layers are built and the data is sent to MODEL.

More detailed information about the discovery phases can be found in Discovery stages and phases.

m_ProcessingNeeded

Externally defined Boolean data type

Boolean Integer

Flag to indicate whether the current topology needs reprocessing. This flag is checked when DISCO is in rediscovery mode in order to determine whether any newly found devices (that are now in the finders.pending table) necessitate the reprocessing of the entire topology:
  • 0: The topology does not need reprocessing
  • 1: The topology needs reprocessing