Doc Title
Forcepoint
Forcepoint Data Classification Powered by
GetVisibility Agent Installation
Report
Forcepoint
December 20, 2022
forcepoint.com Forcepoint Proprietary
GetVisibility: Agent Installation forcepoint.com
Table of Content
INTRODUCTION.................................................................................................................................................................. 2
BASIC INSTALLATION METHOD ..................................................................................................................................... 2
INSTALLATION THROUGH CLI ........................................................................................................................................ 4
INSTALLATION THROUGH GROUP POLICY OBJECT (GPO) ..................................................................................... 5
INSTALLATION THROUGH SCCM ................................................................................................................................... 9
INSTALLATION OF THE GENERIC AGENT .................................................................................................................. 10
© 2022 Forcepoint Forcepoint Proprietary 1
GetVisibility: Agent Installation forcepoint.com
Introduction
This document provides the different methods to install the GetVisibility Agent file on a single machine and across multiple
machines.
Basic Installation Method
Pre-requisites:
1. The MSI file of the agent.
2. Windows 10 machine.
3. 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 opened 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 on Install.
Figure 1: GetVisibility Classifier Setup
5. Click Yes to allow the app to make changes to your device.
© 2022 Forcepoint Proprietary
2
GetVisibility: Agent Installation forcepoint.com
Figure 2: User Account Control
6. The installer will check:
a) If the Microsoft Visual Studio Tools 2010 is installed on the machine.
b) If not, then the user will be prompted with a dialog box to install it first.
o Check the box and click on Install.
© 2022 Forcepoint Proprietary
3
GetVisibility: Agent Installation forcepoint.com
Figure 3: Microsoft Visual Studio Tools 2010
Note: In case the machine does not 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 link to download Microsoft Visual Studio Tools 2010:
https://www.microsoft.com/en-us/download/details.aspx?id=48217
7. Click on Finish. The agent is installed now.
Installation through CLI
Pre-requisites:
1. The MSI file of the agent.
2. Windows 10 machine.
3. Admin access to install the agent.
Steps:
1. Open PowerShell as an Administrator and run the following command to install the Agent:
Start-Process -Wait -ArgumentList "/qn" -PassThru -FilePath
'C:\Users\adm\Downloads\GVClient.2.10.0-CustomerName.msi'
© 2022 Forcepoint Proprietary
4
GetVisibility: Agent Installation forcepoint.com
Note: Where the FilePath argument contains the path of the file that needs to be installed.
Installation through Group Policy Object (GPO)
Pre-requisites:
1. The MSI file of the agent.
2. Windows 10 machine.
3. Domain Admin level access to the Domain Controller.
Steps:
1. Create a folder and bring the agent file here.
2. Create a Network Share for the folder where the agent will reside.
3. Assign access to the Domain Computers with the read level permissions. Now the MSI file is available to all the Domain
accounts.
Figure 4: Create a folder and bring the agent file here
Figure 5: The available MSI file for Domain accounts
© 2022 Forcepoint Proprietary
5
GetVisibility: Agent Installation forcepoint.com
4. Switch to DC1 server, navigate to Group Policy Management console > Domains and then expand the Domains tree.
Figure 6: Location to create new GPO
Note: You must create the Group Policy Object (GPO) to install the software on every computer.
5. Select the Domain in which you want to create the GPO and right-click the Domain.
6. From the context menu, select Create a GPO in this domain and link it here.
Figure 7: Domain context menu
© 2022 Forcepoint Proprietary
6
GetVisibility: Agent Installation forcepoint.com
7. Set a new Name for your GPO and click on OK.
Figure 8: New GPO tab
8. To edit the new GPO:
c) Select the new GPO and right click the new GPO.
d) Click on Edit from the context menu.
Figure 9: Edit your GPO
9. Navigate to Computer Configuration > Policies > Software Settings.
10. Select Software installation and right click on that.
11. From the context menu, select New and then click on Package.
© 2022 Forcepoint Proprietary
7
GetVisibility: Agent Installation forcepoint.com
Figure 10: Software installation context menu
12. Browse to the location of your software MSI file and locate it.
13. Double click on the MSI file or select the MSI file and click on the Open button.
Figure 11: Location of the MSI file
14. Select Assigned on the dialog box and click on OK.
© 2022 Forcepoint Proprietary
8
GetVisibility: Agent Installation forcepoint.com
Figure 12: Deploy Software dialog box
15. To update the group policy object:
a) Open a command prompt on the domain controller and enter gpupdate / force.
b) After the update runs, restart one of your client machines.
Note: You must do a hard reboot to install the software on a computer.
Figure 13: Command prompt on the domain
Installation through SCCM
Pre-requisites:
1. Access to the SCCM Server.
2. GV Agent MSI file.
© 2022 Forcepoint Proprietary
9
GetVisibility: Agent Installation forcepoint.com
Steps:
1. Open SCCM server and navigate to Home > Applications.
2. Then create an application for the software to deploy.
3. Create User Collection to add a user group and here you can set all the rules for deployment.
4. From the Create User Collection Wizard browse and select the target distribution group.
5. Click on Next to finish the settings.
6. From the Deployment Settings, set the Action to install and the Purpose to Available.
7. Click to check box Require administrator approval if users request this application.
8. This will make the software available to the end user but will need administrator permission to install it.
9. To finish the task, click on Next.
10. The software is now deployed to the end user. Click on Close to exit the program.
11. 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 in the installation steps but requires a configuration file as an
addition along with the MSI file.
Pre-requisites:
1. 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 where the agent is present on the machine.
Figure 14. Path to save the json file
2. Edit the InstallerConfig file and add the following variables and their respective values. Click on save.
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
© 2022 Forcepoint Proprietary
10
GetVisibility: Agent Installation forcepoint.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. (For example: Forcepoint). Default: empty
"Name": "",
"ServerAddress": "",
"ServerUseSsl": true,
"KeycloakClientId": "",
"KeycloakUsername": "",
"KeycloakCertificateContent": "",
"KeycloakKeyContent": "",
"SentryDsn": "",
"AutoUpdateArtifactsUri": "",
"UIStyle": ""
3. Now proceed with installation of the agent.
References
Link to install MSI file through GPO: https://community.spiceworks.com/how_to/160869-how-to-install-exe-with-group-policy
Link to install MSI file through SCCM: https://pdf.wondershare.com/business/how-to-deploy-software-with-sccm.html
© 2022 Forcepoint Proprietary
11
GetVisibility: Agent Installation forcepoint.com
About Forcepoint
forcepoint.com/contact Forcepoint is the leading user and data protection cybersecurity
company, entrusted to safeguard organizations while driving
digital transformation and growth. Forcepoint’s humanly-attuned
solutions adapt in real-time to how people interact with data,
providing secure access while enabling employees to create
value. Based in Austin, Texas, Forcepoint creates safe, trusted
environments for thousands of customers worldwide.
© 2022 Forcepoint. Forcepoint and the FORCEPOINT logo are trademarks of Forcepoint.
All other trademarks used in this document are the property of their respective owners.
[Forcepoint Data Classification Powered by GetVisibilitty Agent Installation] [Status]20 Dec.
© 2022 Forcepoint Forcepoint Proprietary 12
22
