EV Reach Client Agent - Installing the Agent Manually

Last modified on 2023/07/12 14:02

Contents

Information

Note: This article relates to the EV Reach v8 release only. If you are using EV Reach, see: Client Agent Deployment and Management

This article describes the utilities available in the EV Reach remote access software client agent installer resource kit. Use the Agent Installer Resource kit for manual installation of the agent or for third party installation utilities.

Information

The EV Reach Client Agent Resource Kit files are located in the EV Reach installation directory (i.e.: C:\Program Files(x86)\EV Reach v7 or EV Reach v8) in the folder called EV Reach Client Agent Installer . The EV Reach Client Agent Resource Kit contains a set of utilities to distribute the EV Reach Agents as well as to configure the EV Reach client settings on a local machine.

File Descriptions

Readme.txt	Information file. Provides a description of the utilities.
EV Reach Client Agents.msi	EV Reach Agents MSI Installer.
GovAgentInstallHelper.exe	Command line utility which sets client side settings
GovAgentInstaller.ini	Client side settings configuration file.

EV Reach Client Agents.msi

EV Reach Client Agents.msi You can use the EV Reach Client Agents.msi file to pre-install the EV Reach Agents on a local machine. The installer replaces any existing EV Reach Agents with the ones included in this MSI. The EV Reach Services and the EV Reach Event Logs are registered.

Note: Administrative Privileges are required to install the EV Reach Agent. Please install the agent with an account that has local admin rights. If UAC is enabled, Hold Shift and right click the .MSI file. Select Run as Different user and enter the local admin credentials. Alternatively you can run CMD.exe as Administrator and run MSIEXEC as stated below.

To run the installer, execute the EV Reach Client Agents.msi file and follow the installation wizard. Once the agents are installed, you can use the Programs and Features control panel applet to remove the agents.

You can optionally configure the EV Reach client settings during the installation (see Advanced settings).

Quiet Mode

To run the installer in silent mode, use the Windows Installer command line options as indicated below.

To install in silent mode, execute: msiexec /i "MSI-FILE-PATH\GoverLAN Client Agents.msi" /qb
To un-install in silent mode, execute: msiexec /x "MSI-FILE-PATH\GoverLAN Client Agents.msi" /qb

Advanced settings

You can optionally include a GovAgentInstaller.ini file in the same directory as the EV Reach Client Agents.msi to specify advanced configuration settings. This ini file allows you to configure the following:

Configure the RMC Client Settings.
Apply special permission on the RMC Client Settings.
Create and configure a 'EV Reach Remote Control Admins' local group.

A documented GovAgentInstaller.ini file has been included.

GovAgentInstallHelper.exe

If you simply need to apply the EV Reach Client Side Security Settings on a machine but do not need to re-install the EV Reach Agents, use the GovAgentInstallHelper.exe. Create a configure a GovAgentInstaller.ini file with the preferred settings and place it in the same directory as the GovAgentInstallHelper.exe file, then run the GovAgentInstallHelper.exe process as follows:

GovAgentInstallHelper /R /S:INITIALIZATION_FILE_PATH

where INITIALIZATION_FILE_PATH is the full path of the GovAgentInstaller.ini file (do not include 'GovAgentInstaller.ini'in the path). i.e.: GovAgentInstallHelper /R /S:\\SERVERNAME\INSTALLSHARE\GovSettings\

To configure the client side settings on a set of machines, create a EV Reach Scope Action with a 'Computer.Processes.Start a new process' action configured to run the process with the appropriate arguments.

Troubleshooting

The installer progress and registrations are logged into the GovAgentInstaller.log file. The GovAgentInstaller.log file is generated in the same directory as the MSI or the GovAgentInstallHelper.exe file.

Tags: