Page tree

Versions Compared

Key

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

Table of Contents

HideElements
metastrue
commentstrue
breadcrumbtrue
childpagestrue
watchtrue
sharetrue
favoritetrue
likestrue


Add repositories


Our repositories are available at https://download.kopano.io/supported/ for customers and partners with a valid subscription. 
The serial is needed to access these repositories.

Tabs group
bordervertical-sides
contentcolorgray-light
navcolornavy


Debian and Ubuntu

Create a file called kopano.list in /etc/apt/sources.list.d/  and add the following.

Take note that the following is an example for Debian 8. Adjust them according to your specific distribution if needed, such as Ubuntu_16.04

Our packages are signed so we need to add the key as well.

bash


All our packages are signed by the same key so you only need to add the key once


RHEL and CentOS

Create a file called kopano.repo in /etc/yum.repos.d/kopano.repo and add the following.

Take note that the following is an example for RHEL 7 and CentOS 7. Adjust them according to your specific distribution if needed



SUSE

Create a file called kopano.repo in /etc/zypp/repos.d/kopano.repo and add the following.

Take note that the following is an example for SLE 12. Adjust them according to your specific distribution if needed.





Install Kopano packages 

We will now install kopano-server-packages and the MySQL server.

kopano-server-packages is a meta package that has a dependency to the basic kopano-core packages

The following is installed with kopano-server-packages

  • kopano-backup
  • kopano-dagent
  • kopano-gateway
  • kopano-ical
  • kopano-monitor
  • kopano-presence
  • kopano-search
  • kopano-server
  • kopano-spooler
  • kopano-utils
  • (and their dependencies)

Install Kopano and MySQL/MariaDB

Tabs group
contentcolorgray-light
navcolornavy


Debian and Ubuntu

First install apt-transport-https 

bash

 

Update the apt database so the Kopano repositories are added

bash

and install

bash



RHEL and CentOS


bash



SUSE


bash




Configure SQL database


Now create a Kopano user in the MySQL server.

Code Block
$ sudo mysql -u root -p   
mysql> CREATE USER 'kopano'@'localhost' IDENTIFIED BY '<password>'; 
mysql> GRANT ALL PRIVILEGES ON kopano.* TO 'kopano'@'localhost';


Change the MySQL password in the /etc/kopano/server.cfg

Code Block
title /etc/kopano/server.cfg
# The user under which we connect with MySQL 
mysql_user = kopano 
# The password for the user (leave empty for no password)
mysql_password = <kopano-user-password>

 

User backend

The preferred way to manage users in a professional environment is OpenLDAP, but Kopano supports several other user backends as well;


Tabs group
contentcolorgray-light
navcolornavy


OpenLDAP

Add the kopano schema to the ldap server

bash


Change the user_plugin  in the /etc/kopano/server.cfg

server.cfg


Copy the ldap.cfg to /etc/kopano

bash

The ldap.cfg has only the options that need to be save all other options are listed in /usr/share/kopano/ldap.openldap.cfg.

If you need to change an other option just add it to the ldap.cfg. ldap.openldap.cfg in /usr/share/kopano/ is not marked as config file so you changes will be removed after a upgrade.

Edit /etc/kopano/ldap.cfg

Add your LDAP bind user and password if you do not use anonymous bind;

bashMidnight

Change the search base so it matches our organisation
bashMidnight



Active Directory

Download the latest version of the AD exstension from our site https://download.kopano.io/supported/adextension:/final/

Make sure you excecute the msi file with a schema master user

Depending on your needs choos for the Typical install of Custom setup

The Typical setup will install the schema and the MMC Snap-in(Active directory tabs)

When the installer is finisched go the Active directory and open one of the user

You should now have to kopano tabs (Kopano, Kopano Features)


Samba 4


It is known that Samba 4 can be slow if you u have more the 25 users. This is due the lack of index capabilities of Samba 4 at the moment.

Therefore we do not recommend using Samba 4 if you have more then 25 users.


Download the ldif and installer from https://stash.kopano.io/projects/KC/repos/kopano-ads-source/browse/samba/kopano-samba-ads

Run kopano_schema_add.sh

bash 4.0 or higher is required


bash

Download the latest version of the AD exstension from our site https://download.kopano.io/supported/adextension:/final/

Make sure you excecute the msi file with a schema master user

Depending on your needs choos for the Typical install of Custom setup

The Typical setup will install the schema and the MMC Snap-in(Active directory tabs)

When the installer is finisched go the Active directory and open one of the user

You should now have to kopano tabs (Kopano, Kopano Features)


Change the user_plugin  in the /etc/kopano/server.cfg

server.cfg


Copy the ldap.cfg to /etc/kopano

bash

The ldap.cfg has only the options that need to be save all other options are listed in /usr/share/kopano/ldap.active-directory.cfg.

If you need to change an other option just add it to the ldap.cfg. ldap.active-directory.cfg in /usr/share/kopano/ is not marked as config file so you changes will be removed after a upgrade.

Edit /etc/kopano/ldap.cfg

Switch the ldap.active-directory.cfg config

Add your LDAP bind user and password if you do not use anonymous bind;

bashMidnight

Change the search base so it matches your organisation
bashMidnight



Database


You do not have to change anything if you use the Database backend, as this already is the default value for user_plugin

/etc/kopano/server.cfg




Now start  the kopano-server

Code Block
languagebash
$ sudo systemctl start kopano-server


To see if the kopano-server is started and contains users, use kopano-admin -l 


Code Block
languagebash
$ sudo kopano-admin -l
User list for Default(34):
	Username	Fullname			Homeserver	
	----------------------------------------------------------------
	SYSTEM		SYSTEM				Kopano	
	user2		Timmothy Schöwalter			
	user5		Joep Goderts				
	user6		Roy Pettersen				
	user7		Lívia Rocha				
	user8		Joakim Lunde				
	user9		स्‍वीकृती तिवारी			
	user10		红梅 容					
	user11		雪 何					
	user12		श्‍यामा श्रेष्ठ				
	user13		Klaus Dieter Segebahn			
	user14		Aleksandra Kade				
	user15		Alford Predovic				
	user16		Roberto Collins				
	user17		Owen Koster				
	user18		Florian de Roo				
	user19		Leopoldine Sauer			
	user20		Niko Liebelt				
	user21		建军 任					
	user22		Juliana Langern				
	user23		Katarina NO PUB CERT Sager		
	beamer		beamer					
	trainingroom	trainingroom				
	sharedbox	sharedbox				
	user4		चिरनजीवी र‌जितकार			
	user3		Marijn Peters				
	admin		admin					

Please check server.log in /var/log/kopano if you get the following error.

Code Block
languagebash
$ sudo kopano-admin -l
Unable to open Admin session: network error (0x80040115)
The server is not running, or not accessible through "default:".
Using the -v option (possibly multiple times) may give more hints.