Skip to main content

Как обновить Printum

title: Как обновить Printum slug: kak-obnovit-printum tags: [обновление, update, install.sh, singlenode, балансировщик, партнёр] domain: Installation type: Runbook audience: partner-engineer product_versions: "4.x" status: ready related_components: [Мониторинг, ПринтМенеджер, Балансировщик] related_pages:

  • kak-vosstanovit-printum-iz-rezervnoy-kopii
  • kak-rabotaet-sinhronizaciya-monitoring-i-printmanager
  • oshibki-posle-obnovleniya-printum (раздел Troubleshooting)

Как обновить Printum

Когда использовать

Перед обновлением Мониторинга или ПринтМенеджера в продуктивной среде.

Предусловия

  • Доступ к серверам по SSH.
  • Дистрибутивы получены от Printum или доступен интернет.
  • Сделан снапшот ВМ или резервная копия — обязательно.

Шаг 0. Резервная копия

Снапшот через гипервизор — предпочтительно. Если недоступен — резервная копия встроенным инструментом:

# М и ПМ на одном сервере
sudo /opt/printum/backup.sh /home/user/backup

# Только ПМ
sudo /opt/printmanager/backup.sh /home/user/backup

Перенести архив на внешнее хранилище:

scp /home/user/backup/printum-backup-*.tar.gz user@storage:/backups/

Восстановление: Как восстановить Printum из резервной копии

Порядок обновления

Всегда обновлять строго по порядку:

  1. Мониторинг (М)
  2. ПринтМенеджер (ПМ) — только после того, как М поднялся

Обновлять ПМ раньше М нельзя.

Singlenode: онлайн-обновление

# 1. Обновить М
sudo curl -L https://s3.printum.io/box/monitoring/install.sh | sudo -E bash

# 2. Убедиться что М работает — открыть ЛК, дождаться 2–5 минут

# 3. Обновить ПМ
sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E bash

Singlenode: офлайн-обновление

# Перенести дистрибутивы на сервер
scp monitoring-x.y.z.tar.gz root@<ip>:/root/dist/
scp monitoring-x.y.z.tar.gz.sha512 root@<ip>:/root/dist/
scp printmanager-x.y.z.tar.gz root@<ip>:/root/dist/
scp printmanager-x.y.z.tar.gz.sha512 root@<ip>:/root/dist/

# Проверить целостность
cd /root/dist
sha512sum -c monitoring-x.y.z.tar.gz.sha512
sha512sum -c printmanager-x.y.z.tar.gz.sha512

# Обновить М
tar xzvf monitoring-x.y.z.tar.gz
cd monitoring-x.y.z
sudo -E ./install.sh

# После запуска М — обновить ПМ
cd /root/dist
tar xzvf printmanager-x.y.z.tar.gz
cd printmanager-x.y.z
sudo -E ./install.sh

Если используется шифрование конфигурационного файла — добавить ENV_VAULT_PASSWORD=<password> в каждую команду install.sh.

Балансировщик: обновление через скрипт массовой установки

Если система устанавливалась через install_all_offline.sh:

# Обновить пути к дистрибутивам в config.ini:
# [Monitoring] — новый дистрибутив М
# [PrintManager_1], [PrintManager_2], ... — новые дистрибутивы ПМ

sudo ./install_all_offline.sh

Балансировщик: ручное обновление

Если скрипт массовой установки не использовался:

# 1. Обновить М стандартной командой на сервере с М

# 2. Остановить ПМ на всех нодах
ssh user@pm1 "cd /opt/printmanager && sudo docker-compose down"
ssh user@pm2 "cd /opt/printmanager && sudo docker-compose down"

# 3. Обновить первую ноду

# 4. Обновить остальные ноды — можно параллельно

# 5. Проверить панель ПМ по адресу балансировщика

Проверка после обновления

# Версии компонентов
cat /opt/printum/.version
cat /opt/printmanager/.version

# Статус контейнеров
cd /opt/printum && sudo docker-compose ps
cd /opt/printmanager && sudo docker-compose ps

Все контейнеры должны быть в статусе Up. Контейнеры в статусе Exit или Restarting — признак проблемы.

Функциональные проверки:

  • Открывается ЛК и панель администратора М.
  • Открывается панель администратора ПМ.
  • Синхронизация М–ПМ завершается без ошибок.
  • Авторизация на МФУ работает.
  • Тестовое задание уходит на печать.

Если что-то пошло не так

Типовые ошибки после обновления — в разделе Troubleshooting:

Связанные страницы

Back to top