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Восстановление из резервной копии

    Порядок

    Базовая обновления

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

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

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

      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

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

      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]General] —указать новыйпуть дистрибутивгде М
# [PrintManager_1], [PrintManager_2], ... —хранятся новые дистрибутивы ПМна сервере:

      [General]
MON_DIST_PATH = /home/user/printum-x.x.x.tar.gz
PM_DIST_PATH = /home/user/printmanager-x.x.x.tar.gz

      Убедится, что в каждом из разделов Мониторинга и ПринтМенеджера переменная SKIP установлена в нужное положение:

      SKIP = false  #если пропускать обновление для данного сервера не нужно.
SKIP = true   #если требуется пропустить обновление данного сервера.

      Сохранить изменения в файле и запустить обновление:

      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"
#ssh 3.user@pm3 "cd /opt/printmanager && sudo docker-compose down"
        Обновить первуюПринтМенеджер нодуна #первой 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