Page tree
Skip to end of metadata
Go to start of metadata


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. 


Installation

Install MySQL


$ sudo yum install mariadb mariadb-server

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


Add repositories

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

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

/etc/yum.repos.d/kopano.repo
[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 

/etc/yum.repos.d/kopano.repo
[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:
 

  • kopano-backup
  • kopano-dagent
  • kopano-gateway
  • kopano-ical
  • kopano-monitor
  • kopano-presence
  • kopano-search
  • kopano-server
  • kopano-spooler
  • kopano-utils


$ sudo yum install kopano-server-packages


Start Kopano Core

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

Install httpd24, httpd-mod_php, and kopano-webapp

$ sudo yum install httpd24 httpd24-mod_php kopano-webapp

Add kopano-webapp config page to httpd24 configuration file

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

Create test user

# 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



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

Log in