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

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

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

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

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

4. Выберите метод аутентификации для роли biha_replication_user и выполните необходимую подготовку. За подробной информацией обратитесь к разделу Настройка аутентификации пользователей.

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

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

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

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

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

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

   Примечание

   bihactl предлагает указать пароль для роли biha_replication_user, только если вы не настроили какой-либо из поддерживаемых методов аутентификации. В этом случае лидер будет создан, но добавление последователей будет недоступно. Чтобы создать полноценный BiHA-кластер, настройте аутентификацию пользователей.

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

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

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 node 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.10.

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

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

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

   SELECT * FROM biha.status_v;

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

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

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

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

3. Выберите метод аутентификации для роли biha_replication_user и выполните необходимую подготовку. За подробной информацией обратитесь к разделу Настройка аутентификации пользователей.

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

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

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

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

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

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

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

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

   Примечание

   bihactl предлагает указать пароль для роли biha_replication_user, только если вы не настроили какой-либо из поддерживаемых методов аутентификации. В этом случае лидер будет создан, но добавление последователей будет недоступно. Чтобы создать полноценный BiHA-кластер, настройте аутентификацию пользователей.

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 node 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.10.

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

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

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

   SELECT * FROM biha.status_v;

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

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

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

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

3. Выберите метод аутентификации для роли biha_replication_user и выполните необходимую подготовку. За подробной информацией обратитесь к разделу Настройка аутентификации пользователей.

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

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

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

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

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

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

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

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

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

   Примечание

   bihactl предлагает указать пароль для роли biha_replication_user, только если вы не настроили какой-либо из поддерживаемых методов аутентификации. В этом случае лидер будет создан, но добавление последователей будет недоступно. Чтобы создать полноценный BiHA-кластер, настройте аутентификацию пользователей.

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

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

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

   SELECT * FROM biha.status_v;

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

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

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

3. Выполните команду bihactl node 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.10.

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

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

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

   SELECT * FROM biha.status_v;

1. Выполните команду bihactl node 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 cluster init укажите параметр --enable-proxima. Например:

   bihactl init \
        --biha-node-id=1 \
        --host=хост \
        --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 не копируется на рефери.

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

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

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

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

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

4. Выберите метод аутентификации для роли biha_replication_user и выполните необходимую подготовку. За подробной информацией обратитесь к разделу Настройка аутентификации пользователей.

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

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

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

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

   Чтобы преобразовать существующий кластер Postgres Pro Enterprise 18, дополнительно укажите параметр --convert.

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

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

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

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

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

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

   SELECT * FROM biha.status_v;

Добавление сегмента

В этом примере кластер GDBiHA состоит из двух сегментов. Сегмент по умолчанию с идентификатором 111 создаётся автоматически при инициализации кластера. Второй сегмент необходимо добавить вручную с помощью команды bihactl segment add.

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

  bihactl segment add \
      --biha-node-id=идентификатор_сегмента \
      --use-leader "host=адрес_узла port=порт_узла biha-port=порт_biha_узла" \

Добавление последователей

Так как в этом примере кластер GDBiHA состоит из шести узлов, необходимо добавить пять последователей.

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

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

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

   Чтобы преобразовать существующий кластер Postgres Pro Enterprise 18, дополнительно укажите параметр --convert-standby.

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

   Примечание

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

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

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

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

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

   SELECT * FROM biha.status_v;

5. Повторите шаги выше, чтобы создать всех необходимых последователей.

6. Когда все узлы готовы, проверьте статус кластера в представлении biha.super_status_v:

   SELECT * FROM biha.super_status_v;

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

• С помощью утилиты 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 cluster init укажите параметр --use-ssl:

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

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

   SHOW biha.use_ssl;

1. Инициализируйте BiHA-кластер с помощью команды bihactl cluster init:

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

   Вывод команды bihactl cluster init является «магической» строкой. Пример «магической» строки выглядит следующим образом:

   dmVyc2lvbj0xIGhvc3Q9bG9jYWxob3N0IHBvcnQ9NTQzMiBiaWhhLXBvcnQ9NTQzMw==

2. Скопируйте и сохраните вывод команды.

3. При добавлении последователя с помощью bihactl node add укажите вывод команды bihactl cluster init в качестве значения параметра --magic-string. Например:

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

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