Articles with the tag:
Close
Changelog
Close
Help Center
Education Edition

Installing Education Edition components on separate servers

Introduction

Education Edition is a paid version free for educational institutions of collaborative system developed to manage documents, projects, customer relationship and email correspondence, all in one place.

Education Edition is shipped in two main versions: as a virtual machine image, compatible with most popular virtual machine managing software, and as an automatic installation script for Linux operating systems with Docker installed. The script will set up Docker containers with all the components necessary for Education Edition correct work and is easy to run, manage and update.

You might additionally want to install Education Edition components (Document Server, Mail Server and Community Server) onto separate computers to balance the server load, have more control on different components or for some other reasons. This guide will show you how to do that using the provided Docker script.

System requirements

To be able to install Education Edition components to different servers, each of your computers used must meet the following requirements:

  • CPU
    dual-core 2 GHz or better
  • RAM
    6 GB or more
  • HDD
    at least 40 GB of free space
  • Additional Requirements
    at least 6 GB of swap
  • OS
    amd64 Linux distribution with kernel version 3.10 or later
  • Additional Requirements
    • Docker: version 1.10 or later
Though running Education Edition is a very resourceful operation, you will not have to allocate swap space before you start installation. When you run the installation script, a 6 Gb swap file is created automatically.

Preparing the server for installation

This section steps must be performed for each server used for the Education Edition components installation.
Getting Education Edition script

Download Education Edition Docker script file. You can do that using our site download page. Or the direct download link can be used, if it is more convenient for you:

wget http://download.onlyoffice.com/install/education-install.sh

Once the download is finished, you can start the installation process.

For the Education Edition to be able to run the Docker service is necessary. The installation script will check if it is present on the computer and its version is not less than the minimal required. Otherwise the Docker will be installed or updated automatically.

Docker specifies Google DNS servers by default. If your Education Edition server is not going to have access to the Internet, we recommend that you change the default Docker DNS address to the address of your local DNS server. To do that go to the /etc/default/docker file and change the IP address in the following line to the IP address of a DNS server in your local network:
docker_OPTS="--dns 8.8.8.8"

Installing Document Server

Please note that all installation actions must be performed with root rights.

First you will need to install Document Server. To do that run the following command at the first server:

bash education-install.sh -ics false -ids true -icp false -ims false -es true

This will skip the installation of Mail Server and Community Server and will install Document Server only.

Installing Mail Server

Now get to the second server and proceed with Mail Server installation. To do that run the following command:

bash education-install.sh -ics false -ids false -icp false -ims true -md "yourdomain.com" -es true

Where yourdomain.com is your own domain that will be used for Mail Server.

Your domain that will be used for maintaining correspondence must be valid and configured for this machine (i.e. it should have the appropriate A record in the DNS settings that points your domain name to the IP address of the machine where Mail Server is installed).
In the command above, the "yourdomain.com" parameter must be understood as a service domain for Mail Server. It is usually specified in the MX record of the domain that will be used for maintaining correspondence. As a rule, the "yourdomain.com" looks like mx1.onlyoffice.com

If you do not have a domain name you can install Education Edition without Mail Server. In this case you should skip this step and continue to install Community Server.

Installing Community Server with Control Panel

The third server will be used to install Community Server together with Control Panel. To do that run the following command:

bash education-install.sh -ics true -icp true -ids false -ims false -mip "mail server ip" -dip "document server ip" -es false

Where document server ip is the IP address of Document Server computer used in the above step and mail server ip is the IP address of Mail Server computer.

If you choose not to install Mail Server, the command should look like this:
bash education-install.sh -ics true -icp true -ids false -ims false -dip "document server ip" -es false

This will skip installation and connection of Mail Server.

The list of all available script parameters is avaiable with the below command:

bash education-install.sh -h

If you choose to run the installation with some additional parameters, please do not skip Control Panel installation, otherwise you will not be able to enter your license key after the installation is finished.

To learn more on how to use all the available script parameters, please refer to this article.

Once the installation is finished you can check Education Edition for correct work. Open a browser and enter the local network computer IP address (please do not use either localhost or 127.0.0.1 network address for the same computer where you have Education Edition installed, use its IP address in the local network instead) to the browser address bar. Education Edition must be up and running indicating the successful installation.

How to install server version components on separate servers
Close
Download Host on your own server Available for Docker,
Windows, Linux and virtual machines
You Might Also Like This:
Close