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
Hard disk spaceUnder /var: 5 GB for a test/development system, 20+ GB for small production systems, 50+ GB for large production systems, see Partitioning
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 lcms2 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 liblcms2-2 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 liblcms2-2 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 liblcms2-2 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.

Partitioning

For the binaries, libraries and configuration files under /opt a rather small partition with about 1 GB of disk space should be sufficient. About 5 GB additional disk space for the log files, caches and site data residing under /var is suitable for a test or development system. For a production system, however, a reasonable size for the /var partition may be 20 or even 50 GB. This number heavily depends on the characteristics of your site.

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.

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

If you use systemd you may also want to install the corresponding packages.

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

Activating systemd

systemd support is currently only available on Red Hat Enterprise Linux/CentOS. Note, that after activating the systemd packages only root can control the PHP-FPM and the Apache HTTP Server.

For Red Hat Enterprise Linux/CentOS distributions we offer optional systemd support for PHP and the Apache HTTP Server. The systemd unit files and corresponding control scripts are delivered with these packages:

  • fit14httpdoptionalsystemd
  • fit14phpfpmoptionalsystemd

To set the proper states for systemd you have to stop the PHP-FPM and Apache services before you install the systemd packages. The recommended procedure is:

$ /opt/sevenval/fit14/sbin/apachectl stop
$ /opt/sevenval/fit14/sbin/phpfpmctl stop
$ yum swap fit14httpdrcscript fit14httpdoptionalsystemd
$ yum swap fit14phpfpmrcscript fit14phpfpmoptionalsystemd
$ systemctl stop fit14apache
$ systemctl stop fit14phpfpm
$ systemctl start fit14apache
$ systemctl start fit14phpfpm

After switching to the systemd packages you can use the control scripts as usual. The update procedure remains the same.

To switch back to the (old) SysV init system use the following commands:

$ systemctl stop fit14apache
$ systemctl stop fit14phpfpm
$ yum swap fit14httpdoptionalsystemd fit14httpdrcscript
$ yum swap fit14phpfpmoptionalsystemd fit14phpfpmrcscript
$ /opt/sevenval/fit14/sbin/apachectl start
$ /opt/sevenval/fit14/sbin/phpfpmctl start