Goverlan Agents

What are the Goverlan Agents?

Goverlan needs a agent running on all client machines in order for most features to work properly. Once installed, the Goverlan Agents stay resident on each client machine s that it can compile events information. Note: Goverlan Agents have been specifically designed to have a very low foot print on memory and CPU consumption.

Note: The user interface displayed on the client machines via the Goverlan Agents is by default in English. You can however change most text displayed by the agents with a translated version.
See: Client Side Text Customization & Localization

What the Goverlan Agents are NOT

Automatic Installation of Goverlan Agents

No pre-installation of Goverlan Agents is required. Goverlan can automatically install/update the required agents. By default, executing an action on a remote machine will verify if the Goverlan Agents exist on that machine. If no Goverlan Agents are found, you will be prompted to authorize their installation.  If a different version of Goverlan Agents is found, they are automatically updated.

Note: The system drive root share (i.e.: C$) and the ADMIN$ shares must be enabled and accessible on a remote machine for Goverlan to remotely install the client agents. Consequently, the File and Printer Sharing network service must also be enabled on the remote system. If the system root drive share and the ADMIN$ share are not accessible, you will need to manually install the Goverlan Agents on your machines using Goverlan Client Agents.msi (see Creating a software distribution package of the Goverlan Agents later in this article).

You can modify the auto-installation settings for Goverlan in the Goverlan Agents category of the Options window:

Check Prompt me before Installing remote agents if you want to authorize the installation of Goverlan Agents. Un-check this option if you want Goverlan to automatically install Goverlan Agents when necessary.

Check Prompt me before Updating remote agents if you want to authorize the update of Goverlan Agents. Un-check this option if you want Goverlan to automatically update Goverlan Agents when necessary.

Manual Installation/Removal of Goverlan Agents

The installation, update or removal of Goverlan Agents on a remote machine can be manually forced. If you wish to pre-install, update or remove Goverlan Agents on a particular machine, select the machine’s icon from the Favorites view, right click on the mouse and select the appropriate action in the Goverlan Agents section.


Managing the Goverlan Agents on a Set of Machines

To install, update or un-install the Goverlan Agents on a set of machines, select Help >> Add/Remove Client Agents from the main menu. Using the Agents Manager window, add the desired machines to the list and click on Install Agents or Remove Agents (to install/update or to un-install the Goverlan Agents respectively).

Note: If you cannot open Goverlan because the trial license has expired, send an email to our Support Team to receive an extension license key.

To Exclude Specific Machines from the Installation or Update of the Goverlan Agents

You can prevent Goverlan from installing or updating agents on specific machines. This feature can be used if you do not want the Goverlan Service and other agents to run on business critical servers or other types of machines or if you want to "freeze" a particular version of the Goverlan Agents.

To prevent the installation or the update of Goverlan Agents on a machine, add the following registry entry:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\PJ Technologies\Goverlan Universal Settings\GAGT\GA_ProtectionType :: REG_DWORD = {0 | 1 | 2}

and set its value as follows:

0     => If the GA_ProtectionType value doesn't exist or is set to 0, the normal agents update behavior is executed

1     => Prevents the installation of Goverlan Agents on the local machine

2     => Prevents the update of Goverlan Agents on the local machine

Tip: This setting may be distributed using Active Directory Group Policy (see Distributing Settings Using a Group Policy Object.)

Note: The registry key path of the GA_ProtectionType value as specified above is valid for Goverlan v6.01 and later. If prior versions of the Goverlan Management Console are running, they will not respect the value of this setting. In such a case, new registry modifications are required. Contact our support team for more information.

Creating a software distribution package of the Goverlan Agents

You can easily create a software distribution package of the Goverlan agents using the Goverlan Client Agents.msi file. This can be useful if you want to use a software distribution product to dispatch Goverlan Agents on your machines.

The Goverlan Client Agents.msi file installs Goverlan Agents on the local machine and registers them. Optionally, it can also apply miscellaneous settings on the local machine.

For more information about this option, refer to the article: Goverlan Client Agent Installer

Troubleshooting the Remote Installation of the Goverlan Agents

If you are attempting to remotely install the Goverlan Agents and the process is failing, use the following guidelines to assist in resolving the issue.


The following dependencies apply for the remote installation of the Goverlan Agents. Once the agents are installed, these dependencies no longer apply:

Network Accessibility

First, the remote machine must be accessible. For this, we need the following:

Open a command prompt and ping the remote machine by its Short name (ie:  ping  SOME_MAC01 ). An IP address should be returned. If an IP Address is not returned, either the name resolution didn't work or the machine is not reachable.

File System Accessibility

Goverlan needs to transfer the agent files over to the client machine. In order to do that, it uses the C$ and ADMIN$ shares. Make sure that these shares are accessible:

Select Start > Run from Windows, type \\SOME_MAC01\C$ and press enter. This instructs Windows to open the C$ share of the client machine. Make sure that this operation succeeds.

Registry Accessibility

Goverlan needs to access a registry key on the client machine in order to query some file system information. Make sure that the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion key of the client machine is accessible from your machine:

For further instruction, please refer to our Knowledge Web Site.


See Also:

Goverlan Client Agent Installer