Installation on Windows - PanDAWMS/InVEx GitHub Wiki
Installation of a local instance on a Windows machine
Creating a local instance on a Windows machine is related with the following activities:
- Installing Python 3.6
- Creating a Virtual Environment and installing necessary modules
- Configuring the Django Server
- Creating an automated launching script
Installing Python 3.6
This can be downloaded from official site: Python downloads
Scroll down to "Files" category and pick an executable installer: Windows x86-64 executable installer.
During installation do not forget to put the "Add Python 3.6 to PATH" tick. Other options can be left default.
Creating a Virtual Environment and Installing Necessary Modules
Download the InVEx git repository using your favorite git client (or via a zip archive). Let the folder with the repository be C:\git\vap\InVEx
Launch a console line with elevated rights (administrative privileges) and enter the following:
cd C:\git\vap
python -m venv venv
- creating Virtual Environment
venv\Scripts\activate
- activating it
python -m pip install --upgrade pip
- upgrading pip
pip install -r InVEx/requirements.txt
- installing the project requirements
Configuring the Django Server
Put your secret file with sensitive data to InVEx\core\settings folder. This file can be requested from VAP project manager. Let its name be django-sensitive-data.
Make a copy of InVEx\core\settings\local.py-example.py
and name it local.py.
Put there the path to the django-sensitive-data file. In our case line 6 of local.py turns into:
exec(open("core/settings/django-sensitive-data").read())
Creating an automated launching script
Last thing to launch an instance is to create a script to launch the Django server.
Create a file called InVEx\start.bat with the following contents:
@CALL ..\venv\Scripts\activate
python manage.py runserver
pause
Launch the script using your favorite file manager or a console line.
The server has successfully launched if you get the following output after launching the script:
Performing system checks...
System check identified no issues (0 silenced).
March 09, 2019 - 06:00:59
Django version 2.1.7, using settings 'core.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.
After completing these steps launch a web browser and navigate to http://127.0.0.1:8000/. Your InVEx local instance will be waiting for you there.
In case of any problems feel free to contact the project development team.