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

Установка 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, пример:

ActionScriptActionScript
node /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 “name_schema” 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. Для обновления приложения необходимо остановить службу

ActionScriptActionScript
#  systemctl  stop  doczilla.service

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

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

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

ActionScriptActionScript
/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. Запустить службу  

#  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