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

Установка

Примечание

Данное руководство описывает установку RS-Web на Ubuntu 22.

Примечание

Для работы приложения необходимо иметь установленные и настроенные: OpenStack Horizon, Apache2 с плагином WSGI.

Важно

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

Режим суперпользователя:

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

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

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

  2. Установите пакет RS-Web:

    pip3 install rs-web
    
  3. Сохраните список установленных пакетов после установки для возможности отката изменений:

    pip3 freeze > /tmp/rollback/rs-web/pip_after.txt
    
  4. Настройте переменные окружения:

    export PIP_INDEX_URL=http://pypi.accentos.ru/simple/
    export PIP_TRUSTED_HOST=pypi.accentos.ru
    

Настройка

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

    adduser --system --group --disabled-login aos
    
  2. Создайте каталог для файлов логов с нужными правами. Например:

    mkdir /var/log/rs-web/
    chown -R aos:aos /var/log/rs-web/
    
  3. Выполните команду openstack aos configure для настройки файлов служб systemd:

    openstack aos configure
    
  4. Скопируйте образец конфигурационного файла и отредактируйте его:

    cp /etc/aos/aos.conf.example /etc/aos/aos.conf
    cp /etc/aos/cloud_manager.conf.example /etc/aos/rs_web.conf
    
  5. Перезапустите службу apache2

    systemctl restart apache2
    
  6. После запуска служб функционал приложения доступен на порту 8888 через любой браузер:

    http://HOST_IP:8888
    

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

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

Секция Параметр Описание Значение по умолчанию
DEFAULT default_availability_zone Зона доступности по умолчанию. nova
DEFAULT instance_name_pattern Шаблон имени для создаваемых виртуальных машин.  
DEFAULT companyname Наименование комании.  
DEFAULT website URL-адрес сайта компании.  
DEFAULT support Электронная почта службы поддержки компании-разработчика.  
DEFAULT documentation URL-адрес сайта с документацией.  
web debug Работа в режиме debug. True
web memcache_location URL-адрес для доступа к системе кэширования. localhost:11211
web compress_enabled Включение сжатия статики. true
broker endpoint_override URL-адрес брокера RSserver.