Removing Components > Removing Web Security components

Removing Web Security components

Applies to

Web Filter 7.6

Web Security 7.6

Web Security Gateway 7.6

Web Security Gateway Anywhere 7.6

Data Security 7.6

Email Security Gateway 7.6

Email Security Gateway Anywhere 7.6

In this topic

Overview

To remove Web Security components (Windows)

To remove Web Security components (Linux)

Overview

The Policy Broker and the Policy Server instances associated with the components you want to remove must be running when you remove Web Security components. Policy Server keeps track of the location of the components associated with it. It must be running so it is aware when a component has been removed. Policy Broker and Policy Server may be running on different machines than the one from which you are removing components. In a Websense appliance-based deployment, Policy Broker and Policy Server run on an appliance in full policy source mode. If you have an appliance running in user directory and filtering mode, then Policy Server is running on it (but not Policy Broker).

Web Security components should be removed in a particular order because of certain dependencies (see Removal order of Web Security components). If you are removing all components on a machine, make sure you move any custom files you want preserved beforehand (see Preserving custom data before removing Web Security component). Also, if your Web Security deployment is integrated with another product, see the following for any integration-specific requirements:

Check Point Integration

Cisco Integration

Citrix Integration

Squid Web Proxy Cache Integration

Universal Integrations

Removal instructions are slightly different depending on the operating system:

To remove Web Security components (Windows)

To remove Web Security components (Linux)

To remove Web Security components (Windows)

Note  After uninstalling components, you may be prompted to restart the machine.

1.	Before removing components:

Use the Websense Backup Utility to make a backup of Websense configuration and initialization files. See the TRITON - Web Security Help for instructions.

If you are removing components from a Windows Server 2008 machine, log in as the built-in administrator, or run the Websense installer with elevated (full administrator) privileges.

2.	Log on with local administrator privileges.

3.	Close all applications (except Websense software; see the next step) and stop any antivirus software.

4.	Make sure Websense software is running. The Web Security uninstaller looks for Policy Server during the removal process.

 

Warning  Do not remove Web Security components without the associated Policy Server running. Policy Server keeps track of configuration and component locations. If Policy Server is not running, files for the selected components are still removed, but configuration information is not updated for those components. Problems could occur later if you attempt to reinstall these components.

5.	Start the Websense installer:

If you chose to keep installation files (see Keeping installer files) go to Start > All Programs > Websense > Websense TRITON Setup. This starts the installer without having to re-extract files.

Double-click the installer executable.

6.	In Modify Installation dashboard, click the Remove link for Web Security.

7.	At the Remove Components screen, select the components you want to remove and then click Next.

Warning  When removing components separately, always remove all other components, then Policy Server, and finally Policy Broker. Do not remove Policy Server before any component other than Policy Broker. Removing Policy Server cuts off communication with the remaining Web Security components and requires the reinstallation of those components.

Note  If you are removing Filtering Service, all associated Network Agents must have already been removed. If you try to remove Network Agent after its associated Filtering Service has been removed, the uninstaller cannot stop Network Agent and an error message is displayed.

If Policy Server is not running, a message indicates removing Web Security components may require communication with Policy Server.

a.	Cancel the uninstaller.

b.	Restart Policy Server from the Windows Services dialog box.

c.	Start the Websense installer again and follow removal instructions again (Step 5).

8.	At the Summary screen, click Next.

The Installation screen appears, showing removal progress.

If you are uninstalling Network Agent after Policy Server has already been removed, expect the process to take several minutes. Network Agent is successfully uninstalled, although no progress notification is displayed.

9.	At the Uninstall Complete screen, click Uninstall.

Important  Do not click Cancel in the Uninstall Complete screen. This renders the uninstallation incomplete. Be sure to click Uninstall.

10.	You are returned to the Modify Installation dashboard.

11.	If you stopped your antivirus software, restart it.

12.	If you remove an integration plug-in, you may need to restart the integration product. See:

Check Point Integration

Cisco Integration

Citrix Integration

Squid Web Proxy Cache Integration

Universal Integrations.

To remove Web Security components (Linux)

 

Note  Before removing components, use the Websense Backup Utility to back up Web Security configuration and initialization files. See the TRITON - Web Security Help for instructions.

1.	Log on as root.

2.	Close all applications (except Websense software; see the next step) and stop any antivirus software.

3.	Make sure Websense software is running. The Websense uninstaller looks for Policy Server during the removal process.

 

Warning  When removing components separately, always remove all other components, then Policy Server, and finally Policy Broker. Do not remove Policy Server before any component other than Policy Broker. Removing Policy Server cuts off communication with the remaining Web Security components and requires the reinstallation of those components.

Note  If you are removing Filtering Service, all associated Network Agents must have already been removed. If you try to remove Network Agent after its associated Filtering Service has been removed, the uninstaller cannot stop Network Agent and an error message is displayed.

4.	Run the uninstall program from the Websense installation directory (/opt/Websense by default):

./uninstall.sh

A GUI version is available on English versions of Linux. To run it, enter:

./uninstall.sh -g

The installer detects the installed Web Security components and lists them.

 

Warning  When removing components separately, always remove all other components, then Policy Server, and finally Policy Broker. Do not remove Policy Server before any component other than Policy Broker. Removing Policy Server cuts off communication with the remaining components and requires the reinstallation of those components.

5.	Select the components you want to remove, and choose Next.

 

Note  If you are removing Filtering Service, all associated Network Agents must have already been removed. If you try to remove Network Agent after its associated Filtering Service has been removed, Setup cannot stop Network Agent and an error message is displayed.

If Policy Server is not running, a message tells you that removing Websense components may require communication with Policy Server

a.	Cancel the uninstaller.

b.	Open a command shell and go to the Websense directory (/opt/Websense, by default).

c.	Enter the following command to start Websense services:

./WebsenseAdmin start

d.	Restart this process at Step 4.

6.	A list shows the components selected for removal. Choose Next.

If you are uninstalling Network Agent on a remote machine after removing Policy Server, expect the process to take several minutes. Network Agent is successfully uninstalled, although no progress notification is displayed.

7.	A completion message indicates that components have been removed. Exit the installer.

8.	If you stopped your antivirus software, restart it.

9.	If you remove an integration plug-in, you may need to restart the integration product. See:

Check Point Integration

Cisco Integration

Citrix Integration

Squid Web Proxy Cache Integration

Universal Integrations.

Removal order of Web Security components

Removal order of Web Security components

When removing a particular Web Security component, it is important to remove any dependent components first. Component dependencies are shown in the following diagram (note: not all Web Security components are included; only those with removal dependencies are shown).

The dependency hierarchy goes from top-down, components below depend on components above. For example, if you want to remove Filtering Service, any associated Network Agent, Remote Filtering Server, and Filtering plug-in instances must be removed first. Likewise, to remove Policy Server, you must first remove any instances of the components below it in the diagram (which is everything except Policy Broker).

It is important to note that these dependencies apply to distributed components as well. The uninstaller will notify you of dependent components on the same machine. However, it cannot notify you of dependent components on other machines. You must be sure to remove any dependent components on other machines before removing a component on this machine. For example, to remove the Policy Server instance shown below (left-side illustration), you must first remove Network Agent and then Filtering Service on the two machines dependent on the Policy Server. The numbers in the right-side illustration indicate the proper order of removal.

Notice that each Network Agent is removed before its associated Filtering Service, which is required by the component dependencies. Also, it does not matter which Filtering Service and Network Agent pair is removed before the other—just both pairs must be removed prior to removing the Policy Server.

Preserving custom data before removing Web Security component

Preserving custom data before removing Web Security component

If you have data or files you created yourself in the Websense\Web Security directory (default: C:\Program Files or Program Files (x86)\Websense\Web Security in Windows; /opt/Websense in Linux) or in sub-directories of the Websense\Web Security directory, copy them to another location before removing all Web Security components. The uninstallation process may remove these files.

 

Note  If you have saved reports you want to retain after uninstalling all components, copy them from the ReportingOutput directory (under the Websense\Web Security directory). The report files are of the following types: *.pdf, *.xls, or *.zip (for HTML files).

Files of the following types are not removed by the uninstaller if they are located in the Websense\Web Security directory itself:

*.zip

*.mdb

*.mdf

*.ndf

*.ldf

*.bak

The above file types are protected from removal only in the Websense\Web Security directory itself. They may be removed if they reside in a sub-directory of the Websense directory. There are two sub-directories, however, that are protected from removal. Files in the Websense backup directory (default: C:\Program Files or Program Files (x86)\Websense\Web Security\backup in Windows; /opt/Websense/backup in Linux), if it exists, will not be removed by the uninstaller. Also, if the Log Database files reside in a sub-directory of the Websense directory, they will not be removed.

Removing Components > Removing Web Security components