Articles with the tag:
Close
Changelog
Close
Help Center
Document Server for Linux

Installing Document Server as a cluster

Document Serverv.4.2 Document Server changelog

Version 4.2.11

Release date: 03/13/2017

New features

Editors

  • Added the possibility to completely hide About and the left toolbar (available to the licensed users only).

Fixes

Back-end

  • Fixed the issue when the JWT token without the permissions field crashes downloadAs.

Version 4.2.10

Release date: 02/20/2017

Fixes

Embedded viewers

  • Fixed the default top position for the toolbar.

Licensing

  • Fixed the availability of the chat and comments buttons for the editors without the license file.

Back-end

  • Fixed the problem with JWT access tokens.

Version 4.2.9

Release date: 02/14/2017

New Features

Spreadsheet Editor

  • The Polish language translations for functions.

Fixes

Spreadsheet Editor

  • Fixed the wrong order of elements in equations (bug #34029).

Version 4.2.8

Release date: 02/06/2017

Fixes

Spreadsheet Editor

  • Fixed entering the characters with diacritical symbols (bug #33908)
  • Fixed the horizontal scroll when using a trackpad (bug #27197)

Plugins

  • Allowed the interface customization using the plugins.

Back-end

  • Minor fixes for logging and status codes.

Version 4.2.7

Release date: 02/01/2017

Fixes

All Editors

  • Prevent editors from performing the save operation if there are no changes to save.

Spreadsheet Editor

  • Fixed error occurring when assembling files with Ranges in some rare cases.

Document conversion

  • Fixed errors occurring when converting from the XLSX to the CSV format.

Back-end

  • Fixed server compilation if the PRODUCT_VERSION and BUILD_NUMBER variables are not defined.

Version 4.2.5

Release date: 01/16/2017

Fixes

All Editors

  • Fixed a rare problem occurring when saving a file with a specific chart type.

Presentation Editor

  • Fixed a problem occurring when saving a file with the notes copied from Document Editor;
  • Fixed a problem occurring when saving a file with a chart copied from Presentation Editor.

Back-end

  • Fixed a problem occurring when opened connection was not closed with close command received while performing some asynchronous actions.

Version 4.2.4

Release date: 01/09/2017

Fixes

Document Editor

  • Fixed the problem with the changes missing when several users enter the text at the same time (bug #33726)
  • Fixed the bug with the cursor positioning after the InsertContent function is used.

Spreadsheet Editor

  • Fixed the Match formula return value in some cases (bug #33735).

Back-end

  • Fixed the missing Asana-Math font in the default installation, needed for equations.

Version 4.2.3

Release date: 12/23/2016

Fixes

Spreadsheet Editor

  • Fixed the usage of functions with references to the other sheets.

Presentation Editor

  • Fixed the timeout error appearing while printing some PPTX files.

Document conversion

  • Fixed the problem with conversion to PDF format when only the first document page was converted.

Licensing

  • Without a valid license file the chat and comment buttons are unavailable, as well as editing the customer information and the logo image at the editor header is not allowed.

Version 4.2.2

Release date: 12/21/2016

Fixes

Presentation Editor

  • Fixed the problem with opening password-protected presentations.

Version 4.2.1

Release date: 12/06/2016

Fixes

Document Editor

  • Fixed the broken Insert number of page button;
  • Fixed the problem with the last hieroglyph duplicate;
  • Fixed the problem with changing the chart type from 2D to 3D (bug #33284).

Spreadsheet Editor

  • Fixed JavaScript error when adding a chart in IE and Edge (bug #33597);
  • Fixed the problem with an empty cell when changing sparklines (bug #33598).

x2t

  • Improved compatibility with the DOC format.

Version 4.2.0

Release date: 12/01/2016

New Features

All Editors

  • Added the possibility to set a dash type for shapes;
  • Redesigned the embedded viewers;
  • Better support of HiDPI systems;
  • Update bootstrap to version 3.3.7.

Document Editor

  • Added the possibility to set Fit to Page or Fit to Width as a default zoom value;
  • Ability to insert number of pages into the document;
  • Added the possibility to open and edit footnotes;
  • Remade version history. Added the possibility to hide minor features.

Spreadsheet Editor

  • Added the possibility to insert equations in Spreadsheet Editor;
  • Added the possibility to open and edit sparklines;
  • Added a new SUMIFS function;
  • Added the possibility to select data from the drop-down menu in the context menu;
  • Added a multiselection support;
  • Added the rotation of 3D charts;
  • Updated and improved the visual styles for all chart types;
  • Brought back the Freeze Panes option in the View Settings menu;
  • Added the new algorithm for calculating a cell height.

Presentation Editor

  • Added the possibility to set Fit to Width as a default zoom value;
  • Added the possibility to insert equations in Presentation Editor.

Back-end

  • Updated nodejs from version 4.2.0 to the current LTS release: 6.9.1.

Fixes

Spreadsheet Editor

x2t

Version 4.1.8

Release date: 11/03/2016

Fixes

License

  • Minor fix for a better license compatibility with the Hide Menu functionality.

Version 4.1.7

Release date: 11/01/2016

Fixes

Editors

  • Fixed a JavaScript error when opening a document in IE 9 and IE 10.

Version 4.1.6

Release date: 10/26/2016

New Features

Editors

  • Added the possibility to hide the menu bars in the editors using the config.

Version 4.1.5

Release date: 10/13/2016

Fixes

Editors

  • Fixed copy-paste on MacOS Sierra.

Plugins

  • Fixed the image load and OLE problems;
  • Viewers do not show plugins any more.

Version 4.1.4

Release date: 10/07/2016

Fixes

Back-end

  • ipfilter can use dns to lookup.

Version 4.1.3

Release date: 09/28/2016

New Features

Plugins

  • Sample plugins are enabled by default.

Version 4.1.2

Release date: 09/22/2016

New Features

Back-end

  • Switched to using PostgreSQL instead of MySQL on back-end;
  • Added the possibility to filter users using ipfilter.

Editors

  • Added whole new code handling text input. Better support for languages which use hieroglyphs;
  • Added whole new copy-paste which is better compatible with external sources.

Changes

  • Improvements in opening of all supported formats.

Fixes

  • A lot small bugfixes in all product modules.

Version 4.0.3

Release date: 08/04/2016

Changes

  • Added the possibility to use full-toolbar mode in the editors with a standard license. Previously the users of standard license were forced to use compact toolbar only.

Version 4.0.2

Release date: 08/03/2016

Fixes

Spreadsheet Editor

  • Fixed losing comments on second and subsequent worksheets (bug #32895);
  • Fixed losing empty values of data with format different from General in the autofilter (bug #32805).

document-server-integration

  • Minor fixes.

Introduction

Installing and running Document Server as a cluster allows you to:

  • run Document Server and all the necessary infrastructure in a distributed manner;
  • flexibly scale Document Server performance;
  • provide fault-tolerance and high availability of the application.

This guide will show you how to install Document Server and run it as a clustered service.

Cluster structure

The structure of Document Server cluster looks the following way:

Installing Document Server as a cluster

The following elements of the cluster are used:

  • Load Balancer - the server which receives the requests from the users and redirects them to the internal servers with Document Server installed.
  • Document Server 1 ... DocumentServer N - a group of servers with Document Server installed, which handles the received requests from the users and allows the document editing.
  • Redis server - the server (or a group of servers) which is used as session storage and a lock storage.
  • RabbitMQ server- the server (or a group of servers) which is used to handle the conversion task queue, result task queue, and event bus.
  • PostgreSQL server - the server (or a group of servers) which is used to store the edited file changes.
  • Storage server - the server (or a group of servers) which is used as a storage for working files.
The Redis server, Storage server, RabbitMQ server, PostgreSQL server here are the shared resources for the group of servers with Document Server installed.

Thus to create a working cluster one needs to perform the below tasks:

  1. Run a group of servers with Document Server installed;
  2. configure each installed Document Server instance to work correctly with the shared resources;
  3. redistribute the incoming user requests to the group of servers with Document Server installed.

Installing and running a group of Document Servers

The installation of Document Server is described step-by-step in these articles: for Debian, Ubuntu and derivatives and for CentOS and derivativesthis article. The installation must be performed the same way for each server that will have Document Server installed to it. Once you are done with it, you can skip to the next step.

Configuring Document Server

Document Server setup parameters are stored in the following files:

  • default.json - see the example of the file with the default settings here;
  • production-linux.json - see the example of the file with the default settings here.

After the installation both configuration files can be found in the /etc/onlyoffice/documentserver%ProgramFiles%\ONLYOFFICE\DocumentServer\config folder.

See the parameters which need to be edited for Document Server correct work for each of the cluster elements in the tables below:

PostgreSQL server
Location Parameter Description
default.json services.CoAuthoring.sql.dbHost The IP address or the name of the host where the PostgreSQL server is running.
services.CoAuthoring.sql.dbPort The PostgreSQL server port number used for connection to it.
services.CoAuthoring.sql.dbName The name of a PostgreSQL database to be created on the image startup.
services.CoAuthoring.sql.dbUser The user name for the PostgreSQL account.
services.CoAuthoring.sql.dbPass The password set for the PostgreSQL account.

If you set up the connection to PostgreSQL server after the product installation, you will additionally need to create tables in the databases. This is done using the following commands:

psql -q -hDB_HOST -UDB_USER -d DB_NAME -f /var/www/onlyoffice/documentserver/server/schema/postgresql/createdb.sql
cd %ProgramFiles%\ONLYOFFICE\DocumentServer\pgsql\bin
psql -q -hDB_HOST -UDB_USER -d DB_NAME -f ..\..\server\schema\postgresql\createdb.sql

where

  • DB_HOST is the IP address or the name of the host where the PostgreSQL server is running;
  • DB_USER is the user name for the PostgreSQL account;
  • DB_NAME is the name of a PostgreSQL database to be created.
Example
"services": {
    "CoAuthoring": {
        "sql": {
            ...
            "dbHost": "sql.example.com",
            "dbPort": 5432,
            "dbName": "onlyoffice",
            "dbUser": "onlyoffice",
            "dbPass": "onlyoffice",
            ...
        }
    }
}
RabbitMQ server
Location Parameter Description
default.json rabbitmq.url The AMQP URL used to connect to the RabbitMQ server.
Example
"rabbitmq": {
    "url": "amqp://rabbitmq.example.com",
    ...
}
Redis server
Location Parameter Description
default.json services.CoAuthoring.redis.host The IP address or the name of the host where the Redis server is running.
services.CoAuthoring.server.port The Redis server port number used for connection to it.
Example
"services": {
    "CoAuthoring": {
        "redis": {
            ...
            "host": "redis.example.com",
            "port": 6379
        }
    }
}
Storage service
Location Parameter Description
production-linux.json storage.fs.folderPath Path to the file storage service.
When configuring the storage, we strongly recommend that you do not change the path to the file storage. You can instead map the shared network folder to the /var/lib/onlyoffice/documentserver/App_Data folder.

If you prefer to change the path to the storage, you will additionally need to change the paths in the internal proxy server configuration file:

sudo sed 's,/var/lib/onlyoffice/documentserver/App_Data,'enter_you_path',' -i /etc/nginx/conf.d/includes/onlyoffice-documentserver-docservice.conf
sudo service nginx reload
Example
"storage": {
    ...
    "fs": {
        "folderPath": "/var/lib/onlyoffice/documentserver/App_Data/cache/files","folderPath": "\\server\storage",
        ...
    }
}

Some of the above properties can be edited during the application installation or configuration.

After changing the configuration files it is necessary to restart the services using the commands:

sudo supervisorctl restart onlyoffice-documentserver:docservice
sudo supervisorctl restart onlyoffice-documentserver:converter
sc stop DsConverterSvc
sc start DsConverterSvc
sc stop DsDocServiceSvc
sc start DsDocServiceSvc

Distributing incoming requests

We recommend that you use HAProxy proxy server to distribute the user incoming requests. The sample configuration file is available here.

Save it and open for editing. Find the lines which look like this:

server onlyoffice-documentserver-X backendserver-address-X check inter 2000 rise 2 fall 3

and edit the backendserver-address-X value changing it for the addresses of the servers with Document Server installed.

The number of lines must be equal to the number of backend servers. For example, if you have three servers with Document Server installed, this configuration file part will look like this:

server onlyoffice-documentserver-1 http://documentserver1.example.com check inter 2000 rise 2 fall 3
server onlyoffice-documentserver-2 http://documentserver2.example.com check inter 2000 rise 2 fall 3
server onlyoffice-documentserver-3 http://documentserver3.example.com check inter 2000 rise 2 fall 3
Download Best editors on your website Let your site users view, edit and collaborate
on all types of text, spreadsheet and presentation files
You Might Also Like This:
Close