AdditionalClasspath

Additional path that enables to run different patterns (that is, database patterns); all paths should be relative to the $PROBE_INSTALL/root/lib/collectors/probeManager/discoveryResources/ folder and should be semicolon separated

Example:

<property name="AdditionalClasspath">db/oracle/.;db/mssqlserver/.</property>
means that following paths will be included in the classpath:

• $PROBE_INSTALL/root/lib/collectors/probeManager/discoveryResources/db/oracle/

• $PROBE_INSTALL/root/lib/collectors/probeManager/discoveryResources/db/mssqlserver/

Indicates whether to allow the execution of caliper on HP-UX. This setting will be used in the WebSphere_By_Shell adapter, to get the full command line when the ps command fails to do so.

Default: false

Indicates whether to allow to call home.

Default: true

The time interval in hours that is allowed between two call home requests from the same host.

Default: 24

Indicates whether to allow Data Center IP addresses to call home.

Default: true

allowGettingCredential
SecuredAttribute

Indicates whether Jython scripts are allowed to get credentials secured data (true) or not (false). If this setting is set to false, then Jython scripts are not allowed to retrieve sensitive credentials data (like passwords that are stored on the server side).

Default: true

Indicates whether to allow the execution of pfiles on Solaris.

Default: false

Indicates whether to allow the execution of pfiles on HP-UX.

Default: false

autoTruncateDbEncoding

Indicates the encoding used by the CMDB underlying database. This property is used for calculating the number of characters that should be sent after truncation.

Default: UTF8

autoTruncatePercentage

If the value of the attribute (with the DDM_AUTOTRUNCATE qualifier) exceeds the size limit multiplied by this parameter it will be truncated to the specified part of the defined size.

Default: 100 percent

clearCommandLineFor
Processes

Clears the Command line for these processes.

This option is used to ensure that no private or confidential data is stored in CMDB.

Default: srvrmgr.exe, srvrmgr, xCmd.exe, HPcmd.exe, ssonsvr.exe

Syntax exceptions: Process names are case insensitive and should be split by commas.

The comma-separated list of commands globally available for all PowerShell connections.

The commands specified in this list will be executed using CMD interpreter (cmd /c "command")

If the management zone is set to Data Center and this parameter is enabled, Data Flow Probe ignores call home messages from Universal Discovery Agent.

Default: Enabled

dbQueryTimeout

The timeout (in seconds) for all SQL queries. Indicates how long to wait for query results.

The timeout applies only if the value is greater than zero (0).

Default: 100 seconds

Specifies whether the resumable download is enabled or not.

true. The resumable download functionality is available.

false. The resumable download functionality is not available.

Specifies whether the resumable upload is enabled or not.

true. The resumable upload functionality is available.

false. The resumable upload functionality is not available.

defaultSapClients

When this parameter is defined, you do not need to specify the SAP Client Number parameter in the SAP ABAP protocol. Instead, you can create one or more comma-separated credentials for multiple SAP systems with different supported clients.

Example:
<property name=
"defaultSapClients">
800,500,200,300
</property>

Default: 800

desktopOperatingSystems

serverOperatingSystems

These two parameters are used to determine if the host's operating system is of type Desktop or Server. If the host's operating system name contains a value from one of these lists, its host_isdesktop is set accordingly. Otherwise the value of host_isdesktop attribute is left empty.

discovereAllListenPorts

Related to application signatures configuration.

discoveredStorageTypes

Describes storage types which have to be reported to UCMDB. Options are split by commas.

Available options are:

• FixedDisk

• NetworkDisk

• CompactDisk

• RemovableDisk

• FloppyDisk

• VirtualMemory

• FlashMemory

• RamDisk

• Ram

• No Root Directory

• Other

• UNKNOWN

Indicates whether to enable the reporting of the improved JEE topology.

Default: false

Specifies whether the label format for output values in the normalization rule is enabled or not.

If you want to display values in the label format instead of the default format that contains underscores for the normalized fields, do the following:

1. Add <property name="enableNormalizationRuleLabel">true</property> in the globalSettings.xml file if it does not exist.
2. Restart the probe.

Default: false

Setting this parameter to true enables Inventory Discovery via SSH to be able to use a user account that has the shared home directory. For example, the home directory is mounted via NFS or Samba, so that the same directory is used when the user logs into different computers.

In order for this feature to work correctly, Universal Discovery Agent cannot be installed to run under a user account that has the home directory that is shared (for example, mounted via NFS or Samba). If it is already installed, uninstall it. For more information, see the How to Completely Uninstall the Universal Discovery Agent section in the Data Flow Management section of the UCMDB Help.

To enable this feature, set this parameter value to true. The default value is false.

The file system discovery method. Valid values are perl and lsawk.

• perl (default). Run Perl scripts to discover file systems. If Perl is not installed on the target host, the lsawk discovery method is used as a fallback mechanism.
• lsawk. Run ls + awk commands to discover file system.

Ignores the attributes in the discovery result processing.

Format: node.name, node.description

Data Flow Probe will not validate the node attribute name and description. The probe will not report these attributes to UCMDB.

Default: node.misc_info

ignoreLocalizedVirtualInterfaces
PatternList

Lists patterns for localized Windows Virtual interface description that must not take part in the Host Key creation process.

Format: Comma-separated list of strings, no additional white-spaces allowed.

ignoreVmwareInterfaces

Indicates whether to ignore the VMware MAC address.

• When there is a Physical MAC (default). The VMware MAC address is used only if the pattern cannot find any physical MAC address.

• Always. Always ignore VMware MAC address.

jdbcDrivers

This section enumerates driver classes used to connect to a dedicated Database server. Names of sub-keys must be the same as used in credentials (sqlprotocol_dbtype attribute of protocol).

Change them if drivers other than OOTB JDBC drivers are used.

Default values for OOTB-installation:

<property name="jdbcDrivers:>
<oracle>
oracle.jdbc.OracleDriver
</oracle>
<oracleSSL>
oracle.jdbc.OracleDriver
</oracleSSL>
<MicrosoftSQLServer>
net.sourceforge.
jtds.jdbc.Driver
</MicrosoftSQLServer>
<MicrosoftSQLServer> net.sourceforge.jtds.
jdbc.Driver
</MicrosoftSQLServerNTLM>
<MicrosoftSQLServerNTLMv2>
net.sourceforge.jtds.jdbc.Driver
</MicrosoftSQLServerNTLMv2>
<Sybase>
com.sybase.jdbc.SybDriver
</Sybase>
<db2>
com.ibm.db2.jcc.DB2Driver
</db2>
<mysql>
com.mysql.jdbc.Driver
</mysql>
</property>

jdbcPreUrls

This section enumerates URL templates used to connect to dedicated the database server. Names of sub-keys must be the same as those used in credentials (sqlprotocol_dbtype attribute of protocol). Change them if drivers other than OOTB JDBC drivers are used. Values depend on used drivers and should be taken from driver documentation.

Default values for OOTB-installation:
<property name="jdbcPreUrls">
<oracle>jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=
(PROTOCOL=tcp)
(HOST=%%ipaddress%%)(PORT=%%protocol_port%%))
(CONNECT_DATA=(%%connect_data%%=%%sqlprotocol_dbsid%%)))
</oracle>
<oracleSSL>jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=
(PROTOCOL=tcps)
(HOST=%%ipaddress%%)(PORT=%%protocol_port%%))
(CONNECT_DATA=(%%connect_data%%=%%sqlprotocol_dbsid%%)))
</oracleSSL>
<MicrosoftSQLServer>
jdbc:jtds:sqlserver://
%%ipaddress%%:%%protocol_port%%;
instanceName=%%sqlprotocol_dbname%%;
loginTimeout=%%protocol_timeout%%;
logging=false;ssl=request
</MicrosoftSQLServer>
<MicrosoftSQLServerNTLM>
jdbc:jtds:
sqlserver://%%ipaddress%%:
%%protocol_port%%;instanceName=
%%sqlprotocol_dbname%%;domain=
%%sqlprotocol_windomain%%;
loginTimeout=
%%protocol_timeout%%;logging=false
</MicrosoftSQLServerNTLM>

loadExternalDTD

Used to configure file_mon_utils to prevent downloading DTD files while validating the XML.

Default: false

maxExecutionRecords

Specifies maximal number of execution records that can be in the communication log. This parameter should be used when the discovery process discovers a lot of data. The parameter can be overridden on an adapter level. In this case, add the parameter to the adapter with desired record limit (see Probe documentation).

Default: -1 means unlimited

maximumConnectionsPerSecond

Enables limiting the number of new connections per second created by the Probe to other machines.

• 0. Unlimited number of connections allowed.

• > 0. The maximum number of connections. If this limit is reached, any job trying to create a new connection will wait for a period of time that is determined in the timeToSleepWhenMaximumConnectionsLimitReached parameter below.

Default: 0 (unlimited)

maxStoreSentResults

Specifies maximal number of sent results that can be stored in the communication log.

This parameter can be changed if there are too many results stored in the communication log.

If this value is greater than 0, the log will store the corresponding number of results for deleted results AND updated results, meaning that the results set will contain double the value of maxStoreSentResults.

Default: -1 means unlimited

Specifies the maximum IPv6 count of per range for Ping Sweep.

Default: 1000000

Indicates whether multiple DB2 instances are installed on the same server.

Default: true

multipleUpdateIgnoreTypes

Used by UCMDB. The Probe does not generate a Multiple updates in bulk warning for enumerated CI types.

Specifies a list of methods that are not to be recorded in the communication log.

To remove a method from being recorded in the communication log, copy its name from the communication log and add it here.

Example:

<property name="notRecordedMethods">

<method>getLastCommandOutputBytes</method>

</property>

NtcmdAgentRetention

NTCMD agent retention mode. Specifies how to handle a remote NTCMD service and its executable file when closing the connection.

• 0 (default). Unregister the service and delete the remote executable file.

• 1. Unregister the service but keep the executable file on the file system.

• 2. Leave the service running, keep the executable file.

NtcmdSessionUseProcessBuilder

This parameter is for NtcmdSessionAgent and should be always be true. This parameter tells how to create a new process.

• true. The new process will be created by ProcessBuilder (new API from Java 5.0)

• false. The new process will be created by Runtime.exec (old API, from Java 1.4.2). Set to false only in case of backward compatibility problems.

objectSendAmountThreshold

When the number of discovered objects exceeds this threshold, the objects are immediately sent to the server. Requires using the sendObject(s) API in jython scripts.

Default: 2000 objects

objectSendTimeThreshold

When more than the specified time (in seconds) has passed since the previous object report, the objects are immediately sent to the server. Requires using the 0sendObject(s) API in jython scripts.

Default: 300 seconds

(Only for the Inventory Discovery by Scanner job) Indicates whether to allow to ping Client IP addresses.

Default: false

(Only for the Inventory Discovery by Scanner job) Indicates whether to allow to ping host names.

Default: false

portExpirationTime

The expiration time (in seconds) of the TCP/UDP port entry in the Probe's database.

Default: 60 seconds

powershellConnectionIdleTimeout

Defines the maximum idle time (in milliseconds) for the powershellconnector.exe process.

The timer resets its state after each command execution.

Default: 3600000 milliseconds (1h)

processExpirationTime

The expiration time (in seconds) of the Process entry in the Probe database.

Default: 60 seconds

The protocol connection order for the Host Connection by Shell job.

Default: ssh, telnet, ntadmin, powercmd

remoteProcessTimeout

After being launched, the remote process should connect with the Probe within the defined time (in milliseconds), otherwise the following error is produced: Failed to connect to remote process.

Default: 300000 milliseconds (5 minutes)

removeCopiedFiles

In some cases DFM copies scripts and third-party utilities on a client machine. The removeCopiedFiles parameter defines whether these files should (true) or should not (false) be deleted after discovery is finished.

Indicates whether to report SAP Application Server databases that are based on the configuration file content.

Only affects the Host Applications by Shell, and SAP ABAP Topology by SAP JCO jobs.

Default: false

Indicates whether to report physical serial numbers from hwsmbiosPhysicalAttributeSerialNumber of scan files.

Default: false

ResultProcessIsLenient

When setting to true, the discovery result processing is lenient, which is not recommended:

• If a reported string attribute has a too large value, the string is automatically truncated according to the CMDB Class Model definition.

• If the OSH attribute is invalid (type/nonexisting attribute/missing ID attribute), only the invalid OSH is dropped, rather than entire bulk (default).

Default: false

setBiosUuidToMicrosoftStandart

Indicates whether the BIOS UUID value for Windows operating systems should be reported in Microsoft style (some bytes order reversed) instead of the original BIOS value. Affects Host Connection jobs.

• false (default). Converts to original BIOS stored value

• true. Converts to Microsoft standard.

The maximum bandwidth (in kilobits per second) to upload and download files to and from the discovery node

shellGlobalCommandTimeout

Global timeout (in milliseconds) for all Shell client commands. Indicates how long to wait for a command's result.

Default: 15000 milliseconds

siebelCommandTimeout

The amount of time to wait for the Siebel command's result.

Default: 3 minutes (180000 ms)

This is the time, in milliseconds, after which a request using SNMP will timeout.

Default: 3,000 milliseconds

snmpTestQueries

Defines the default SNMP test query for SNMP Agent. Can be overridden for specific devices.

Default:

<property name="snmpTestQueries">

<query>
1.3.6.1.2.1.1.1,1.3.6.1.2.1.1.2,
string</query>

</property>

The SSH log level.

Levels: 1-7, where 7 is the most detailed defect level.

tcpExpirationTime

The expiration time (in hours) of TCP connection entry in probe database.

Default: 24 hours

timeToSleepWhenMaximum
ConnectionsLimitReached

Determines how long (in milliseconds) a job needs to wait until a new connection can be created, assuming the maximum connections limit has been reached. (See maximumConnectionsPerSecond above.)

Default: 1000 milliseconds (1 second)

tnsnamesFilePaths

Paths to search the tnsnames.ora file (including tnsnames.ora itself, comma separated)

Example:

<property name=
"tnsnamesFilePaths">
c:\temp\tnsnames.ora
</property>

Whether to prevent the SSH protocol from recording the executed command to the environment variable $HISTFILE on UNIX server.

If the value is true, the executed command is not recorded in the environment variable $HISTFILE on UNIX server.

Default: false

useIntermediateFileForWmic

Usage of an intermediate temporary file for data transfer by wmic command.

Default: false

useJinteropOnWindows

This property is used on Windows machines.

• true. The Probe uses JInterop for WMI discovery.

• false (default). The Probe uses WMIdll native code.

Indicates whether to use multiple threads in Event Hub.

Default: true

useNtcmdModifiedMarkers

• true. The Probe uses markers with counters in NTCMD agents' infrastructure.

• false (default). The Probe uses old NTCMD behavior - without markers with counters.

useWinexeOnLinux

This setting is used on non-Windows machines.

• true. The Probe uses local winexe executable for NTCMD Windows discovery.

• false (default). The Probe uses Windows remote Proxy.