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

Любая инструкция для linux является примерной, 

и создана для того, чтобы показать основные команды и действия, 

в связи с очень большим разнообразием linux-систем

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

Обновление Doczilla на 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-1.0-202312312359.zip

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

mv ./pro.doczilla.1.0-202312312359   /opt/doczilla

6. Перенести документы, лицензию и kerberos настройки из резервной копии в рабочую

cp  -f  /opt/doczilla_backup/work/documents  /opt/doczilla/work/
cp  -f  /opt/doczilla_backup/work/licences  /opt/doczilla/work/

rm  -rf /opt/doczilla/conf/
cp  -rf /opt/doczilla_backup/conf  /opt/doczilla/

7. Отредактировать конфигурационные файлы: service.sh / server.properties ( https://help.doczilla.pro/docs/install-doczilla-linux)

## подробнее в инструкции https://help.doczilla.pro/docs/install-doczilla-linux#настройка-скрипта-запуска-servicesh
vi  /opt/doczilla/bin/service.sh

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


## подробнее в инструкции https://help.doczilla.pro/docs/install-doczilla-linux#настройка-файла-конфигурации-serverproperties
vi  /opt/doczilla/work/server.properties

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

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

systemctl start doczilla

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

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

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

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

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

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

mv  /opt/doczilla.nodejs   /opt/doczilla.nodejs_backup

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

unzip pro.doczilla.nodejs-202312312359.zip

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

mv ./pro.doczilla.nodejs-202312312359  /opt/doczilla.nodejs

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

systemctl start nodejs   /   systemctl start doczilla

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

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

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

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

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

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

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