Having installed the FIT Server successfully, you need to generate the basic
configuration files (to be found in
/opt/sevenval/fit14/conf) for FIT, PHP and
$ /opt/sevenval/fit14/bin/fitadmin config generate
Now start the FastCGI process manager along with the Apache Web server:
$ service fit14phpfpm start $ service fit14apache start
Check your installation with
$ /opt/sevenval/fit14/bin/fitadmin config check
All tests should return
Congratulations – the FIT Server is now up and running!
If you want to set up a test system with only a single server, the installation is now complete.
To set up a cluster consisting of several servers for production operation,
repeat the steps for every server. You will also have to synchronize the state
/var/lib/fit14 and global files in
all members of the cluster.
To ensure that the logfiles written by the FIT Server do not grow without
logrotate or another mechanism should be configured to rename, compress
and finally remove the logfiles. FIT supplies an
example configuration file
conf/fit14logrotate.conf.template that can be
/etc/logrotate.d and adjusted to your specific requirements. You
should verify proper installation using
logrotate may silently ignore configuration files, some configuration sections
or logfiles if the files themselves or the directories that contain them have
Therefore, the template will not work as-is if
FIT_USER is set to
Every 20 minutes, a cron job removes expired entries from the disk based cache
/var/cache/fit14. Its behavior can be configured in the file
CACHE_MAX_AGE to the number of hours after which files will be considered
CACHE_DISK_MIN_FREE_PERCENT is set, no clean up will be performed,
as long as the configured percentage of disk space and inodes in
The PHP FastCGI Process Manager (PHP-FPM) has its own configuration files which control the behavior of the process manager. This includes, for example, the number of processes to start, log files for accesses and errors and the IP address or socket that PHP-FPM uses to communicate with the Apache Web server.
You should not change the main configuration file
conf/php-fpm.conf, as it will
be overwritten when updating the software. Instead, you should customize the PHP-FPM
configuration exclusively via the
.conf files in the directory
Always start your configuration files with the appropriate section mark
You should copy the file
and at least adjust the maximum number of PHP-FPM processes to be started (
so that the maximum number of PHP-FPM and Apache
processes together cannot consume all the RAM available.
Consider 80 MB as a reference value for the size of a PHP-FPM process. In any case, check this
value during operation with
top and adjust it if necessary.
pm.max_children should be adapted to the performance of
the processor cores. The execution of a FIT request usually involves
loading data from a source server. While waiting for the response, the
PHP-FPM process does not use the CPU. Depending on the average waiting time,
we recommend setting the number of PHP-FPM processes higher than the number of CPU cores.
For example, at a 3:1 ratio of waiting time to CPU time, the suggested lower limit for
pm.max_children is around four times the number of cores.
Restart the running PHP-FPM processes for the changes to the configuration files to take effect:
$ service fit14phpfpm reload
For PHP settings that affect both the command line interface and PHP-FPM, see the
conf/php.ini and the files under
conf/php.ini.d/. You should not modify the
supplied files as they may
get overwritten. Instead, create your own
.ini files in
Please refer to the documentation on the Apache Web server configuration.