Параметры install.sh и установка в терминале

Установщик install.sh запускается на сервере через sudo. Без параметров он готовит сервер и печатает ссылку на мастер первого запуска — этот путь описан на странице Установка. Параметры нужны, чтобы настроить трекер в терминале, выбрать другой каталог или задать IP мастера вручную.

Общие правила

• Параметры пишутся после имени файла: sudo bash install.sh --path /opt/micator.
• Параметр со значением требует значение. Иначе установщик отвечает «Нет значения для …».
• На неизвестный параметр установщик отвечает «Неизвестный параметр: …» и ничего не делает.
• Любой из параметров --headless, --panel, --track, --email, --admin-email, --restore-env включает установку в терминале. Мастер при этом не запускается.
• При повторном запуске указывайте те же параметры, что в первый раз.

Таблица параметров

Домены указываются без https://, порта и пути, международные имена — в punycode. По сети выпуск загружается только по HTTPS: на другой протокол установщик отвечает «Загрузка разрешена только по HTTPS.»

Установка в терминале

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

1. Скачайте установщик первой командой.
2. Запустите его с параметром --headless второй командой.
3. Ответьте на четыре вопроса: Домен панели, Домен трафика, Email для HTTPS-сертификатов, Логин владельца.
4. Дождитесь строки «Готово. Панель: https://panel.example.com».

curl -fsSLo install.sh https://install.micator.com/install.sh
sudo bash install.sh --headless

Чтобы установщик ничего не спрашивал, передайте все четыре значения параметрами. Параметр --headless тогда не нужен:

sudo bash install.sh --panel panel.example.com --track track.example.com --email [email protected] --admin-email admin

Если указана только часть значений, остальные установщик спросит в терминале.

По ходу работы установщик печатает: «Загружаю подписанный выпуск…», «Подготавливаю Docker…», «Загружаю готовые образы…», «Запускаю базы, панель и трекер…». В конце — три строки:

Готово. Панель: https://panel.example.com
Доступ владельца сохранён только для root: /opt/tracker/owner-access.txt
Проверка установки: sudo trackerctl check

Если установка остановилась с ошибкой, устраните причину и повторите ту же команду с теми же значениями. Принятые домены, email и логин установщик сохраняет и заново не спрашивает. Если ошибка случилась раньше — например, домен ещё не разрешается в DNS, — вопросы будут заданы снова.

Отличия от мастера

После установки войдите в панель:

1. Прочитайте доступ владельца на сервере командой ниже. В файле три строки: «Панель», «Логин» и «Пароль».
2. Откройте https://panel.example.com/login.
3. Введите Логин и Пароль из файла.
4. Нажмите Войти.

sudo cat /opt/tracker/owner-access.txt

Если открылся экран «Доступ к трекеру закрыт», введите ключ в поле Ключ лицензии и нажмите Активировать — см. Получение ключа и активация.

Другой каталог установки

По умолчанию трекер ставится в /opt/tracker. Параметр --path задаёт другой каталог:

sudo bash install.sh --path /opt/micator

• Каталог должен иметь вид /opt/имя. В имени допустимы латинские буквы, цифры, _ и -.
• Каталог должен быть пустым или отсутствовать. Установщик создаст его сам. Символическая ссылка не принимается.
• Параметр работает и с мастером, и с установкой в терминале.
• Файлы setup-access.txt, owner-access.txt и остальные файлы установки лежат в этом каталоге. Базы и загруженные страницы хранятся в томах Docker, а не в нём.
• При повторном запуске установщика и при --update-controller указывайте тот же --path.
• Вторую установку на тот же сервер параметр не добавляет: установщик найдёт прежнюю и остановится.

Команде trackerctl каталог указывать не нужно: она запоминает его при установке.

IP мастера вручную

Мастер открывается по публичному IPv4 сервера. Установщик ищет этот адрес на сетевых интерфейсах сервера. Если публичного адреса на них нет, установщик останавливается: «Не удалось определить публичный IPv4. Передайте --setup-ip IP сервера.»

sudo bash install.sh --setup-ip 203.0.113.10

• Принимается только публичный IPv4. На частный адрес и на IPv6 установщик отвечает тем же сообщением.
• Мастер отвечает только по этому адресу и по домену панели.
• Адрес закрепляется при подготовке мастера. После появления ссылки на мастер повторный запуск с другим --setup-ip его не меняет.
• При установке в терминале параметр не используется.

Команда trackerctl

Установщик ставит на сервер команду trackerctl. При установке с мастером она появляется после подготовки сервера, при установке в терминале — после того, как трекер запущен и прошёл проверку готовности.

Запускайте check после запуска трекера. Проверка выполняется на самом сервере и не показывает, открыты ли порты 80 и 443 снаружи. Если предыдущий запуск установщика в терминале закончился ошибкой, обе команды после строки с версией печатают «Последняя попытка прервалась на этом этапе.» Разбор ответов — в разделе Где смотреть состояние установки.

Значения этапа

При установке в терминале команда появляется уже после проверки готовности, поэтому показывает ready.

Если не получилось

Сообщение «Не готовы: …» в конце установки разобрано в разделе Сервисы не готовы, остальные — на странице Ошибки установки и их устранение. Где лежат файлы и какие службы созданы — на странице Файлы установки, порты, службы и журналы.