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

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.