Обновление

• Онлайн-обновление Мониторинга
• Офлайн-обновление Мониторинга
• Онлайн-обновление ПринтМенеджера
• Офлайн-обновление ПринтМенеджера
• Обновление в отказоустойчивой конфигурации
• Обновление Клиента ПМ на Linux
• Обновление Сетевого агента
• Обновление Локального агента
• Обновление Клиента ПМ на Windows

Онлайн-обновление Мониторинга

Описание

Обновление Мониторинга до последней стабильной версии через интернет с помощью install-скрипта.

Предусловия

• Сервер имеет доступ в интернет
• Права sudo на сервере

Шаги

Стандартное обновление

Команда обновления мониторинга до стабильной версии:

sudo curl -L https://download.printum.io/box/monitoring/install.sh | sudo -E bash

Скрипт автоматически скачает дистрибутив стабильной версии, проверит целостность по чек-сумме (sha512) и выполнит обновление.

Обновление с шифрованием конфигурационного файла

Если при установке использовалось шифрование .env-файла, добавьте переменную ENV_VAULT_PASSWORD:

Установка по hostname:

sudo curl -L https://download.printum.io/box/monitoring/install.sh | sudo -E MON_HOSTNAME=<hostname> ENV_VAULT_PASSWORD=<password> bash -s agent

Установка по IP:

sudo curl -L https://download.printum.io/box/monitoring/install.sh | sudo -E IP_ADDRESS=<ip> ENV_VAULT_PASSWORD=<password> bash -s agent

Во время обновления система запросит ввод пароля повторно.

Важно: переход с незашифрованного файла на зашифрованный в процессе обновления не поддерживается.

Проверка

• Проверьте доступность личного кабинета Мониторинга.
• Убедитесь в корректности отображения данных устройств.

Офлайн-обновление Мониторинга

Описание

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

Предусловия

• Получены ссылки на дистрибутив и файл чек-суммы (sha512) от техподдержки
• Файлы переданы на сервер

Шаги

Стандартное обновление

Обновление запускается следующей командой:

sudo -E ./install.sh

Обновление с шифрованием конфигурационного файла

При обновлении ПринтМенеджера с включённым шифрованием конфигурационного файла необходимо указать переменную ENV_VAULT_PASSWORD=<password>

sudo ENV_VAULT_PASSWORD=<password> -E ./install.sh

Пример: sudo ENV_VAULT_PASSWORD=passW0rd@ -E ./install.sh

Система запросит ввод пароля повторно. Переход с незашифрованного на зашифрованный в процессе обновления не поддерживается.

Проверка

• Проверьте доступность личного кабинета Мониторинга.
• Убедитесь в корректности отображения данных.

Онлайн-обновление ПринтМенеджера

Описание

Обновление ПринтМенеджера до актуальной стабильной версии через интернет.

Предусловия

• Сервер имеет доступ в интернет
• Права sudo на сервере

Шаги

Стандартное обновление

sudo curl -L https://download.printum.io/distrib/printum-printmanager/install.sh | sudo -E bash

Скрипт скачает дистрибутив стабильной версии, проверит целостность (sha512) и выполнит обновление.

Обновление с шифрованием конфигурационного файла

sudo curl -L https://download.printum.io/distrib/printum-printmanager/install.sh | sudo -E PM_HOSTNAME=<ip> ENV_VAULT_PASSWORD=<password> bash

Важно: переход с незашифрованного на зашифрованный файл в процессе обновления не поддерживается.

Проверка

• Проверьте доступность панели администратора ПринтМенеджера (https://<ip>:8080/config/).
• Убедитесь в корректности синхронизации с Мониторингом.

Офлайн-обновление ПринтМенеджера

Описание

Обновление ПринтМенеджера без доступа в интернет.

Предусловия

• Получены ссылки на дистрибутив и файл чек-суммы от техподдержки
• Файлы переданы на сервер и проверена целостность

Шаги

Стандартное обновление

Аналогично офлайн-установке, но без переменной PM_HOSTNAME:

sudo -E ./install.sh

Обновление с шифрованием конфигурационного файла

sudo ENV_VAULT_PASSWORD=<password> -E ./install.sh

Пример: sudo ENV_VAULT_PASSWORD=passW0rd@ -E ./install.sh

Система запросит ввод пароля повторно. Переход с незашифрованного на зашифрованный не поддерживается.

Проверка

• Проверьте доступность панели администратора ПринтМенеджера.
• Проверьте синхронизацию с Мониторингом.

Обновление в отказоустойчивой конфигурации

Описание

Обновление системы, развёрнутой в конфигурации Active-Active с балансировщиком нагрузки (HAProxy) и несколькими серверами ПринтМенеджера.

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

1. Обновите Мониторинг по инструкции «Онлайн-обновление Мониторинга» или «Офлайн-обновление Мониторинга».
2. Остановите ПМы на серверах. Для этого зайдите на каждый по ssh и выполните команды:

   cd /opt/printmanager
   sudo docker-compose down
   

3. Последовательно обновите каждый сервер ПринтМенеджера командой обновления ПМ.
4. Проверьте, что панель администратора ПМ по адресу балансировщика после обновления стабильно доступна.

Обновление с шифрованием конфигурационного файла

При включённом шифровании массовое развёртывание через скрипт массовой установки не поддерживается. Применяйте ручной порядок установки с добавлением переменной ENV_VAULT_PASSWORD для каждого сервера:

sudo -E ENV_VAULT_PASSWORD=<password> ./install.sh

Проверка

Откройте панель администратора HAProxy и убедитесь, что все секции (ftp, cups_1631, tcp_converter_7776/7777, admin_8010, admin_8080) отображают зелёные строки серверов. Каждый из разделов должен иметь все зеленые строчки (кроме коричневых строк Frontend или Backend).

Обновление Клиента ПМ на Linux

Описание

Обновление клиентской части ПринтМенеджера на рабочих станциях Linux.

Предусловия

• Получена ссылка на актуальный дистрибутив от техподдержки.
• УЗ пользователя, от которой выполняется обновление есть sudo-права на целевой рабочей станции.

Шаги

1. Обратитесь в службу поддержки для получения ссылки на актуальный дистрибутив.
2. Скачайте новую версию клиента:

curl -O https://download.printum.io/distrib/printmanager-client/printmanager_client-linux-x.y.z.tar

3. Распакуйте архив и повторите шаги установки из раздела «Установка клиента ПМ»:

tar xvf printmanager_client-linux-x.y.z.tar
cd printmanager_client-linux-x.y.z
sudo -E ./install.sh

Как проверить обновление

Выполните команду ниже для просмотра системных логов работы службы клиента ПМ:

sudo systemctl status printum-printmanager-client.service

• Служба должна быть активна.
• В системе должен присутствовать виртуальный принтер с именем Printum.

Логи

sudo journalctl -u printum-printmanager-client.service
# или
cat /var/log/printum/printmanager_client.log

Обновление Сетевого агента

Описание

Обновление сетевого агента мониторинга на Linux или Windows.

Обновление на Linux (офлайн)

1. Получите ссылку на последнюю версию дистрибутива от техподдержки.
2. Скачайте и выполните обновление:

tar xf agent-linux-x.x.tar.gz
cd printum-agent
sudo bash ./update.sh

Обновление на Windows (офлайн)

1. Получите и скачайте архив agent-win-x.x.x.zip от техподдержки.

2. Распакуйте в удобную директорию, например C:\Printum\agent-win-x.x.x.

3. Откройте и настройте config.env:

   • TOKEN=<GUID_network_agent> — токен из Настройки → Интеграции → Сетевые агенты.
   • BACKEND=http://<address_mon>:8000/— IP-адрес сервера мониторинга. Важно указывать слэш (/) в конце: http://<IP_M>:8000/.

4. Откройте командную строку от имени администратора и выполните:

cd C:\Printum\agent-win-x.x.x
install.bat

Проверка

В панели Мониторинга откройте список агентов. В колонке version должна быть целевая версия, в updated_at — актуальные дата и время.

Обновление Локального агента

Описание

Обновление локального агента для мониторинга заданий печати на Windows или Linux.

Обновление локального агента на Linux

Скачайте обновленный дистрибутив и выполните команды.

tar xf printum-jtm-linux-x.x.tar
cd printum-jtm-linux-x.x
./install.sh

Чтобы проверить, что служба работает, выполните:

systemctl status printum-jtm

Обновление локального агента на Windows

Обновление ПО осуществляется аналогично установке, запустите командную строку от имени администратора и выполните команду:

msiexec /i printmanager_client-a.b.c-win.msi /qn /L install.log

При обновлении менять стандартный путь установки не нужно. Предварительно удалять предыдущую версию не нужно. Установщик самостоятельно удалит предыдущие версии продукта, сохранив настройки в файле settings.yml

Обновление Клиента ПМ на Windows

Описание

Обновить Клиент ПМ на рабочей станции Windows до актуальной версии.

Предусловия

• Клиент ПМ ранее установлен на рабочей станции.
• Командная строка запущена от имени администратора.
• Получена ссылка на актуальную версию дистрибутива от технической поддержки.

Что потребуется

• MSI-файл актуальной версии дистрибутива: printmanager_client-a.b.c-win.msi.

Шаги обновления

Шаг 1. Получить и скачать актуальный дистрибутив

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

Шаг 2. Запустить обновление

Запустите командную строку от имени администратора и выполните команду:

msiexec /i printmanager_client-a.b.c-win.msi /qn /L install.log

При обновлении менять стандартный путь установки не нужно. Предварительно удалять предыдущую версию не нужно. Установщик самостоятельно удалит предыдущие версии продукта, сохранив настройки в файле settings.yml.

Обновление через групповые политики

Обновление через групповые политики проходит так же, как и установка. Воспользуйтесь разделом "Установка MSI пакета" со страницы Установка клиента ПМ на Windows — групповые политики.

Предварительно удалять предыдущую версию не нужно. Установщик самостоятельно удалит предыдущие версии клиента, сохранив настройки в файле settings.yml.

Для обновления настроек проверки HTTPS-сертификата замените содержимое файла сертификатов в папке с программой:

C:\Program Files\printum\printmanager_client\lib\certifi\cacert.pem

Содержимое файла должно соответствовать описанному в разделе "Настройка проверки HTTPS-сертификата для службы в Windows" страницы Настройка SSL для служб Мониторинга.

Ожидаемый результат

• Клиент ПМ обновлён до актуальной версии.
• Служба Printum Optimize Service запущена.
• Настройки из файла settings.yml сохранены.

Как проверить обновление

• Открыть "Службы" и убедиться, что Printum Optimize Service в состоянии "Выполняется".
• Проверить версию установленного ПО в разделе "Установка и удаление программ".

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

• Удаление Клиента ПМ на Windows

---