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

Установка¶

sudo -i

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

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

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

2. Установите пакет RemoteApp:

   pip3 install remoteapp
   

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

   pip3 freeze > /tmp/rollback/remoteapp/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 /etc/remoteapp
   chown -R aos:aos /etc/remoteapp
   

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

   mkdir /var/log/remoteapp/
   chown -R aos:aos /var/log/remoteapp/
   

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

   mkdir /var/lib/remoteapp/
   chown -R aos:aos /var/lib/remoteapp/
   

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

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

6. Выполните команду remoteapp-configure для настройки файлов служб systemd:

   remoteapp-configure
   

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

   FLASK_APP=remoteapp.cloudapi.app flask db upgrade
   

8. В конфигурационном файле укажите адрес облака, с которым будет работать приложение. При необходимости измените другие параметры.

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

   systemctl daemon-reload
   systemctl enable ra-api.service
   systemctl start ra-api.service
   systemctl enable ra-listener.service
   systemctl start ra-listener.service
   

10. Добавьте в переменные окружения данные для авторизации на удаленном облаке. Например:

    export ipaddr=CLOUD_IP
    export domain=CLOUD_DOMAIN
    export user=CLOUD_USER
    export password=CLOUD_USER_PASSWORD
    

11. Создайте шаблоны для формирования файлов. Для этого выполните следующие команды:

    ra-client create type type=mstsc template=default ext=rdp os_type=appv
    ra-client create pub type=win configure=default ext=reg
    

    os_type – тип операционной системы, которая будет использоваться для подключения. Возможные варианты:

    • linux - для Linux приложений,
    • rdp - для получения рабочего стола Windows,
    • appv - для получения Windows приложения.

12. Создайте симлинки на конфигурацию remoteapp для Apache:

    ln -s /etc/apache2/conf-available/remoteapp-web.conf /etc/apache2/conf-enabled/remoteapp-web.conf
    systemctl restart apache2
    

13. После запуска служб функционал приложения доступен на порту 8080 через любой браузер:

    http://HOST_IP:8080
    

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

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