Contents

Anchor
_heading=h.30j0zll _heading=h.30j0zll

Introduction

This document discusses the different methods to install the GV Agent file on a single machine and across multiple machines. Based on the requirement you can install the flavors for the agent. For Eg to apply for Seclore protection you need to install the seclore flavor agent, remaining all the steps are the same as mentioned below.

Anchor
_heading=h.1fob9te _heading=h.1fob9te

Basic Installation Method

Pre-requisites

• The MSI file of the agent.

• installerConfig.json file (optional)

• Windows 10 machine

• Admin access to install the agent

...

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. Place the  “installerConfig.json” file given by GV in the same place where the agent is present on the machine.

   

4. Edit the InstallerConfig file and edit the files based on the document below as per requirement:

   Agent - installerConfig.json

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

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

   

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

   

8. 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”
   

   

9. Press “finish”. The agent is installed now

Anchor
_heading=h.3znysh7 _heading=h.3znysh7

Installation through CLI

Pre-requisites
The MSI file of the agent + installerConfig.json file.

...

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.

Anchor
_heading=h.2et92p0 _heading=h.2et92p0

Installation through group policy (GPO)

Pre-requisites
The MSI file of the agent.

...

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.

...

Anchor
_heading=h.tyjcwt _heading=h.tyjcwt

Installation through SCCM

Pre-requisites

1. SCCM Server

2. Access to the SCCM Server

3. GV Agent MSI file

...

The arguments can be passed directly to the msiexec command, e.g: msiexec /i "path_to_msi.msi" LAUNCHAGENT=0

• CONFIGFILE - determines configuration used during the deployment, see more: Config values - instead of using installerConfig.json (Agent - installerConfig.json) to provide the config, it’s possible to inject them via CLI arguments (starting from version 4.0.0 of the agent):

  • SERVERADDRESS

  • SERVERUSESSL

  • LANGUAGE

  • VISUALSTYLE

  • KEYCLOAKCLIENTID

  • KEYCLOAKAUTHTYPE

  • KEYCLOAKUSERNAME

  • KEYCLOAKUSERPASSWORD

  • KEYCLOAKCLIENTSECRET

  • KEYCLOAKCERTIFICATECONTENT

  • KEYCLOAKKEYCONTENT

The arguments can be passed directly to the msiexec command, e.g: msiexec /i "path_to_msi.msi" CONFIGFILE=C:\Users\Administrator\Desktop\installerConfig.json" SERVERADDRESS="{server_address}" SERVERUSESSL="True" LANGUAGE="en" VISUALSTYLE="1" KEYCLOAKCLIENTID="agent_v2" KEYCLOAKAUTHTYPE="1" KEYCLOAKUSERNAME="agent" KEYCLOAKUSERPASSWORD="{pwd}" KEYCLOAKCLIENTSECRET="{secret}"

GVClient.Tools.SetupHelper can help generate the proper command:

...

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

Further installation steps

• Preventing Users From Disabling Getvisibility Agent - Getvisibility - Confluence (atlassian.net)