REMOTE_HOST - UEM Manager configuration option

Description

The REMOTE_HOST option specifies a comma-delimited list of one or more hosts upon which a command can run.

Each host in the list can be specified as a host name or an IP address in dotted decimal notation.

Note

For purposes of this discussion, even if one host is specified, it is considered a list with a single entry.

If multiple hosts are specified, the UEM Manager will try each one until it successfully connects to a Universal Broker. When a successful connection is established, no more hosts in the list are tried. If the UEM Manager is unable to establish a connection to a Universal Broker on any of the hosts in the list, the UEM Manager will fail.

Each host in the REMOTE_HOST list also can include a port number or service name that the UEM Manager will use to establish a connection with the Universal Broker on that host. This is useful in situations where the remote Broker is configured to accept incoming connections on a port that is different from the UEM Manager's configured value.

UEM Manager automatically removes any duplicates found in the list of hosts before it makes its first connection attempt. This includes any host names that resolve to the same IP address, or duplicate IP addresses that are added to the list following DNS expansion (see the DNS_EXPAND option).

Note

Duplicate IP addresses may appear in the resolved, expanded, scrubbed list of hosts if a different port number is specified for each occurrence of a particular IP address (for example, 192.168.1.1:7887 and 192.168.1.1:7888 are considered distinct entries).

To set configuration options that control selection of the hosts in the REMOTE_HOST list, see the HOST_SELECTION, CONNECT_TIMEOUT, and DNS_EXPAND options.

The following text briefly describes each of these options. Each is briefly described below.

HOST_SELECTION

UEM Manager uses the HOST_SELECTION option to control which host in the REMOTE_HOST list is selected first. UEM Manager can be configured to always select the first host or to select with a randomly chosen host as it begins its attempts to connect to a remote Universal Broker. In either case, when a host is selected, UEM Manager processes the list sequentially until either a connection succeeds or all hosts in the list are tried.

(See the HOST_SELECTION option for more information.)

CONNECT_TIMEOUT

UEM Manager uses the CONNECT_TIMEOUT option to specify how long it will wait for a connection attempt to succeed before it moves on to the next host in the list.

(See the CONNECT_TIMEOUT option for more information.)

DNS_EXPAND

The DNS_EXPAND option controls the number of IP addresses returned when UEM Manager issues a DNS query to resolve a host name. If the UEM Manager is configured to expand the results of the query, all IP addresses defined for a particular host name are returned and expanded (in-place) within the list of hosts. Otherwise, only the first host is returned, and no expansion is performed.

(See the DNS_EXPAND option for more information.)

Usage

Method

Syntax

IBM i

HP NonStop

UNIX

Windows

z/OS

Command Line, Short Form

-i hostlist



(tick)

(tick)

(tick)

Command Line, Long Form

-host hostlist



(tick)

(tick)

(tick)

Environment Variable

UCMDHOST hostlist



(tick)

(tick)


Configuration File Keyword

host hostlist



(tick)

(tick)

(tick)

Values

hostlist is a list of one or more hosts, in the following format:

[host1[[:port1],host2[:port2],host3[:port3],...hostn[:portn]]

In this format:

  • host is the IP address (in dotted decimal notation) or host name of the system upon which the command may run.
  • port is an optional port number (or service name), which is necessary only if the remote Universal Broker is accepting incoming connections on a port that is different from the value specified by the REMOTE_PORT option.

Note

The port number, when specified, must be separated from the host by a colon ( : ).