Дополнительные параметры установки

Бывает, что нельзя просто так взять и установить Apiary из бандла на целевую машину. Может потребоваться:

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

В этом параграфе описано как это можно сделать.

Что собой представляет бандл

Бандл представляет собой shell скрипт и архив в формате .tar.gz в одном файле. Он создан при помощи makeself и его задача просто распаковать во временную директорию содержимое архива и запустить скрипт инсталляции (embedded script в терминологии makeself).

Вы можете просмотреть текст скрипта makeself в любом текстовом редакторе, что бы убедиться, что в нём нет ничего подозрительного.

Ещё в нём есть опции. Вы можете посмотреть все опции, например, так:

sudo bash ./install_hw_fh_en-US_2025.8.3.run --help

Наиболее интересные, с практической точки зрения опции:

--noexec: не запускать скрипт инсталляции после распаковки.
--target: распаковать содержимое в указанную директорию вместо временной.
--: все последующие аргументы передать в скрипт инсталляции.

Извлечение файлов инсталляции

Иногда требуется извлечь файлы из бандла. Это может потребоваться для того, что бы изучить его содержимое или для того что бы провести диагностику ошибки в случае, если инсталляция ломается по непонятной причине.

Пользуясь опциями из предыдущего параграфа, вы можете просто распаковать весь архив с Apiary таким образом:

sudo bash ./install_hw_fh_en-US_2025.8.3.run --noexec --target 2025.8.3

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

Инсталляция из распакованного бандла

Если вы распаковали бандл, как описано в предыдущем параграфе, то вы можете перейти в директорию, в которую распаковали бандл, и запустить инсталлятор из неё:

sudo ./installer

Или так: если требуется диагностировать работу инсталлятора:

sudo bash -x ./installer

Содержимое архива бандла

Рассмотрим содержимое бандла.

имя файла или директории	назначение	примечания
`ascii-logo.txt`	Логотип, которое отображается в консоли при установке
`bin/`	Директория с bash скриптами для распаковки в `/opt/hw-fh/bin`	Копируются в `/opt/hw-fh/bin`
`config/defaults.ini`	Глобальная конфигурация версии приложения	Копируется в `/opt/hw-fh/config/`
`config/user-template.ini`	Пример всех настроек приложения, доступных пользователю	Копируется в `/opt/hw-fh/config/`
`images_list.txt`	Список образов контейнеров, входящих в состав Apiary
`installer`	Скрипт инсталляции
`installer.sh`	Дополнительные, используемые скриптом инсталляции
`kb/`	Шаблоны отчётов	Копируется в `/opt/hw-fh/kb`
`dpssl/`, `fssl/`, `qssl/`	Дефолтные директории для SSL сертификатов и приватных ключей для `HTTPS`
`systemd/`	Директория с шаблонами systemd модулей	Копируется в `/opt/hw-fh/systemd`
`*.tgz`	Образы контейнеров	Только для offline бандла

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

Опции скрипта инсталляции

Но опции есть не только у makeself, но и у скрипта инсталляции. Что бы увидеть их вы можете сделать:

sudo bash ./install_hw_fh_en-US_2025.8.3.run -- --help

Наиболее интересные опции:

--nostart: не стартовать автоматически Apiary после установки.
--noconfig: не делать автоматическую переконфигурацию Apiary в процессе инсталляции ('nostart' подразумевается).

Экспериментальные функции (не рекомендуем для производственного окружения):

--foreign-docker-host: указать docker host для rootless докера.
--foreign-docker-user: указать пользователя, под которым работает rootless docker.

Пример: вы хотите произвести установку, но не запускать и не конфигурировать Apiary для того что бы задать свой собственный начальный пароль (или произвести другие тонкие настройки):

sudo bash ./install_hw_fh_en-US_2025.8.3.run -- --nostart --noconfig

После этого вы можете открыть файл /opt/hw-fh/config/users.ini на редактирование, и в секции [main] добавьте, например, такую строку:

[main]
b.root.password = <new_password>

Чтобы изменения вступили в силу, выполните следующую команду:

sudo /opt/hw-fh/bin/reconfig

Apiary автоматически запустится, и у пользователя root будет установлен указанный дефолтный пароль.

Подробнее про настройки, которые можно выполнить в файле /opt/hw-fh/config/users.ini смотрите здесь.