Install the Universal Discovery Agent with the Agent Driven Flow Enabled Manually

  • KM03693207
  • 20-Aug-2020
  • 20-Aug-2020

Summary

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

Answer

  1. 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.

      Tip  

      • The file name indicates the platform.
      • UNIX only. Additionally, extract the agentinstall.sh file.
    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. The certificate files are acstrust.cert and agentca.pem.

  2. Retrieve the UD Agent certificates

    Go to <DataFlowProbe_Home>\runtime\probeManager\discoveryResources, and retrieve adicert.pem and adikey.pem.

  3. Copy the UD Agent installation file and the UD Protocol certificate

    Copy the exported UD Agent installation file and certificates 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.
    • Make sure that all the four certificates acstrust.certagentca.pemadicert.pem, and adikey.pem are included in the certificate folder.
    • Windows

      Copy the UD Agent installation file and certificates 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.

    • UNIX and the UNIX variants

      1. Create a folder $HOME/.discagnt and then copy the UD Agent installation file, certificates, and agentinstall.sh file to this folder.

      2. Perform the installation by using the following command line parameters. For details on parameters for all platforms, see Universal Discovery Agent Installation Resources. For example:

        sudo ./agentinstall.sh --async ./[installation file] --url0 [FQDN]:80 --cert /$HOME/.discagnt

      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.
  4. Enable the Agent driven flow on UCMDB server

    To enable the Agent driven flow, do the following:

    • Windows

      1. Go to the following directory in Registry Editor:

        • x86: HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\Universal Discovery\V1\Options
        • x64: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Hewlett-Packard\Universal Discovery\V1\Options
      2. Add the following string values in the preceding directory:

        Name Value
        SCHEDULER_Enabled True
        SCHEDULER_ProbeBaseURL https://[Probe FQDN]:9443/rest/agent/
    • UNIX and the UNIX variants

      Add the following in $HOME/.discagnt/aioptionrc

      • SCHEDULER_Enabled=True
      • SCHEDULER_ProbeBaseURL=https://[Probe FQDN]:9443/rest/agent/
         
  5. Enable the Agent driven flow on Data Flow Probe

    To enable the Agent driven flow on Data Flow probe, do the following:

    In the DataFlowProbe.properties file, set the value of com.hp.ucmdb.discovery.probe.agents.probemgr.agentdrivenflow.enabled to true.
    Then restart this Data Flow Probe