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

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

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

Обновление Doczilla 3.X на 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. Надо обратить внимание, что изменились расположения некоторых директорий и конфигов.
Поэтому внимательно переносим документы, лицензию и конфиги из резервной копии в рабочую

## копируем документы и конфигурационные файлы
cp -f /opt/doczilla_backup/work  /opt/doczilla/

cp -rf /opt/doczilla_backup/conf/spnego/*  /opt/doczilla/conf/spnego/
cp -rf /opt/doczilla_backup/conf/licences  /opt/doczilla/conf/
cp -rf /opt/doczilla_backup/conf/smtp.properties  /opt/doczilla/conf/

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


## подробнее в инструкции https://help.doczilla.pro/articles/#!knowledge_base/install-doczilla-linux/a/h3_324729909
vi  /opt/doczilla/bin/service.sh

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


## подробнее в инструкции https://help.doczilla.pro/articles/#!knowledge_base/install-doczilla-linux/a/h3__61675794
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), где в меню "Администрирование" - необходимо выбрать "Генерация схемы базы данных".

Обновление 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-3.0.0-202412312359.zip

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

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

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

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

## запуск скриптов nodejs, если отдельной службой
systemctl start 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

Обновление Doczilla 3.X на Windows

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

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

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

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

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

## пример команды бекапа БД различными способами: 
pg_dump -Fc doczilla > c:\DZ\doczilla.dump 
pg_dump -h 127.0.0.1 -p 5432 -U postgres doczilla  >  c:\DZ\doczilla.dump 

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

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

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

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

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

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

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

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

move C:\DZ\pro.doczilla-3.2.0-202505312359  C:\DZ\doczilla

mkdir C:\DZ\doczilla\log

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

- копирование файлов и директорий можно выполнить выделением кнопкой мыши - правой кнопкой мыши Копировать и в новом месте правой кнопкой мыши Вставить,
из директории с резервной копией перенести всю папку work и spnego, так же файлы wrapper.conf, server.properties, smtp.properties
- или через командную строку:

## копируем нужные директории
xcopy /i /s C:\DZ\doczilla_backup\work  C:\DZ\doczilla\

xcopy /i /s C:\DZ\doczilla_backup\conf\spnego  C:\DZ\doczilla\conf\


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

xcopy /i /s C:\DZ\doczilla_backup\conf\server.properties  C:\DZ\doczilla\conf\

xcopy /i /s C:\DZ\doczilla_backup\conf\smtp.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=C:\\Program Files\\LibreOffice
....

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

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