Introduction

This document is intended as a base to install a Red Hat Enterprise Linux server running Kopano Core and Kopano Webapp.

Audience

This document is intended to be used by experienced system administrators and engineers who have in-depth knowledge of both Linux and MySQL environments.

Disclaimer

Use these suggestions at your own risk and only if you know what you are doing.

These instructions are intended as pointers and not as a definitive configuration, as every environment can be set up differently.

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 5.3 is PHP 5.5 and RHEL 6 only ships 5.3 per default, RHEL 6 and RHEL 7would be unsupported by WebApp 5.3. 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 7.1 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-71” suffix in the end of the package name. With these packages, you will be able to install and run WebApp 5 on RHEL 6 and RHEL 7.

For more information on Software Collections, feel free to check out the official page https://www.softwarecollections.org. 

$ sudo yum install mariadb mariadb-server

$ sudo chkconfig mysqld on
$ sudo /etc/init.d/mysqld start

# 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 yum-utils

# 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-php71

# 3. Start using the software collection:
$ scl enable rh-php71 bash

Example repository configuration

To add the Kopano repositories for Redhat Enterprise Linux 6 with SCL rh-php71 installed 

[Kopano-Core]
name=Builds of final releases (RHEL_6)
type=rpm-md
baseurl=https://serial:<ENTERYOURSERIALHERE>@download.kopano.io/supported/core:/final/RHEL_6_PHP_71/
gpgcheck=1
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/core:/final/RHEL_6_PHP71/repodata/repomd.xml.key
enabled=1
 
[Kopano-webapp]                                                                                                         
name=Builds of final releases (RHEL_6)                                                                                      
type=rpm-md                                                                                                             
baseurl=https://serial:<ENTERYOURSERIALHERE>@download.kopano.io/supported/webapp:/final/RHEL_6_PHP_71/
gpgcheck=1
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/core:/final/RHEL_6_PHP_71/repodata/repomd.xml.key
enabled=1

and for Redhat Enterprise Linux 7 with SCL rh-php71 installed 

[Kopano-Core]
name=Builds of final releases (RHEL_7)
type=rpm-md
baseurl=https://serial:<ENTERYOURSERIALHERE>@download.kopano.io/supported/core:/final/RHEL_7_PHP_71/
gpgcheck=1
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/core:/final/RHEL_7_PHP71/repodata/repomd.xml.key
enabled=1
 
[Kopano-webapp]                                                                                                         
name=Builds of final releases (RHEL_7)                                                                                      
type=rpm-md                                                                                                             
baseurl=https://serial:<ENTERYOURSERIALHERE>@download.kopano.io/supported/webapp:/final/RHEL_7_PHP_71/
gpgcheck=1
gpgkey=https://serial:<INSERT_SERIALKEY>@download.kopano.io/supported/core:/final/RHEL_7_PHP71/repodata/repomd.xml.key
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

$ sudo /etc/init.d/kopano-server start

$ sudo yum install httpd24 httpd24-mod_php kopano-webapp

$ sudo ln -s /etc/httpd/conf.d/kopano-webapp.conf /opt/rh/httpd24/root/etc/httpd/conf.d/kopano-webapp.conf

# kopano-admin -c jdoe -p jdoe -e john@doe.com -f "John Doe"
# kopano-admin -l
User list for Default(2):
	Username	Fullname	Homeserver	
	--------------------------------------------
	SYSTEM		SYSTEM		Kopano	
	jdoe		John Doe

# chkconfig httpd24-httpd on
# /etc/init.d/httpd24-httpd start