Adapter Configuration Tab

When selected, indicates that the adapter can connect to a remote machine via IPv6 addresses, and can handle IPv6 results in the output.

Choose to create a log file that logs the connection between the Probe and a remote machine.

• Always. A communication log is created for this session.

• Never. A communication log is not created for this session.

• On Failure. A communication log is created for this session, only if the execution fails.

  That is, DFM reports an error (report of a warning does not create a communication log). This is useful when you need to analyze which queries or operations take most of the time, send data for analysis from different locations, and so on. If the job completes successfully, no log is created.

When requested (in the Discovery Progress pane), a log retrieved from the Probe is displayed (if a log has been created). For details, see Discovery Progress Dialog Box.

Communication log files are created on the Probe Manager under the C:\UCMDB\DataFlowProbe\runtime\communicationLog folder. For details on how the communication logs work, see Record DFM Code.

Each job is run using multiple threads. You can define a maximum number of threads that can be used concurrently when running a job. If you leave this box empty, the Probe's default threading value is used (8).

The default value is defined in the DataFlowProbe.properties file, in the appilog.agent.local.services.defaultMaxJobThreads parameter.

Enable aging

The aging mechanism specifies how long a period must pass in which CIs are discovered, before DFM treats these CIs as no longer relevant and removes them. Choose from one of the following aging options:

• System Default: Use the system's default value for the Enable Aging attribute of each CI type.
• Always Enabled: Select this option to always enable the aging mechanism.
• Always Disabled: Select this option to always disable the aging mechanism.

The value you set here is for each CI result that is reported to the UCMDB by the jobs of this adapter.

For details on aging, see The Aging Mechanism Overview.

Enable Automatic Deletion

Choose between:

• Always. Automatic Deletion or Candidate for Deletion is always enabled, regardless of whether discovery succeeds or fails.

• On Success or Warnings. Automatic Deletion or Candidate for Deletion is enabled only when discovery finishes with a success or warning status. In the case of a discovery error, nothing is removed and CIs are not marked as a candidate for deletion.

• Only on Success. Automatic Deletion or Candidate for Deletion is enabled only when discovery finishes with a success status. In the case of a discovery error or warning, nothing is removed and CIs are not marked as a candidate for deletion (this is the default).

Selecting this option enables the Automatic Deletion box where you select specific CITs for deletion or as candidates for deletion, if the Data Flow Probe does not find them during its next invocation.

To select CITs, click the Add button. In the Choose Discovered Class dialog box, choose the CITs that should be automatically deleted.

The changes you make here are added to the adapter configuration file, for example:

<resultMechanism isEnabled="true">

    <autoDeleteCITs isEnabled="true">

        <CIT>shell</CIT>

          <candidateForDeletionCIT>node</candidateForDeletionCIT>

    </autoDeleteCITs>

</resultMechanism>

For information about how the Data Flow Probe handles CI deletion, see Automatically Deleted CIs and Relationships and Candidates for Deletion CIs.

Note for Java-based population adapters: In order for CITs to be deleted by the population engine, you must configure the adapter configuration file manually as described in How to Define CITs to be Deleted by Java-based Population Adapters.

Enable collecting 'Discovered by' data

• Selected. DFM collects data on the results of running the adapter. This data is then used to enable rediscovery of CIs. The data is necessary for the Discovery tab in IT Universe to function correctly. It is also used for the View Based Discovery Status functionality which leverages the data to aggregate the complete discovery status for certain views.

• Cleared. DFM does not collect this data. The check box needs to be cleared for adapters where rediscovery is not helpful. For example, the Range IPs by ICMP job has this check box cleared by default because its Trigger CI is the Probe Gateway and so all CIs discovered by this job have the same Trigger CI. If the check box was not cleared, a rediscovery attempt on any view containing any single IP would result in a ping sweep throughout the entire customer network—certainly not desirable behavior.

The job results of this adapter are displayed in the Discovery for View dialog box only if this check box is selected. For details, see How to Check the Status of Application Discovery (Rediscover a View) and Show Discovery Status and Changes Dialog Box.

Enable reporting of empty values

When selected, the Data Flow Probe reports empty values for discovered properties to UCMDB.

Default: Enabled

Enable update 'Last Access Time'

When selected, if a CI is touched when a discovery or integration job runs, the Last access time property of the CI is updated. This indicates that the CI represents an active component in the system, and prevents the CI from becoming a deletion candidate.

For details about the aging mechanism and deletion candidates, see The Aging Mechanism Overview.

Fail entire bulk if invalid CIs are found

If a set of objects (for example, 1,000 objects) includes even one invalid CI (for example, a node cannot be identified because of missing topological information), the reconciliation engine drops the entire set and does not send it to the CMDB. This is the default behavior.

If this option is not selected, the results are still sent to the CMDB but without the invalid CIs (and their topology). In the above example, 999 objects would be processed. UCMDB displays an error message when you view the results.

Available for: Discovery adapters and Jython-based integration adapters only

To group results in the Probe before they are sent to the server, type the value that indicates how long results are stored in the Probe before being transferred to the server.

The default value is 30 seconds.

Specify the number of CIs that should accumulate in the Probe before being transferred to the server.

The default value is 5000.