Локальная конфигурация сервера (local.cfg.json)

Назначение

Параметры запуска центральной ноды сервера, нужные до получения конфигурации платформы: имя и адрес ноды, порты, каталоги, ключ кластера (psk).

Файл есть на каждом сервере и меняется только на диске. Мастер конфигураций, API и сценарии его не читают и не меняют.

Расположение и доступ

  • Путь: /var/lib/era/_workdir/erainstaller/local.cfg.json.

  • Права 0600, владелец — пользователь, от которого работает платформа (root или, в контейнере, era). Центральная нода при старте приводит права к этому виду.

Принцип использования

  • Создаётся инсталлятором при установке сервера (era install): значения берутся из параметров установки (srvname, srvip, psk, distports).

  • Читается при каждом старте сервера: скриптом era start (/usr/bin/era, в контейнере — его вызывает docker_entrypoint.sh) и центральной нодой.

  • Изменения действуют со следующего старта сервера (era start, перезапуск контейнера).

Когда менять

  • Нужно изменить параметр запуска центральной ноды без переустановки: диапазон портов, каталоги, путь к Erlang.

  • Нужно задать ключ кластера psk (например, сервер переносится в другой кластер): значение можно записать открытым, при старте оно будет замаскировано.

srvname и srvhost образуют имя центральной ноды и должны совпадать с сервером в конфигурации платформы (name сервера и адрес интерфейса logiface). psk одинаков на всех серверах кластера.

Структура

JSON-объект:

{
  "erl_rootdir": "/usr/lib/era/erlang",
  "psk": "ha_v=4;g4veLkEJSYXG1OWHY33Kxg",
  "srvname": "srv01",
  "srvhost": "192.168.0.10",
  "pipe_dir": "/var/run/era",
  "work_dir": "/var/lib/era/_workdir",
  "min_dist_port": 9300,
  "max_dist_port": 9309
}

Ключи

Ключ Тип Описание Пример

erl_rootdir

string

Каталог Erlang/OTP платформы (bin/erl, bin/run_erl).

"/usr/lib/era/erlang"

psk

string

Ключ кластера, из него строится cookie нод. Одинаков на всех серверах кластера. Хранится замаскированным; открытое значение принимается и при старте заменяется замаскированным.

"ha_v=4;g4veLkEJSYXG1OWHY33Kxg"

srvname

string

Имя сервера в конфигурации, короткое имя центральной ноды.

"srv01"

srvhost

string

Адрес сервера — хост имени центральной ноды <srvname>@<srvhost>.

"192.168.0.10"

pipe_dir

string

Каталог каналов run_erl нод (подключение to_erl).

"/var/run/era"

work_dir

string

Рабочий каталог нод.

"/var/lib/era/_workdir"

min_dist_port

int

Начало диапазона портов распределения центральной ноды.

9300

max_dist_port

int

Конец диапазона портов распределения центральной ноды.

9309