Установка Doczilla на Linux ОС
    • 23 May 2024
    • 2 Minutes to read
    • Contributors
    • Dark
      Light
    • PDF

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

    • Dark
      Light
    • PDF

    Article summary

    Любая инструкция для 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 поле пароля оставить пустым, нажать "Войти", после этого необходимо дважды задать пароль для учетной записи Администратора.




    Was this article helpful?