Version

Secure Web version 2.0 is available in our debian repository starting end November 2010.

• Version 1.8 will be maintained until end 2011 (depending on customer request).
• With version 2.0 we also started to maintain 64bit versions of the software.
• We recommend Ubuntu 10.04 LTS as the operating system of your choice for our proxy software.

Repository Layout

With this new release we have decided to maintain two different repository trees at deb.cyan-networks.com:

debian/etch

• this tree is used to continue the maintenance for version 1.8
• the reference platform for building the binaries is: debian 4.0 (etch), 32bit
• the binaries are tested and support on debian 4.0 (etch), debian 5.0 (lenny), ubuntu 8.04 (hardy)

rax

• this new tree is named after a hill close to Vienna
• this tree will hold all binaries of the version 2.0
• the reference platforms for building the binaries are: ubuntu 10.04 (lucid), 32bit and 64bit
• the binaries are tested and support on ubuntu 10.04 (lucid) 32bit and 64bit, debian 5.0 (hardy) 32bit and 64bit

Upgrade Notice

In the case you have a running installation on debian 4.x or ubuntu prior to 10.04 we strongly recommend an operating system upgrade.

Preparation

The files in our software repository are signed, so that the APT package management system can verify that the package is retrieved from the correct source.

Prepare your Debian or Ubuntu system to trust the CYAN Networks software repository by installing our public key:

On Debian execute the following command with root permission:

wget -O- "http://www.cyan-networks.com/files/sweb.key" | apt-key add -

On Ubuntu execute the following command:

wget -O- "http://www.cyan-networks.com/files/sweb.key" | sudo apt-key add -

Installation

To install Secure Web on Debian and Ubuntu, you have to configure the APT package management system to access our Debian style software repository.

Note: all commands must be executed with proper administrative (root) permissions. In the case you are logged in as a user on an Ubuntu system, please us sudo together with the command (e.g. sudo apt-get update).

Install using APT

Step 1: Add this line to the file  /etc/apt/sources.list, so APT can access the CYAN Networks software repository:

for Secure Web up to version 1.8 use the following

deb http://deb.cyan-networks.com/ debian/etch stable

for Secure Web version 2.0 and later please use the following

deb http://deb.cyan-networks.com/ rax stable

Step 2: Update your package list with

apt-get update

Step 2-A: (64-bit only) Install 32-bit compatibility layer

apt-get install ia32-libs

Step 3-A: Install the CYAN Secure Web bundle by executing

apt-get install cyan-sweb-1.8

or

apt-get install cyan-sweb-2.0

Step 3-B: Alternatively you may install the CYAN Secure Web bundle including support packages in one go (select your required packages):

apt-get install cyan-sweb-1.8 cyan-sweb-1.8-vscan-clamav cyan-sweb-1.8-vscan-eset cyan-sweb-1.8-crs-sample-database


or

apt-get install cyan-sweb-2.0 cyan-sweb-2.0-vscan-avira cyan-sweb-2.0-vscan-clamav cyan-sweb-2.0-vscan-eset cyan-sweb-2.0-crs-sample-database

Support Packages

In the debian software repository we supply a set of support packages that configure your environment properly in order to enable certain features of CYAN Secure Web. The actual product package cyan-sweb-* does not have dependencies on these support packages. It is intended that these packages are selectively installed on demand.

Upgrade

Upgrades are made easy using the APT package management system. The package managment software will take care of downloading, installing and reconfiguring your system

Step 1: Update the systems package lists

apt-get update

To continue please choose if you are updating to the latest patch level of our software or if you would like to upgrade to a new release version.

Note: all commands must be executed with proper administrative (root) permissions. In the case you are logged in as a user on an Ubuntu system, please us sudo together with the command (e.g. sudo apt-get update).

Upgrade to the latest patch level

APT provides you with an easy way to upgrade your complete system to the latest version of all installed software

Step 2-A: Upgrade the entire software on the system to the latest patch levels

On Debian and Ubuntu systems execute

apt-get dist-upgrade

APT will show you an overview of all tasks that is going to perform, conflicts that might exist and proposed conflict resolutions, and will ask you for your confirmation.

Step 2-B: Upgrade only the Secure Web installation

APT provides an implicit way to upgrade a certain package to the latest patch level by executing the install command.

We strongly recommend to include all required support packages in one command line. Otherwise APT might uninstall packages that are in conflict with a newer version but have no dependency with the main package you are upgrading.

Depending on the version you are looking for execute

apt-get install cyan-sweb-1.8 cyan-sweb-1.8-vscan-clamav cyan-sweb-1.8-vscan-eset cyan-sweb-1.8-crs-sample-database


or

apt-get install cyan-sweb-2.0 cyan-sweb-2.0-vscan-avira cyan-sweb-2.0-vscan-clamav cyan-sweb-2.0-vscan-eset cyan-sweb-2.0-crs-sample-database

Upgrade to the latest release

Upgrades across major product versions, like upgrading a 1.8 installation to 2.0, will never be performed automatically by the package manager.

Please note that there may be changes in the system requirements between major releases which may need additional work for an upgrade to work. If in doubt, please contact CYAN Support at support@cyan-networks.com for help.

Step 2-C: To upgrade your Secure Web version to the latest available major release, simply execute the install command

We strongly recommend to include all required support packages in one command line. Otherwise APT might uninstall packages that are in conflict with a newer version but have no dependency with the main package you are upgrading.

apt-get install cyan-sweb-2.0 cyan-sweb-2.0-vscan-avira cyan-sweb-2.0-vscan-clamav cyan-sweb-2.0-vscan-eset cyan-sweb-2.0-crs-sample-database

The reporting sample database

Do not worry to uninstall the support package that sets up the sample database for the reporting system. An existing database will be preserved!

Additional tasks

To view which packages are available from our repository execute

aptitude search cyan


To get the version information of a particular package execute aptitude show like in the following example

aptitude show cyan-sweb-1.8


You can install only selected components, e.g. the CYAN Reporting System package, by executing apt-get for the particular package:

apt-get install cyan-sweb-1.8-crs


LTS

We provide a Long Time Support(LTS) version as a special service to our customers on request. Right now all our customers are updating their systems to the latest available major version. The next LTS version will be defined on customer request.