Prerequisites
This documentation lists all the requirements for imperia CMS.
Hardware requirements#
Minimum hardware requirements#
- Processor with 2 GHz and Dualcore
- 2 GB RAM
- HDD hard disk
Recommended hardware requirements#
- Processor 3+ GHz and 4+ cores
- 8+ GB RAM
- SSD hard disk
Dedicated database server#
In the standard system, the data is stored in the file system and in the SQLite database provided. Alternatively, the data can also be stored in an external database.
For 50,000 documents or more, the system performance can be improved by outsourcing the data to a dedicated database server.
From 100,000 documents, the CMS is only performant without a dedicated database server in exceptional cases.
Software requirements#
imperia CMS can be installed on Linux/UNIX (Ubuntu, SUSE, RedHat, Solaris, CentOS, archlinux) or Microsoft Windows operating systems. The operation of imperia CMS via Docker has the lowest requirements, since in this case only the Docker software has to be installed. Read Run imperia CMS with Docker to use imperia CMS via Docker. Here you will find the requirements for a direct installation.
imperia CMS has a Staging Architecture, i.e. an editorial system with many target systems. Your editors produce the content on the editorial system and publish it on the target systems. Your readers only access content published on the target systems. The editorial system and target systems are installed and updated individually. For more information about the architecture read the Operational concept.
Webserver#
The imperia CMS software runs on your web server. We recommend Apache with the mod_perl module or the internal webserver of imperia CMS with NGINX as reverse proxy. For the local development you can also use the supplied imperia web server.
Perl#
Install Perl version 5.18.1 or higher. Under Windows you can install Strawberry-Perl 5.18.1 or higher.
SQLite#
Install the Perl database interface DBI and the database interface driver DBD::SQLite in a version 3.7.9 or higher for the internal SQLlite database.
With Ubuntu, Debian, Mint:
apt-get install libdbd-sqlite3-perl
With CentOS, Redhat:
yum install perl-DBD-SQLite
Imagemagick#
Install the image editing software Imagemagick and the Perl interface Image::Magick.
With Ubuntu, Debian, Mint:
apt-get install perlmagick
With CentOS, Redhat:
yum install ImageMagick-perl
Prerequisites for a database support#
In the standard system, the data is stored in the file system and in the SQLite database provided. Alternatively, the data can also be stored in an external database. Depending on the database software, you must install the corresponding Perl DBI driver.
PostgreSQL#
Install the database interface driver DBD::Pg for PostgreSQL databases.
With Ubuntu, Debian, Mint:
apt-get install libdbd-pg-perl
With Red-Hat, CentOS:
yum install perl-DBD-Pg
imperia CMS supports PostgreSQL from version 9.1. A good step-by-step guide for setting up a PostgreSQL database with detailed explanation can be found at the hosting service DigitalOcean: How To Install and Use PostgreSQL on Ubuntu 18.04.
MySQL/Maria#
Install the database interface driver DBD::mysql for MySQL or Maria databases.
With Ubuntu, Debian, Mint:
apt-get install libdbd-mysql-perl
With Red-Hat, CentOS:
yum install perl-DBD-MySQL
imperia CMS supports MySQL from version 5.5. and Maria from version 5.5. A good step-by-step guide for setting up a MySQL database with detailed explanation can be found at the hosting service DigitalOcean: How To Install MySQL on Ubuntu 18.04.
Note
There are several methods to store the data tables in MySQL. We recommend InnoDB. The advantage lies in InnoDB's transaction security and the use of correct foreign keys, which speeds up the search in the database.
Note
In order for imperia to access the database correctly, the "Isolation Level" of the database must be set to READ COMMITTED. imperia does not do this automatically. However, accessing the database through other applications can cause problems. Therefore the imperia MySQL user must have SUPER privileges. This can be done with the following command: GRANT SUPER ON *.* TO user@host. Replace "user" and "host" with the database user and host.
Oracle#
Install the database interface driver DBD::Oracle for Oracle databases.
With Ubuntu, Debian, Mint:
apt-get install libdbd-oracle-perl
With Red-Hat, CentOS:
yum install perl-dbd-oracle
Prerequisites for special functions#
imperia full text search#
The imperia full text search provides a search function for your website. The data is stored in a Berkeley database. Install the database software and the Perl interface.
With Ubuntu, Debian, Mint:
apt-get install libdb-dev libberkeleydb-perl
Advanced information about MP3s#
With Ubuntu, Debian, Mint:
apt-get install libmp3-info-perl
Service-Worker#
With Ubuntu, Debian, Mint:
apt-get install libcryptx-perl
Workflow step SEO#
With Ubuntu, Debian, Mint:
apt-get install libweb-query-perl liblingua-stopwords-perl
Media zip import#
With Ubuntu, Debian, Mint:
apt-get install libarchive-zip-perl
Advanced information about PDFs in the MAM#
With Ubuntu, Debian, Mint:
apt-get install libpdf-api2-perl
Image encoding tool#
With Ubuntu, Debian, Mint:
apt-get install libmime-tools-perl libmime-base32-perl
XML export#
With Ubuntu, Debian, Mint:
apt-get install libxml-perl libxml-parser-perl libxml-dom-perl libhtml-treebuilder-libxml-perl
Excel import#
With Ubuntu, Debian, Mint:
apt-get install libspreadsheet-parseexcel-perl
Authentication via LDAP#
With Ubuntu, Debian, Mint:
apt-get install libnet-ldap-perl
Auhentication via OAuth#
With Ubuntu, Debian, Mint:
apt-get install libnet-oauth-perl
SFTP transfer / Secure Copy transfer#
With Ubuntu, Debian, Mint:
apt-get install libnet-sftp-foreign-perl
Note
A fallback for this package is delivered with imperia CMS.
Markdown converter#
With Ubuntu, Debian, Mint:
apt-get install libtext-markdown-perl
Email plugin#
With Ubuntu, Debian, Mint:
apt-get install libemail-find-perl libnet-smtp-ssl-perl