This documentation is for an outdated version: 14.5.0. The current version is 14.6.17 - get the documentation here.

Installation

Here we show you how to install the Sevenval FIT Server, configure and start it.

First-time installation procedure:

Installation requirements

You need to download credentials for the Sevenval download server to install the packages.

For the minimum installation requirements and recommended hardware configuration see the table below.

System requirements
Processor architecturex86-64 (AMD64, x86_64)
HardwareIntel Core 2 Duo 3 GHz (or any CPU with support for MMX, SSE, SSE2, SSE3, fxsr (FXSAVE FXRSTOR) and cx16 (CMPXCHG16B)), 4 GB RAM
Hardisk space5 GB for a test/development system, 20+ GB for small production systems, 50+ GB for large production systems
Operating systems (64 bit)Red Hat Enterprise Linux/CentOS 7, SUSE Linux Enterprise Server 12, openSUSE Leap 42.1, Ubuntu 14.04.1 LTS Server Edition
ProtocolsHTTP/HTTPS over IPv4
Required packages
RHEL/CentOS libstdc++ libtool-ltdl bzip2 which libpng zlib freetype cronie pcre libjpeg findutils grep libpng openssl-libs curl libcurl nss ca-certificates httpd mod_ssl hostname
SUSE Linux Enterprise Server libltdl7 bzip2 libpng12-0 libz1 libfreetype6 pcre cron libjpeg62 util-linux findutils grep libstdc++6 libopenssl1_0_0 curl libcurl4 ca-certificates-mozilla ca-certificates apache2-worker net-tools
openSUSE libltdl7 bzip2 libpng12-0 libz1 libfreetype6 cron libpcre1 libjpeg62 util-linux findutils grep libstdc++6 libopenssl1_0_0 curl libcurl4 ca-certificates-mozilla apache2-worker
Ubuntu libltdl7 libstdc++6 bzip2 libpng12-0 zlib1g libfreetype6 cron libpcre3 libjpeg-turbo8 findutils debianutils grep libssl1.0.0 curl libcurl3 ca-certificates apache2

Performance considerations

A system matching those requirements can process 20 million page impressions on average per month, provided that the requests are uniformly distributed. Since FIT is usually CPU-bound, you can estimate the maximum throughput of your FIT Server to be in the order of 10 million page impressions per month per core. If the sources of your sites have unusually long response times or require time-consuming processing, more RAM is required to keep a constant throughput.

Installing packages

When installing packages, the program files are installed in /opt/sevenval/fit14. Under /var, directories for log files, caches and site data are created. In addition, init scripts for the services and cron jobs to maintain the cache directories are registered. During operation, the files under /var take the bulk of disk space. For the files under /opt, however, a small partition with about 1 GB of disk space would be sufficient.

The FIT Server is shipped in several RPM or Debian packages. To install the packages, you must be logged in as root. During the installation of the packages, the users fit and fit-data as well as the corresponding groups are automatically created provided they do not yet exist.

The packages can be installed either manually or with a package management system (yum, zypper, apt). The repositories will provide automatic notification or installation of software updates.

Red Hat Enterprise Linux/CentOS

At first, download and register the repository. Replace your credentials in the URL.

$ yum-config-manager --add-repo \
 'https://USERNAME:PASSWORD@download.sevenval-fit.com/FIT_Server/14/packages/RHEL/fit14.repo'

Then install the packages with

$ yum install fit14fitserver

The RPM packages and repositories are signed with the GPG key of packages@sevenval.com with ID 0xD6E8E072. Upon the initial installation, yum will prompt you to accept the downloaded key. Make sure the given fingerprint matches 7bac 27fa 2415 7c54 70d1 feec afa8 5fd8 d6e8 e072.

Continue with the configuration.

SUSE Linux Enterprise Server

At first, download and register the repository. Keep your download credentials at hand.

$ zypper addrepo --check --refresh \
 'https://download.sevenval-fit.com/FIT_Server/14/packages/SLES/$releasever/current/$basearch' fit14

Then install the packages with

$ zypper install fit14fitserver

The RPM packages and repositories are signed with the GPG key of packages@sevenval.com with ID AFA85FD8D6E8E072. Upon the initial installation, zypper will prompt you to accept the downloaded key. Make sure the given fingerprint matches 7BAC27FA24157C5470D1FEECAFA85FD8D6E8E072.

Continue with the configuration.

openSUSE

At first, download and register the repository. Keep your download credentials at hand.

$ zypper addrepo --check --refresh \
 'https://download.sevenval-fit.com/FIT_Server/14/packages/SUSE/$releasever/current/$basearch' fit14

Then install the packages with

$ zypper install fit14fitserver

The RPM packages and repositories are signed with the GPG key of packages@sevenval.com with ID AFA85FD8D6E8E072. Upon the initial installation, zypper will prompt you to accept the downloaded key. Make sure the given fingerprint matches 7BAC27FA24157C5470D1FEECAFA85FD8D6E8E072.

Continue with the configuration.

Ubuntu

The repositories are signed with the GPG key of packages@sevenval.com with ID 1024D/D6E8E072. Its fingerprint is 7BAC 27FA 2415 7C54 70D1 FEEC AFA8 5FD8 D6E8 E072. Download and add the sevenval GPG key to the apt keyring used for package and repository verification the GPG key with the following commands:

$ wget https://download.sevenval-fit.com/FIT_Server/sevenval.key
$ apt-key add sevenval.key

To get a list of all imported keys including their fingerprints, use

$ apt-key finger
[...]
pub   1024D/D6E8E072 2011-06-07
      Key fingerprint = 7BAC 27FA 2415 7C54 70D1  FEEC AFA8 5FD8 D6E8 E072
uid                  FIT RPM Builder <packages@sevenval.com>
sub   2048g/692A737C 2011-06-07

Register the FIT Server 14 repository and update your package database. Replace your credentials in the URL.

$ apt-add-repository \
 'deb https://USERNAME:PASSWORD@download.sevenval-fit.com/FIT_Server/14/packages/ubuntu/trusty/current/ amd64/'
$ aptitude update

Then install the packages with

$ aptitude install fit14fitserver

Continue with the configuration.

Manually Installing Packages