Конфигурация PostgreSQL

Перейти на страницу ОБЪЕКТЫ УПРАВЛЕНИЯ Сервисы СУБД.
Нажать на имя сервиса для перехода на страницу со вкладками просмотра информации о выбранном сервисе.
На вкладке "Конфигурации" в выпадающем списке выбрать пункт "Конфигурация PostgreSQL". Откроется страница с таблицей групп параметров конфигураций.
Нажатием соответствующего элемента управления слева от названия конфигурации раскрыть группу параметров, в которую нужно внести изменения. При наведении курсора на значок справа от имени параметра появляется всплывающая подсказка с описанием выбранного параметра.
Для нужных параметров задать в полях ввода в столбце "Значение" новые значения:
- Изменённые поля ввода обводятся цветной рамкой:
  - оранжевой, если для применения параметра требуется перезагрузка конфигурации;
  - красной, если для применения параметра требуется перезапуск сервиса;
  - синей рамкой обводится редактируемое поле ввода параметра.
    
    Новое значение параметра сохраняется при переводе курсора в поле ввода / выбора другого параметра, либо при клике в пустой области окна.
- Справа от изменённого поля параметров появляется индикатор или в зависимости от параметра. При наведении курсора на данные индикаторы отображается всплывающее сообщение с указанием, какое действие необходимо для применения нового значения данного параметра.
- На панели управления конфигурациями активируется кнопка Применить, на ней появляется индикатор общего количества измененных параметров. Отображается надпись "Изменения вступят в силу после ПЕРЕЗАГРУЗКИ ПЕРЕЗАПУСКА" (в зависимости от изменённых параметров может быть как одна, так и обе плашки).
- В зависимости от типа и количества параметров справа от названий групп параметров появляются индикаторы: оранжевый индикатор показывает количество параметров, требующих перезагрузки конфигурации (reload), красный — количество параметров, требующих перезапуска сервиса (restart). При попытке сохранения некорректного значения параметра рамка поля будет красного цвета. Под рамкой появится правило, которому должны соответствовать корректные значения.
- При изменении одного и более параметров активируются кнопки (1) и (2) сброса изменённых параметров к значениям до сессии редактирования:
  
  Нажатие кнопки (1) в панели управления конфигурациями сбросит к значениям до сессии редактирования все изменённые параметры. Нажатие кнопок (2) в строках групп параметров сбросит к значениям до сессии редактирования параметры соответствующей группы.
После изменения всех необходимых параметров нажать кнопку Применить.

Дальнейший ход изменения конфигурации PostgreSQL зависит от типа кластерного ПО (Pacemaker/Corosyc или Patroni) кластера, в котором производятся изменения.

При изменении конфигурации сервисов кластеров PostgreSQL Pacemaker/Corosync откроется окно со списком изменённых параметров. Визуально проконтролировать корректность новых значений параметров. При необходимости установить флаг "Выполнить перезагрузку (reload) конфигурации". При установке флага выводится предупреждающее сообщение о возможных перебоях в работе сервиса, связанных с перезагрузкой конфигурации.

Для применения изменений конфигурации сервиса с выполнением перезагрузки конфигурации нажать кнопку "Я понимаю, продолжить", для отмены перезагрузки конфигурации нажать Отменить.

Нажать кнопку Сохранить (в случае отсутствия установки флага "Выполнить перезагрузку (reload) конфигурации") или кнопку Сохранить и перезагрузить (в случае установки флага "Выполнить перезагрузку (reload) конфигурации").

Если флаг "Выполнить перезагрузку (reload) конфигурации" не установлен, то параметры будут сохранены в файлы на узлах, но не будут применены. Если флаг установлен, то будет выполнена перезагрузка конфигурации сервиса на всех узлах кластера.

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

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

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

В правом верхнем углу страницы появится всплывающее сообщение о старте операции.

В процессе выполнения операции для кластера, в котором выполняется операция изменения параметров pgconfig, и всех объектов этого кластера вместо элементов управления вызова меню действий отображаются вращающиеся спиннеры.

По нажатию кнопки Перейти во всплывающем сообщении будет осуществлен переход на страницу "Операции". В верхней строке таблицы операций отобразится операция изменения параметров pgconfig и статус её выполнения.

Если выполнение операции прошло успешно:

Статусы всех задач операции – "ВЫПОЛНЕНА". При нажатии кнопки справа от статуса задачи открывается окно просмотра логов выбранной задачи. Если задача завершена с ошибкой, то в окне просмотра появляется вкладка "Ошибки" с информацией об ошибке.
На странице "Сервисы СУБД" справа от статуса сервиса, для которого были изменены и сохранены без применения параметры PostgreSQL, отображаются индикаторы необходимости перезагрузки конфигурации (reload) и / или необходимости перезапуска сервиса (restart) (в зависимости от изменённых параметров).

Если после изменения параметров конфигурации появились указанные индикаторы, то это означает, что соответствующие файлы конфигурации изменены, но ещё не применены к экземплярам сервиса. Для применения изменённых файлов необходимо выполнить:
- перезапуск сервиса, если отображаются индикаторы или (перезагрузка конфигурации в случае отображения двух индикаторов будет выполнена при перезапуске сервиса);
- перезагрузку конфигурации, если отображается индикатор .
  
  Если параметры конфигурации PostgreSQL были изменены, но перезагрузка конфигурации сервиса выполнена не была, при последующем открытии страницы "Конфигурация PostgreSQL" кнопка Применить меняется на Перезагрузить. При нажатии кнопки Перезагрузить выводится окно подтверждение действия с сообщением о возможных перебоях в работе сервиса, связанных с его перезагрузкой.
  
  Для перезагрузки конфигурации нажать кнопку Перезагрузить.

При изменении конфигурации PostgreSQL сервисов кластеров Patroni откроется окно со списком изменённых параметров. В нижней части окна отобразится жёлтая плашка с сообщением о возможных перебоях в работе сервиса, связанных с перезагрузкой конфигурации. Визуально проконтролировать корректность новых значений параметров. При необходимости установить флаг "Выполнить перезапуск сервиса (restart)".

При применении изменений в конфигурации PostgreSQL сервисов кластеров Patroni операция перезагрузки конфигурации будет инициирована всегда.

Нажать кнопку Продолжить. Откроется окно визарда "Применение конфигурации PostgreSQL для сервиса <…>", автоматически начнётся выполнение шага 1 "Проверка резервных копий". Количество операций (шагов) и их тип зависят от изменённых параметров и установки флага "Выполнить перезапуск сервиса (restart)".

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

Для продолжения выполнения операций нажать кнопку Продолжить.

Если все операции завершились успешно, в нижней части окна отобразится соответствующая зеленая плашка. Нажать кнопку Завершить. Окно визарда будет закрыто.

Если в процессе выполнения операций возникнет ошибка, выполнение шагов визарда будет остановлено. Номер шага будет выделен красным цветом, станут доступны кнопки Отменить и Продолжить, в нижней части окна отобразится красная плашка с информацией об ошибке. Нажать кнопку Продолжить. Шаг 2 "Применение конфигурации" будет выделен красным цветом. Инициируется шаг 3 "Восстановление из резервной копии":

Если операция восстановления конфигурации завершится успешно, в нижней части окна отобразится жёлтая плашка с сообщением "• Настройки конфигурации reload были применены некорректно. • Конфигурация reload восстановлена из резервной копии".

Если операция восстановления завершится с ошибкой, в нижней части окна отобразится красная плашка с подробной информацией об ошибке.

Для завершения работы визарда нажать кнопку Завершить.

На любом шаге визард можно свернуть, нажав кнопку в правом верхнем углу окна. Для раскрытия окна визарда нужно нажать кнопку Статус операции на панели управления страницы "Конфигурация PostgreSQL".

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

После нажатия в окне визарда кнопки Завершить кнопка Статус операции исчезает.

Известные проблемы:

Название Описание Способ решения

Пропадает индикатор необходимости перезагрузки конфигурации.

Пропадает индикатор необходимости перезагрузки конфигурации, если изменить конфигурацию PostgreSQL без перезагрузки и затем выполнить операцию "Режим обслуживания (standby)" для узла, на котором расположен ведущий экземпляр. При этом на узле синхронной реплики остаются неперезагруженные (неприменённые) параметры.

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

Не отображаются текущие действующие значения конфигурации PostgreSQL при редактировании не через "Спектр".

Если изменения в конфигурацию PostgreSQL вносятся напрямую через файлы конфигурации или с использованием SQL-оператора ALTER SYSTEM, и при этом конфигурация не перезагружается, то в веб-интерфейсе "Спектра" можно увидеть только новое значение параметра, которое еще не действует, а текущее действующее значение параметра увидеть нельзя.

Выполнять перезагрузку конфигурации сервиса при редактировании параметров через файлы или редактировать параметры через "Спектр".

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

Ряд параметров конфигурации PostgreSQL допускает различный формат единиц измерения. Например, для параметра autovacuum_naptime единица измерения “s” (секунды). При этом значение параметра может указываться как с использованием единиц измерения, так и без. Для autovacuum_naptime возможно указание одного и того же значения в виде: 60, 60s, 1m. Для таких параметров не осуществляется проверка ввода, и пользователь может ввести произвольное значение параметра, в том числе и ошибочное, например, "1abc".

Вводить корректные значения параметров.