Universal Discovery Protocol

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Parameter	Description
UD SHA1 ID	A hash of UD credential's certificates. Enables you to visually distinguish between UD credentials that have different certificates (different hash) and those that have similar certificates (similar hash). Note This value is generated automatically and cannot be modified.
Port Number	The port number on which the UD Agent listens. Select one of the following ports: 2738 7738
Connection Timeout	The amount of time (in milliseconds) after which the Probe stops trying to connect to the UD Agent.
Sudo paths	The full paths to the sudo command. Paths are separated by commas.
Sudo commands	A list of commands that can be executed with the sudo command. Commands are separated by commas. For all commands to be executed with sudo, add an asterisk () to this field. This field accepts a sudo* command that prompts for the user's password. There is both pattern matching and pattern completion using Python/Jython regular expressions. For example, for the expressions: /usr/sbin/uname uname -a uname -r /mypath/my_other_path/uname -my args -my other args the pattern match would be: *.uname This matches anything before uname, and any arguments uname has. The list of commands that can be executed with sudo is dependant on the configuration of sudo** commands on the discovered destination. Therefore, an asterisk () in this field means that all commands configured on the discovered destination should be run with sudo. Note To enable a non-root user to deploy the UD Agent on a UNIX environment, ensure that the list of commands includes the agentinstall.sh* and nohup commands.
Agent Certificate/Key File	Enabled after clicking the Import DDMI certificates button in the Universal Discovery Protocol pane. Allows you to select and import a Universal Discovery agent certificate / key file for use in encrypted communication between the Universal Discovery Agent and the Data Flow Probe.
Probe Certificate File	Enabled after clicking the Import DDMI certificates button in the Universal Discovery Protocol pane. Allows you to select and import the probe certificate file for use in encrypted communication between the Universal Discovery Agent and the Data Flow Probe.
Key Store File	Enabled after clicking the Import DDMI certificates button in the Universal Discovery Protocol pane. Allows you to select and import the probe keystore file for use in encrypted communication between the Universal Discovery Agent and the Data Flow Probe.

Parameter

Description

UD SHA1 ID

A hash of UD credential's certificates. Enables you to visually distinguish between UD credentials that have different certificates (different hash) and those that have similar certificates (similar hash).

Note This value is generated automatically and cannot be modified.

Port Number

The port number on which the UD Agent listens.

Select one of the following ports:

2738
7738

Connection Timeout

The amount of time (in milliseconds) after which the Probe stops trying to connect to the UD Agent.

Sudo paths

The full paths to the sudo command. Paths are separated by commas.

Sudo commands

A list of commands that can be executed with the sudo command. Commands are separated by commas. For all commands to be executed with sudo, add an asterisk (*) to this field. This field accepts a sudo command that prompts for the user's password.

There is both pattern matching and pattern completion using Python/Jython regular expressions. For example, for the expressions:

/usr/sbin/uname
uname -a
uname -r
/mypath/my_other_path/uname -my args -my other args

the pattern match would be: .*uname

This matches anything before uname, and any arguments uname has.

The list of commands that can be executed with sudo is dependant on the configuration of sudo commands on the discovered destination. Therefore, an asterisk (*) in this field means that all commands configured on the discovered destination should be run with sudo.

Note To enable a non-root user to deploy the UD Agent on a UNIX environment, ensure that the list of commands includes the agentinstall.sh and nohup commands.

Agent Certificate/Key File

Enabled after clicking the Import DDMI certificates

button in the Universal Discovery Protocol pane. Allows you to select and import a Universal Discovery agent certificate / key file for use in encrypted communication between the Universal Discovery Agent and the Data Flow Probe.

Probe Certificate File

Enabled after clicking the Import DDMI certificates

button in the Universal Discovery Protocol pane. Allows you to select and import the probe certificate file for use in encrypted communication between the Universal Discovery Agent and the Data Flow Probe.

Key Store File

Enabled after clicking the Import DDMI certificates

button in the Universal Discovery Protocol pane. Allows you to select and import the probe keystore file for use in encrypted communication between the Universal Discovery Agent and the Data Flow Probe.

Note This protocol supports IPv6.