Предварительные требования

1. На всех узлах будущего кластера установите пакет postgrespro-ent-17-contrib. Не создавайте экземпляры баз данных.

2. Убедитесь, что вы выполняете команду bihactl от имени пользователя, который будет запускать сервер Postgres Pro Enterprise.

   Например, если вы запускаете сервер как пользователь postgres, команда bihactl должна также выполняться пользователем postgres.

3. Если вы планируете использовать pg_probackup с biha, установите пакет pg-probackup-ent-17.

Инициализация кластера

Используйте команду bihactl init, чтобы инициализировать кластер и создать узел-лидер.

1. Выполните команду bihactl init с необходимыми параметрами:

   bihactl init \
        --biha-node-id=1 \
        --host=узел_1 \
        --port=порт_узла \
        --biha-port=порт_biha \
        --nquorum=количество_узлов \
        --pgdata=каталог_PGDATA_лидера

   На этом этапе также можно включить SSL для служебных соединений в кластере. За подробной информацией обратитесь к разделу Настройка SSL.

2. (Необязательно) Задайте пароль для роли biha_replication_user и введите повторно для проверки.

   Примечание

   Этот шаг пропускается, если вы предварительно указали пароль в файле паролей.

   Запускается утилита initdb, редактируются файлы postgresql.conf и pg_hba.conf.

   При инициализации BiHA-кластера генерируется «магическая» строка. Об использовании «магической» строки читайте в Подразделе 27.2.8.

3. Запустите СУБД с помощью pg_ctl:

   pg_ctl start -D каталог_PGDATA_лидера -l файл_журнала_лидера

4. Проверьте статус узла в представлении biha.status_v:

   SELECT * FROM biha.status_v;

Добавление узла-последователя

          WARNING:  aborting backup due to backend exiting before pg_backup_stop was
          called
      

1. Убедитесь, что узел-лидер находится в состоянии LEADER_RO или LEADER_RW.

2. Убедитесь, что пароль роли biha_replication_user в файле паролей совпадает с паролем этой роли на узле-лидере.

3. Выполните команду bihactl add с необходимыми параметрами:

   bihactl add \
       --biha-node-id=2 \
       --host=узел_2 \
       --port=порт_узла \
       --biha-port=порт_biha \
       --use-leader "host=узел_лидер port=порт_лидера biha-port=порт_лидера_biha" \
       --pgdata=каталог_PGDATA_последователя

   Создаётся резервная копия узла-лидера при помощи pg_basebackup или pg_probackup в зависимости от значения, переданного в параметре --backup-method. Также редактируются файлы postgresql.conf и pg_hba.conf.

   Примечание

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

   Также можно добавить данные для подключения к узлу-лидеру с помощью «магической» строки. За дополнительной информацией об использовании «магической» строки обратитесь к Подразделу 27.2.8.

4. Запустите СУБД с помощью pg_ctl:

   pg_ctl start -D каталог_PGDATA_последователя -l файл_журнала_последователя

5. Проверьте статус узла в представлении biha.status_v:

   SELECT * FROM biha.status_v;

Преобразование ведущего узла в узел-лидер

1. Остановите существующий ведущий узел с помощью pg_ctl:

   pg_ctl stop -D каталог_PGDATA_ведущего_узла

2. Выполните команду bihactl init с параметром --convert:

   bihactl init --convert \
       --biha-node-id=1 \
       --host=узел_1 \
       --port=порт_PostgresPro \
       --biha-port=порт_biha \
       --nquorum=количество_узлов \
       --pgdata=каталог_PGDATA_лидера

   На этом этапе также можно включить SSL для служебных соединений в кластере. За подробной информацией обратитесь к разделу Настройка SSL.

   Во время преобразования кластера генерируется «магическая» строка. За дополнительной информацией об использовании «магической» строки обратитесь к Подразделу 27.2.8.

3. (Необязательно) Задайте пароль для роли biha_replication_user и введите повторно для проверки.

   Примечание

   Этот шаг пропускается, если вы предварительно указали пароль в файле паролей.

4. Запустите СУБД с помощью pg_ctl:

   pg_ctl start -D каталог_PGDATA_лидера -l файл_журнала_лидера

5. Проверьте статус узла в представлении biha.status_v:

   SELECT * FROM biha.status_v;

Преобразование ведомого узла в узел-последователь

1. Убедитесь, что пароль роли biha_replication_user в файле паролей совпадает с паролем этой роли на узле-лидере.

2. Остановите ведомый узел с помощью pg_ctl:

   pg_ctl stop -D каталог_PGDATA_ведомого_узла

3. Выполните команду bihactl add с параметром --convert-standby:

   bihactl add --convert-standby \
     --biha-node-id=2 \
     --host=узел_2 \
     --port=порт_PostgresPro \
     --biha-port=5435 \
     --use-leader "host=адрес_узла_лидера port=порт_лидера biha-port=порт_лидера_biha" \
     --pgdata=каталог_PGDATA_последователя

   При преобразовании существующего ведомого узла в узел-последователь biha создаёт файлы каталог_PGDATA_последователя/pg_biha/biha.conf и каталог_PGDATA_последователя/pg_biha/biha.state, необходимые для подключения узла к кластеру, и редактирует файлы postgresql.conf и pg_hba.conf.

   Также можно добавить данные для подключения к узлу-лидеру с помощью «магической» строки. За дополнительной информацией об использовании «магической» строки обратитесь к Подразделу 27.2.8.

4. Запустите СУБД с помощью pg_ctl:

   pg_ctl start -D каталог_PGDATA_последователя -l файл_журнала_последователя

5. Проверьте статус узла в представлении biha.status_v:

   SELECT * FROM biha.status_v;

Преобразование существующего узла в узел-лидер

1. Остановите существующий узел с помощью pg_ctl:

   pg_ctl stop -D каталог_PGDATA_сервера

2. Выполните команду bihactl init с параметром --convert:

   bihactl init --convert \
       --biha-node-id=1 \
       --host=узел_1 \
       --port=порт_PostgresPro \
       --biha-port=порт_biha \
       --nquorum=количество_узлов \
       --pgdata=каталог_PGDATA_лидера

   Редактируются файлы postgresql.conf и pg_hba.conf.

   Во время преобразования узла генерируется «магическая» строка. За дополнительной информацией об использовании «магической» строки обратитесь к Подразделу 27.2.8.

3. Запустите СУБД с помощью pg_ctl:

   pg_ctl start -D каталог_PGDATA_лидера -l файл_журнала_лидера

4. Проверьте статус узла в представлении biha.status_v:

   SELECT * FROM biha.status_v;

Добавление узла-последователя

1. Убедитесь, что узел-лидер находится в состоянии LEADER_RO или LEADER_RW.

2. Убедитесь, что пароль роли biha_replication_user в файле паролей совпадает с паролем этой роли на узле-лидере.

3. Выполните команду bihactl add с необходимыми параметрами:

    bihactl add \
        --biha-node-id=2 \
        --host=узел_2 \
        --port=порт_узла \
        --biha-port=порт_biha \
        --use-leader "host=адрес_узла_лидера port=порт_лидера biha-port=порт_biha_лидера" \
        --pgdata=каталог_PGDATA_последователя
    

   Создаётся резервная копия узла-лидера при помощи pg_basebackup или pg_probackup в зависимости от значения, переданного в параметре --backup-method. Также редактируются файлы postgresql.conf и pg_hba.conf.

   Также можно добавить данные для подключения к узлу-лидеру с помощью «магической» строки. За дополнительной информацией об использовании «магической» строки обратитесь к Подразделу 27.2.8.

4. Запустите СУБД с помощью pg_ctl:

   pg_ctl start -D каталог_PGDATA_последователя -l файл_журнала_последователя

5. Проверьте статус узла в представлении biha.status_v:

   SELECT * FROM biha.status_v;

1. Выполните команду bihactl add с соответствующим значением параметра --mode:

   bihactl add \
         --biha-node-id=3 \
         --host=узел_3 \
         --port=порт_узла \
         --biha-port=порт_biha \
         --use-leader "host=адрес_узла_лидера port=порт_лидера biha-port=порт_лидера_biha" \
         --pgdata=каталог_PGDATA_рефери \
         --mode=referee

   или

   bihactl add \
         --biha-node-id=3 \
         --host=узел_3 \
         --port=порт_узла \
         --biha-port=порт_biha \
         --use-leader "host=адрес_узла_лидера port=порт_лидера biha-port=порт_лидера_biha" \
         --pgdata=каталог_PGDATA_рефери \
         --mode=referee_with_wal

2. Проверьте параметр конфигурации shared_buffers на рефери.

   Если значение слишком высокое, установите значение по умолчанию 128 МБ.

3. С помощью pg_ctl запустите экземпляр Postgres Pro с настроенным узлом-рефери:

   pg_ctl start -D каталог_PGDATA_рефери

4. Проверьте статус узла в представлении biha.status_v:

   SELECT * FROM biha.status_v;

1. Во время инициализации BiHA-кластера с нуля в команде bihactl init укажите параметр --enable-proxima. Например:

   bihactl init \
        --biha-node-id=1 \
        --host=узел_1 \
        --port=порт_узла \
        --biha-port=порт_biha \
        --nquorum=количество_узлов \
        --pgdata=каталог_PGDATA_лидера
       --enable-proxima

   Утилита bihactl добавляет proxima в список shared_preload_libraries в файле postgresql.conf, создаёт файл postgresql.proxima.conf и включает его в файл postgresql.biha.conf.

2. Добавьте последователей.

   Так как последователи добавляются с помощью создания и восстановления резервной копии лидера, конфигурация proxima копируется на последователей так же, как и другие параметры конфигурации BiHA.

   При добавлении узла-рефери конфигурация proxima не копируется на рефери.

Подготовка сертификата и ключа

• С помощью утилиты OpenSSL сгенерируйте сертификат и закрытый ключ и сохраните их в каталоге /PGDATA/pg_biha на каждом узле кластера:

  openssl req -x509 -newkey rsa:4096 -keyout путь_к_ключу -out путь_к_сертификату -sha256 -days срок_действия -nodes -subj "/CN=домен_сертификата"

  Например:

  openssl req -x509 -newkey rsa:4096 -keyout /PGDATA/pg_biha/biha_priv_key.pem -out /PGDATA/pg_biha/biha_pub_cert.pem -sha256 -days 365 -nodes -subj "/CN=localhost"

  Будут созданы следующие файлы:

  • biha_priv_key.pem — закрытый ключ с доступом пользователя на чтение и запись (0600)

  • biha_pub_cert.pem — самоподписанный сертификат, выпущенный на указанный период времени и для указанного домена

  Важно

  Убедитесь, что для файлов сертификата и закрытого ключа вы использовали вышеуказанные имена, так как BiHA будет искать файлы именно по этим именам.

Включение SSL

1. При инициализации BiHA-кластера с помощью команды bihactl init укажите параметр --use-ssl:

   bihactl init \
        --biha-node-id=1 \
        --host=узел_1 \
        --port=порт_узла \
        --biha-port=порт_biha \
        --nquorum=количество_узлов \
        --pgdata=каталог_PGDATA_лидера
       --use-ssl

2. Чтобы убедиться, что SSL включен, после завершения настройки BiHA-кластера с помощью команды SHOW проверьте, что для параметра biha.use_ssl установлено значение true:

   SHOW biha.use_ssl;

1. При инициализации кластера перенаправьте вывод bihactl в файл:

   bihactl init \
      --biha-node-id=1 \
      --host=узел_1 \
      --port=порт_узла \
      --biha-port=порт_biha \
      --nquorum=количество_узлов \
      --pgdata=каталог_PGDATA_лидера > /tmp/magic-file

2. При добавлении узла-последователя выполните следующие действия:

   1. Установите переменную окружения:

      export MAGIC_STRING="$(cat /tmp/magic-file)"

   2. Добавьте параметр --magic-string в bihactl add:

      bihactl add \
          --biha-node-id=2 \
          --host=узел_2 \
          --port=порт_узла \
          --biha-port=порт_biha \
          --magic-string=$MAGIC_STRING \
          --pgdata=каталог_PGDATA_последователя

   Узел-последователь будет использовать закодированные данные из «магической» строки для подключения к узлу-лидеру.