Управление узлом через IPMI

Sharx Base позволяет настроить взаимодействие кластера с контроллерами BMC узлов по протоколу IPMI и управлять питанием узлов.

BMC — контроллер удаленного управления узлом, работает независимо от узлов кластера.

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

Внимание

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

Для настройки потребуются:

идентификатор узла кластера;
IP-адрес BMC;
порт BMC, если используется нестандартный порт;
учетные данные пользователя IPMI.

Идентификатор узла можно получить командой

cluster freenodes list

Настроить IPMI для узла кластера

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

commands ipmi node add --node_uuid <NODE_UUID> 
                       --ipmi_addr <IPMI_ADDR> 
                       [--ipmi_port <IPMI_PORT>] 
                       --user <USER> 
                       --password <PASSWORD> 
                       [--node_name <NODE_NAME>]

где

node_uuid — идентификатор узла кластера;
ipmi_addr — IP-адрес BMC;
ipmi_port — порт BMC. Если порт не указан, по умолчанию присваивается порт 623;
user — имя пользователя IPMI;
password — пароль пользователя IPMI;
node_name — имя узла кластера.

После выполнения команды плагин связывает идентификатор узла с BMC и использует эту связь для отправки запросов к контроллеру.

Просмотреть привязки IPMI

Чтобы просмотреть IPMI-данные всех узлов кластера, выполните команду

commands ipmi node list

Чтобы просмотреть привязку BMC для определенного узла, выполните команду

commands ipmi node show --node_uuid <NODE_UUID>

Изменить привязку IPMI

Чтобы изменить IP-адрес BMC, порт, учетные данные или имя узла, выполните команду

commands ipmi node update  --node_uuid <NODE_UUID> 
                           [--ipmi_addr <IPMI_ADDR>] 
                           [--ipmi_port <IPMI_PORT>] 
                           [--user <USER>]
                           [--password <PASSWORD> ]
                           [--node_name <NODE_NAME>]

Укажите параметры, значения которых необходимо изменить. Описание параметров приведено выше.

Удалить привязку IPMI

Чтобы удалить связь между узлом кластера и BMC, выполните команду

commands ipmi node del --node_uuid <NODE_UUID>

После удаления привязки нельзя управлять питанием узла через IPMI и использовать этот узел в правилах фенсинга, пока привязка не будет создана повторно.

Управление питанием узла

Команды управления питанием возвращают код завершения:

0 — команда принята контроллером BMC;
1 — команду не удалось выполнить.

Важно

Код 0 подтверждает принятие команды контроллером BMC, но не всегда означает, что узел уже перешел в требуемое состояние.

Перезагрузить узел

Чтобы перезагрузить узел, выполните команду

commands ipmi power reset --node_uuid <NODE_UUID> 
                         [--mode <warm|cold>]

Параметр mode определяет режим перезагрузки:

warm — горячая перезагрузка. Используется по умолчанию;
cold — холодная перезагрузка.

При холодной перезагрузке команда возвращает код 0, если BMC принял сообщение об отключении питания узла. После этого запускается ожидание перехода узла в состояние off длительностью до 300 секунд. Когда узел переходит в состояние off, плагин отправляет BMC команду на включение питания.

Warning

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

Включить узел

Чтобы включить узел, выполните команду

commands ipmi power on --node_uuid <NODE_UUID>

Команда возвращает результат принятия запроса контроллером BMC и не ожидает перехода узла в состояние on.

Выключить узел

Чтобы выключить узел, выполните команду

commands ipmi power off --node_uuid <NODE_UUID>

Команда возвращает результат принятия запроса контроллером BMC и не ожидает перехода узла в состояние off.

Дополнительная информация

Примеры процедур. Готовые сценарии для типовых задач.

Термины и определения содержатся в статьях: