Старая Инструкция по установке и обновлению Doczilla
    • 05 Jun 2024
    • 4 Minutes to read
    • Contributors
    • Dark
      Light
    • PDF

    Старая Инструкция по установке и обновлению Doczilla

    • Dark
      Light
    • PDF

    Article summary

    Установка DOCZILLA PRO (linux)


    На сервере приложения

    1. Установить Java 1.8

    #  yum install java-1.8.0-openjdk.x86_64 java-1.8.0-openjdk-devel.x86_64
    
    # apt install openjdk-8-jdk

    2. Разархивировать (зависит от архива) дистрибутив и БД в директорию /opt/

    #  tar -xvf ./doczilla.tar -C /
    
    # unzip ./doczilla.zip -d /opt/
    
    # chmod +x /opt/doczilla/bin/*.sh  /opt/doczilla/bin/doczilla

    3. Указать путь до каталога с JAVA в файле  service.sh

    #  vi /opt/doczilla/bin/service.sh
    
    export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64

    можно указать и строку запуска NodeJS для автоматического запуска вместе с Doczilla, пример:

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

    4. Указать настройки в файле «server.properties»  для БД (наименование схемы и путь), путь до ПО LibreOffice и при необходимости можно (необязательно) изменить порт для сайта (порт умолчанию 9080)

    #  vi /opt/doczilla/work/server.properties
    
    
    application.database.schema=name-schema
    
    application.database.connection=jdbc:postgresql://10.0.0.9:5432/doczilla
    
    office.home=/usr/lib/libreoffice
    
    web.server.http.port=9080

    На сервере СУБД (если БД отдельно)

    1. На сервере СУБД устанавливаем PostgreSQL (поддерживается с 9.6 и выше)

    #  yum install postgresql11  postgresql11-lib.x86_64 postgresql11-server postgresql11-contrib.x86_64
    
    # apt install postgresql-9.6 postgresql-server-9.6

    2. Инициализируем с русской локалью и запускаем СУБД

    #  su - postgres 
    
    $ /usr/lib/postgresql/bin/initdb -D /var/lib/pgsql/data/ --locale=ru_RU.utf8 
    
    #  systemctl start postgresql

    3. При необходимости настраиваем pg_hba.conf и postgresql.conf


    pg_hba.conf- меняем метод доступа к БД на trust

    postgresql.conf- редактируем параметры listen_addresses, max_connections


    4. Создаем БД «doczilla», роль и расширения

    #  su - postgres 
    
    $ createdb -T template0 doczilla 
    
    
    $ psql 
    
    postgres=# CREATE ROLE doczilla WITH PASSWORD 'doczilla' LOGIN; 
    
    postgres=# \q 
    
    
    $ psql doczilla 
    
    doczilla=# CREATE EXTENSION pg_trgm; 
    
    doczilla=# CREATE SCHEMA namecompany AUTHORIZATION doczilla; 
    
    doczilla=#  \q

    5. Восстанавливаем бекап БД из папки /opt/ (если сборка поставляется с базой)

    #  su - postgres 
    
    $ psql -d doczilla -f /opt/namebackup.sql

    P.S. если владец не пользователь postgres 

    #  su - postgres
    
    $  psql -d postgres -U yours_name_user
    
    postgres=#  CREATE ROLE doczilla WITH PASSWORD 'doczilla' LOGIN;
    
    postgres=#  ALTER ROLE doczilla SUPERUSER;
    
    postgres=#  ALTER ROLE doczilla CREATEDB;
    
    $  psql -d postgres -U doczilla
    
    postgres=#  CREATE DATABASE doczilla;
    
    postgres=#  \q
    
    $  psql -d doczilla -U doczilla
    
    doczilla=#  CREATE EXTENSION pg_trgm;
    
    doczilla=#  CREATE SCHEMA “name_schema” AUTHORIZATION doczilla;

    Запуск

    Запускать файлом  /opt/doczilla/service.sh  или настроить запуск службой (поправив в файле пути и имя/группу запускаемого пользователя)

    #  cp  /opt/doczilla/bin/service  /etc/systemd/system/doczilla.service
    
    #  systemctl  enable  doczilla.service
    
    #  systemctl  start  doczilla.service
    
    • Выполнить обновление базы данных "Меню" “Администрирование” - “Генерация схемы” 


    Обновление сборки, с сохранением документов


    1. Для обновления приложения необходимо остановить службу

    ActionScriptActionScriptActionScript#  systemctl  stop  doczilla.service

    2. Переименовать папку с текущей версией (для сохранения созданных документов) (обычно папка называется doczilla переименовываем на doczilla-old), и распаковать архив с новой версией, переименовать распакованную папку в doczilla .

    3. Из старой версии doczilla-old скопировать директории c файлами документов в папку doczilla

    Директории с доменными настройками, документами и версиями:


    ActionScriptActionScriptActionScript/opt/doczilla/conf/spnego/
    /opt/doczilla/work/documents/

    4. Из старой версии doczilla-old скопировать настройки из старых конфигурационных файлов в файлы с новой версией

    ## путь к JAVA, запуск nodejs и настройки доменной авторизации SSO/DOMAIN/TARGET
    /opt/doczilla/bin/service.sh
    
    ## схема БД, логин/пароль и путь до БД, путь до Libreoffice, и дополнительные кастомные настройки для доменной/LDAP авторизации
    /opt/doczilla/work/server.properties

    5. Запустить службу  

    ActionScriptActionScript

     

    #  systemctl  start  doczilla.service

    6. После обновления приложения

    • Запустить с ПК Браузер необходимо перейти по ссылке на сайт doczilla.

    • Залогиниться учётной записью “Админ”

    • Выполнить обновление базы данных "Меню" “Администрирование” - “Генерация схемы” 

    • После выполнения генерации схемы данных на 100% нажать кнопку “Готово“

    Установка NodeJS


    1. Для Linux установить из репозитория среду выполнения версии 8.0 и выше

    #  yum install nodejs -y
    #  apt install nodejs -y

    2. Распаковать архив с приложением, сделать запускаемым скрипт и запустить файл

    #  unzip  ./doczilla.nodejs.zip  -d /opt/
    #  chmod  +x  /opt/doczilla.nodejs/start.sh
    #  /opt/doczilla.nodejs/start.sh

    3. Для Windows скачать и установить среду выполнения

    https://nodejs.org/dist/v14.16.0/node-v14.16.0-x64.msi

    4. Распаковать архив с приложением, отредактировать путь до NodeJS и запустить файл

    C:\pro.doczilla.nodejs-1.0\start.bat

    Установка DOCZILLA PRO (windows)


    1. Выбрать ОС и версию PostgreSQL (v.9.6 и выше), скачать и установить

    https://www.postgresql.org/download/windows/

    2. При необходимости настраиваем pg_hba.conf и postgresql.conf

    • pg_hba.conf- меняем метод доступа к БД на trust

    • postgresql.conf- редактируем параметры listen_addresses, max_connections

    3. Создаем БД  doczilla, и восстанавливаем бекап БД

    >  cd "c:\Program Files\PostgreSQL\11\bin"
    >  createdb -T template0 doczilla
    
    >  psql
    postgres=# CREATE ROLE doczilla WITH PASSWORD 'doczilla' LOGIN;
    postgres=# \q
    
    >  psql doczilla
    doczilla=#  CREATE EXTENSION pg_trgm;
    doczilla=#  CREATE SCHEMA “name_schema” AUTHORIZATION doczilla;
    doczilla=#  \q

    Указываем в командной строке кодировку UTF-8 и ресторим бекап

    >  chcp 65001
    >  psql -d doczilla  -U doczilla < c:\namebackup.sql

    4. Устанавливаем JAVA 1.8

    OpenJDK https://github.com/ojdkbuild/ojdkbuild/releases

    Oracle JAVA JDK https://www.oracle.com/java/technologies/javase/javase8-archive-downloads.html

    5. Распаковать архив с приложением и запустить файлы

    Прописать путь для JAVA_HOME в %PATH%  операционной системы или в файле 

    ./conf/wrapper.xml

    set.JAVA_HOME=/java/path
    
    > .\doczilla\bin\install.bat
    > .\doczilla\bin\start.bat

    В ОС Windows, настроить путь до JAVA и сменить порт можно в файле 

    .\doczilla\conf\wrapper.conf

    5. Резервное копирование и восстановление

    Резерное копирование обязательно проводить при остановленном сервисе приложения Doczilla Pro, т.к. необходимо выполнять одновременное резервное копирование БД и директорий с документами приложения (тогда версии документов будут соответствовать хранимым данным в БД). 

    Выполнение резервного копирования 

    • произвести остановку службы приложения Doczilla;

    • произвести резервное копирование БД (backup) на сервере СУБД (для критических данных рекомендуется ежедневное); 

    • произвести резервное копирование файловой системы Doczilla на сервере приложения (для критических данных рекомендуется ежедневное);

    • убедиться в успешном завершении процедуры путём проверки наличия созданных файлов и соответствующих записей в лог-файлах;

    • настроить систему сжатия и ротации хранимых резервных копий, в соответствии с необходимым периодом хранения.

    Примеры команд:

    pg_dump -h 192.168.0.111  doczilla  >  /backup/doczilla.dump 
    psql -U postgres  doczilla  >  /backup/doczilla.dump 
    zip -r /backup/docz.zip  /opt/doczilla

    Выполнение восстановления 

    • произвести остановку службы приложения Doczilla 

    • удалить базу данных: “doczilla”

    • создать базу данных “doczilla” с локалью “ru.RU_UTF8”

    • произвести восстановление (restore) базы данных из резервной копии. 

    • произвести удаление файловой системы Doczilla на сервере приложения; 

    • произвести восстановление файлов на сервере приложения из резервной копии в папку Doczilla.

    Примеры команд: 

    dropdb doczilla
    createdb  -T template0  doczilla 
    unzip /backup/docz.zip -d /opt/doczilla
    pg_restore -d doczilla  /backup/doczilla.dump 
    psql doczilla  <  /backup/doczilla.dump

    6. Возможные ошибки

    При скачивании PDF, ошибка «officeHome doesn`t exist or is not a directory: /usr/lib/libreoffice»

    В таком случае нужно установить LibreOffice или прописать правильный путь в файле  

    ./work/project.xml


    Was this article helpful?