2. Installation¶
2.1. System Requirements¶
2.1.1. Hardware Recommendations¶
To give an estimate on the resource use of KC we have created the table below. These are merely guidelines, giving a rough estimation on what hardware is required. In this table we assume the CPU is under low load from other applications.
Table 2.1. Minimal Hardware Recommendations
| Database Size / Users | CPU (Cores)* | Memory | Harddisk | Raid level |
|---|---|---|---|---|
| < 5 GB / 1-25 users | 2 | 2 GB | SATA, SAS, 7.2k | RAID 1 |
Important
Tuning of the server configuration and the individual software components for the specific onsite usage can drastically improve performance of your Kopano Web Meetings instance. For more than 100 users, as well as any high availability structures it is advised to seek professional engineering support.
2.1.2. Connection/bandwidth Recommendation¶
In order to seamlessly connect Web Meetings clients to Kopano the network latency should not be higher than 20ms. Network latencies of 200ms (500ms under exceptional circumstances) should not be exceeded in order to aid the user acceptance.
The needed bandwidth is very much depended on the individual user behaviour. Based on large scale projects we use the following key figures to calculate the minimal needed bandwidth:
For implementations with more than 100 users (with external access) we calculate with an average bandwidth utilization of “x (actual amount of users) * 8kbit/s (ISDN speed)”. In real world scenarios not all users will require exactly the same amount of bandwidth at the exact same time, which still leaves room to serve short term higher demands of single users (like requesting an attachment from the server).
Given these key figures (with +20% TCP protocol overhead) the following minimum bandwidth for Web Meetings users can be calculated: .Minimum Bandwidth Recommendations
| Amount of concurrent users in meetings | Connection speed | Connection speed incl. TCP overhead |
|---|---|---|
| 25 | 20000 kbit/s | 24000 kbit/s |
Of course these are only bare minimums and providing a higher bandwidth will increase download speeds.
2.1.3. Supported Platforms¶
KC and Kopano Web Meetinsg consists of a large variety of components: some back-end components that are run on Linux platforms, and components that can be installed on the computers of end-users in the form of a web browser. In this section we list the different platforms that we support.
At the start of each general release cycle (like 7.x.x) we decide which plaforms are supported. Usually that means the current release of that platform and the most recent previous release. During the major release cycle supported platforms can be added but not removed.
Please use the x86_64 or 64bit packages if 64bit hardware and OS are available. It is recommended to run on 64bit whenever possible.
Table 2.2. Supported platforms for Kopano Web Meetings back-end components
| OS Release | Supported CPU Architectures |
|---|---|
| Debian 7.0 (Wheezy) | i386, x86_64 |
| Debian 8.0 (Jessie) | x86_64 |
| RHEL 6 | i686, x86_64 |
| RHEL 7 | x86_64 |
| SLES 12 | x86_64 |
| Ubuntu 14.04 LTS | i386, x86_64 |
| Ubuntu 16.04 LTS | i386, x86_64 |
| Univention 4.x | i386, x86_64 |
2.1.4. Dependencies¶
In order to build or install Kopano Web Meetings back-end components a bunch of requirements have to be met. These are the main dependencies of Kopano Web Meetings:
- Apache or any other webserver that supports PHP. KC is tested with Apache 2.0 and 2.2.
- NGINX to provide SSL and proxying HTTPS and Web Socket connections to the backend servers.
Most of these dependencies are resolved automatically by the package manager of the Linux distribution that Kopano Web Meetings is being installed on. This allows the 3rd party components used by KC to be installed and upgraded automatically through the package manager of the distribution.
The default method of deploying KC is installing the packages on one of the Linux distributions we support, allowing the 3rd party components used by KC to be installed automatically through the package manager of the distribution. In this case the 3rd party components are upgraded in a standard way according to that distribution.
2.2. Installing with the distribution’s package manager¶
The recommended way to install the Kopano Web Meeting is by installing Kopano prebuilt packages using the distributions package manager.
2.2.1. Adding the NGINX package repositories¶
You will need to add the official NGINX package repositories to your systems’s configuration. This can be done in the following way:
Important
An NGINX version >= 1.4 is required for websocket proxying!
2.2.1.1. Adding the NGINX package repositories on Debian wheezy (7.0)¶
Add the NGINX repository to your /etc/apt/sources.list
deb http://nginx.org/packages/debian/ wheezy nginx
And add the release keys
curl http://nginx.org/packages/keys/nginx_signing.key | sudo apt-key add -
2.2.1.2. Adding the NGINX package repositories on Ubuntu precise (12.04)¶
Add the NGINX repository to your /etc/apt/sources.list
deb http://nginx.org/packages/ubuntu/ precise nginx
And add the release keys
curl http://nginx.org/packages/keys/nginx_signing.key | sudo apt-key add -
2.2.1.3. Adding the NGINX package repositories on Ubuntu trusty (14.04)¶
Add the NGINX repository to your /etc/apt/sources.list
deb http://nginx.org/packages/ubuntu/ trusty nginx
And add the release keys
curl http://nginx.org/packages/keys/nginx_signing.key | sudo apt-key add -
2.2.1.4. Adding the NGINX package repositories on RHEL 7.0¶
Add the NGINX repository to your yum repo list
rpm -ivh http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm
2.2.2. Installing the NGINX package on Debian wheezy (7.0)¶
Install NGINX on Debian platforms with apt-get
apt-get install nginx
2.2.3. Installing the NGINX package on RHEL 7.0¶
Install NGINX on RHEL platforms with yum
yum -y install nginx
2.2.4. Installing Kopano basic server and the Web Meetings packages¶
The suggested Setup combines WebApp together with the Web Meetings packages on one host. For this documentation we will assume a basic KC server is already installed. Please refer to the KC Administrator Manual for setup details.
In the Web Meetings manual we are only installing the Web Meetings packages and its dependencies from the additional Kopano Extras Repository on top of your KC server. Kopano Web Meetings requires you to install the kopano-presence and kopano-webapp package from the KC distribution. Furtherore the php-curl package is required. Please ensure that these packages are installed. In case they are not yet installed please perform the following steps.
2.2.4.1. Install Web Meetings on Debian wheezy (7.0)¶
Install your Kopano server according to the KC Administrator Manual. To install the kopano-presence package from the KC distribution please enter the following command in the directory for your platform where you unpacked the packages included in the KC tarball.
dpkg -i kopano-presence_*.deb
To install the kopano-webapp package from the KC distribution please enter the following command in the directory for your platform where you unpacked the packages included in the KC tarball.
dpkg -i kopano-webapp_*.deb
Note
Add any additional packages as described in the KC Administrator Manual.
Install php-curl on Debian platforms with apt-get
apt-get install php5-curl
Note
Please ensure that the curl.so file gets loaded. This is normally loaded by /etc/php5/conf.d/20-curl.ini
Please unpack the kopano-extras distribution tarball for your platform and enter the unpacked directory and into the binaries subdirectory.
Install Kopano WebApp Web Meetings Plugin and Web Meetings
dpkg -i kopano-webapp-plugins-meetings_*.deb kopano-webmeetings_*.deb
2.2.4.2. Install Web Meetings on RHEL 7.0¶
Install your Kopano server according to the KC Administrator Manual. To install the kopano-presence package from the KC distribution please enter the following command in the directory for your platform where you unpacked the packages included in the KC tarball.
rpm -Uvh kopano-presence_*.rpm
To install the kopano-webapp package from the KC distribution please enter the following command in the directory for your platform where you unpacked the packages included in the KC tarball.
rpm -Uvh kopano-webapp-*.rpm
Note
Add any additional packages as described in the KC Administrator Manual.
On RHEL PHP curl support is built-in. On other RPM based platforms you will need to check if an additional package must be installed.
Please unpack the kopano-extras distribution tarball for your platform and enter the unpacked directory and into the binaries subdirectory.
Install Kopano WebApp Web Meetings Plugin and Web Meetings
rpm -Uvh kopano-webapp-plugins-meetings-*.rpm kopano-webmeetings-*.rpm