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

## Цель

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

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

- Сервер соответствует требованиям из страницы «Требования к серверу для установки Принтум».
- Подключение к серверу по SSH под пользователем root.
- Доступен компьютер с выходом в интернет для скачивания дистрибутива.
- Установлен `scp` или другой инструмент для передачи файлов.

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

- Дистрибутив ПринтМенеджера: `printmanager-x.y.z.tar.gz` и `printmanager-x.y.z.tar.gz.sha512`.
- IP-адрес сервера или доменное имя (хостнейм).
- При желании — пароль для суперпользователя.

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

### Шаг 1. Скачать дистрибутив

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

### Шаг 2. Создать папку на сервере и передать файлы

Зайдите на сервер по SSH и создайте папку:

```
mkdir /root/dist_pm
```

Перепишите файлы со своего компьютера на сервер:

```
scp printmanager-x.y.z.tar.gz root@<ip>:/root/dist_pm
scp printmanager-x.y.z.tar.gz.sha512 root@<ip>:/root/dist_pm
```

где `<ip>` — IP-адрес вашего сервера, `x.y.z` — версия ПринтМенеджера.

### Шаг 3. Проверить целостность архива

Зайдите на сервер по SSH от имени root и выполните:

```
cd /root/dist_pm
sha512sum -c printmanager-x.y.z.tar.gz.sha512
```

Команда sha512sum проверит целостность скачанного архива. Убедитесь, что команда вывела на экран `printmanager-x.y.z.tar.gz: OK`, иначе остановите подготовку к установке и обратитесь в службу технической поддержки.

### Шаг 4. Распаковать архив и подготовить скрипт

```
tar xvf printmanager-x.y.z.tar.gz
cd printmanager-x.y.z
chmod u+x ./install.sh
```

где `x.y.z` — ваша версия ПринтМенеджера.

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

```
export PM_ADMIN_PASSWORD=x
```

где `x` — новый пароль.

### Шаг 6. (Опционально) Задать нестандартные порты

```
export PM_HTTP_PORT=x
```

где `x` — порт для протокола http.

```
export PM_HTTPS_PORT=x
```

где `x` — порт для протокола https.

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

Установка с адресацией по IP-адресу и с использованием автоматических сертификатов:

```
sudo PM_HOSTNAME=<ip> ./install.sh
```

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

Установка с адресацией по доменному имени и с использованием автоматических сертификатов:

```
sudo PM_HOSTNAME=<hostname> ./install.sh
```

где `<hostname>` — доменное имя сервера.

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

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

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

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

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

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

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

- **sha512sum выдал ошибку** — архив повреждён при передаче; скачать заново и повторить проверку; при повторной ошибке обратиться в службу технической поддержки.
- **Permission denied при запуске install.sh** — выполнить `chmod u+x ./install.sh` перед запуском установки.
- **Авторизация на панели администратора не проходит** — если при установке задавался `PM_ADMIN_PASSWORD`, использовать его вместо пароля по умолчанию `printum`.
- **Адрес из пула 10.28.32.0/26** — эти адреса используются внутренней сетью; выбрать другой 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/ustanovka-printmenedzera-onlain-avtomaticeskie-sertifikaty)
- [Установка ПринтМенеджера — офлайн, собственные сертификаты](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-printmenedzera-oflain-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)