Configuring a Remote Management Agent

Enterprise Manager uses remote agents as a communication mechanism to monitor and manage host machines. You must install and configure a remote agent on any host machine running Big Data Discovery nodes. Enterprise Manager can then monitor the host, discover any Big Data Discovery targets running on the host, and manage the targets.

To configure a remote agent:

  1. Log in to Enterprise Manager Cloud Control.
  2. Select Setup > Add Target > Add Targets Manually.
  3. Select Add Host Targets and click Add Host...
  4. On the Add Host Targets: Host and Platform page, click + Add and do the following:
    1. In Host field, specify the fully qualified name of the host where you want to install the remote agent.
    2. From the Platform list, select the appropriate platform.
      For example, this is typically Linux x86-64.
    3. Specify as many target hosts as necessary.
    4. Click Next.
  5. On the Add Host Targets: Installation Details page, do the following:
    1. In Installation Base Directory field, specify the path to install the remote agent into.
      For example, the typical installation path is /localdisk/basedir.
    2. The Instance Directory name is populated by default based on the Installation Base Directory value. You should not have to change this value.
    3. In Named Credential field, click the + icon.
  6. In the Create new Named Credential dialog, specify the following:
    1. In UserName, specify the user who has privileges to log into the host where you want to install the remote agent.
    2. In Password and Confirm Password, specify the corresponding password for the user.
    3. In Run Privilege, select Sudo.
    4. In Run as, specify root.
    5. Click OK.
    The user you specify must have write privileges to create an installation directory on the host.
  7. In the Privileged Delegation Setting, add -S to the list of command line arguments.
    For example: 
    /usr/bin/sudo -S -u %RUNAS% %COMMAND%
  8. At the top of the Add Host Targets: Installation Details page, click Next.
  9. On the Add Host Targets: Review page, confirm the information and click Deploy Agent.
    It may take a few moments to install the remote agent on the host. If you specified multiple target hosts in step 4, Enterprise Manager deploys an agent to each host.
  10. Click Done.