installation.rst

Установка

Подготовка

Прежде чем начать установку убедитесь что у вас установлены пакеты "git" и "Apache". Если их нет, то выполните их установку. Эту и все последующие установочные команды будем выполнять от пользователя root на примере ОС Ubuntu 18:

$ sudo -i
# apt install git
# apt install apache2
# systemctl enable apache2

1) Клонируем портал на локальный компьютер

Загрузите исходный код с git, находясь в папке "opt":

# cd /opt/
# git clone https://github.com/sp4plm/SPLM

и перейдите в директорию проекта:

# cd SPLM

2) Устанавливаем пакеты вируальной среды

Подготовьте виртуальное окружение VirtualEnv для Python. Желательно иметь версию Python 3.7 или следующую. Дополнительно смотрите: https://python-scripts.com/virtualenv. Если у вас уже есть необходиммая версия Python, то первую команду из указанных ниже можно пропустить. Создайте виртуальную среду (virtual environment):

# apt install python3.8
# apt install python3-venv
# apt install python3.8-venv

3) Разворачиваем виртуальную среду

Разворачиваем в папке "venv" среду для соответствующей версии Pythonи и активируем ее:

# mkdir venv
# python3.8 -m venv venv
# source venv/bin/activate

После выполнения последней команды в адресной строке терминала перед именем пользователя должна появиться надпись "(venv)" без кавычек. Это значит что дальнейшие команды будут выполняться в запущенной виртуальной среде.

4) Устанавливаем дополнительные пакеты:

Устанавливаем необходимые дополнительные пакеты для приложения (python dependencies):

Чтобы установка из пакета "requirements.txt" прошла гладко необходимо обновить следующие пакеты:

pip install pip --upgrade
pip install setuptools --upgrade

И затем выполняем собственно установку всех необходимых пакетов:

# pip install -r requirements.txt

5) Запускаем приложение:

Запускаем приложение из командной строки:

# python3 run.py

Если все прошло успешно, то в терминале появится информация о запуске приложения в отладочном режиме:

Для запуска приложения в рабочем режиме скорректируйте файл run.py в соответствии с документацией на Flask:

# nano run.py

Если передти по указанной выше ссылке http://127.0.0.1:5001 то попадете на следующую страничку портала:

6) Запускаем установщик портала:

В строке браузера указываем путь http://127.0.0.1:5001/portlal/installer

в появившемся окне нажимаем единственную кнопку и ждем несколько секунд ...

Через несколько секунд дожно появится сообщение об окончании кофиигурирования:

7) Административная часть портала

Для входа в административную часть портала и настройки приложения укажите следующий адрес:

http://127.0.0.1:5001/portal

для входа используйте логин manager и пароль testadmin

8) Остановка портала

Останавливаем портал и виртуальное окружение:

Для этого в окне терминала нажимаем сосчетание клавиш CTR+C

И выполняем команду выхода из виртуального окружения:

# deactivate

Теперь надпись "(venv)" перед именем пользователя должна исчезнуть.