Installation

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

First-time installation procedure:

• Checking the installation requirements
• Installing the packages
  • Red Hat Enterprise Linux or CentOS 7
  • SUSE Linux Enterprise Server 12
  • openSUSE Leap 42.1
  • Ubuntu 14.04 LTS
  • Manual Installation
• Configuring the system
• Configuring logfile rotation

Installation requirements

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

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

• Install the package dependencies listed in the requirements table above
• Download the packages for your distribution from https://download.sevenval-fit.com/FIT_Server/14/packages/ (credentials required)
• Install the downloaded packages with rpm -i *.rpm or deb -i *.deb
• Continue with the configuration

Activating systemd

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