Установка Doczilla на Linux ОС

Любая инструкция для linux является примерной, 

и создана для того, чтобы показать основные команды и действия, 

в связи с очень большим разнообразием linux-систем

Установку программного обеспечения должен выполнять технический специалист с базовыми знаниями и навыками администрирования систем Linux и базами данных PostgreSQL

Для работы приложения Doczilla Pro необходимо в наличии установленное дополнительное ПО, для установки которого можно обратиться к официальной документации или использовать примеры на нашем сайте:

- JAVA JDK 1.8 или OpenJDK 8 (обязательно Java Development Kit) - для работы Doczilla Pro, пример установки https://help.doczilla.pro/docs/install-java-jdk

- NodeJS 8.0 (или версии выше) - для скачивания форматированных документов, пример установки   https://help.doczilla.pro/docs/install-nodejs

- PostgreSQL 9.6 (или версии выше) - база данных для работы Doczilla Pro, пример установки https://help.doczilla.pro/docs/install-postgresql

- LibreOffice 6 (или версии выше, обязательные пакеты libreoffice-common libreoffice-calc libreoffice-writer) - для скачивания документов в формате PDF

Распаковка

Сборка Doczilla и nodejs-скриптов поставляется в архивных файлах, которые необходимо распаковать, рекомендуем в папку /opt/

unzip doczilla-1.0-20240101.zip -d /opt/                       ## распаковка сборки в папку /opt
mv /opt/doczilla-1.0-20240101  /opt/doczilla                   ## переименование распакованной папки в удобное имя
unzip pro.doczilla.nodejs-20240101.zip -d /opt/                ## распаковка java-скриптов для nodejs в папку /opt
mv /opt/pro.doczilla.nodejs-20240101  /opt/doczilla.nodejs     ## переименование папки в удобное имя

Настройка службы автозапуска

Необходимо настроить автоматический запуск службы. Копируем шаблон и редактируем его

cp /opt/doczilla/bin/service  /etc/systemd/system/doczilla.service        ## копирование шаблона в папку запуска
vi /etc/systemd/system/doczilla.service                                   ## запуск редактирования скрипта автозапуска

Редактируем имя пользователя под которым будет осуществляться запуск (строки User, Group, Environment) и пути куда распаковали сборку (строки WorkingDirectory, ExecStart, ExecStop)

[Unit]
Description=null
After=syslog.target
After=network.target
After=postgresql.service

[Service]
Type=simple
User=root
Group=root
WorkingDirectory=/opt/doczilla
ExecStart=/opt/doczilla/bin/service.sh
ExecStop=/opt/doczilla/bin/stop.sh
Restart=always
Environment=USER=root HOME=/root

[Install]
WantedBy=multi-user.target

Включить автозапуск службы

systemctl enable doczilla                   ## включить автозапуск службы

Настройка скрипта запуска service.sh

Для запуска Doczilla необходимо отредактировать скрипт /opt/doczilla/bin/service.sh

vi /opt/doczilla/bin/service.sh

Только для операционных систем Debian и Ubuntu необходимо сменить первую строку скрипта

на debian/ubuntu вместо
#!/usr/bin/env sh

необходимо указать
#!/usr/bin/env bash

Для запуска Doczilla необходимо, чтобы версия Java 1.8.0 была установлена по умолчанию. Если установлено несколько версий или альтернативная версия Java, необходимо указать полный путь до папки установки

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64

Для запуска скриптов NodeJS необходимо указать строку запуска

node  /opt/doczilla.nodejs/server.js &

Пример, отредактированного скрипта на операционной системе Ubuntu

#!/usr/bin/env bash

### !!! NOTE !!! ###
# If Ubuntu or Debian, change 'sh' to 'bash'
### !!! NOTE !!! ###

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64

node /opt/doczilla.nodejs/server.js &

Создание базы данных и настройка конфигурации

Необходимо на сервере СУБД создать базу данных и её настроить

su - postgres                                 ## переключение пользователя
 $ createdb -T template0 doczilla             ## создание БД doczilla

 $ psql                                       ## вход в редактор
  postgres=#  CREATE ROLE doczilla WITH PASSWORD 'doczilla' LOGIN;         ## создание в БД пользователя doczilla с паролем doczilla
  postgres=#  \c doczilla                     ## переключение к БД doczilla
  doczilla=#  CREATE EXTENSION pg_trgm;       ## включение расширения для ускорения поиска
  doczilla=#  CREATE SCHEMA test AUTHORIZATION doczilla;             ## созание схемы TEST в БД
  doczilla=#  \q                              ## выход из редактора
 $ exit

Настройка файла конфигурации server.properties

Для настройки Doczilla необходимо отредактировать файл конфигурации /opt/doczilla/work/server.properties

vi /opt/doczilla/work/server.properties

Необходимо указать название базы данных, имя схемы, логин и пароль пользователя базы данных, а так же адрес и порт  базы данных.

## указать имя схемы в БД
application.database.schema=test
## указать имя пользователя владельца БД
application.database.user=doczilla
## указать пароль пользователя
application.database.password=doczilla

## указать путь до сервера СУБД, порт и имя БД
application.database.connection=jdbc:postgresql://192.168.0.10:5432/doczilla

Необходимо указать путь для установленного LibreOffice

office.home=/usr/lib/libreoffice

Пример отредактированного конфига

application.database.schema=test
application.database.user=doczilla
application.database.password=doczilla
application.database.driver=org.postgresql.Driver
application.database.connection=jdbc:postgresql://192.168.0.10:5432/doczilla
.....
office.home=/usr/lib/libreoffice

Установка и настройка закончена

Необходимо запустить (перезапустить) службу Doczilla

systemctl start doczilla       ## start/stop/restart  запуск/остановка/перезапуск службы

Первый вход и генерация схемы

Необходимо запустить браузер Google Chrome / Microsoft Edge последних версий и перейти на сайт сервера

http://localhost:9080

при первом входе отроется сайт Докзиллы, где в меню "Администрирование" - необходимо выбрать "Генерация схемы".

После успешного выполнения необходимо перелогиниться, в окне авторизации ввести логин Admin поле пароля оставить пустым, нажать "Войти", после этого необходимо дважды задать пароль для учетной записи Администратора.