Adding Remote Hosts to the Remote Agent

Prerequisites

  • SSH connection is enabled from remote agent host to all remote hosts.
  • Password-less sudo configuration is required for the remote host target.

Note:

  • Remote host addition to remote agent is only supported on Linux x86-64, in this release.

  • PowerBroker option is not supported for adding remote host target to remote agent, in this release.

Adding Host Target to Remote Agent Using the Console

From Setup, go to Add Targets Manually, click Add Remote Host Targets and fill the form with the following inputs and click Submit.

Table 1-1 UI Input

Input field Description
Session Name

Pre-populated by default with the task name, user name and date stamp, to be useful when reusing from previous session, but can be changed as needed.
Remote agent

Select the remote agent to be used from the list.
Host Monitoring Credential

Used for monitoring and will not need escalation to root. All metric collections will use this credential.

Supports SSH keys and username/password.
Host Admin Credential

Root credentials used for pushing sbin content as part of Cache Maintenance operations

Require ability of escalating to root without a password using PDP settings (sudo)

SSH Port

Pre-populated with the default value, 22, can be changed as needed.

Privileged Delegation Setting

Pre-populated with the default path, /usr/bin/sudo -u %RUNAS% %COMMAND%, can be changed as needed.

Remote cache

Cache of scripts, archives, monitoring utilities and application metadata maintained on remote host. Minimum 1 GB space required on remote host.
Remote cache Sbin

Cache contains utilities like nmosudo and nmgsshe root owned contents on remote host. Remote agent may need certain root owned executables for monitoring.

Adding Host Target to Remote Agent Using emcli

Use the submit_add_remote_host emcli command line option to add remote host to the remote agent: 

emcli submit_add_remote_host
    -host_names=<host name>
    -remote_cache_root=<path to remote cache>
    -remote_cache_sbin_root=<path to remote cache utilities>
    -agent=<agent name> 
    -host_cred_mon=<credentials type, e.g. SSH>
    -host_cred_admin=<root credentials, e.g. SSH_ROOT>
    -privilege_delegation_setting="/usr/bin/sudo -u %RUNAS% %COMMAND%"
    -wait_for_completion

Example:

emcli submit_add_remote_host
    -host_names=host1.example.com
    -remote_cache_root=/u01/app/rcache
    -remote_cache_sbin_root=/u01/app/rcacheroo
    -agent=host1.example.com:1838
    -host_cred_mon=SSH
    -host_cred_admin=SSH_ROOT
    -privilege_delegation_setting="/usr/bin/sudo -u %RUNAS% %COMMAND%"
    -wait_for_completion