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

Установка 

Примечание

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

Примечание

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

Важно

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

sudo -i

Перед началом установки сохраните список установленных ранее пакетов, это позволит Вам безболезненно восстановить систему в случае ее повреждения. Для этого выполните следующие команды:
```
mkdir -p /tmp/rollback/rs-web
pip3 freeze > /tmp/rollback/rs-web/pip_before.txt
```
После чего в каталоге /tmp/rollback/rs-web будет находиться файл pip_before.txt с перечнем установленных приложений.
Установите пакет RS-Web:
```
pip3 install rs-web
```
Сохраните список установленных пакетов после установки для возможности отката изменений:
```
pip3 freeze > /tmp/rollback/rs-web/pip_after.txt
```

Настройте переменные окружения:

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

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

adduser --system --group --disabled-login aos

Создайте каталог для файлов логов с нужными правами. Например:
```
mkdir /var/log/rs-web/
chown -R aos:aos /var/log/rs-web/
```
Выполните команду openstack aos configure для настройки файлов служб systemd:
```
openstack aos configure
```
Скопируйте образец конфигурационного файла и отредактируйте его:
```
cp /etc/aos/aos.conf.example /etc/aos/aos.conf
cp /etc/aos/cloud_manager.conf.example /etc/aos/rs_web.conf
```
Перезапустите службу apache2
```
systemctl restart apache2
```
После запуска служб функционал приложения доступен на порту 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.