# Установка Мониторинга — онлайн, автоматические сертификаты

## Цель

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

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

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

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

- IP-адрес сервера или назначенное через DNS доменное имя (хостнейм).
- При желании — пароль для суперпользователя (минимум 6 символов, 2 буквы).

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

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

```
ssh username@ip_address
```

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

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

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

Если требуется задать пароль администратора Мониторинга на этапе установки:

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

Пароль можно задать и позже.

### Шаг 3. Запустить установку

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

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

где `<ip>` — IP-адрес сервера. Не использовать адреса из пула `10.28.32.0/26`, они используются внутренней сетью.

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

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

где `<hostname>` — доменное имя, указывающее на сервер.

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

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

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

- Установка завершается без ошибок.
- В выводе указаны URL Панели администратора Мониторинга и URL Личного кабинета.
- Панель администратора доступна по адресу `https://<ip_address>:8001/config/`.

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

- Открыть в браузере URL Личного кабинета и Панели администратора Мониторинга.
- Авторизоваться с учётными данными по умолчанию (логин `printum`, пароль `printum`) или с заданным `MON_ADMIN_PASSWORD`.
- Подробнее — см. «Завершение установки Мониторинга — первый вход и проверка».

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

- **Ошибка скачивания установочного скрипта** — проверить доступ к `https://s3.printum.io` и работу `curl`.
- **Несовпадение чек-суммы архива** — повторить установку. Если повторяется — обратиться в техподдержку.
- **Ошибка при `apt`-операциях во время установки** — применить последние обновления системных компонентов и повторить установку.

## Что проверить перед эскалацией

- Версия и редакция ОС, используемое ядро.
- IP-адрес или хостнейм, указанные в команде.
- Наличие сетевого доступа к `s3.printum.io` на 443.
- Полный вывод установочного скрипта.

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

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

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

- [Требования к серверу для установки Принтум](http://wiki.printum.io/books/3-ustanovka/page/trebovaniia-k-serveru-dlia-ustanovki-printum)
- [Подготовка Astra Linux к установке Принтум](http://wiki.printum.io/books/3-ustanovka/page/podgotovka-astra-linux-k-ustanovke-printum)
- [Установка Мониторинга — онлайн, собственные сертификаты](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-monitoringa-onlain-sobstvennye-sertifikaty)
- [Установка Мониторинга — офлайн, автоматические сертификаты](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-monitoringa-oflain-avtomaticeskie-sertifikaty)
- [Завершение установки Мониторинга — первый вход и проверка](http://wiki.printum.io/books/3-ustanovka/page/zaversenie-ustanovki-monitoringa-pervyi-vxod-i-proverka)