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

Установка¶

sudo -i

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

   mkdir -p /tmp/rollback/rs_server
   pip3 freeze > /tmp/rollback/rs_server/pip_before.txt
   

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

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

   openstack aos db list -n rs_sever > /tmp/rollback/rs_server/migrations.txt
   

   Где:

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

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

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

     pip3 install rs-server
     

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

   pip3 freeze > /tmp/rollback/rs_server/pip_after.txt
   

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

   useradd -m aos
   passwd password
   

Настройка¶

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

   openstack aos configure -n rs_server
   

   При выполнении команды openstack aos configure -n rs_server:

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

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

   mkdir -p /var/log/aos/rs-server
   chown -R aos:aos /var/log/aos/rs-server
   

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

   cp /etc/aos/aos.conf.example /etc/aos/aos.conf
   cp /etc/aos/rs_server.conf.example /etc/aos/rs_server.conf
   

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

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

5. Отредактируйте секцию [database] конфигурационного файла etc/aos/rs_server.conf, например:

   [database]
   url = mysql+pymysql://aos:password@tst.stand.loc:3306/rs_server?charset=utf8
   

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

   openstack aos db migrate -n rs_server
   

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

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

8. Создайте сервис RSserver API:

   openstack service create --name rs-server --description "RSserver Service" rs-server
   

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

   openstack endpoint create --region RegionOne rs-server internal http://controller:9364
   openstack endpoint create --region RegionOne rs-server admin http://controller:9364
   openstack endpoint create --region RegionOne rs-server public http://controller:9364
   

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

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

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

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

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

    systemctl daemon-reload
    systemctl enable aos-rs-server-api.service
    systemctl start aos-rs-server-api.service
    systemctl enable aos-rs-broker-api.service
    systemctl start aos-rs-broker-api.service
    systemctl enable aos-rs-listener.service
    systemctl start aos-rs-listener.service
    systemctl enable aos-rs-beat.service
    systemctl start aos-rs-beat.service
    systemctl enable aos-rs-worker.service
    systemctl start aos-rs-worker.service
    

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

    [oslo_messaging_notifications]
    driver = messagingv2
    

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

    [oslo_messaging_notifications]
    driver = messagingv2
    

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

    [DEFAULT]
    notification_driver = messagingv2
    

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

    [DEFAULT]
    notification_driver = messagingv2
    

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

    # Debian:
    ln -s /etc/apache2/conf-available/aos-rs-web.conf /etc/apache2/conf-enabled/aos-rs-web.conf
    service apache2 restart
    

    Примечание

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

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

    # Debian:
    systemctl restart nova-api.service
    systemctl restart neutron-server.service
    

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

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

• Путь до WSGI-приложения: rs_server.api.broker_api.wsgi:application;

• WSGI-файл:

  # Ubuntu, Debian:
  ``/usr/local/bin/aos-rs-broker-wsgi``.
  

Настройка Prom SSO¶

Для включения режима prom SSO необходимо выполнить следующие шаги

1. Переключить флаг sso_enabled=True в конфиг-файле

2. Создать yaml-файл с credentials, как описано тут

3. Поместить yaml-файл в /etc/aos/

4. Сгенерировать ключи сервера командами:

   openssl genrsa -out private_key.pem 2048
   openssl rsa -in private_key.pem -pubout -out public_key.pem
   

5. Передать публичный ключ сервера на клиент, получить от клиента публичный ключ. Ключи клиента могут быть сгенерированы аналогичными командами.

6. Записать полученные ключи в конфиг-файл aos.conf:

   [broker_api]
   server_private_key='private_key'
   client_public_key='public_key'
   

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

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

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

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

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

   openstack aos db list -n rs_server
   openstack aos db migrate -n rs_server --migration 14
   

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

   cd /tmp/rollback/rs_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
   pip3 uninstall -r pip_uninstall.txt
   pip3 install -r pip_install.txt