Full Upgrade
Full Upgrade
Upgrade Instructions | Web, Data, and Email Solutions | Version 8.5.x, 8.6.x, 8.7.x
This guide describes how to upgrade a Forcepoint deployment with multiple modules
—web, email, and/or data—to 8.5.x, 8.6.x, 8.7.x. For information on upgrading
systems that include stand-alone installations of data, email, or web protection
solutions, refer to the Deployment and Installation Center in the Forcepoint Technical
Library.
Forcepoint security solutions must be at one of the following versions to upgrade to
v8.5.x:
● v8.1.x (to v8.5 only; upgrade to v8.5.3 or v8.5.4 is not supported)
● v8.2.x
● v8.3.x
● v8.4.x
● v8.5.x, 8.6.x, 8.7.x (to v8.5.3 or v8.5.4)
For information on upgrading from earlier versions to version 7.8.4, see Upgrading
TRITON Enterprise v7.7.x to v7.8.x. For information about upgrading from v8.0 to
v8.3, see Upgrading TRITON APX Suite to v8.3.
Because Forcepoint Email Security includes Forcepoint DLP components, the
upgrade procedure for combined web and email solutions is the same as the upgrade
procedure for all Forcepoint modules.
Certain older V10000 and V5000 appliances are not supported with version 8.0.0 and
higher. See Appliances supported with version 8.x.
To upgrade to 8.5.x, 8.6.x, 8.7.x, see:
● System requirements for this version
● Before upgrading Forcepoint security solutions, page 2
● Upgrade procedure for Forcepoint security solutions, page 5
Perform the upgrade in the order described. This sequence is critical, because if you
upgrade supplemental servers or agents before the management server, they stop
Upgrade Guide 1
communicating. If you upgrade the management server first, it continues
communicating with the components until they are upgraded.
Important
Forcepoint Security Solutions v8.5.x does not support
dual-mode appliances. Dual-mode appliances host both
Forcepoint Email Security and Forcepoint Web Security,
or Forcepoint Email Security and Forcepoint URL
Filtering.
If you are upgrading a dual-mode appliance, see V Series
Dual-Mode Appliance Upgrade Guide.
The upgrade process guides you through upgrading all components on the selected
machine.
■ You cannot choose which components to upgrade.
■ Partial upgrades are not supported.
■ Upgrades must proceed in the exact order listed in Upgrade procedure for
Forcepoint security solutions, page 5.
When upgrading the Forcepoint management server, if upgrade fails for any
component except Forcepoint Management Infrastructure, you can either continue to
upgrade the rest of the components or exit the process and modify component settings.
■ You cannot continue if the infrastructure upgrade fails.
■ You cannot roll back a component that was upgraded successfully.
After upgrade, your system has the same configuration as before the upgrade. Apart
from the option to edit the Forcepoint Email Security database IP address if it has
changed since installation, the upgrade process does not allow you to change your
configuration or settings.
To prepare for the upgrade:
● Read the relevant 8.5.x, 8.6.x, 8.7.x release notes.
■ Release Notes for Forcepoint Web Security and Forcepoint URL Filtering
(version 8.5.4)
■ Release Notes for Forcepoint Web Security and Forcepoint URL Filtering
(version 8.5.3)
■ Release Notes for Forcepoint DLP (version 8.7)
■ Release Notes for Forcepoint DLP (version 8.6)
■ Release Notes for Forcepoint Email Security (version 8.5.4)
■ Release Notes for Forcepoint Email Security (version 8.5.3)
Upgrade Guide 2
■ Release Notes for Forcepoint Appliances (version 8.5.4)
■ Release Notes for Forcepoint Appliances (version 8.5.3)
● Verify the current deployment. Unless instructed otherwise by Forcepoint
Technical Support, ensure that your system is functional prior to upgrade, and that
required network interfaces have reliable connections to Forcepoint components
and the Internet. The upgrade process does not repair a non-functional system.
● Ensure the time set on all appliances is synchronized prior to upgrade.
● If you are not already familiar with the preparation required for upgrading off-
appliance components, review the requirements before upgrading your
appliances.
● Verify the system requirements for the version to which you are upgrading. See
System requirements for this version.
● Prepare Windows components. See Preparing for installation for an explanation
of general preparations for upgrading the Windows components in your security
solution.
● Ensure that your firewall is configured correctly so that the ports needed for
proper protection are open. See Default ports for on-premises Forcepoint
security solutions.
● Prepare Microsoft Azure virtual network if you are upgrading to Forcepoint Email
Security in Azure. See Installing Forcepoint Email Security in Microsoft Azure.
● Prepare for service disruption during upgrade. Appliance services are not
available while the upgrade is applied, continuing until the appliances finishes its
final restart. Service is not disrupted while the off-appliance components are
upgraded.
● If you are using link aggregation and plan to enable VLAN support after upgrade,
disable link aggregation before enabling VLAN support on the blade or chassis.
VLAN is only available on X Series appliances.
● If you are already using Virtual Machines (VMs) for Forcepoint Security Manager
or for Microsoft SQL Server, take a snapshot of the VMs before you start a
Forcepoint upgrade.
● If you have a remote database, ensure that the SQL account has a sysadmin role.
● Back up all of your Forcepoint components before starting the upgrade process. If
you are upgrading from v7.x, see Backup and Restore FAQ for instructions. If
you are upgrading from v8.x, see Backup and Restore FAQ v8.x.
The Backup and Restore FAQ includes instructions for backing up all of the
pieces that make up Forcepoint Web Security Hybrid Module (formerly Web
Security Gateway Anywhere) on all platforms:
■ Forcepoint Management Infrastructure
■ Web Security components
■ Content Gateway
■ Data Security components
● (Appliance upgrades only) Uninstall the following hotfix:
Upgrade Guide 3
■ If you have any appliance with Hotfix 200 (Spectre/Meltdown Hotfix)
installed, you must uninstall the hotfix before upgrading to v8.5. After
upgrading, reinstall Hotfix 200 on the new version.
● (Appliance upgrades only) Install the following hotfix:
■ If you are a Forcepoint V5000 G2R2 customer upgrading from v8.4 to v8.5,
you must install 8.4 Appliance Hotfix 101 (APP-8.4.0-101) before upgrading.
● (Forcepoint Email Security upgrades) Back up and remove tomcat log files and
remove temporary manager files (optional; recommended to facilitate timely
Forcepoint Security Manager upgrade). Use the following steps:
1. Log onto the Windows server where the Forcepoint Security Manager resides.
2. Navigate to the following directory:
C:\Program Files (x86)\Websense\Email Security\ESG
Manager\tomcat\logs
3. Copy C:\Program Files (x86)\Websense\Email Security\ESG
Manager\tomcat\logs to another location (for example, to
C:\WebsenseBackup\Email), and then delete it in the directory mentioned in
step 2.
4. Navigate to the following directory:
C:\Program Files (x86)\Websense\Email Security\ESG
Manager\tomcat\tempEsgUploadFileTemp
5. Delete all the downloadFile* files.
● Inventory all customizations and make a plan for restoring any that are required.
Customizations are not retained through the upgrade process. After your upgrade,
contact Forcepoint Technical Support for assistance with restoring files from your
pre-upgrade file system. Customizations can include:
■ Custom patches
■ Hand updated files
■ Extra packages added
■ Extra files added, binary or configuration
● Back up appliance configuration and settings. It is critical to perform a full
appliance configuration backup and save it to a filestore.
1. Log onto the CLI and elevate to config mode.
2. To perform an immediate full backup, use:
create backup now --location filestore_alias [--desc
"<description>"]
3. Include a unique description to make it easier to identify backup files that may
have very similar names and dates.
Upgrade Guide 4
Upgrade procedure for Forcepoint security solutions
When upgrading multiple Forcepoint components, you must upgrade them in the
following order.
For information on upgrading systems that include standalone installations of data,
email, or web protection solutions, refer to the Deployment and Installation Center in
the Forcepoint Technical Library.
Forcepoint Security Solutions v8.5 does not support dual-mode V Series appliances
(that is, appliances that host Forcepoint Email Security and Forcepoint Web Security,
or Forcepoint Email Security and Forcepoint URL Filtering). If you are upgrading a
dual-mode appliance, see V Series Dual-Mode Appliance Upgrade Guide.
This procedure covers the steps required to upgrade either the all on-premises security
solutions or Web and Email solutions (given that Email includes Data components).
● Step 1: Upgrade the Policy Broker machine, page 5
● Step 2: Upgrade additional Policy Server machines, page 7
● Step 3: Upgrade additional Filtering Service and User Service machines, page 8
● Step 4: Upgrade Log Servers, page 10
● Step 5: Upgrade the management server, page 10
● Step 6: Upgrade appliances, page 16
● Step 7: Upgrade additional components, page 16
Upgrade Guide 5
For a software installation, run the Forcepoint Security Installer or Web Linux
installer. The instructions in this section cover the upgrade of a Windows machine. For
instructions on upgrading an appliance or a Linux machine, see the Upgrade Guide:
Forcepoint Web Security.
1. Make sure that no administrators are logged on to the management console.
2. Log on to the installation machine with an account having domain and local
administrator privileges.
Important
If you are upgrading Log Server on this machine and it
uses a Windows trusted connection to access the Log
Database, you must log on to this machine using the same
trusted account.
Warning
Be sure to close the Windows Event Viewer, or the
upgrade may fail.
Upgrade Guide 6
Critical files are backed up and install properties initialized, and then the upgrade
begins.
If Policy Broker resides on the management server, or on the same machine as
Log Server, the upgrade process checks for a required version of Microsoft SQL
Server Native Client and related tools and installs them, if necessary.
11. Wait for the Upgrade Complete screen to appear. Click Done to exit the installer.
12. Reboot the machine.
Important
The machine must be rebooted to complete the upgrade
process.
Important
If you are upgrading Log Server on this machine and it
uses a Windows trusted connection to access the Log
Database, you must log on to this machine using the same
trusted account.
Warning
Be sure to close the Windows Event Viewer, or the
upgrade may fail.
Upgrade Guide 7
4. Go to the Downloads tab of My Account to download the Forcepoint Security
Installer.
■ The installer file is Forcepoint85xSetup.exe.
■ The installer and its extracted files require approximately 7 GB of disk space.
■ Verify that the MD5 value of the downloaded file matches the value shown on
the download page.
5. Right-click Forcepoint85xSetup.exe and select Run as administrator to launch
the installer. A progress dialog box appears, as files are extracted.
The installer detects Web components from an earlier version and asks how you
want to proceed.
6. Click OK.
7. On the installer Introduction screen, click Next.
The Installer Dashboard remains on-screen, behind the installer screens
mentioned in the remaining steps.
8. On the Upgrade screen, select Start the upgrade, then click Next.
9. Accept the subscription agreement. When you click Next, a Stopping All Services
progress message appears. Wait for services to be stopped.
The Pre-Upgrade Summary screen appears when the services have been
stopped.
In some cases, the installer may be unable to stop the services. If this occurs, you
are prompted to stop them manually (you do not need to exit the installer to do
this). Use the Windows Services tool to stop the services, then return to the
installer.
10. On the Pre-Upgrade Summary screen, review the list of components that will be
upgraded, and then click Next.
Critical files are backed up and install properties initialized. And then the
Installing Forcepoint screen appears.
11. Wait for the Upgrade Complete screen to appear. Click Done to exit the installer.
12. Reboot the machine.
Important
The machine must be rebooted to complete the upgrade
process.
Upgrade Guide 8
● Windows Server 2008 R2 SP1, 2012, or 2012 R2 machines
● RHEL 6.5 or later, 7.0, 7.1, or 7.2 machines
Filtering Service and Network Agent may also reside on filtering only appliances.
If you have filtering only appliances in your deployment, upgrade these appliances
after the corresponding full policy source or user directory and filtering appliance has
been upgraded. This is because appliances that have instances of Policy Server must
be upgraded before you upgrade any components that point to it.
The instructions in this section cover the upgrade of a Windows machine. For
instructions on upgrading an appliance or a Linux machine, see Upgrade Guide:
Forcepoint Web Security.
Make sure that no administrators are logged on to the management console.
1. Log on to the installation machine with an account having domain and local
administrator privileges.
Important
If you are upgrading Log Server on this machine and it
uses a Windows trusted connection to access the Log
Database, you must log on to this machine using the same
trusted account.
Warning
Be sure to close the Windows Event Viewer, or the
upgrade may fail.
Upgrade Guide 9
The Pre-Upgrade Summary screen appears when the services have been
stopped.
In some cases, the installer may be unable to stop the services. If this occurs, you
are prompted to stop them manually (you do not need to exit the installer to do
this). Use the Windows Services tool to stop the services, then return to the
installer.
9. On the Pre-Upgrade Summary screen, review the list of components that will be
upgraded, and then click Next.
Critical files are backed up and install properties initialized. And then the
Installing Forcepoint screen appears.
10. Wait for the Upgrade Complete screen to appear. Click Done to exit the installer.
11. Reboot the machine.
Important
The machine must be rebooted to complete the upgrade
process.
Important
Make sure that no Email Log Database or Web Log
Database jobs are running while the Log Server instances
are being upgraded.
For information on Web Security Log Server, see Upgrade Guide: Forcepoint Web
Security.
For information on Email Security Log Server, see Upgrading to Forcepoint Email
Security v8.5.
Upgrade Guide 10
● Whenever possible, upgrade the management server before any other Data
components. This ensures that policy engines continue to function until they are
upgraded themselves.
New policies cannot be deployed to the policy engines until they are upgraded to
the same version as the management server.
● If you need to upgrade a policy engine before upgrading the management server—
because the policy engine resides on a full policy source appliance—detection of
fingerprinted content might not work on the appliance until the management
server is upgraded.
The policy engine embedded in Content Gateway and Email products continues to
monitor the old Web and Email DLP policies and block/permit accordingly.
1. Make sure that no administrators are logged on to the management console.
2. Log on to the installation machine with an account having domain and local
administrator privileges.
3. Close all applications and stop any antivirus software.
Warning
Be sure to close the Windows Event Viewer, or the
upgrade may fail.
Upgrade Guide 11
10. Reboot the machine.
Important
You may be prompted to restart the machine after each
component is upgraded. This is optional. You may prefer
to restart the machine once after all components are
upgraded.
Management Infrastructure
The Forcepoint Management Infrastructure provides basic framework for all of the
management components that make up the Forcepoint Security Manager. This
framework includes a central settings database that stores shared configuration (like
administrator directory and account information) for all management modules, as well
as other internal shared services.
The infrastructure upgrade wizard contains the following screens.
Upgrade Guide 12
Wizard Screen Fields
Installation Shows upgrade progress.
The system stops processes, copies new files, updates
component registration, removes unused files, and more.
A popup message appears at this stage, warning that you
must also upgrade all modules. This popup may be hidden
behind the main installer window. If your installation
appears to freeze, locate the hidden popup by moving the
main installer window, and click OK to proceed with the
installation.
Summary Summarizes your system settings after module upgrade is
complete, including:
● The destination folder for the installation files.
● The name of the SQL Server machine and the user
name of an authorized database administrator.
● The IP address of the Forcepoint management server
and administrator credentials.
Click Finish to complete the upgrade for this module.
Forcepoint DLP
Before running the data upgrade wizard, the installer validates system requirements to
ensure your upgrade will be successful.
The pre-upgrade check validates hardware requirements, credentials for your SQL
management database, endpoint security certificates, manager configuration,
Upgrade Guide 13
administrator upgrade permissions, and your database structure. As it proceeds, it
reports whether a step succeeded or failed, or it gives you a warning.
If there is a failure, the upgrade stops. For details, see \AP-DATA-
PreUpgradeTests.log in the directory where you installed Forcepoint DLP.
If there are only warnings, you have the option to proceed with the upgrade or stop it.
If you continue, your system may behave unexpectedly, but this will not have a critical
impact.
If the pre-upgrade check succeeds or if you proceed with warnings, the Forcepoint
DLP wizard is launched, followed by wizards for each installed component.
The Data Security upgrade wizard contains the following screens.
Upgrade Guide 14
Wizard Screen Fields
Configuration Shows the IP address of the database engine configured to
manage the Email Security Log Database and the logon
type. If you have changed the database since your previous
installation, modify the settings here.
Pre-Installation Summary Shows:
● The components to be installed
● The pre-existing and new version numbers
● The destination folder for the installation files
● The required and available disk space
Click Install to begin the upgrade.
Installation Shows that the installation is progressing.
The management component is upgraded on the Forcepoint
management server.
The Email Security Log Server is upgraded on machines
where it is found.
When complete, the installer configures your Forcepoint
Email Security software. This can take up to 10 minutes.
Summary You are notified when installation of this module is
complete. Click Done to exit the installer.
Post-upgrade steps
After the Forcepoint management server upgrade is complete:
1. Restart the management server.
2. Log onto Forcepoint Security Manager:
https://<IP_address_or_hostname>:9443
3. Click Data in the Security Manager toolbar to select the Data Security module.
4. Follow the prompts that appear for updating data loss protection policies and
classifiers.
Depending on the number of policies you have, this can take up to an hour. During
this time, do not restart the server or any of the services.
5. If you removed applications from Forcepoint DLP’s predefined endpoint
application groups prior to upgrade, go to the Main > Resources > Endpoint
Application Groups page after logging on and remove them again. The upgrade
process restored these to their original state.
6. Click Deploy.
7. Click Email in the Security Manager toolbar to select the Email Security module.
8. Go to the page Settings > General > Database Downloads and click Update
Now to perform an immediate database download update.
Upgrade Guide 15
Step 6: Upgrade appliances
Upgrade all appliances that have not been upgraded in the above steps. This can be
done in any order, and can be completed in parallel.
If you have deployed Forcepoint Email Security in cluster mode, release all appliances
from the cluster before performing an upgrade. Upgrade or migrate each appliance as
needed, then rebuild your cluster after the process is complete.
The Email MTA continues to function after the management server upgrade, but the
logs are cached on the appliance until Forcepoint Email Security is upgraded as well.
For best practice, redirect email traffic to another MTA as cached messages may be
lost otherwise.
For more information, see the following:
● V Series Appliance Upgrade Guide
● X Series Appliance Upgrade Guide
● Upgrading Forcepoint Email Security
©2020 Forcepoint. Forcepoint and the FORCEPOINT logo are trademarks of Forcepoint. All other
trademarks used in this document are the property of their respective owners.
Upgrade Guide 16