Skip to content
Snippets Groups Projects
Tor-Einar Skog's avatar
Tor-Einar Skog authored
This reverts commit 3bf4d355.
f900c6e0
History

VIPSWeb

This is the code for the public web page for VIPS. It should be adaptable enough to suit many organizations.

The public web page acts as a client of the VIPSLogic system, all information displayed to the users in VIPSWeb is fetched via web service endpoints in VIPSLogic.

How VIPSLogic fits into the whole VIPS architecture

Each organization within the VIPSLogic system will typically have their own VIPSWeb installation. Or the organization can choose to pull the data from VIPSLogic and display integrated in their own web sites.

Requirements

The system has been tested and found to run well on Ubuntu >= 18

  • The programming language is Python >= 3.6
  • The web framework is currently Django 3.1
  • Apache web server with mod_wsgi compiled for Python 3

Install and setup

  1. Install and activate a virtual Python environment
python3 -m venv my_venv
source my_env/bin/activate
  1. Install all the requirements into the virtual environment. Remember to be in the folder where the requirements.txt file is
pip install -r requirements.txt
  1. Copy VIPSWeb/local_settings_sample.py into VIPSWeb/local_settings.py and adapt to your needs

  2. Run all database migrations

./manage.py migrate

Running with mod_wsgi

The official Django documentation for this can be found here

  • If running on e.g. Ubuntu 18, please remember to install the libapache2-mod-wsgi-py3 and not the libapache2-mod-wsgi package
  • Here's an example mod_wsgi configuration in an Apache2 virtualhost
        WSGIDaemonProcess vipsweb python-path=/opt/VIPSWeb/VIPSWeb python-home=/opt/VIPSWeb/py3dj3
        WSGIProcessGroup vipsweb

        WSGIScriptAlias / /opt/VIPSWeb/VIPSWeb/VIPSWeb/wsgi.py

        <Directory /opt/VIPSWeb/VIPSWeb/VIPSWeb>
                <Files wsgi.py>
                        Require all granted
                </Files>
        </Directory>