Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

HideElements
metastrue
commentstrue
breadcrumbtrue
childpagestrue
watchtrue
sharetrue
favoritetrue
likestrue

 

Table of Contents

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 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 RHEL 6. We 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 https://www.softwarecollections.org. 

 

Installation

Install MySQL

 

Code Block
$ sudo yum install mysql-server.x86_64

Enable and start

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

 

Enable Software Collections

Code Block
# 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

 

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

Note

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

Code Block
themeMidnight
title/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_56/
gpgcheck=0
gpgkey=
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_56/
gpgcheck=0
gpgkey=
enabled=1

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

Code Block
themeMidnight
title/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_7_PHP_56/
gpgcheck=0
gpgkey=
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_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:
 

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

 

Code Block
$ sudo yum install kopano-server-packages kopano-webapp	

Start Kopano Core

 

 

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

 

Create test user

Code Block
# 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

 

 

Note

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

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

Log in

Image Added