Документооборот для BPMSoft

  1. Главная
  2. Документы
  3. Документооборот для BPMSoft
  4. Установка продукта Документооборот для BPMSoft
  5. Резервное копирование и восстановление

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

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

Команды Linux в этой статье выполняйте в административной оболочке соответствующего узла: сначала sudo -i. Это необходимо и для cd в закрытые каталоги проектов, а не только для запуска Docker. После завершения работ выйдите командой exit.

Что сохранить

  • Базу BPMSoft с данными и схемами.
  • Каталог приложения: установленные пакеты, конфигурацию, нативные библиотеки и постоянные данные приложения.
  • Ключи защиты/шифрования и сертификаты с закрытыми ключами; пароли — в отдельном защищённом хранилище.
  • Оригиналы и версии файлов во внешних папках, S3, Nextcloud или другом используемом хранилище.
  • Конфигурацию службы, IIS/nginx, контейнеров и сетевых подключений.

Redis не является резервной копией базы и документов. Не восстанавливайте кэш другой среды в качестве способа вернуть документы.

Зафиксируйте согласованное состояние

В окно обслуживания завершите пользовательские изменения и остановите фоновые записи/интеграции. На Linux остановите только приложение sudo systemctl stop bpmsoft; на Windows остановите нужный сайт и пул IIS, сохранив работу других сайтов. Для внешнего хранилища используйте согласованный снимок, относящийся к тому же состоянию документов.

В профиле PostgreSQL из нашей инструкции на Linux-узле выполните:

sudo -i
cd /opt/bpmsoft-db
umask 077
install -d -m 0700 backup
(
  set -e
  temp=$(mktemp backup/.bpmsoft.XXXXXXXX)
  trap 'rm -f -- "$temp"' EXIT
  docker compose exec -T db pg_dump -U postgres -d bpmsoft -Fc > "$temp"
  test -s "$temp"
  docker compose exec -T db pg_restore --list < "$temp" > /dev/null
  mv -T --no-clobber "$temp" backup/bpmsoft-before.backup
  test ! -e "$temp" || { echo "Backup already exists. Choose a new filename." >&2; exit 1; }
)

Проверьте код завершения сразу после команды: echo $? должен вернуть 0. Ненулевой код или пустой файл — ошибка. Затем проверьте читаемость оглавления:

docker compose exec -T db pg_restore --list < backup/bpmsoft-before.backup
sha256sum backup/bpmsoft-before.backup

Проверка оглавления подтверждает формат архива, но не заменяет пробное восстановление. Сохраните также определения служебных ролей и секреты подключения принятым защищённым способом; обычный pg_dump не содержит всех ролей сервера.

Пока приложение остановлено, скопируйте его каталог средствами резервного копирования ОС, сохраняя права, и выполните согласованную копию внешних файлов. Запишите версии компонентов и состав комплекта. После окончания включите приложение, проверьте вход и работу контрольной записи.

Проверьте восстановление отдельно

  1. Выделите изолированную среду с совместимыми версиями. Не направляйте её в рабочие SMTP, Диадок и другие внешние системы. Отключите фоновые отправки до первого запуска восстановленного приложения.
  2. Восстановите приложение, его ключи и конфигурацию. Замените только адреса изолированной среды; не генерируйте новые ключи вместо сохранённых без процедуры миграции зашифрованных данных.
  3. Создайте новую пустую БД и восстановите архив. Не выполняйте очистку или восстановление поверх продуктивной базы.
  4. Восстановите соответствующие файлы внешнего хранилища и отдельный кэш среды. Проверьте права ОС.
  5. Выполните вход, откройте старый документ и несколько прежних версий вложения, проверьте назначенные задачи и нумерацию. Секреты подключений должны расшифровываться, а не заменяться отключением функции.

Возврат после неуспешного обновления

Остановите изменения в неуспешной среде и сохраните её журналы. Восстановите весь согласованный комплект исходной версии. Учитывайте документы, появившиеся после копии: их потерю или перенос нужно решить до восстановления. После запуска повторите приёмку, затем возвращайте внешние интеграции и пользователей.

Не удаляйте рабочую базу и не выполняйте docker compose down -v как стандартный шаг отката. Каталог резервных копий не должен публиковаться через веб-сайт.

Пример согласованной копии Ubuntu с контейнерной БД

На выделенном узле остановите приложение и подтвердите, что пользователи и интеграции больше не пишут в его файлы/БД. Создайте закрытый каталог на диске резервного хранения, например /srv/backup/bpmsoft/2026-11-06-before-install; дату и путь замените фактическими.

sudo install -d -m 700 /srv/backup/bpmsoft/2026-11-06-before-install
sudo systemctl stop bpmsoft
sudo tar --acls --xattrs -cpf /srv/backup/bpmsoft/2026-11-06-before-install/app.tar -C /opt/bpmsoft app
sudo cp /etc/systemd/system/bpmsoft.service /srv/backup/bpmsoft/2026-11-06-before-install/
sudo cp /etc/nginx/sites-available/bpmsoft /srv/backup/bpmsoft/2026-11-06-before-install/

Скопируйте отдельно сертификаты/ключи, если они находятся вне приложения, и выполните pg_dump из раздела выше. Ключи и JSON/XML подключения делают архив конфиденциальным, даже если документов в нём нет. Сохранение каталога не заменяет снимок внешнего S3/Nextcloud/папки.

Для выделенного кластера PostgreSQL можно дополнительно сохранить роли:

cd /opt/bpmsoft-db
umask 077
install -d -m 0700 backup
docker compose exec -T db pg_dumpall -U postgres --globals-only > backup/globals-before.sql

Файл содержит сведения о ролях и может содержать хеши паролей; храните его закрыто и не прикладывайте к открытой документации. На общем сервере согласуйте состав с администратором БД: не переносите роли других приложений автоматически.

В журнале копии запишите пути, версии, время остановки/запуска и результат каждой команды. Вычислите SHA256 файлов комплекта, перенесите копию на независимый носитель и проверьте суммы после переноса. Не храните единственную копию только в томе, который будет пересоздаваться.

Пример копии Windows

Остановите сайт и пул BPMSoft в IIS, сохранив остальные сайты. В PowerShell администратора выполните копирование в новый каталог:

robocopy 'C:\inetpub\wwwroot\BPMSoft' 'D:\Backups\BPMSoft-before-install\application' /E /COPYALL /DCOPY:DAT /R:2 /W:2 /XJ /LOG:'D:\Backups\BPMSoft-before-install\robocopy.log'
$LASTEXITCODE

Каталог назначения и его родитель должны существовать и быть доступны только администраторам. Коды robocopy ниже 8 не означают обязательную ошибку, но требуют просмотра сводки; 8 и выше — ошибка копирования. /XJ исключает обход junction, поэтому вынесенные через них данные должны копироваться отдельно. Не используйте /MIR без понимания: он может удалить лишние файлы назначения.

Экспортируйте конфигурацию сайта/пула и сертификат с закрытым ключом принятым защищённым способом. Пароль PFX храните отдельно. На Windows-узле PostgreSQL в pgAdmin откройте контекстное меню базы bpmsoft → Backup, выберите формат Custom и сохраните файл в закрытый каталог резервного хранения. Убедитесь, что задача завершилась успешно, и сохраните SHA256 через Get-FileHash -Algorithm SHA256. Проверьте оглавление командой pg_restore.exe --list на узле БД. На изолированном Windows-экземпляре пробное восстановление выполняйте по ветке Windows с отдельной пустой БД, отдельным кэшем и точечным правилом HBA для её имени. Сохраните конфигурацию контейнерного Redis и закрытые секреты тем же согласованным комплектом. Перед запуском сайта проверьте окончание всех частей копирования.

Тест восстановления контейнерного PostgreSQL

На узле изолированного контейнерного PostgreSQL откройте Bash, выполните sudo -i и перейдите в /opt/bpmsoft-db. Поместите копию в backup/bpmsoft-before.backup. Команды создают отдельную базу bpmsoft_restore_check с уже подготовленной ролью bpmsoft и восстанавливают в неё данные.

cd /opt/bpmsoft-db
docker compose exec -T db pg_restore --list < backup/bpmsoft-before.backup &&
docker compose exec -T db psql -U postgres -d postgres -v ON_ERROR_STOP=1 \
  -c "CREATE DATABASE bpmsoft_restore_check OWNER bpmsoft TEMPLATE template0 ENCODING 'UTF8'" &&
docker compose exec -T db pg_restore --single-transaction --exit-on-error --no-owner --no-acl --role=bpmsoft -U postgres -d bpmsoft_restore_check < backup/bpmsoft-before.backup &&
docker compose exec -T db psql -U postgres -d bpmsoft_restore_check -v ON_ERROR_STOP=1 -c 'SELECT count(*) FROM "SysSchema";' 

Если база с таким именем уже есть, не удаляйте её вслепую: выберите другое новое имя. До запуска тестовой копии в её ConnectionStrings.config укажите Database=bpmsoft_restore_check и отдельный кэш. На узле тестовой БД с правами root откройте /opt/bpmsoft-db/pg_hba.conf. Если действующее правило разрешает вход роли bpmsoft только в одноимённую базу, добавьте отдельное разрешение для bpmsoft_restore_check перед общими правилами reject. Следующая строка разрешает вход только с loopback для приложения и контейнера PostgreSQL на одном узле:

host bpmsoft_restore_check bpmsoft 127.0.0.1/32 scram-sha-256

Для отдельного сервера приложения замените 127.0.0.1/32 фактическим IPv4 источника с маской /32. Если выбрали другое имя базы, подставьте его также в правило HBA, строку подключения и команды восстановления. Для контейнерной БД с сетью host используйте фактический адрес приложения. Если для БД настроен TLS, используйте hostssl. Сохраните файл на месте и выполните в административной оболочке на узле БД:

cd /opt/bpmsoft-db
docker compose exec -T db psql -U postgres -d postgres -v ON_ERROR_STOP=1 -c \
  'SELECT line_number, error FROM pg_hba_file_rules WHERE error IS NOT NULL'

При нуле строк примените изменения:

docker compose exec -T db psql -U postgres -d postgres -v ON_ERROR_STOP=1 -c 'SELECT pg_reload_conf()'

Ожидается t. После запуска тестового приложения проверьте сессию приложения на узле БД, подставив в SQL имя bpmsoft_restore_check. До запуска исключите производственные внешние отправки и доступ к рабочим интеграциям на уровне изолированной сети.

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

Когда копию можно считать пригодной

Есть все части одного состояния, контрольные суммы совпали, восстановление в отдельную среду завершилось, контрольные документы/файлы открылись и известен ответственный за возврат. Если отсутствует ключ шифрования или внешний файл, завершение pg_restore не делает копию полной.

Был ли данный материал полезен вам? Да Нет