1. Пакет для установки на сервер

      alterator-heartbeat-0.1-alt0.M40.1.noarch.rpm

2. Описание конфигурационных файлов

2.1 Модуль настраивает параметры heartbeat в каталоге
/etc/ha.d. Шаблоны настройки не требуются, все действия выполняются
утилитами самого модуля из каталога /usr/lib/alterator-heartbeat/.

2.2 После настройки параметры кластера находятся в файлах:
/etc/ha.d/ha.cf - конфигурация кластера
/etc/ha.d/authkeys - ключ аутентификации кластера
/var/lib/heartbeat/crm/cib.xml - сохранённая база ресурсов кластера,
редактировать напрямую нельзя, только через утилиты управления
кластером.

3. Настройка кластера

3.1 Для работы кластера нужно включить сервис heartbeat, поставив галочку
у соответствующего пункта настройки. В дальнейшем, если не указано
другое, для любых действий существует соответствующий пункт в
интерфейсе модуля. Все изменения настроек должны завершаться нажатием
соответствующей кнопки - Применить, Удалить и т.п.

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

3.3 Определение узлов кластера. В этой форме можно не менять никакие
настройки, если они сгенерировались корректно. Корректные настройки
содержат один из трёх способов связи между узлами кластера. По
умолчанию используется автоматический поиск сетевых интерфейсов для
широковещательного (broadcast) вещания.

Если узлы кластера находятся в разных подсетях, на каждом узле
кластера нужно указать ip адрес удалённого узла (схема для 2-х
узлового кластера).

Если узлов кластера больше 2-х и они находятся в разных подсетях, для
них нужно указать настройки группового (multicast) вещания.

3.4 После настройки определения узлов нужно запустить службу heartbeat
(ссылка наверху страницы). После запуска службе нужно около 30 секунд
для обнаружения узлов, поэтому обновление страницы модуля может
произойти не сразу.

4. Ресурсы кластера

4.1 Для добавления ресурса нужно указать его имя, выбрать тип ресурса
из выпадающего списка и на следующей странице настройки вписать
параметры ресурса. Для ресурса IPaddr это ip адрес, для Openldap - имя
базы Openldap.

4.2 Ресурс Openldap представляет собой клон с переменным состоянием,
реализующий концепцию Мастер/Подчинённый (Master/Slave). Такой ресурс
запускает своих клонов на узлах кластера, один из клонов становится
активным, и переводит базу Openldap в режим Master. Второй клон на
своём узле переводит базу Openldap в режим Slave, в котором происходит
репликация данных из Master.

Ресурс Openldap для своих действий использует бакенд
alterator-openldap, поэтому alterator-openldap должен быть установлен
и настроен на обоих узлах кластера к моменту настройки ресурса.

При изменении имени базы существующего ресурса Openldap нужно нажимать
на иконку редактирования главного ресурса (Master/Slave) -
редактировать имя базы напрямую в клонах нельзя, попытки будут
проигнорированы в бакенде. Убрать иконку возле клонов, чтобы на неё и
не пытались нажимать, нельзя из-за ограничений alterator.

То же самое касается удаления ресурса - удалять нужно главный ресурс
Master/Slave, он удалится вместе с клонами. Попытки удаления клонов
будут проигнорированы в бакенде. Причина та же - ограничения
alterator.

5. Недоделки

5.1 Кластер реагирует на добавление ресурсов с задержкой примерно в 30
секунд, если ожидаемые изменения не появились сразу, нужно обновить
страницу.

5.2 Добавление ресурса с тем же именем, что и только что удалённый
может иногда приводить к тому, что ресурс не запустится. В этом случае
нужно перезапустить heartbeat.

5.3 Ресурс Openldap с ненастроенной базой (не включена репликация, не
может переключаться в master/slave) запускаться не будет, модуль не
проверяет правильность базы.

5.4 Нет механизма переключения ресурса в Master на заданном узле,
сейчас это можно сделать остановкой сервиса heartbeat на втором узле.
