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:

Administration & Diagnostic mode:

Scope Actions mode:
During a Scope Action execution, Goverlan cannot prompt you for the installation or the update of Goverlan Agents. The behavior adopted during a scope action execution depends on these settings.

Checking the Goverlan Agents Status on a Remote Machine

To view the Goverlan Agents status on a target machine, open its System Information window. The Goverlan Agents status, version number and available actions are displayed on the top right corner of this window.

You can also use a Scope Action to generate a report of the Goverlan Agents status for a group of machines.

Note: The Goverlan Agents have their own version number which is different from the Goverlan Management Console version number.

Manual Installation/Removal of Goverlan Agents

The installation, update or removal of Goverlan Agents on a remote machine can also be forced manually. You can do it via any of the following methods:

Using the Administration & Diagnostic feature

Select the machine’s icon from the Users view or the Machines view, right click on the mouse and select Install Goverlan Agents or Remove Goverlan Agents accordingly.

Using the Help Menu

Click on the Help menu located in the top right corner of the main application, and select Add/Remove Client Agents. Add one or more machine objects to the list and click on Install Agents or Remove Agents.

Using a Scope Action

To do a mass install, update or removal of Goverlan agents on your network, use a Scope Action. Create a new Scope Action, define its name and scope, create an Action Module and under Actions select: Add / Remove > Execute Computer Action > Goverlan Agents > Install / Update Agents (or Un-install Agents).

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.)

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.

Dependencies

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. Please verify that this operation has been done successfully.

Registry Accessibility

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

For more instructions, please refer to our Knowledge Web Site.