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)`

Configuration Management System (CMS)2018.05

Use > Data Flow Management > Data Flow Management Setup > Universal Discovery Agents > How to Install the Universal Discovery Agent Manually

How to Install the Universal Discovery Agent Manually

This task describes how to install the Universal Discovery (UD) Agent manually on remote machines.

Prerequisite
- Ensure that the platform of the remote machine on which you want to install the UD Agent is supported.
- For more information, see Universal Discovery Agent Deployment.
- For a list of out-of-the-box supported version, see the Supported Content section of the Content Help.
Export the UD Agent installation file and the UD Protocol certificate
1. Go to Administration > Package Manager and export the UDAgentManagement archive file.
  
  For more information, see How to Export a Package.
2. Extract the UD Agent installation file or files that are appropriate for the platform of your discovery nodes from the following location in the archive file:
  
  discoveryResources\ud_agents
  
  For a mapping of installation files to platforms, see Universal Discovery Agent Installation Resources.
3. In Data Flow Management, go to Data Flow Probe Setup > Domains and Probes. In the relevant domain, select the UD protocol credential whose certificate you want to export, and click Export Public Certificates.
Copy the UD Agent installation file and the UD Protocol certificate

Copy the exported UD Agent installation file and certificate to the remote machine and install them using one of the following methods:

Note Ensure that you distribute or copy installation files that are appropriate to the platform of the discovery node.
- Attended (Windows only)
  
  Copy the UD Agent installation file and certificate using any manual method or remote access technology to the remote Windows machine, and then perform installation by clicking the executable (MSI) file. For more information on running or configuring this installer, see Agent Installation Wizard.
- Unattended (All platforms)
  1. Copy the UD Agent installation file or files and the certificate file to the remote machine using any manual method or remote access technology.
    
    UNIX only. Additionally, copy the agentinstall.sh file.
  2. Perform the installation by using command line parameters. For details on parameters for all platforms, see Universal Discovery Agent Installation Resources.
  For example, the following command is used to install the UD Agent on a Windows machine, to listen on port 7738, with a connection timeout of 900 msec, with the UD Protocol certificate located in c:\UDAgentInstall, and with the logging function enabled.
  
  c:\AgentTest>msiexec /i ud-agent-win32-x86-10.10.000.xxx.msi /log <log_file_name.txt> /quiet SETUPTYPE=Enterprise PORT=7738 TIMEOUT=900 CERTPATH=c:\UDAgentInstall PERIOD=90 SOFTWAREUTILIZATION=ON URL0=15.178.179.124 URL1=15.178.179.125 URL2=15.178.179.126
  Note
  - For error code information, see platform-specific information at Universal Discovery Agent Installation Resources.
  - If an error occurs, the screen may also display a message with information about the error.
Generate Unique IDs for Disk Cloning- Optional

If you are using disk cloning to distribute images that contain the UD Agent, perform the following to generate Unique IDs:
1. UNIX and Mac OS X only. Log in using the user account that is used to run the UD Agent. If the location of the data files were modified with the --home command line option at the time of installation, type HOME=<HOME> and press ENTER at a command prompt.
  
  Note <HOME> is the home directory of the user that runs the UD Agent on the computer where the disk image was created.
2. Navigate to the directory that contains the UD Agent executable files and run the following command:
  - Windows: discagnt.exe --newuniqueid
  - UNIX: ./discagnt --newuniqueid
  Note Ensure that you run the command before the UD Agent runs the first time.
Results

When you activate the Infrastructure activity, the Data Flow Probe connects to the UD Agent installed on the remote machine.

To verify that the Data Flow Probe is able to communicate with the remote UD Agent, go to Universal Discovery > Activity Discovery Status > Progress tab and make sure that a UDA CI instance was discovered. For more information, see Zone-based Discovery View.

The following events also occur as a result of installing the UD Agent:
- The UD Agent generates a Unique ID which is stored locally on the discovery node and in UCMDB as follows:
- Software Identification Tag files are created and stored on the discovery node. For more information about Software Identification Tags, see Hardware and Software Recognition.

Related Information

Send Help Center feedback