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

Установка¶

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

   mkdir -p /tmp/tionix_rollback/vdi_server
   pip freeze > /tmp/tionix_rollback/vdi_server/pip_before.txt
   

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

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

   openstack tnx db list -n tnx_vdi_sever > /tmp/tionix_rollback/vdi_server/migrations.txt
   

   Где:

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

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

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

     # Ubuntu, CentOS:
     pip install tionix-vdi-server
     

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

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

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

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

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

   useradd -m tionix
   passwd tionix
   

Настройка¶

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

   openstack tnx configure -n tnx_vdi_server tnx_client
   

   При выполнении команды openstack tnx configure -n tnx_vdi_server tnx_client:

   • производится копирование примеров файлов конфигураций в каталог /etc/tionix/;
   • формируются конфигурационные файлы для веб-сервера Apache;
   • выполняется сборка статики для TIONIX.VDIserver.

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

   python /usr/share/openstack-dashboard/manage.py collectstatic --settings=tionix_vdi_server.django_settings
   python /usr/share/openstack-dashboard/manage.py compress --settings=tionix_vdi_server.django_settings
   

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

   mkdir -p /var/log/tionix/vdi-server
   chown -R tionix:tionix /var/log/tionix/vdi-server
   

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

   cp /etc/tionix/vdi_server.yaml.example /etc/tionix/vdi_server.yaml
   

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

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

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

   openstack tnx db migrate -n tnx_vdi_server
   

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

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

7. Создайте сервис VDIserver API:

   openstack service create --name tnx-vdi --description "TIONIX VDIserver Service" tnx-vdi
   

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

   openstack endpoint create --region RegionOne tnx-vdi internal http://controller:9364
   openstack endpoint create --region RegionOne tnx-vdi admin http://controller:9364
   openstack endpoint create --region RegionOne tnx-vdi public http://controller:9364
   

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

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

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

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

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

    systemctl daemon-reload
    systemctl enable tionix-vdi-server-api.service
    systemctl start tionix-vdi-server-api.service
    systemctl enable tionix-vdi-broker-api.service
    systemctl start tionix-vdi-broker-api.service
    systemctl enable tionix-vdi-keystone-listener.service
    systemctl start tionix-vdi-keystone-listener.service
    systemctl enable tionix-vdi-nova-listener.service
    systemctl start tionix-vdi-nova-listener.service
    systemctl enable tionix-vdi-neutron-listener.service
    systemctl start tionix-vdi-neutron-listener.service
    systemctl enable tionix-vdi-project-syncer.service
    systemctl start tionix-vdi-project-syncer.service
    systemctl enable tionix-vdi-worker.service
    systemctl start tionix-vdi-worker.service
    

12. Настройте службы Nova, на всех контроллерах и вычислительных узлах, для синхронизации виртуальных машин (в файле конфигурации /etc/nova/nova.conf):

    [oslo_messaging_notifications]
    driver = messagingv2
    

13. Настройте службы Keystone, на всех контроллерах, для синхронизации проектов (в файле конфигурации /etc/keystone/keystone.conf):

    [oslo_messaging_notifications]
    driver = messagingv2
    

14. Настройте службы Neutron, на всех контроллерах, для синхронизации плавающих IP-адресов (в файле конфигурации /etc/neutron/neutron.conf):

    [DEFAULT]
    notification_driver = messagingv2
    

15. Создайте симлинк на поставляемый конфигурационный файл Apache и перезапустите веб сервера:

    # Ubuntu:
    ln -s /etc/apache2/conf-available/tionix-vdi-server.conf /etc/apache2/conf-enabled/tionix-vdi-web.conf
    service apache2 restart
    
    # ALT Linux 7:
    ln -s /etc/httpd2/conf/sites-available/tionix-vdi-server.conf /etc/httpd2/conf/sites-enabled/tionix-vdi-web.conf
    systemctl restart httpd2
    

    Примечание

    Необходимо убедиться в корректности конфигурационного файла: проверить пути к установленным модулям, пути к логам, соответствие директив установленной версии Apache.

16. Перезапустите службы Nova и Neutron, данное действие необходимо для включения уведомлений:

    # Ubuntu:
    service nova-api restart
    service neutron-server restart
    
    # ALT Linux 7:
    systemctl restart openstack-nova-api
    systemctl restart neutron-server
    
    # CentOS:
    systemctl restart openstack-nova-api
    systemctl restart neutron-server
    

Настройка сервиса VDI broker API¶

По умолчанию для запуска сервиса используется WSGI-сервер gunicorn. Для настройки альтернативного сервера используйте следующие параметры:

• Путь до WSGI-приложения: tionix_vdi_server.api.vdi_broker_api.wsgi:application;
• WSGI-файл: /usr/bin/tnx-vdi-broker-wsgi.

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

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

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

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

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

   openstack tnx db list -n tnx_vdi_server
   openstack tnx db migrate -n tnx_vdi_server --migration 14
   

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

   cd /tmp/tionix_rollback/vdi_server
   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