v8.1 Linux upgrade instructions for web security products

Deployment and Installation Center | Web Protection Solutions | v7.8.x - v8.0.x

Use the Linux installer (WebsenseWeb81xSetup_Lnx.tar.gz) to upgrade existing components. After the installer starts, it detects which Websense components are installed and need to be upgraded.

Perform a full system backup before starting the upgrade process. See the Backup & Restore FAQ for instructions.

If Websense components are installed on multiple machines, see Web protection upgrade order for important information about the required upgrade sequence.


	Important Upgrade the primary (or standalone) Policy Broker machine first, then any replica Policy Broker machines, then any machines running Policy Server. Distributed components on other machines must be upgraded after Policy Broker and Policy Server.


	Important Policy enforcement and logging services are not available while you are performing the upgrade. To reduce the impact on network users, run the upgrade after hours, or during a quiet time on the network.

Perform the following procedure on each machine running Websense web protection components.

Make sure no administrators are logged on to the TRITON console.

Log on the installation machine with administrator privileges (typically, as root).

Close all applications and stop any antivirus software.

Check the etc/hosts file. If there is no host name for the machine, add one.

See Preparing for installation for instructions.

Create a setup directory for the installer files, such as /root/Websense_setup.


	Important If your Websense services have been running uninterrupted for several months, the installer may have difficulty stopping them. To prevent the upgrade process from timing out and failing, use the /opt/Websense/WebsenseAdmin restart command to restart the services manually before beginning the upgrade.

Get the Linux installer from the Downloads page at mywebsense.com. The installer file is called WebsenseWeb81xSetup_Lnx.tar.gz.

Uncompress the installer file and use one of the following commands to launch it:

To launch the graphical installer (available only on English versions of Linux):

./install.sh -g

To launch the command-line installer, omit the -g switch:

./install.sh

See Starting the Web Linux installer for more detailed instructions.

On the Introduction screen, click Next.


	Note These instructions refer to the graphical installer screens. If you are using the command-line installer, the same prompts appear. Enter the menu-item number or character, corresponding to the button described in each step.

On the Subscription Agreement screen, click I accept the terms of the Subscription Agreement and click Next.

10.

On the Websense Upgrade screen, select Start the upgrade and then click Next.


	Important Before clicking Next, be sure to no administrators are logged on to the TRITON console anywhere in the network.

11.

When you click Next, a "Stopping All Services" progress message appears. Wait for Websense 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 Websense services. If the services have not been stopped after approximately 10 minutes, then stop them manually using the /opt/Websense/WebsenseAdmin stop command. You can leave the installer running when you do so. Once you have manually stopped the services, return to the installer.

12.

On the Pre-Upgrade Summary screen, review the list of Websense components that will be upgraded, and then click Install.

Critical files are backed up and install properties initialized. And then the Installing Websense screen appears.

13.

Wait for the Upgrade Complete screen to appear. Click Done to exit the installer.

14.

Reboot the machine.


	Important The machine must be rebooted to complete the upgrade process.

15.

If you stopped your antivirus software, restart it.

16.

If you have an integration product installed, additional upgrade steps may be necessary. See:

Integrating Web Filter & Security with Cisco

Integrating Web Filter & Security with Citrix

Integrating Web Filter & Security using ICAP Service

Integrating Web Filter & Security with TMG

Installing for Universal Integrations

17.

Repeat the upgrade procedure on each machine running web protection components, in the recommended order (see Web protection upgrade order).

All components that interact must be upgraded to the same version.

If you have complete installations in separate locations that do not interact, they do not have to run the same Websense software version.

18.

After all components have been upgraded, see Initial Configuration for All Websense Modules.

To add additional components to the machine after upgrade, run the Websense installer again on the same machine. This time, the installer will ask if you want to add components. See Adding or modifying Windows components.