Server
The backend server software layer which is the part of ONLYOFFICE Document Server and is the base for all other components.
Document service set up
This instruction describes document service deployment for Windows based platform.
Installing necessary components
For the document service to work correctly it is necessary to install the following components for your Windows system (if not specified additionally, the latest version for 32 or 64 bit Windows can be installed with default settings):
a) Node.js version 6.9.1 or later (https://nodejs.org/en/download/)
b) Java (https://java.com/en/download/). Necessary for the sdk build.
c) MySql Server version 5.5 or later (http://dev.mysql.com/downloads/windows/installer/). When installing use the onlyoffice
password for the root
user.
с) or PostgreSQL Server version 9.1 or later (https://www.postgresql.org/download/).
d) Erlang (https://www.erlang.org/download.html)
e) RabbitMQ (https://www.rabbitmq.com/releases/rabbitmq-server/v3.5.4/rabbitmq-server-3.5.4.exe)
f) Redis (https://github.com/MSOpenTech/redis/releases/download/win-2.8.2102/Redis-x64-2.8.2102.msi)
g) Python 2.7.x (https://www.python.org/download/releases/2.7.3/#download)
h) Microsoft Visual C++ Express 2010 (necessary for the spellchecker modules build)
Setting up the system
a) Database setup MySQL
Run the schema/mysql/createdb.sql script for MySQL
a) or Database setup PostgreSQL
Enter in psql
(PostgreSQL interactive terminal) with login and password introduced during installation, then enter commands:
CREATE DATABASE onlyoffice;
CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';
\c onlyoffice
\i 'schema/postgresql/createdb.sql';
GRANT ALL PRIVILEGES ON DATABASE onlyoffice to onlyoffice;
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO onlyoffice;
Delete from server\Common\config\development-windows.json
option sql
.
b) Install the Web Monitor for RabbitMQ (see the details for the installation here - https://www.rabbitmq.com/management.html)
Open the command line cmd
executable. Switch to the installation directory using the cd /d Installation-directory/sbin
command.
Run the following command:
rabbitmq-plugins.bat enable rabbitmq_management
The Web Monitor is located at the http://localhost:15672/ address. Use the guest/guest
for the login/password combination.
c) If Redis does not start or crashes after the start for some reason, try to change the maxheap
parameter in the config settings. For 64 bit version of Windows 7 the config file can be found here: C:\Program Files\Redis\redis.windows-service.conf.
Find the # maxheap <bytes>
line and change it to, e.g.
maxheap 128MB
Restart the service.
Running the service
Run the run.bat
script to start the service.
Notes
All config files for the server part can be foun in the Common\config
folder
default.json
- common config files similar for all production versions.production-windows.json
- config files for the production version running on a Windows based platform.production-linux.json
- config files for the production version running on a Linux based platform.development-windows.json
- config files for the development version running on a Windows based platform (this configuration is used when running the 'run.bat' script).
In case it is necessary to temporarily edit the config files, create the local.json file and reassign the values there. It will allow to prevent from uploading local changes and losing config files when updating the repository. See https://github.com/lorenwest/node-config/wiki/Configuration-Files for more information about the configuration files.
User Feedback and Support
If you have any problems with or questions about ONLYOFFICE Document Server, please visit our official forum to find answers to your questions: dev.onlyoffice.org or you can ask and answer ONLYOFFICE development questions on Stack Overflow.
License
Server is released under an GNU AGPL v3.0 license. See the LICENSE file for more information.