Локальная конфигурация сервера (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
}
Ключи
| Ключ | Тип | Описание | Пример |
|---|---|---|---|
|
string |
Каталог Erlang/OTP платформы ( |
|
|
string |
Ключ кластера, из него строится cookie нод. Одинаков на всех серверах кластера. Хранится замаскированным; открытое значение принимается и при старте заменяется замаскированным. |
|
|
string |
Имя сервера в конфигурации, короткое имя центральной ноды. |
|
|
string |
Адрес сервера — хост имени центральной ноды |
|
|
string |
Каталог каналов |
|
|
string |
Рабочий каталог нод. |
|
|
int |
Начало диапазона портов распределения центральной ноды. |
|
|
int |
Конец диапазона портов распределения центральной ноды. |
|