Различия

Показаны различия между двумя версиями страницы.

--- mp_doc:imain_install_ubuntu_web [2020/12/17 17:25] – создано zis
+++ mp_doc:imain_install_ubuntu_web [2024/03/31 22:03] (текущий) – внешнее изменение 127.0.0.1
@@ Строка 1: / Строка 1: @@
 ====== Установка узла веб интерфейса (Ubuntu Server 18.04) ======
-. Создать каталог для ведения логов и назначить права:
+. Создадим пользователя mpweb (из под root):
-<code>mkdir /var/log/mpweb
+<code>adduser mpweb</code>
-chown mpweb:adm /var/log/mpweb</code>
+. Создать каталог для ведения логов и назначить права (из под root):
+<code>mkdir /var/log/mpweb && chown mpweb:adm /var/log/mpweb</code>
+. Установим зависимости (из под root):
+<code>apt install subversion python3 python3-pip gettext libmysqlclient-dev
+pip3 install virtualenv virtualenvwrapper setuptools</code>
+. Добавим в конец /home/mpweb/.bashrc
+<code>export PYTHONPATH=/usr/bin/python3
+export VIRTUALENVWRAPPER_PYTHON=$PYTHONPATH
+export WORKON_HOME=$HOME/.virtualenvs
+source /usr/local/bin/virtualenvwrapper.sh</code>
+. **Это важно!!!** ВОЙДЕМ под пользователем **mpweb**!\\
+\\
+. Создадим виртуальное окружение:
+<code>mkvirtualenv mpweb
+workon mpweb
+</code>
+=== Настройка интерфейса администратора ===
+Все действия выполняем из под пользователя mpweb, если не указано иное.\\
+. Создадим скрипт (/home/mpweb/mpweb.sh) получения и обновления исходников:
+<code>#!/bin/sh
+#
+# Global
+pth=/home/mpweb/minipbx_web
+user=XXX
+# Checkout!
+#mkdir $pth
+#svn checkout --username $user http://svn.minipbx.ru/minipbx_web/mpweb $pth
+#
+# Update
+svn update --username $user $pth</code>
+. Сделаем исполняемым:
+<code>chmod +x /home/mpweb/mpweb.sh</code>
+. Первый раз делаем checkout, потом update.
+. Установим зависимости:
+<code>python3 ./setup.py install</code>
+. Скопируем файл настроек и настроем его:
+<code>cp /home/mpweb/minipbx_web/development.ini.sample /home/mpweb/minipbx_web/development.ini
+cp /home/mpweb/minipbx_web/production.ini.sample /home/mpweb/minipbx_web/production.ini
+</code>
+Настройка начинается с базы данных и секретных ключей:
+  * sqlalchemy.url - строка подключения к БД minipbx;
+  * auth.secret - секрет для авторизации;
+  * session.key - ключ для передачи параметров сессии;
+  * session.secret - секрет для передачи параметров сессии;
+Для генерации случайных ключей воспользуйтесь командой:
+<code>openssl rand -hex 32</code>
+. Для тестирования иногда нужно запускать сервер в терминале. Для этого скопируем скрипт запуска (из под root):
+<code>mkdir /home/mpweb/.local/bin
+cp /home/mpweb/minipbx_web/scripts/run_mpweb /home/mpweb/.local/bin/</code>
+. Для запуска в качестве службы скопируем systemd скрипт и включим его автоматический запуск (из под root):
+<code>cp /home/mpweb/minipbx_web/scripts/mpweb.service  /lib/systemd/system/
+systemctl enable mpweb
+systemctl start mpweb
+systemctl status mpweb</code>
+. В каталоге minipbx_web выполнить **lcompile.sh**. Скрипт выполняет обновление перевода (ru\en)\\
+. Не совсем правильная штука, но чтобы не выполнять при каждом обновлении setup.py, сделаем:
+<code>cd /home/mpweb/.virtualenvs/mpweb/lib/python3.6/site-packages/mpweb-1.0-py3.6.egg
+mv mpweb mpweb.1
+ln -s /home/mpweb/minipbx_web/mpweb mpweb
+</code>
+Каталог mpweb.1 можно удалить.
+=== Настройка интерфейса пользователя ===
+Все действия выполняем из под пользователя mpweb, если не указано иное.\\
+. Создадим скрипт (/home/mpweb/mpami.sh) получения и обновления исходников  (из под пользователя mpweb):
+<code>#!/bin/sh
+#
+# Global
+pth=/home/mpweb/minipbx_ami
+user=XXX
+# Checkout!
+#mkdir $pth
+#svn checkout --username $user http://svn.minipbx.ru/minipbx_web/mpami $pth
+#
+# Update
+svn update --username $user $pth</code>
+. Сделаем исполняемым:
+<code>chmod +x /home/mpweb/mpami.sh</code>
+. Первый раз делаем checkout, потом update.\\
+. Установим зависимости:
+<code>bash /home/mpweb/minipbx_ami/setup.txt</code>
+. Скопируем файл настроек и настроем его:
+<code>cp /home/mpweb/minipbx_ami/mpami.ini.sample /home/mpweb/minipbx_ami/mpami.ini</code>
+Настройка начинается с базы данных и секретного ключа:
+  * [DB].url - строка подключения к БД minipbx;
+  * [MAIN].secret_key - ключ для шифрования JWT;
+Для генерации случайных ключей воспользуйтесь командой:
+<code>openssl rand -hex 32</code>
+. Для тестирования иногда нужно запускать сервер в терминале. Для этого скопируем скрипт запуска (из под root):
+<code>mkdir /home/mpweb/.local/bin
+cp /home/mpweb/minipbx_ami/bin/run_mpami /home/mpweb/.local/bin/</code>
+. Для запуска в качестве службы скопируем systemd скрипт и включим его автоматический запуск (из под root):
+<code>cp /home/mpweb/minipbx_ami/bin/mpami.service  /lib/systemd/system/
+systemctl enable mpami
+systemctl start mpami
+systemctl status mpami</code>
+. В каталоге minipbx_ami выполнить **lcompile.sh**. Скрипт выполняет обновление перевода (ru\en)\\