# Установка филиального ПринтМенеджера

## Цель

Установить дополнительный филиальный сервер ПринтМенеджера, подключённый к центральному Мониторингу.

## Предусловия

- Сервер соответствует требованиям из страницы «Требования к серверу для установки Принтум».
- Центральный Мониторинг установлен и доступен по сети.
- Подготовлены собственные SSL-сертификаты (для филиальных ПринтМенеджер используются только собственные сертификаты).
- Подключение к серверу по SSH под пользователем с правами sudo.
- Установлен `curl`.

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

- IP-адрес или доменное имя сервера дополнительного ПринтМенеджера (`<ip_PM>`).
- IP-адрес или доменное имя сервера Мониторинга (`<ip_M>`).
- Файл сертификата: `client.crt`.
- Ключ сертификата: `client.key`.
- СА сертификат: `ca.crt`.

## Шаги установки

### Шаг 1. Запустить установку филиального ПринтМенеджера

Дополнительные филиальные серверы устанавливаются так же, как описано в разделе «Установка сервера управления печатью», но к команде необходимо добавить адрес мониторинга и ключи сертификатов.

Для подключения дополнительных филиальных серверов необходимо использовать собственные сертификаты.

Пример команды онлайн-установки:

```
sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E PM_HOSTNAME=<ip_PM> MONITORING_ADDRESS=<ip_M> SSL_CERT=client.crt SSL_KEY=client.key SSL_CERT_CA=ca.crt bash
```

где:

- `<ip_PM>` — IP-адрес сервера дополнительного ПМ.
- `<ip_M>` — IP-адрес сервера Мониторинга.

### Шаг 2. Дождаться завершения установки

Среднее время установки — 10–20 минут.

### Шаг 3. Настроить синхронизацию

Филиальные ПМы получают информацию о пользователях при синхронизации с Мониторингом. Данные, импортированные из контроллера домена, также будут передаваться из Мониторинга в филиальный ПринтМенеджер (например, номера карт авторизации или адреса папок для сканирования). Если пользователи в филиале самостоятельно привязывают свои карты авторизации, то номера карт сохраняются в филиальном ПМе.

Для настройки синхронизации обратитесь к разделу «Интеграция с ПМами».

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

- Установка завершается без ошибок.
- Панель администратора филиального ПринтМенеджер доступна по адресу `https://<ip_PM>:8080/config/`.
- Филиальный ПринтМенеджер отображается в разделе «Интеграция с ПМами» в Мониторинге.

## Как проверить установку

- Открыть в браузере URL панели администратора филиального ПринтМенеджера.
- Авторизоваться с учётными данными по умолчанию: логин `printum`, пароль `printum`.
- Убедиться, что синхронизация с Мониторингом настроена: перейти в «Интеграция с ПМами».

## Примечание

- По окончании срока действия сертификаты потребуется заменить. Инструкция в разделе «Обновление сертификатов».

## Следующие шаги

- «Завершение установки ПринтМенеджера — первый вход и проверка»
- «Интеграция с ПМами»

## Типовые ошибки

- **MONITORING\_ADDRESS не указан** — при установке филиального ПринтМенеджер на отдельный сервер переменная `MONITORING_ADDRESS=<ip_M>` обязательна; без неё ПринтМенеджер не подключится к Мониторингу.
- **Разные корневые сертификаты** — Мониторинг и все филиальные ПринтМенеджер обязаны использовать один корневой CA; для каждого сервера выписать отдельный SSL-сертификат от единого CA.
- **Авторизация не проходит** — если при установке задавался `PM_ADMIN_PASSWORD`, использовать его вместо пароля по умолчанию `printum`.
- **Синхронизация не работает после установки** — настроить синхронизацию через раздел «Интеграция с ПМами» в Личном кабинете Мониторинга.

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

- [Требования к серверу для установки Принтум](http://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-serveru-dlia-ustanovki-printum)
- [Требования к сертификатам безопасности](http://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-sertifikatam-bezopasnosti)
- [Установка ПринтМенеджера — онлайн, собственные сертификаты](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-printmenedzera-onlain-sobstvennye-sertifikaty)
- [Завершение установки ПринтМенеджера — первый вход и проверка](http://wiki.printum.io/books/3-ustanovka/page/zaversenie-ustanovki-printmenedzera-pervyi-vxod-i-proverka)
- [Синхронизация Мониторинга и ПринтМенеджера](http://wiki.printum.io/books/1-arxitektura-i-koncepcii/page/sinxronizaciia-monitoringa-i-printmenedzera)