This article describes the system requirements that you must meet for installation with web hosting providers.
Note
The software usually tries to load the .ini files via the /etc/php directory. If this is not correct, alternative paths can be specified. Customization on the part of xentral is not possible. More information can be found here.
The following system requirements apply to the installation at web hosting providers:
-
Apache / Lighttpd web server
-
MYSQL database with optional PHPMyAdmin, from xentral version 20.1 is minimum requirement MySQL version 5.7
-
PHP version 7.3 from xentral version 21.1, from xentral version 20.1 is minimum requirement PHP version 7.2
-
PHP extensions → php-mbstring, php-soap, php-imap, php-xml, php-zip, PHP-GD, php-cli
-
PHP extension for MySQL → Requires mysqli with MySQL Native Driver Support (mysqlnd) and PDO support.
-
Ioncube version of 10.2 or higher is required
-
Ioncube (web server) for the PHP version used
-
Ioncube (CLI) for the used PHP version (with the rights of the web server)
-
Sufficient upload capacity of at least 25MB
-
Sufficient script runtime (PHP timeout) with 15 minutes
-
Memory per PHP process at least 256MB
-
Setup of a cronjob with interval of one minute
Minimum requirement from version 17.1 is MySQL 5.5. Starting with xentral version 20.1 MySQL 5.7 becomes minimum requirement for operation. The use of MySQL 8.0 is possible, but currently not recommended or supported, because it can lead to display problems (as of 06/2020).
Starting with xentral version 20.1, MariaDB 10.2 becomes a minimum requirement for operation. Depending on the system, it may also be recommended to use version 10.4.
Minimum requirement from version 21.1 is PHP 7.3. Starting with xentral version 20.1 PHP 7.2 became minimum requirement for operation.
Root Privileges:
-
From version 21.3.x root-privileges (superadmin user) are necessary on the server
Minimum requirements for small businesses with about one to three employees are these:
-
Ubuntu or Debian-Linux as operating system
-
2 CPU cores
-
6GB RAM
-
100GB hard disk capacity
Minimum requirements for medium-sized companies (approx. 3-10) employees:
-
Ubuntu or Debian Linux as operating system
-
4 CPU cores
-
8GB RAM
-
200GB hard disk capacity
Minimum requirements for larger companies (e.g.):
-
Ubuntu or Debian Linux as operating system
-
8 CPU cores
-
16GB RAM
-
500GB hard disk capacity
Which PHP modules have been installed can be checked in the system log, under Administration > Settings > System > System log. The installed PHP modules can also be seen under the following URL call: Own_Domain.com/WWW/index.php?module=systemlog
Binary Zip-extension for command lines available
xentral usually reads the zip module from the following path: /usr/bin/zip. You can use the "whereis zip" command to trace where this module was installed.
A refresh within the system log checks the paths again, because only when the zip-extension (binary) is read out in the system log, the entry in the system health is also displayed after the process starter is run again.
Note
As of 08.03.2021, the command is not supported on Mittwald systems.
For information about the PHP customization, see PHP and CLI customization.
The following settings are necessary/useful for processes with increased load time. Here the server timeout time should be increased. Often the default time is 30 seconds. Examples for processes that could load longer than 30 seconds:
-
Recalculate traffic lights in the order overview for >500 orders
-
Calculate auto shipping for >200 orders
-
Start autoversand (in general, the process starter "autoversand_manual" should always be set up in xentral here (queue) → processes each job individually in the queue and prevents a server timeout in this way)
-
Batch processing that takes more loading time Settings on the server:
-
max_execution_time → set approx. to 60-1000 (guideline: 10 orders - 500 and more).
-
max_input_time → must always be set greater than/equal to "max_execution_time".
Note
The settings can be viewed in the system log (see above).
The following system requirements apply to the installation at web hosting providers for version 22.1 and above:
-
Nginx web server
-
MySQL version 5.7
-
PHP version 7.4
-
PHP extensions → php-imap, PHP-GD, php-ldap, php-intl, mysqli with MySQL Native Driver Support (mysqlnd) and PDO support, php-soap, php-zip, php-cli, php-xml, php-mbstring
-
Ioncube version 10.4
-
Ioncube (web server) for the PHP version used
-
Ioncube (CLI) for the used PHP version (with the rights of the web server)
-
Sufficient upload capacity of at least 25MB
-
Sufficient script runtime (PHP timeout) with 15 minutes
-
Memory per PHP process at least 256MB
-
Setup of a cronjob with interval of one minute: cronjobs/starter2.php