|Table of Contents|
This document is intended as a base to install a Red Hat Enterprise Linux server running Kopano Core and Kopano Webapp.
This document is intended to be used by experienced system administrators and engineers who have in-depth knowledge of both Linux and MySQL environments.
Use these suggestions at your own risk and only if you know what you are doing.
Also keep in mind that some steps in this guide can take time depending on the size and complexity of your environment.
Software Collections and PHP
Since the minimum requirement for WebApp 3.0 is PHP 5.4 and RHEL 6 only ships 5.3 per default, RHEL 6 would be unsupported by WebApp 3.0. To circumvent this problem we added support for Software Collections.
Red Hat Enterprise Linux (RHEL) introduced the Software Collections (SCL’s) – supported by Red Hat (!) – allowing the availability of more recent versions of specific software components for existing enterprise releases without forcing usage of these packages (as they are not API/ABI safe with distribution included packages).
With Red Hat providing the rh-php56 software collection, we are able to build PHP-MAPI based on PHP 5.6 for RHEL 6 and RHEL 7, and provide these to our customers in a standardised way. You can easily identify the Kopano Core builds with the “-php-56” suffix in the end of the package name. With these packages, you will be able to install and run WebApp 3 on , for example, RHEL 6. RHEL 6 only ships 5.3 per default and would be unsupported by WebApp 3.0, since the minimum requirement for WebApp 3.0 is PHP 5.4We also added SCL support for RHEL 7 because it is maintained better than the shipped php version 5.4.
For more information on Software Collections, feel free to check out the official page
$ sudo yum install mysql-server.x86_64
Enable and start
$ sudo chkconfig mysqld on $ sudo /etc/init.d/mysqld start
Enable Software Collections
# 1. Install a package with repository for your system: # On CentOS, install package centos-release-scl available in CentOS repository: $ sudo yum install centos-release-scl # On RHEL, enable RHSCL repository for your system: $ sudo yum-config-manager --enable rhel-server-rhscl-7-rpms # 2. Install the collection: $ sudo yum install rh-php56 # 3. Start using the software collection: $ scl enable rh-php56 bash
We recommend that you use our repositories to install Kopano. They are available at https://download.kopano.io/supported/. Use the following examples to configure repositories for your operating system:
Example repository configuration
Please be aware that special characters in the username or password like '!' can cause issues
[Kopano-Core] name=Builds of final releases (RHEL_6) type=rpm-md baseurl=https://<username>serial:<password>@download<ENTERYOURSERIALHERE>@download.kopano.io/supported/core:/final/RHEL_6_PHP_56/ gpgcheck=0 gpgkey= enabled=1 [Kopano-webapp] name=Builds of final releases (RHEL_6) type=rpm-md baseurl=https://<username>serial:<password>@download<ENTERYOURSERIALHERE>@download.kopano.io/supported/webapp:/final/RHEL_6_PHP_56/ gpgcheck=0 gpgkey= enabled=1
[Kopano-Core] name=Builds of final releases (RHEL_6) type=rpm-md baseurl=https://<username>serial:<password>@download<ENTERYOURSERIALHERE>@download.kopano.io/supported/core:/final/RHEL_7_PHP_56/ gpgcheck=0 gpgkey= enabled=1 [Kopano-webapp] name=Builds of final releases (RHEL_7) type=rpm-md baseurl=https://<username>serial:<password>@download<ENTERYOURSERIALHERE>@download.kopano.io/supported/webapp:/final/RHEL_7_PHP_56/ gpgcheck=0 gpgkey= enabled=1
Installing the packages
You can install kopano*, manually pick the packages you want to install, or install the meta package 'kopano-server-packages'. The meta package will install:
$ sudo yum install kopano-server-packages kopano-webapp
Start Kopano Core
$ sudo /etc/init.d/kopano-server start
Create test user
# kopano-admin -c jdoe -p jdoe -e email@example.com -f "John Doe" # kopano-admin -l User list for Default(2): Username Fullname Homeserver -------------------------------------------- SYSTEM SYSTEM Kopano jdoe John Doe
To install and configure the OpenLDAP plugin, please reference the appropriate chapters in this installation guide and adjust the commands to RHEL-based distributions
Start Apache 2.4
# chkconfig httpd24-httpd on # /etc/init.d/httpd24-httpd start