Раздел general

Описание

Общие параметры конфигурации, не относящиеся к другим разделам.

Параметры раздела

Table 1. Параметры раздела
Спецификация Описание

Ключ: generaldomain
Обязательный: да
По умолчанию: — 

Алиас главного домена из раздела "tds"

Ключ: version
Обязательный: да
По умолчанию: — 

Версия конфигурации. Представляет собой строгое значение, известное системе. На текущий момент "3.0"

Ключ: master_admin_login
Обязательный: нет
По умолчанию: — 

Логин мастер-администратора.
Учетные данные пропускают запросы в систему под ролью администратора.
При этом самой учетной записи в домене не существует.

Ключ: master_admin_pwd
Обязательный: нет
По умолчанию: — 

Пароль мастер-администратора.
Может быть указан в виде зашифрованного значения.
Зашифровать и расшифровать пароль можно через API.
Ключ шифра зависит от экземпляра текущей системы.

Ключ: logging_min_disk_space
Обязательный: нет
По умолчанию: 3

Минимальный объем свободного места на диске, при достижении которого, логирование будет отключено, в ГБ.

Ключ: logging_role_store_days
Обязательный: нет
По умолчанию: 2

Количество дней, в течении которого лог-файлы хранятся в рабочей директории ролевой ноды.

Ключ: logging_role_max_size
Обязательный: нет
По умолчанию: 100

Максимальный объем лог-файлов, который может быть занят одной ролевой нодой (каталог log в рабочей директории ролевой ноды), в ГБ.

Ключ: check_quorum
Обязательный: нет
По умолчанию: false

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

Кворум - группа активных связанных между собой и доступных друг другу серверов сайта общим количеством более половины.
Применение кворума обеспечивает целостность данных в момент рассыпания сайта на несколько частей, за счет того, что функционирование поддерживается только на части, обладающей кворумом, а таких в любой момент времени не более одной.
Алгоритм определения кворума выполняется в нодах, где запускается или работает мастер-экземпляр любой из ролей, резервирующихся в режиме Active-Passive - в момент активации и каждые 10 секунд во время работы.

Ключ: odd_referee
Обязательный: нет
По умолчанию: — 

Адрес или доменное имя стороннего сервера, выступающего в качестве нечетного арбитра при определении кворума среди четного количества серверов.
Проверка арбитражного сервера осуществляется с помощью отправки ping-запроса.
Применяется в качестве значения по умолчанию, если иное не указано в свойствах сайта.
Если параметр не задан глобально и не определен в настройках конкретного сайта, то при определении кворума на этом сайте считается, что арбитражный сервер доступен и кворум имеется.
Арбитражный сервер используется только если количество сконфигурированных серверов на сайте четно, и доступна ровно половина из них.

Ключ: pwd_hash_alg
Обязательный: нет
По умолчанию: — 

Хеш-функция хранения паролей пользователей. По умолчанию параметр отсутствтует, и хеш функция не используется, пароли пользователей хранятся в БД в открытом виде. Аналогично значению "none".
В случае указания sha, sha256, sha384, sha512, md5 - при изменении пароля пользователя он размещается в БД в хешированном виде, а при проверке производится хеширование проверяемого значения.
Любое другое значение - отключает хеширование.
При изменении параметра данные в БД не изменяются и требуют задания новых паролей для всех пользователей.
В случае использования сценариев внешней авторизации (проверки пароля во внешней системе), пароли учетных записей пользователей, сохраненные в БД не используются в нормальном режиме, и могут быть использованы только при ошибках в назначении или работе сценария.

Пример значения поля

{
  ...
  "general": {
    "generaldomain": "td_main",
    "master_admin_login": "superduke",
    "master_admin_pwd": "megaPassword42",
    "version": "3.0"
  },
  ...
}