Problem Description
How do I move policies from a version 7.1 or 7.5 Websense Web Security deployment to version 7.6 without performing an upgrade?
Resolution
The recommended method for migrating
from version 7.1 or 7.5 to version 7.6 is via a standard upgrade. If you
are migrating to new equipment, install your current version on the new
machine, use the Backup Utility to move their existing configuration to
the new installation, and then upgrade the new installation.
If the recommended procedure is not possible, then use the following steps to perform the migration.
WARNING: Error when running PgSetup on Linux:
-
If running ./PgSetup on a Linux server produces a "Framework Library.so file that it can't find" error, then add a library path to the Websense bin directory by entering:
-
export LD_LIBRARY_PATH=/opt/Websense/bin
-
Or, before running PgSetup, execute the following from command from the Websense bin directory:
-
export LD_LIBRARY_PATH=.
-
Yes that is a period after the equals sign. It represents the current directory.
SECTION 1
On the v7.1 (or v7.5) machine:
-
Go to the Websense bin directory (C:\Program Files\Websense\bin\ or /opt/Websense/bin/, by default) and make a backup copy of the config.xml file.
-
From the same directory, use the
appropriate command to back up the Policy Database. Note that the "--"
in the commands below represents two dashes.
-
Linux:
./PgSetup --save 7x.policy_db
-
Windows:
PgSetup --save 7x.policy_db
-
Place these files in a location that can be accessed from the v7.6 machine.
SECTION 2
On the v7.6 machine:
-
Use the Websense Backup Utility to
run an immediate back up of the current, clean v7.6 configuration. To do
this, go to the C:\Program Files (x86)\Websense\Web Security\bin
directory (Windows) or /opt/Websense directory (Linux), and enter the
following command:
-
Linux:
-
./WebsenseTools -b -b -d <backup_file_directory>
-
Windows:
-
wsbackup -b -d <backup_file_directory>
-
Stop all Websense services. If Websense Manager or TRITON - Web Security is on another machine,
stop all of the Websense Web Security services or daemons on any
management console machine that connects to this Policy Broker.
-
Go to the Websense bin directory (C:\Program Files (x86)\Websense\Web Security\bin or /opt/Websense/bin, by default) and back up the config.xml file. Rename the copy config.xml.orig.
-
From the same directory, use the appropriate command to back up the Policy Database:
-
Linux:
./PgSetup --save 76.backup_policy_db
-
Windows:
PgSetup --save 76.backup_policy_db
-
Store the backup files in a safe location.
-
While still in the Websense bin directory, restore the v7.1 (or v7.5) Policy Database as follows:
-
Linux:
./PgSetup --restore 7x.policy_db
-
Windows:
PgSetup --restore 7x.policy_db
-
From the same directory, use the following command to update the v7.1 (or v7.5) Policy Database to v7.6:
-
Linux:
./PgSetup --upgrade
-
Windows:
PgSetup --upgrade
-
To synchronize config.xml password with Policy Database:
-
Open v7.1 (or v7.5) config.xml file and search for "Token" under the "BrokerService" container.
-
Copy the "Token" value.
-
Edit v7.6 config.xml file.
-
Replace existing "Token" value with the one copied from the v7.1 (or v7.5) file.
-
Save and close the config.xml file.
-
On the v7.6 system, rename the config.xml.bak file to config.xml.bak.old.
Note:
If policies are imported to a new off-box server running
Policy Broker / Policy Database and the V-Series appliance is being used
in Policy-Lite mode (Policy Server, User Service, Filtering Service),
then the Token within the config.xml file must be updated on the V-Series appliance as well. You will need to contact Websense Technical Support for assistance to access the config.xml on the V-Series appliance.
SECTION 3
On the TRITON Management Server:
-
Ensure that all administrators are logged out of the TRITON Unified Security Center.
-
Ensure that the Websense TRITON Settings Database service is running.
-
Go to Start > Administrative Tools > Task Scheduler.
-
In the Task Scheduler window, select Task Scheduler Library.
-
If you are using Windows Server 2003, open Windows control panel and select Scheduled Tasks.
-
If the Triton Backup task is disabled, right-click the task and select Enable.
-
Right-click the Triton Backup task and select Run. By default, the backup file save to C:\EIPBackup.
-
Continue with the appropriate section:
-
If TRITON - Web Security and Policy Broker are on the same machine, see SECTION 3A.
-
If TRITON - Web Security and Policy Broker are on separate machines, see SECTION 3B.
-
If TRITON - Web Security or Policy Broker are on a V-Series appliance, see SECTION 3C.
SECTION 3A
If TRITON - Web Security and Policy Broker are on the same machine:
-
Use the Windows Service Control Manager to start the Websense Policy Database, Websense Policy Broker, Websense Policy Server, and Websense TRITON Settings Database services, in that order.
-
From the Websense\EIP Infra\ directory, run the following command:
MergeTRITONAdministrators.bat "..\Web Security\Manager\wsg_admins.conf"
-
Start the remaining Websense services.
SECTION 3B
If TRITON - Web Security is on another machine:
-
Use the Windows Service Control Manager or /opt/Websense/WebsenseDaemonControl script to start the Websense Policy Database, Websense Policy Broker, and Websense Policy Server, in that order.
-
Go to the machine where TRITON - Web Security is installed.
-
Use the Windows Service Control Manager to start the Websense TRITON Settings Database service.
-
From the Websense\EIP Infra\ directory, run the following command
MergeTRITONAdministrators.bat "..\Web Security\Manager\wsg_admins.conf"
-
Start the remaining Websense services.
SECTION 3C (The following procedure requires assistance from Websense Tech Support)
If TRITON - Web Security or Websense Policy Broker is on a V-Series appliance:
-
In the WSE DomU, go to the /opt/Websense/ directory and enter the following command:
./WebsenseDaemonControl
-
Start the services in this order:
-
Policy Database - B
-
Policy Broker - C
-
Policy Server - D
-
Go to the /opt/Websense/Manager/ directory and edit the wsg_admins.conf file as follows:
wsg.ps.ipaddress=169.254.254.3
wsg.ps.port=55806
eip.application.adapter.order=wsg
eip.to.eip.merge.scenario=false
prefer.application.password=true
-
Update the wsg.ps.ipaddress field from 169.254.254.3 to the IP address of the C interface.
-
Go to the /opt/Websense/EIP_Infra/ directory and enter the following command:
./MergeTRITONAdministrators ../Manager/wsg_admins.conf
-
Go to the /opt/Websense directory and enter the following command:
./WebsenseAdmin restart