Различия

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

--- mp_doc:imain_install_ubuntu_web [2021/01/12 19:42] – 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):
+. Создать каталог для ведения логов и назначить права (из под root):
-<code>apt install subversion python3 python3-pip
+<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>
-. Создадим скрипты получения и обновления исходников  (из под пользователя mpweb):
+. Добавим в конец /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>
-/home/mpweb/mpweb.sh
+=== Настройка интерфейса администратора ===
+Все действия выполняем из под пользователя mpweb, если не указано иное.\\
+. Создадим скрипт (/home/mpweb/mpweb.sh) получения и обновления исходников:
 <code>#!/bin/sh
@@ Строка 13: / Строка 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>
-/home/mpweb/mpami.sh
+. Сделаем исполняемым:
+<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_web
+pth=/home/mpweb/minipbx_ami
+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/mpami $pth
 #
 # Update
-svn update --username zis $pth</code>
+svn update --username $user $pth</code>
-. Сделаем их исполняемыми:
+. Сделаем исполняемым:
-<code>/home/mpweb/mpweb.sh
+<code>chmod +x /home/mpweb/mpami.sh</code>
-/home/mpweb/mpami.sh</code>
+. Первый раз делаем checkout, потом update.\\
-. Первый раз делаем checkout, потом update.
+. Установим зависимости:
-. Создадим виртуальное окружение:
+<code>bash /home/mpweb/minipbx_ami/setup.txt</code>
-<code>mkvirtualenv mpweb
+. Скопируем файл настроек и настроем его:
-workon mpweb
+<code>cp /home/mpweb/minipbx_ami/mpami.ini.sample /home/mpweb/minipbx_ami/mpami.ini</code>
-</code>
+Настройка начинается с базы данных и секретного ключа:
-Добавим в конец /home/mpweb/.bashrc
+  * [DB].url - строка подключения к БД minipbx;
-<code>export PYTHONPATH=/usr/bin/python3
+  * [MAIN].secret_key - ключ для шифрования JWT;
-export VIRTUALENVWRAPPER_PYTHON=$PYTHONPATH
+Для генерации случайных ключей воспользуйтесь командой:
-export WORKON_HOME=$HOME/.virtualenvs
+<code>openssl rand -hex 32</code>
-source /home/mpweb/.local/bin/virtualenvwrapper.sh</code>
+. Для тестирования иногда нужно запускать сервер в терминале. Для этого скопируем скрипт запуска (из под root):
+<code>mkdir /home/mpweb/.local/bin
+cp /home/mpweb/minipbx_ami/bin/run_mpami /home/mpweb/.local/bin/</code>
-x. Создать каталог для ведения логов и назначить права:
+. Для запуска в качестве службы скопируем systemd скрипт и включим его автоматический запуск (из под root):
-<code>mkdir /var/log/mpweb
+<code>cp /home/mpweb/minipbx_ami/bin/mpami.service  /lib/systemd/system/
-chown mpweb:adm /var/log/mpweb</code>
+systemctl enable mpami
+systemctl start mpami
+systemctl status mpami</code>
+. В каталоге minipbx_ami выполнить **lcompile.sh**. Скрипт выполняет обновление перевода (ru\en)\\