# Установка ПринтМенеджера — онлайн, собственные сертификаты

## Цель

Установить ПринтМенеджер на сервер с выходом в интернет с использованием собственных SSL-сертификатов.

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

- Сервер соответствует требованиям из страницы «Требования к серверу для установки Принтум».
- Сервер имеет выход в интернет и доступ к `https://s3.printum.io`.
- Подключение к серверу по SSH под пользователем с правами sudo.
- Установлен `curl`.
- Подготовлены собственные SSL-сертификаты.

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

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

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

### Шаг 1. Подключиться к серверу по SSH

```
ssh username@ip_address
```

Где `username` —логин пользователя на сервере, а `ip_address` — адрес удаленного сервера.

После ввода этой команды нужно будет ввести пароль от учетной записи для подключения.

### Шаг 2. (Опционально) Задать пароль суперпользователя

```
export PM_ADMIN_PASSWORD=<пароль>
```

### Шаг 3. Запустить установку с собственными сертификатами

Можно указать полный путь к файлу или только имя файла, если запускаете установку из директории с сертификатами.

Установка с адресацией по IP-адресу и с собственными сертификатами:

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

Установка с адресацией по доменному имени и с собственными сертификатами:

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

### Шаг 4. (Опционально) Установка на выделенный сервер

Для установки ПринтМенеджера на выделенный сервер добавьте переменную `MONITORING_ADDRESS`:

```
sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E MONITORING_ADDRESS=<mon_hostname_or_ip> PM_HOSTNAME=<hostname> bash
```

где `<mon_hostname_or_ip>` — доменное имя или IP-адрес сервера мониторинга.

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

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

При установке автоматически происходит сравнение чек-суммы (алгоритм sha512) скачанного архива. Среднее время установки — 10–20 минут.

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

- Установка завершается без ошибок.
- В выводе указан URL панели администратора ПринтМенеджера.
- Панель администратора («зелёная админка») доступна по адресу `https://<ip_address>:8080/config/`.

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

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

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

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

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

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

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

- **Браузер сообщает об ошибке сертификата** — убедиться, что CA-сертификат добавлен в доверенные на клиентских машинах; при использовании разных серверов обязателен единый корневой CA для Мониторинга и ПринтМенеджера.
- **Нет доступа к https://s3.printum.io** — проверить интернет-соединение; при отсутствии доступа использовать офлайн-установку.
- **Авторизация не проходит** — если задавался `PM_ADMIN_PASSWORD`, использовать его вместо `printum`.
- **Установка на отдельный сервер (не на тот же, что Мониторинг)** — обязательно добавить переменную `MONITORING_ADDRESS=<mon_hostname_or_ip>` в команду установки.

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

- [Требования к серверу для установки Принтум](http://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-serveru-dlia-ustanovki-printum)
- [Требования к сетевой доступности и портам](http://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-setevoi-dostupnosti-i-portam)
- [Требования к сертификатам безопасности](http://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-sertifikatam-bezopasnosti)
- [Установка ПринтМенеджера — онлайн, автоматические сертификаты](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-printmenedzera-onlain-avtomaticeskie-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)