Различия

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

--- mp_doc:imain_install_ubuntu_web [2021/01/12 23:31] – zis
+++ mp_doc:imain_install_ubuntu_web [2024/03/31 22:03] (текущий) – внешнее изменение 127.0.0.1
@@ Строка 2: / Строка 2: @@
 . Создадим пользователя mpweb (из под root):
 <code>adduser mpweb</code>
-. Создать каталог для ведения логов и назначить права:
+. Создать каталог для ведения логов и назначить права (из под root):
-<code>mkdir /var/log/mpweb
+<code>mkdir /var/log/mpweb && chown mpweb:adm /var/log/mpweb</code>
-chown mpweb:adm /var/log/mpweb</code>
 . Установим зависимости (из под root):
 <code>apt install subversion python3 python3-pip gettext libmysqlclient-dev
@@ Строка 13: / Строка 12: @@
 export WORKON_HOME=$HOME/.virtualenvs
 source /usr/local/bin/virtualenvwrapper.sh</code>
-. ВЫЙДЕМ и ВОЙДЕМ снова! **это важно!!!**
+. **Это важно!!!** ВОЙДЕМ под пользователем **mpweb**!\\
+\\
 . Создадим виртуальное окружение:
 <code>mkvirtualenv mpweb
@@ Строка 20: / Строка 20: @@
 === Настройка интерфейса администратора ===
-. Создадим скрипт (/home/mpweb/mpweb.sh) получения и обновления исходников  (из под пользователя mpweb):
+Все действия выполняем из под пользователя mpweb, если не указано иное.\\
+. Создадим скрипт (/home/mpweb/mpweb.sh) получения и обновления исходников:
 <code>#!/bin/sh
@@ Строка 26: / Строка 27: @@
 # Global
 pth=/home/mpweb/minipbx_web
+user=XXX
 # Checkout!
 #mkdir $pth
-#svn checkout --username zis http://svn.minipbx.ru/minipbx_web/mpweb $pth
+#svn checkout --username $user http://svn.minipbx.ru/minipbx_web/mpweb $pth
 #
 # Update
-svn update --username zis $pth</code>
+svn update --username $user $pth</code>
 . Сделаем исполняемым:
-<code>/home/mpweb/mpweb.sh</code>
+<code>chmod +x /home/mpweb/mpweb.sh</code>
 . Первый раз делаем checkout, потом update.
 . Установим зависимости:
@@ Строка 45: / Строка 47: @@
 Настройка начинается с базы данных и секретных ключей:
   * sqlalchemy.url - строка подключения к БД minipbx;
-  * auth.secret - ключ для авторизации;
+  * auth.secret - секрет для авторизации;
-  * session.secret - ключ для передачи параметров сессии;
+  * session.key - ключ для передачи параметров сессии;
+  * session.secret - секрет для передачи параметров сессии;
 Для генерации случайных ключей воспользуйтесь командой:
-<code>openssl rand -hex 20</code>
+<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
@@ Строка 56: / Строка 75: @@
 # Global
 pth=/home/mpweb/minipbx_ami
+user=XXX
 # Checkout!
 #mkdir $pth
-#svn checkout --username zis http://svn.minipbx.ru/minipbx_web/mpami $pth
+#svn checkout --username $user http://svn.minipbx.ru/minipbx_web/mpami $pth
 #
 # Update
-svn update --username zis $pth</code>
+svn update --username $user $pth</code>
 . Сделаем исполняемым:
-<code>/home/mpweb/mpami.sh</code>
+<code>chmod +x /home/mpweb/mpami.sh</code>
-. Первый раз делаем checkout, потом update.
+. Первый раз делаем 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)\\