Установка и настройка¶

Установка¶

1. Перед началом установки сохраните список установленных ранее пакетов, это позволит Вам безболезненно восстановить систему в случае ее повреждения. Для этого выполните следующие команды:

   mkdir -p /tmp/tionix_rollback/node_control
   pip freeze > /tmp/tionix_rollback/node_control/
   

   После чего в каталоге /tmp/tionix_rollback/node_control будет находиться файл pip_before.txt с перечнем установленных приложений.

2. Также сохраните версии миграции:

   openstack tnx db list -n tnx_node_control > /tmp/tionix_rollback/node_control/migrations.txt
   

   Где:

   • /tmp/tionix_rollback/node_control/ - директория файла;
   • migrations.txt - наименование файла с версиями миграций.

3. Установите пакет TIONIX.NodeControl:

   • из репозитория Python-пакетов:

     # Ubuntu, CentOS:
     pip install tionix-node-control
     

   • из репозитория RPM пакетов:

     # ALT Linux 7:
     apt-get -y install python-module-tionix_node_control
     
     # CentOS:
     yum -y install python-tionix_node_control
     

4. Сохраните список установленных пакетов после установки для возможности отката изменений:

   pip freeze > /tmp/tionix_rollback/node_control/pip_after.txt
   

5. Добавьте пользователя:

   useradd -m tionix
   passwd tionix
   

Настройка¶

1. Выполните первичную настройку модуля:

   openstack tnx configure -n tnx_node_control tnx_client
   

2. Создайте каталог для логов с нужными правами:

   mkdir -p /var/log/tionix/node-control
   chown -R tionix:tionix /var/log/tionix/node-control
   

3. Скопируйте образец конфигурационного файла, при использовании нестандартных параметров отредактируйте их (подробнее см. Файл конфигурации):

   cp /etc/tionix/node_control.yaml.example /etc/tionix/node_control.yaml
   

4. Создайте базу данных на примере MySQL, настройте права, тип базы и остальные параметры:

   # Зайдите в базу данных, используя пароль пользователя root
   mysql -uroot -p
   # Создайте пользователя tionix c паролем password
   CREATE USER 'tionix'@'localhost' IDENTIFIED BY 'password';
   # Создайте базу данных tionix_node_control
   CREATE DATABASE tionix_node_control;
   # Дайте пользователю права на чтение, редактирование, выполнение любых действий над всеми таблицами базы данных tionix_node_control
   GRANT ALL PRIVILEGES ON tionix_node_control.* TO 'tionix'@'localhost';
   # Осуществите выход из базы данных
   

5. Выполните миграцию базы данных:

   openstack tnx db migrate -n tnx_node_control
   

6. Настройте брокер сообщений RabbitMQ Server:

   rabbitmqctl add_user tionix password
   rabbitmqctl add_vhost tionix
   rabbitmqctl set_permissions -p tionix tionix ".*" ".*" ".*"
   rabbitmqctl set_permissions tionix ".*" ".*" ".*"
   

7. Создайте пользователя в OpenStack для API сервисов:

   openstack user create --domain default --project service --project-domain default --password password --or-show tionix
   

8. Назначьте пользователю роль admin:

   openstack role add --user tionix --user-domain default --project service --project-domain default admin
   

9. Включите и запустите службы systemd:

   systemctl daemon-reload
   systemctl enable tionix-node-control-api.service
   systemctl start tionix-node-control-api.service
   systemctl enable tionix-node-control-node-syncer.service
   systemctl start tionix-node-control-node-syncer.service
   systemctl enable tionix-node-control-node-tracker.service
   systemctl start tionix-node-control-node-tracker.service
   systemctl enable tionix-node-control-worker.service
   systemctl start tionix-node-control-worker.service
   systemctl enable tionix-node-control-agent.service
   systemctl start tionix-node-control-agent.service
   

10. Создайте сервис NodeControl API:

    openstack service create --name tnx-nc --description "TIONIX Node Control Service" tnx-nc
    

11. Создайте точки входа (endpoint):

    openstack endpoint create --region RegionOne tnx-nc internal http://controller:9362
    openstack endpoint create --region RegionOne tnx-nc admin http://controller:9362
    openstack endpoint create --region RegionOne tnx-nc public http://controller:9362
    

Файл конфигурации¶

Конфигурационный файл представлен в yaml формате и состоит из следующих секций и параметров:

Возможности использования модуля¶

• Инициализация вычислительных узлов;
• Заполнение информации о вычислительных узлах;
• Создание образа для PXE;
• Инициализация устройств управления питанием;
• Управление питанием вычислительных узлов;
• Синхронизация вычислительных узлов;
• Мониторинг и управление вычислительными узлами;
• Управление резервированием гипервизоров.

План восстановления¶

В случае неудачной установки или обновления модуля TIONIX.NodeControl выполните возврат к исходному состоянию:

1. Сравните версии миграций в файле /tmp/tionix_rollback/node_control/migrations.txt с текущими. При наличии отличий произведите миграцию на предыдущую версию. Пример миграции:

   openstack tnx db list -n tnx_node_control
   openstack tnx db migrate -n tnx_node_control --migration 27
   

2. Произведите возврат к предыдущему состоянию пакетов:

   cd /tmp/tionix_rollback/node_control
   diff --changed-group-format='%>' --unchanged-group-format='' pip_before.txt pip_after.txt > pip_uninstall.txt
   diff --changed-group-format='%<' --unchanged-group-format='' pip_before.txt pip_after.txt > pip_install.txt
   pip uninstall -r pip_uninstall.txt
   pip install -r pip_install.txt