Contents

Introduction

This document discusses the different methods to install the GV Agent file on a single machine and across multiple machines.

Basic Installation Method

Pre-requisites

• The MSI file of the agent.

• Windows 10 machine

• Admin access to install the agent

Steps

1. Download the MSI file to the Windows machine

2. Make sure all the office applications are not open to ensure the clean installation of the agent

3. Double click on the agent to proceed with the installation

4. Check the box to accept the terms in the License Agreement and click Install.
   
   

   

Click “Yes” to allow the app to change your device.

The installer will check if the Microsoft visual studio tools 2010 is installed and if not then the user will be prompted with the below dialog box to install it. Check the box and click on the button “install”

Note: In case the machine doesn't have access to the internet then either the Microsoft website should be whitelisted or the executable file of the Visual Studio need to be brought inside to that machine. Here is the download link: https://www.microsoft.com/en-us/download/details.aspx?id=48217
Press “finish”. The agent is installed now

Installation through CLI

Pre-requisites
The MSI file of the agent.

1. Windows 10 machine

2. Admin access to install the agent

Steps
Open PowerShell as an Administrator and run the following command to install the Agent

Where the “FilePath” argument contains the path of the file that needs to be installed.

Installation through group policy (GPO)

Pre-requisites
The MSI file of the agent.

1. Windows 10 machine

2. Domain Admin level access to the Domain Controller

Steps

Create a folder and bring the agent file here.

Create a Network Share for the folder where the agent resides and assign access to the Domain Computers with the read level permissions. Now the MSI file will be available to all the Domain accounts.

Switch to our DC1 server and open the Group policy management console. Then expand Domains and then the domain in which you want to create the GPO.

Once you are in the correct domain, expand the Organizational Unit. Since we want the software to be installed on every single computer, we are going to create the Group Policy Object. Go ahead and click on that OU. To create a new GPO, right-click on the appropriate Organization Unit and select “Create a GPO in this domain, and Link it here”

Name your new GPO and hit OK.

Edit the new GPO: Select and then right-click on the GPO under the Organization Unit. Then select Edit.

Go ahead and expand Computer Configuration, then Policies, and then Software Settings.
Next click on and select Software Installation. Right-click on the right side of the Software Installation, select New and then click on Package.

Browse to the location where your software .msi file exists. Once you have located it, double click on the file or select it and then click on the “Open” button.

Select Assigned and click OK.

Don't forget to start updating the group policy object. To do this, open a command prompt on the domain controller and enter “gpupdate / force”
Once the update runs through you can go to one of your clients and restart the machine. Remember that for the software to be installed on a computer, you will need to do a hard reboot.

Installation through SCCM

Pre-requisites

1. SCCM Server

2. Access to the SCCM Server

3. GV Agent MSI file
   

Steps

1. Open SCCM and navigate to the Home tab and click on Applications. Then you need to create an application for the software to deploy

2. Create User Collection” to add a user group. In this progress, you need to set all the rules for deployment. From the Create User Collection Wizard browse and select the target distribution group. Here BPO users have been set as an example. Hit the “Next” button to finish the setting.

3. From the Deployment Settings, set the Action to install and the Purpose to Available. Click to check the box named “Require administrator approval if users request this application.” This will make the software available to the end user but will need administrator permission to install it. To finish the task, click on “Next”. The software in now deployed to the end user. Click on close to exit the program. You can check the details of deployment on the deployment completion page.

Installation of the Generic Agent

The agent can be installed with the similar approach mentioned above but requires a configuration file as an addition along with the MSI file.

Pre-requisites
GV generic agent

Note: Other prerequisites will be defined based on which of the above listed approaches is chosen for installation 

Steps

1. Place the  “installerConfig.json” file given by GV in the same place where the agent is present on the machine.
   

   

2. Edit the InstallerConfig file and add the following variables and their respective values and Save it.
   
   For versions >= 2.10.0 - The config file is a .json which accepts the following fields:

   Name - Name of customer. Used to set the Sentry environment. Default: agent

   ServerAddress- Address of the AgentEdge. The address should be without the schema and should not include the port. Default: gvqa.gvdevelopment.k3s.getvisibility.com

   ServerUseSsl- if SSL should be used. For SSL the port 443 will be used, otherwise 80. Default: true

   KeycloakClientId - The ClientId configured in Keycloak. Default: agent

   KeycloakUsername - The Username configured in Keycloak. Default: agent (email: agent@gv.com)

   KeycloakCertificateContent - The .crt of the user certificate. Default below.

   KeycloakKeyContent - the .key of the user certificate. Default below.

   SentryDsn - Sentry URL. Default: empty

   AutoUpdateArtifactsUri - AutoUpdate artifacts URI

   UIStyle - UI style of the agent. (e.g. Forcepoint). Default: empty

{
	"Name": "",
	"ServerAddress": "",
	"ServerUseSsl": true,
	"KeycloakClientId": "",
	"KeycloakUsername": "",
	"KeycloakCertificateContent": "",
	"KeycloakKeyContent": "",
	"SentryDsn": "",
	"AutoUpdateArtifactsUri": "",
	"UIStyle": ""
}

Now proceed with the installation of the agent

References

MSI file installation through GPO:
https://community.spiceworks.com/how_to/160869-how-to-install-exe-with-group-policy

MSI file installation through SCCM: https://pdf.wondershare.com/business/how-to-deploy-software-with-sccm.html