Любая инструкция является примерной,
и создана для того, чтобы показать основные команды и действия,
в связи с очень большим разнообразием linux-систем и windows-систем
Установку программного обеспечения должен выполнять технический специалист с базовыми знаниями и навыками администрирования систем Linux и базами данных PostgreSQL
Для работы приложения Doczilla Pro необходимо в наличии установленное дополнительное ПО, для установки которого можно обратиться к официальной документации или использовать примеры на нашем сайте:
- JAVA JDK 1.8 или OpenJDK 8 (обязательно Java Development Kit) - для работы Doczilla Pro, пример установки Пример установки JAVA JDK
- NodeJS 16.7 (или версии выше) - для скачивания форматированных документов, пример установки Пример установки NodeJS
- PostgreSQL 11 (или версии выше) - база данных для работы Doczilla Pro, пример установки Пример установки PostgreSQL
- LibreOffice 6 (или версии выше, обязательные пакеты libreoffice-common libreoffice-calc libreoffice-writer) - для скачивания документов в формате PDF
Распаковка
Сборка Doczilla и nodejs-скриптов поставляется в архивных файлах, которые необходимо распаковать, рекомендуем в папку /opt/
## распаковка сборки в папку /opt
unzip doczilla-3.0.0-20241231.zip -d /opt/
## переименование распакованной папки в удобное имя
mv /opt/doczilla-3.0.0-20241231 /opt/doczilla
## распаковка java-скриптов для nodejs в папку /opt
unzip pro.doczilla.nodejs-3.0.0-20241231.zip -d /opt/
## переименование папки в удобное имя
mv /opt/pro.doczilla.nodejs-20241231 /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/cluster.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/cluster.js &
...Создание базы данных и настройка конфигурации
Необходимо на сервере СУБД создать базу данных doczilla, схему (в примере это test) и настроить
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/conf/server.properties
vi /opt/doczilla/conf/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
## start/stop/restart запуск/остановка/перезапуск службы
systemctl start doczillaПервый вход и генерация схемы
Необходимо запустить браузер Google Chrome / Microsoft Edge последних версий и перейти на сайт сервера
при первом входе откроется сайт Doczilla, где в меню "Администрирование" ("Еще"-"Администрирование") -> необходимо выбрать "Генерация схемы".
После успешного выполнения необходимо перелогиниться, в окне авторизации ввести логин Admin поле пароля оставить пустым, нажать "Войти", после этого необходимо дважды задать пароль для учетной записи Администратора.