When Should I Deploy Leaf-Agents?

Agentless machines can be patched and managed without installing client-side software (the Leaf-Agent), which many Administrators find desirable. Many if not most machines can be managed as Agentless machines.

However, Leaf-Agents are very useful for hardened machines that disallow RPC ports (135, 139, or 445), or disallow services like NetLogon, Remote Registry Access, Server (IPC$ share), or File and Print Services. Under these conditions, a Leaf-Agent will be mandatory since you can't treat the target as an "Agentless" candidate.

Even if the target has not been hardened, you may want to take advantage of the Leaf-Agent for encryption services, disconnected machine support, or patch deployment performance advantages. Many environments do best with a well thought out mix of Agentless and Leaf-Agent machines.

Leaf-Agent Features

Leaf-Agents are preferred when you want one or more of the following features:

Here's a table comparing the attributes of an Agentless (RPC) machine versus a Leaf-Agent machine.

Leaf-Agent Installation

Tip-1: Remotely installing a Leaf-Agent requires that the target is NOT already hardened. In other words, if you can query the machine as an Agentless machine, it is likely able to accept a remote install of a Leaf-Agent. Once the Leaf-Agent is installed, then you may harden the target. If the machine is already hardened, you either need to do a local Leaf-Agent install, or perhaps temporarily return the machine to an un-hardened state to allow for a remote install.

Tip-2: In UpdateEXPERT Premium 7.0, you can supply valid target machine credentials during the Agent Installation dialogue. In UpdateEXPERT 6.3 and earlier current logon credentials are used for Leaf installation, meaning that your current login must be an administrative account that matches an existing local administrator account on the target machine. In UpdateEXPERT 6.3 and earler, after installation, Alternate Credentials can be set so that it is easy to repeatedly query and deploy patches to the Leaf. See "Leaf-Agent Credentials" section, below.

Tip-3: When running the Agent-Installer (GUI or command line), you must configure the Leaf-Agent with a port assignment of 1025 to 65535, with the default being 9968.

Tip-4: The Agent-Installer allows the Master and Leaf to be identified by Hostname or IP address. If installing Leafs to machines with static IP addresses, especially in a DMZ, you will probably want to use IP addresses in the installation dialogue. This is efficient and avoids name resolution issues. If the target machines get their IP address using DHCP (for example, mobile users taking advantage of disconnected machine support) you will probably want to use Hostname to allow for possible IP address reassignments made by the DHCP server.

Leaf Agents can be installed using several different methods:

Note that there are several ways you can determine if a Leaf-Agent is already installed on a system.

Leaf-Agent Credentials

Install troubles are usually due to misunderstanding Leaf-Agent credentials, trying to remotely install to a hardened machine that won't allow the install, and using hostnames instead of IP addresses across a firewall. See the articles below:

Leaf-Agent Database

The ability of Leaf-Agents to download their own patches, and reduce network I/O for tasks like querying and validation is supported by the fact that Leaf-Agents have their own local database.

Leaf-Agents in a DMZ

Leaf-Agents are especially useful for patching machines in a DMZ environment because the Leaf-Agents can communicate with the Master Agent over a single administrator specified TCP port number, thus not requiring Microsoft networking ports & services, and uses encrypted communications, making it ideal for secure environments.

It is recommended that Master/Leaf communications be bidirectional over the configured port. However, it is possible to utilize one-way communications between Master & Leaf Agents, as long as you understand the limitations.

Operationally, for a DMZ, it may work best to open the port number on your firewall first (9968 by default), then do "local" Leaf Agent installs on each DMZ machine, identifying the Master Agent and Leaf Agent by IP address (to avoid reliance on name resolution assuming static IP addresses) during the Agent Installer dialogue.

At the end of each Leaf install, the Leaf registers with the Master Agent through the firewall port, which you opened already. As you complete Leaf installs, a "head" icon should appear on the enumerated Leaf in the Console interface. Here is a summary of the steps for performing a local Leaf-Agent install, or more detail if you prefer.

Once a Leaf is installed, Alternate Credentials can be set to make repeated queries and patch deployment easy. Here is a comparison of Agentless vs. Leaf-Agent credentials.

In addition to Leaf-Agents, there are other features that are security related.

Uninstallation Issues affecting Master/Leaf Operations

When Leaf-Agents are deployed, they "belong" to a Master-Agent. If at a later point in time, you want to uninstall/re-install the Master-Agent, the existing Leaf-Agent connections will be lost unless you use AgentUtil.exe as a backup tool. This means you will be required to re-install the Leaf-Agents.

If you want to uninstall a Leaf-Agent, do so from the UpdateEXPERT GUI, which is recommended. It is possible, but not recommended unless necessary, to uninstall a Leaf-Agent from the command-line.

In UpdateEXPERT 6.3 or earlier, if Leaf-Agent machines are going to be removed from the network, uninstall Leaf-Agents first to remove them from the Master-Agent. If you do not do this, then you will have "orphaned" Leaf-Agents on the Master-Agent that will need to be removed.