Doc Title

Forcepoint

Forcepoint Data Classification Powered by

GetVisibility Agent - AutoUpdate Feature

Report

Forcepoint
December 20, 2022
forcepoint.com Forcepoint Proprietary
Getvisibility: Agent - AutoUpdate Feature forcepoint.com

Table of Contents

INTRODUCTION.................................................................................................................................................................. 2
BASIC INFORMATION ....................................................................................................................................................... 2
CONFIGURE ARTIFACTS URI ............................................................................................................................................... 2
LOCAL FILESYSTEM PATH .................................................................................................................................................... 2
AUTO UPDATE PROCESS ................................................................................................................................................ 2
UPGRADE PROCESS ........................................................................................................................................................ 3
DOWNGRADE PROCESS.................................................................................................................................................. 3

© 2022 Forcepoint Forcepoint Proprietary 1

GetVisibility: Agent - AutoUpdate Feature forcepoint.com

Introduction
This document provides a high-level understanding of how auto update feature will work in Data Classification Agent. The latest
updates of Data Classification will update automatically, and no action needs from the end user. This document explains the
technical side of how this feature functions.

Basic Information
Configure Artifacts URI

→ The Artifacts URI is the location from which update artifacts (in form of zip packages) will be fetched and applied.
→ The default URI for the auto-update feature is the same as the agent edge.
→ The default URI for Forcepoint is FPs GV server.
→ The default config will give to Forcepoint, and every Forcepoint customer has their own auto-update deployment version.
→ GetVisibility manages the artifacts for Forcepoint through normal deployment process.
→ The URI can be specified in the installerConfig.json file of the generic installer:

...

"AutoUpdateArtifactsUri": ""

The URI should be in Local Filesystem path format.

Local Filesystem path

The path must point to an existing directory on the clients PC.

For example: C:\Autoupdate\Artifacts.

Auto Update Process

1. During the installation of GVClient, a new Windows Service is installed on the machine which will check for updates are:
→ Start-up
→ Periodically check the updates every 5 to 15 mins for all agents in all the end user (it can be changed in
AutoUpdateService config:
C:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\GVClient.Windows.AutoUpdateSer
vice\GVClient_Windows_AutoUpdateService_Properties.config.json)

2. During the routine check for updates, the service lists all packages from the provided URI and applies the Upgrade or
Downgrade in the following scenarios:
→ Upgrade: when the latest available version is higher than the current version.
→ Downgrade: when the latest available version is lower than the current version.

© 2022 Forcepoint Forcepoint Proprietary

2
GetVisibility: Agent - AutoUpdate Feature forcepoint.com

3. By default, the application is installed under C:\Program Files (x86)\GVClient\app-x.x.x

Note: The 'x' stands for the current version.

Upgrade Process
When a newer version is detected, the AutoUpdateService will execute the following steps:

1. Download the latest package to a temp folder.

2. Extract the package to the installation directory under a new version folder:
For example: If the application was installed under C:\Program Files (x86)\GVClient\ and the latest package
version is 2.9.1, then the latest package will be extracted to C:\Program Files (x86)\GVClient\app-2.9.1.

3. Start a new AutoUpdateService process (with the argument -execute_version_apply {version}).

4. The new process will execute the following steps:

a) Update plugin registry keys to point to the new version.
b) Update AgentUI autorun registry to point to the new version.
c) Kill PlatformHub service.
d) Kill any running AutoUpdateService.
e) Update PlatformHub service to point to the new version and start it.
f) Update AutoUpdateService to point to the new version and start it.
g) Update installed version registry keys.
h) Exit.

Downgrade Process
All the steps are similar to upgrade process, but all configs will be adjusted to point to the lower version.

© 2022 Forcepoint Forcepoint Proprietary

3
Getvisibility: Agent - AutoUpdate Feature 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 GetVisibility Agent - AutoUpdate Feature]
© 2022 Forcepoint Forcepoint Proprietary 4
[Status]20 Dec. 22