Конфигурационные параметры

Дарья Барышева

В этой статье описаны параметры, которые могут быть настроены для сервисов ADB через ADCM. Получить дополнительную информацию по процессу настройки конфигурационных параметров можно в статьях, соответствующих online-установке и offline-установке.

ПРИМЕЧАНИЕ
Некоторые из перечисленных параметров становятся доступны в UI ADCM после установки флага Show advanced.

ADB

Main
Параметр Описание Значение по умолчанию

Name of default database

Имя создаваемой по умолчанию базы данных. Эта база поддерживается скриптами crontab (garbage collection, transaction wraparound и так далее)

adb

Use segment mirroring

Включает синхронную репликацию основных сегментов с данными (primary), добавляя зеркальные сегменты (mirror) в кластер. В результате обеспечивается большая отказоустойчивость, но размер хранимых данных увеличивается вдвое. При достаточном количестве хостов в кластере применяется политика зеркалирования spread, иначе — group

true

ADB MADlib Extension

Требуется ли установка расширения ADB MADlib Extension. MADlib — это библиотека с открытым исходным кодом для масштабируемой аналитики в распределенных базах данных. Она поддерживает параллельную реализацию математических, статистических и ML-методов (Machine Learning) для структурированных и неструктурированных данных. В своей работе MADlib использует набор основанных на SQL алгоритмов для машинного обучения, интеллектуального анализа данных и статистики, которые выполняются в масштабе ядра базы данных без необходимости передачи данных между ADB и другими системами

false

ADB PostGIS Extension

Требуется ли установка расширения PostGIS. PostGIS — это расширение для PostgreSQL, позволяющее сохранять в базе данных объекты GIS (Geographic Information Systems). Расширение включает поддержку пространственных индексов R-Tree на основе GiST и функции для анализа и обработки объектов GIS

false

ADB GPperfmon Extension

Требуется ли установка расширения ADB GPperfmon Extension. GPperfmon — это встроенная утилита для мониторинга, заполняющая специальную базу данных gpperfmon разнообразной информацией, включая список медленных запросов, статистику использования баз данных, системные свойства и иные показатели

true

ADB Auto Core Dump Service

Требуется ли установка Auto Core Dump Service — плагина, позволяющего формировать файлы core dump для процессов ADB. Можно использовать в целях отладки. При включении опции файлы сохраняются по следующему пути: /var/lib/systemd/coredump/. При достижении максимального объема хранения (1 ГБ) старые дампы удаляются. Параметр доступен начиная с версии ADB 6.21.1.36

false

Diskquota Extension

Требуется ли установка расширения Diskquota Extension. Модуль Diskquota позволяет администраторам Arenadata DB ограничивать объем дискового пространства для схем и ролей БД

false

PL/Python3u Extension

Требуется ли установка расширения PL/Python3u

false
Advanced
Параметр Описание Значение по умолчанию

Number of segments per host

Количество primary-сегментов на одном Segment-сервере. Если параметр не установлен, по умолчанию используется значение (<Количество ядер CPU>) / 2. Необходимо учитывать, что чем больше параллельных SQL-запросов вы планируете запускать одновременно, тем меньше primary-сегментов на хосте вам требуется

(<Количество ядер CPU>) / 2

Segment host data directories

Директории, используемые для хранения данных на Segment-серверах. Значение параметра Number of segments per host должно быть кратно количеству директорий. Имена директорий указываются в первом столбце. Во втором столбце можно опционально указать имена блочных устройств хранения данных — для их монтирования к соответствующим директориям на Segment-серверах. Например, sdc (без указания префикса /dev). Названия устройств должны быть одинаковы на всех Segment-серверах

/data1

Use nobarrier for segments

Необходимо ли использовать опцию nobarrier на Segment-серверах. Эта опция отключает I/O-барьеры (barriers). Не рекомендуется использовать барьеры в XFS

false

Masters host data directory

Директории, используемые для хранения данных на серверах Master и Standby Master

/data1

Mount master storage device for data

Необходимо ли монтирование блочных устройств хранения к каталогам данных на серверах Master и Standby Master. Монтирование не осуществляется, если параметр Master server storage device не заполнен

false

Master server storage device

Блочные устройства хранения на Master-сервере. Например, sdb (без указания префикса /dev). Названия устройств должны быть одинаковы на всех Master-серверах (включая Master и Secondary Master)

 — 

Use nobarrier for master

Необходимо ли использовать опцию nobarrier на Master-серверах. Эта опция отключает I/O-барьеры (barriers). Не рекомендуется использовать барьеры в XFS

false

Arenadata configs directory name

Название директории, содержащей конфигурационные файлы Arenadata. Директория размещается в домашнем каталоге системного пользователя

arenadata_configs

Sysctl parameters

Параметры ядра Linux, необходимые для ADB

 — 

System user GID

Уникальный идентификатор группы, в которую входит системный пользователь. Системный пользователь должен быть создан с одинаковыми UID и GID на всех серверах кластера, чтобы избежать проблем с доступом к общим сетевым хранилищам, содержащим файлы резервных копий ADB

2042

System user name

Имя системного пользователя

gpadmin

System user UID

Уникальный идентификатор системного пользователя. Системный пользователь должен быть создан с одинаковыми UID и GID на всех серверах кластера, чтобы избежать проблем с доступом к общим сетевым хранилищам, содержащим файлы резервных копий ADB

2042

Disable firewall

Необходимо ли отключение firewalld на хостах кластера

true

Edit /etc/hosts

Требуется ли редактирование файла /etc/hosts в ходе установки ADB в целях использования коротких имен хостов вместо FQDN для корректного функционирования ADB в дальнейшем

true

Amount of shared memory

Размер разделяемой памяти (shared memory), выделенной под метрики запросов (в КБ). Максимальный размер — 131072. Необходим перезапуск ADB для применения изменений

5120

Maximum scan node’s instrumentations

Максимальное количество сканирований ноды на один запрос (в shmem). Необходим перезапуск ADB для применения изменений

300
Use dedicated cluster network
Параметр Описание Значение по умолчанию

Cluster network

Подсеть, используемая для интерконнекта нод кластера. Использует нотацию "подсеть/маска сети", например 192.168.1.0/24. Если этот параметр не задан, то ADCM использует адреса с маршрутом по умолчанию. Хост должен иметь ровно один адрес в диапазоне. Для применения изменений необходимо выполнить Reinstall ADB

 — 
Crontab
Параметр Описание Значение по умолчанию

Crontab maintenance scripts

Список скриптов обслуживания системного пользователя ADB gpadmin. См. Инструментарий arenadata_toolkit

 — 

Delete old maintenane script logs

Количество дней, по истечении которых необходимо удалять логи скриптов обслуживания

30
Другие параметры
Параметр Описание Значение по умолчанию

Custom pg_hba section

Кастомная часть файла pg_hba.conf

 — 

ADB Control

External ADB Control server parameters
Параметр Описание Значение по умолчанию

External ADB Control server parameters

Необходимо ли использовать внешний сервер ADB Control

false

ADB Control address

Адрес внешнего сервера ADB Control. Параметр становится доступным после установки флага External ADB Control server parameters

 — 
UI component parameters
Параметр Описание Значение по умолчанию

ADB user name

Имя пользователя, используемое для подключения из ADB Control к ADB. Доступ необходим для получения информации о топологии кластера и для отмены запросов, инициированных пользователем

adcc

Servername

Имя сервера для подключения к ADB Control по HTTP

 — 

Listening port

Номер порта, на котором доступен UI ADB Control при подключени по HTTP

81

Xmx ram parameter

Xmx-параметр, указывающий максимальный пул выделения памяти для компонента UI (maximum Java heap size)

8

Log level

Уровень логирования, используемый компонентом UI. Возможные значения: TRACE, DEBUG, INFO, WARN, ERROR

INFO
HTTPS parameters
Параметр Описание Значение по умолчанию

HTTPS parameters enable

Необходимо ли включить доступ к UI ADB Control по HTTPS

false

Listening port

Номер порта, на котором доступен UI ADB Control при подключении по HTTPS

8443

Server certificate

Содержимое серверного сертификата в формате CRT (файл *.crt)

 — 

Server private key

Содержимое серверного приватного ключа (файл *.key)

 — 

Verify system endpoints' certificates

Флаг, определяющий необходимость проверки сертификатов системных конечных точек

false

Server JKS keystore path

Путь к keystore-файлу в формате JKS для серверной части ADB Control. Например, /opt/adcc/ssl/keystore.jks

 — 

Server JKS keystore password

Пароль для доступа к keystore-файлу Server JKS keystore path

 — 

Server JKS truststore path

Путь к truststore-файлу в формате JKS для серверной части ADB Control. Например, /opt/adcc/ssl/truststore.jks

 — 

Server JKS truststore password

Пароль для доступа к truststore-файлу Server JKS truststore path

 — 

Client JKS keystore path

Путь к keystore-файлу в формате JKS для клиентской части ADB Control (агентов ADB Control/ADBM). Например, /opt/ssl/keystore.jks

 — 

Client JKS keystore password

Пароль для доступа к keystore-файлу Client JKS keystore path

 — 

Client JKS truststore path

Путь к truststore-файлу в формате JKS для клиентской части ADB Control (агентов ADB Control/ADBM). Например, /opt/ssl/truststore.jks

 — 

Client JKS truststore password

Пароль для доступа к truststore-файлу Client JKS truststore path

 — 
UI LDAP authentication
Параметр Описание Значение по умолчанию

UI LDAP authentication

Необходимо ли использовать LDAP-аутентификацию

false

Type

Тип LDAP-сервера. Возможные значения:

  • MSAD — Microsoft Active Directory;

  • FreeIPA — 389 Directory server в составе FreeIPA.

MSAD

URI

URI для подключения к LDAP-серверу(-ам). Например, ldap://example.com:389. Допускается использование доменного имени, а также преобразование имени в адреса нескольких LDAP-серверов

 — 

Users baseDN

Ограничение на область поиска объектов в каталоге LDAP, применяемое в запросах на поиск пользователей

 — 

Groups baseDN

Ограничение на область поиска объектов в каталоге LDAP, применяемое в запросах на поиск групп пользователей

 — 

Users OUs

Список OU для поиска пользователей. Если опция заполнена, поиск производится только в выбранных OU относительно Users baseDN, иначе — относительно всего Users baseDN. Каждое значение OU вводится в виде отдельной строки в формате ou=<name> (например, ou=users1)

 — 

Groups OUs

Список OU для поиска групп пользователей. Если опция заполнена, поиск производится только в выбранных OU относительно Groups baseDN, иначе — относительно всего Groups baseDN. Каждое значение OU вводится в виде отдельной строки в формате ou=<name> (например, ou=groups1)

 — 

Group

Имя группы, используемое в сервисных запросах к LDAP-серверу

 — 

Login

Имя пользователя, используемое в сервисных запросах к LDAP-серверу

 — 

Password

Пароль пользователя, используемый в сервисных запросах к LDAP-серверу

 — 

Size limit

Максимальное количество записей, возвращаемое LDAP-сервером

1000

Lowercase login

Необходимо ли преобразование имен пользователей в нижний регистр

false
Backend parameters
Параметр Описание Значение по умолчанию

Xmx ram parameter

Xmx-параметр, указывающий максимальный пул выделения памяти для компонента backend (Java heap size)

8

Log level

Уровень логирования, используемый компонентом backend. Возможные значения: TRACE, DEBUG, INFO, WARN, ERROR

INFO
Registry parameters
Параметр Описание Значение по умолчанию

Xmx ram parameter

Xmx-параметр, указывающий максимальный пул выделения памяти для компонента registry (Java heap size)

2

Log level

Уровень логирования, используемый компонентом registry. Возможные значения: TRACE, DEBUG, INFO, WARN, ERROR

INFO
Database parameters
Параметр Описание Значение по умолчанию

Database name

Название БД для хранения данных ADB Control

adcc

Listening port

Номер порта для подключения к базе данных ADB Control

5433

Data dir

Полный путь к директории с данными ADB Control. По умолчанию ADB Control использует Docker-том adcc_data

 — 
ВНИМАНИЕ

Директория, указанная в параметре Data dir, должна быть пустой перед началом инициализации БД в ходе установки сервиса ADB Control.
External database parameters
Параметр Описание Значение по умолчанию

External database parameters

Необходимо ли использовать внешнюю базу данных

false

Server ip

IP-адрес сервера, на котором хранится внешняя база данных

 — 

External database port

Номер порта для подключения к серверу, на котором хранится внешняя база данных. Номер порта для подключения к базе данных ADB Control (параметр Listening port) игнорируется

5432
Database migration parameters
Параметр Описание Значение по умолчанию

Migration completion timeout

Период времени для завершения миграции (в минутах)

3
External ADQM parameters
Параметр Описание Значение по умолчанию

External ADQM parameters

Необходимо ли использовать внешний ADQM

false

ADQM address

Адрес внешнего ADQM

 — 

External ADQM port

Номер порта для подключения к внешнему ADQM

8123
Agent parameters
Параметр Описание Значение по умолчанию

Xmx ram parameter

Xmx-параметр, указывающий максимальный пул выделения памяти для агентов ADB Control (Java heap size)

2

Log level

Уровень логирования, используемый агентами ADB Control. Возможные значения: TRACE, DEBUG, INFO, WARN, ERROR

INFO

Servers list update timeout

Период времени между запросами информации о доступных серверах ADB Control Backend (в ms)

5000
ADB Control scheduler param
Параметр Описание Значение по умолчанию

Xmx ram parameter

Xmx-параметр, указывающий максимальный пул выделения памяти для планировщика ADB Control scheduler (Java heap size)

2

Log level

Уровень логирования, используемый для ADB Control scheduler. Возможные значения: TRACE, DEBUG, INFO, WARN, ERROR

INFO

Analytic DB server IP

Внешний IP-адрес для Analytic DB

 — 

Analytic DB server port

Внешний порт для Analytic DB

 — 

Analytic DB name

Имя базы данных Analytic DB

 — 

Connection username

Имя пользователя базы данных Analytic DB

 — 

Connection password

Пароль пользователя базы данных Analytic DB

 — 
Advanced parameters
Параметр Описание Значение по умолчанию

Backend app parameters

Параметры приложения для ADB Control backend

 — 

Backend logback parameters

Logback-параметры сервера ADB Control backend

 — 

Registry app parameters

Параметры приложения для ADB Control registry

 — 

Registry logback parameters

Logback-параметры для ADB Control registry

 — 

UI server app parameters

Параметры приложения для ADB Control UI

 — 

UI server logback parameters

Logback-параметры ADB Control UI

 — 

Scheduler app parameters

Параметры приложения для ADB Control scheduler

 — 

Scheduler logback parameters

Logback-параметры для ADB Control scheduler

 — 

ADB Control agent properties

Свойства агента ADB Control

 — 

ADB Control agent logback parameters

Logback-параметры агента ADB Control

 — 

ADB Control agent override parameters

Перезаписываемые параметры агента ADB Control

 — 

ADB Control agent service config parameters

Сервисные конфигурационные параметры агента ADB Control

 — 

ADBM

Backend parameters
Параметр Описание Значение по умолчанию

Xmx ram parameter

Xmx-параметр, указывающий максимальный пул выделения памяти для ADBM backend (Java heap size)

8

Log level

Уровень логирования, используемый для ADBM backend. Возможные значения: TRACE, DEBUG, INFO, WARN, ERROR

INFO
Agent parameters
Параметр Описание Значение по умолчанию

Xmx ram parameter

Xmx-параметр, указывающий максимальный пул выделения памяти для агента ADBM (Java heap size)

2

Log level

Уровень логирования, используемый для агента ADBM. Возможные значения: TRACE, DEBUG, INFO, WARN, ERROR

INFO
External database parameters
Параметр Описание Значение по умолчанию

External database parameters

Необходимо ли использовать внешнюю базу данных

false

Server ip

IP-адрес сервера, на котором хранится внешняя база данных

 — 

External database port

Номер порта для подключения к серверу, на котором хранится внешняя база данных. Номер порта для подключения к базе данных ADBM игнорируется

5432
Database parameters
Параметр Описание Значение по умолчанию

Database name

Название БД для хранения данных ADBM

adbm
Database migration parameters
Параметр Описание Значение по умолчанию

Migration completion timeout

Период времени для завершения миграции (в минутах)

3
Advanced parameters
Параметр Описание Значение по умолчанию

Backend app parameters

Параметры приложения для ADBM backend

 — 

Backend logback parameters

Logback-параметры ADBM backend

 — 

Backend auth properties

Свойства авторизации ADBM backend

 — 

ADBM agent properties

Свойства агента ADBM

 — 

ADBM agent logback parameters

Logback-параметры агента ADBM

 — 

ADBM agent override parameters

Перезаписываемые параметры агента ADBM

 — 

ADBM agent service config parameters

Сервисные конфигурационные параметры агента ADBM

 — 

Chrony

Параметр Описание Значение по умолчанию

NTP servers

Адреса действующих NTP-серверов. Например, 0.ru.pool.ntp.org, 1.ru.pool.ntp.org. Если этот параметр установлен, Master получает время от NTP-серверов, Secondary Master — от Master или NTP-серверов, Segment hosts — от Master или Secondary Master. Если параметр не установлен или все NTP-серверы становятся недоступны, Master использует локальные часы, Secondary Master получает время от Master или использует локальные часы, а Segment Hosts используют время Master или Secondary Master

 — 

Monitoring Clients

Параметр Описание Значение по умолчанию

Protocol

Протокол, используемый для отправки метрик в кластер мониторинга. Возможные значения: TCP и UDP. Выбор протокола UDP доступен в кластерах мониторинга начиная с версии 2.8

TCP

Enable echo ADB-specific metrics

Необходимо ли добавлять специфические ADB-метрики в вывод скрипта мониторинга /home/gpadmin/arenadata_configs/arenadata_segments_monitor.sh

false

Check adb monitoring

Необходимо ли проверять, что агенты мониторинга установлены на всех хостах кластера ADB

true

PXF

Параметр Описание Значение по умолчанию

Use custom JAVA_HOME

Необходим ли пользовательский каталог JAVA_HOME

false

JAVA_HOME

Путь к пользовательскому каталогу JAVA_HOME. Должен вести к работающей JAVA. Параметр становится доступным после установки флага Use custom JAVA_HOME. Если параметр не заполнен, используется системное значение по умолчанию:

  • /usr/lib/jvm/jre-11-openjdk (для всех операционных систем)

 — 

PXF_JVM_OPTS

Устанавливает опции PXF_JVM_OPTS

-Xmx2g -Xms1g

PXF log4j properties

Параметры log4j для PXF

 — 

Use custom PXF_BASE

Необходим ли пользовательский каталог PXF_BASE

false

PXF_BASE

Путь к пользовательскому каталогу PXF_BASE для установки PXF. Параметр становится доступным после установки флага Use custom PXF_BASE

/var/lib/pxf

Encryption

Используется ли шифрование

false

Keystore file

Абсолютный путь к файлу хранилища ключей (keystore) JKS. Например, /var/lib/pxf/conf/pxfkeystore.jks

 — 

Keystore password

Пароль хранилища ключей (keystore) JKS

 — 

Encryption key alias

Псевдоним (alias) ключа шифрования. В этом поле не следует указывать приватный ключ

 — 
Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней