Обновление на Doczilla 3.0

Любая инструкция является примерной,
и создана для того, чтобы показать основные команды и действия,
в связи с очень большим разнообразием linux-систем и windows-систем

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

Обновление на Doczilla 3.0 в Linux

Обновление включает в себя, остановку службы, выполнения резервного копирования БД и директории с приложением, замену директории сборки, настройку конфигов и возврат документов из копии

1. Необходимо остановить службу Doczilla

systemctl stop doczilla

2. Выполнить на сервере СУБД резервное копирование БД, используя одну из команды в примере:

## пример команды бекапа БД различными способами:
pg_dump -Fc doczilla > /tmp/doczilla.dump
pg_dump -h 127.0.0.1 -p 5432 -U postgres doczilla  >  /tmp/doczilla.dump
pg_dump -h localhost -p 5432 -U postgres doczilla | gzip > /tmp/backup_db_`date +\%Y-\%m-\%d`.sql.gz

3. Переименовать на сервере приложения рабочую версию в резервную

mv /opt/doczilla  /opt/doczilla_backup

4. Распаковать новую версию

unzip pro.doczilla-3.0.0-202412312359.zip

5. Переименовать директорию в исходную (рабочую)

mv ./pro.doczilla-3.0.0-202412312359   /opt/doczilla

6. Надо обратить внимание, что изменились расположения некоторых директорий и конфигов.
Поэтому внимательно переносим документы, лицензию и конфиги из резервной копии в рабочую

## создаем директории если их нет
mkdir /opt/doczilla/work
mkdir  /opt/doczilla/work/just-in-time
mkdir  /opt/doczilla/work/just-in-time/workspaces

## копируем нужные директории
cp -f  /opt/doczilla_backup/work/documents  /opt/doczilla/work/
cp -f  /opt/doczilla_backup/work/just-in-time/schemas/*  /opt/doczilla/work/just-in-time/workspaces/

## копируем конфигурационные файлы
cp -rf /opt/doczilla_backup/conf/*  /opt/doczilla/conf/
cp -rf  /opt/doczilla_backup/work/licences  /opt/doczilla/conf/
cp -rf  /opt/doczilla_backup/work/server.properties  /opt/doczilla/conf/

7. Отредактировать конфигурационные файлы: service.sh / server.properties (ссылка)


## service.sh подробнее в инструкции
vi  /opt/doczilla/bin/service.sh

например,
node  /opt/doczilla.nodejs/cluster.js &
SSO=
DOMAIN=


## server.properties подробнее в инструкции
vi  /opt/doczilla/conf/server.properties

например,
application.database.schema=
application.database.connection=
...
trusted.users.create=
...
office.home=
....

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

systemctl start doczilla

Генерация схемы

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

например, http://localhost:9080

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

Обновление на Doczilla 3.0 в Windows

Копируем файлы обновления на сервер на диск и в директорию, где установлена Doczilla, например
C:\DZ\pro.doczilla-3.0.0-202412312359.zip
C:\DZ\pro.doczilla.nodejs-3.0.0-202412312359.zip

1. Необходимо остановить и удалить службу Doczilla, при срабатывании фильтра SmartScreen - выбрать: "Подробнее" - нажать: "Выполнить в любом случае"

C:\DZ\doczilla\bin\stop.bat
C:\DZ\doczilla\bin\uninstall.bat

2. Выполнить на сервере СУБД резервное копирование БД, используя одну из команд в примере:

## пример команды бекапа БД различными способами: 
pg_dump -Fc doczilla > /tmp/doczilla.dump 
pg_dump -h 127.0.0.1 -p 5432 -U postgres doczilla  >  /tmp/doczilla.dump 
pg_dump -h localhost -p 5432 -U postgres doczilla | gzip > /tmp/backup_db_`date +\%Y-\%m-\%d`.sql.gz

Так же можно воспользоваться программой pgAdmin4
(подключиться к серверу СУБД - выбрать базу данных doczilla - выполнить backup)

3. Переименовать на сервере приложения рабочую версию в резервную

Можно выполнить на директории правой кнопкой мыши - Переименовать,
или через командную строку:

move C:\DZ\doczilla  C:\DZ\doczilla_backup

4. Распаковать новую версию

Можно на архиве правой кнопкой мыши - Извлечь всё - выбрать путь C:\DZ\
или воспользоваться сторонними программами, например 7-zip

5. Переименовать директорию в исходную (рабочую)

Можно на директории правой кнопкой мыши - Переименовать,
или через командную строку:

move C:\DZ\pro.doczilla-3.0.0-202412312359  C:\DZ\doczilla

- создание директории можно выполнить правой кнопкой мыши - Создать - Папку,
- копирование файлов и директорий можно выполнить выделением кнопкой мыши - правой кнопкой мыши Копировать и в новом месте правой кнопкой мыши Вставить,
- или через командную строку:

## создаем директории если их нет
mkdir C:\DZ\doczilla\conf\licences
mkdir C:\DZ\doczilla\work\documents
mkdir C:\DZ\doczilla\work\just-in-time\workspaces

## копируем нужные директории
xcopy /i /s C:\DZ\doczilla_backup\work\documents  C:\DZ\doczilla\work\documents\
xcopy /i /s C:\DZ\doczilla_backup\work\just-in-time\schemas  C:\DZ\doczilla\work\just-in-time\workspaces\

## копируем конфигурационные файлы
xcopy /i /s C:\DZ\doczilla_backup\conf  C:\DZ\doczilla\conf\
xcopy /i /s C:\DZ\doczilla_backup\work\licences  C:\DZ\doczilla\conf\licences\
xcopy /s C:\DZ\doczilla_backup\work\server.properties  C:\DZ\doczilla\conf\

7. Отредактировать конфигурационные файлы: wrapper.conf / server.properties ( https://help.doczilla.pro/articles/#!doczilla/install-doczilla-windows)

## wrapper.conf подробнее в инструкции

notepad C:\DZ\doczilla\conf\wrapper.conf   
например,

set.JAVA_HOME=C:\Program Files\Java\jre1.8.0_321


## server.properties подробнее в инструкции

notepad C:\DZ\doczilla\conf\server.properties   
например,

application.database.schema=
application.database.connection=
...
trusted.users.create=
...
office.home=
....

8. Установить и запустить службу Doczilla, при срабатывании фильтра SmartScreen - выбрать: "Подробнее" - нажать: "Выполнить в любом случае"

C:\DZ\doczilla\bin\install.bat
C:\DZ\doczilla\bin\start.bat

Генерация схемы

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

например, http://localhost:9080

Обновление NodeJS скриптов

1. Необходимо остановить службу/задачу Nodejs или Doczilla (если используется совместный запуск)

## Linux - если нода запускается совместно с Докзиллой
systemctl stop doczilla

## Linux - если нода запускается отдельной службой
systemctl stop nodejs

## Windows 
Зайти в "Планировщик задач" - остановить задачу NodeJS

2. Переименовать боевую версию в резервную

## Linux
mv  /opt/doczilla.nodejs   /opt/doczilla.nodejs_backup
## Windows
move C:\DZ\doczilla.nodejs C:\DZ\doczilla.nodejs_backup

3. Распаковать новую версию

## Linux
unzip pro.doczilla.nodejs-3.0.0-202412312359.zip
## Windows
На файле C:\DZ\pro.doczilla.nodejs-3.0.0-202412312359.zip правой кнопкой мыши - Извлечь все - выбрать путь C:\DZ\

4. Переименовать директорию в исходную

## Linux
mv ./pro.doczilla.nodejs-3.0.0-202412312359  /opt/doczilla.nodejs
## Windows
move C:\DZ\pro.doczilla.nodejs-3.0.0-202412312359 C:\DZ\doczilla.nodejs

5. Запустить службу Nodejs или Doczilla (если используется совместный запуск)

## Linux - запуск службы, если запуск скриптов nodejs прописаны в service.sh
systemctl start doczilla

## Linux - запуск скриптов nodejs, если отдельной службой
systemctl start nodejs

## Windows 
Зайти в "Планировщик задач" - запустить задачу NodeJS

Восстановление предыдущей версии (откат обновления)

Необходимо выполнить в следующем порядке

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

systemctl stop doczilla

2. на сервере СУБД удалить используемую схему в базе данных: “doczilla”

su - postgres
psql doczilla
DROP SCHEMA nameschema CASCADE;

3. создать схему в базе данных “doczilla”

CREATE SCHEMA nameschema AUTHORIZATION doczilla;
\q

4. произвести на сервере СУБД восстановление (restore) базы данных из резервной копии (сделанной ранее, до обновления), примеры команды:

## пример команд восстановления БД
pg_restore -d doczilla  /tmp/doczilla.dump
psql doczilla  <  /tmp/doczilla.dump
gunzip -c /tmp/backup_db_2023-12-31.sql.gz | psql doczilla

5. произвести удаление директории Doczilla и NodeJS на сервере приложения;

rm -rf  /opt/doczilla/
rm -rf  /opt/doczilla.nodejs/

6. произвести восстановление директорий на сервере приложения из резервной копии (сделанной ранее, до обновления) в папку Doczilla

cp  -rf  /opt/doczilla_backup  /opt/doczilla
cp  -rf  /opt/doczilla.nodejs_backup  /opt/doczilla.nodejs

7. запустить службу приложения Doczilla

systemctl start doczilla