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

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_лидера

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

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

2. Запустите СУБД:

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

3. Проверьте статус узла в представлении 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.6.

4. Запустите СУБД:

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

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

   SELECT * FROM biha.status_v;

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

Если текущий кластер синхронный, то есть у него задано значение параметра synchronous_standby_names (например, synchronous_standby_names=walreceiver), выполните следующие шаги перед конвертацией в BiHA-кластер:

1. Сбросьте параметр synchronous_standby_names:

   ALTER SYSTEM RESET synchronous_standby_names;

2. Из файла postgresql.conf и всех его директив включения, вручную удалите значения synchronous_standby_names.

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

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

   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_лидера

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

3. Запустите СУБД:

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

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

   SELECT * FROM biha.status_v;

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

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

2. Остановите ведомый узел:

   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.6.

4. Запустите СУБД:

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

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

   SELECT * FROM biha.status_v;

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

1. Остановите узел:

   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.6.

3. Запустите СУБД:

   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.6.

4. Запустите СУБД:

   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. Запустите экземпляр Postgres Pro с настроенным узлом-рефери:

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

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

   SELECT * FROM biha.status_v;

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_последователя

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