ModernERP EAM / Рабочая инструкция
Резервное копирование и восстановление EAM
Сохраните базу и настройки, проверьте checksum и восстановление только в новую пустую PostgreSQL-БД.
Редакция от 21 ноября 2026 года. Действия и ограничения сверены с исходниками EAM; установленная версия и права могут отличаться.
Перед началом
Кому нужен доступ
Администратор с правами pg_dump, создания отдельной restore-БД и чтения защищённой конфигурации. Обычному пользователю EAM не нужен доступ к архивам и секретам.
Что подготовить
Клиенты PostgreSQL 19, shell, sha256sum или shasum, каталог копий с ограниченным доступом и свободное место. Пароли лучше получать из защищённого .pgpass, не из аргументов команды.
1. Согласуйте состав копии
Зафиксируйте версию приложения и миграций. Копия БД включает оборудование, ремонтную историю, аудит и inbox/outbox; APP_SECRET, connector credentials и серверная конфигурация хранятся отдельно. Определите, какие задания нужно остановить.
Проверьте результат: Есть согласованный комплект, а не один SQL-файл без настроек подключения и версии кода.
2. Явно выберите исходную БД
Передайте PGHOST, PGPORT, PGUSER и PGDATABASE именно для EAM. Не полагайтесь на случайные defaults пользователя shell. Проверьте имя и сервер до запуска backup.
Проверьте результат: Копируется нужная EAM-БД, не ERP, APS или локальная тестовая база.
3. Создайте архив и checksum
Запустите sh ops/backup.sh с новым путём. Скрипт проверяет PostgreSQL 19, создаёт custom-format dump без owner/ACL и файл .sha256; существующий архив не перезаписывается.
Проверьте результат: Архив и checksum созданы, права ограничены. Для следующего запуска выбран новый файл, а не удалена последняя хорошая копия.
4. Подготовьте новую пустую цель
Для проверки создайте отдельную БД. PGDATABASE и EAM_RESTORE_CONFIRM должны явно совпадать с её именем. Restore отказывается очищать уже непустую базу. Рабочие обмены восстановленного стенда не включайте.
Проверьте результат: Назначение действительно новое и изолированное. Параметр подтверждения не содержит имя рабочей БД.
5. Проверьте восстановление
Запустите sh ops/restore.sh с архивом и checksum рядом. Скрипт сверяет checksum и пустоту цели, затем выполняет pg_restore с остановкой при ошибке. Подготовьте владельца/права целевой БД отдельно: owner/ACL в dump не переносятся.
Проверьте результат: Восстановление завершилось без ошибок. Проверены количество и содержимое оборудования, нарядов, простоев, аудита и очередей.
6. Проведите прикладную проверку
На правильной версии кода проверьте вход, открытие карточки, историю, отчёты и состояние подключений. До осознанного переключения заблокируйте рабочую доставку внешним системам и генерацию jobs на стенде.
Проверьте результат: Стенд не создал повторных бизнес-событий в реальном APS. Результат восстановления и ответственный за cutover зафиксированы.
Ограничения и ошибки
Checksum обнаруживает порчу, но не заменяет доверенный канал хранения. Restore не обещает транзакционную очистку после любого сбоя: неудачный результат проверяйте в новой цели, а не запускайте повтор поверх неполной базы. Нет автоматического отката схемы через down.
Если действие недоступно, проверьте роль, разрешения, принадлежность к участку и статус документа. При ошибке сохраните номер документа, время и текст сообщения; передайте их ответственному, прежде чем повторять изменяющую операцию.
Примеры и команды
Копия выбранной EAM-БД
Учебные имена и путь. Каталог должен существовать и быть защищён; пароль берётся из настроенного .pgpass. Архив сохраняет реальные данные выбранной базы.
PGHOST=127.0.0.1 PGPORT=5432 PGUSER=eam PGDATABASE=eam \
sh ops/backup.sh /secure-backups/eam-2026-11-21.dumpВосстановление в отдельную пустую БД
База eam_restore_check должна быть заранее создана и пуста. Не подставляйте рабочую базу. Не включайте production-коннекторы восстановленного стенда.
PGHOST=127.0.0.1 PGPORT=5432 PGUSER=eam PGDATABASE=eam_restore_check \
EAM_RESTORE_CONFIRM=eam_restore_check \
sh ops/restore.sh /secure-backups/eam-2026-11-21.dump