Installation and deployment is shown in short below (for Linux and MacOS system) and in more detail in the Install & Deployment chapter. The deployment via apache2 and mod-wsgi is tested for debian-based Linux systems. A guide for windows installation (tested only for conda) and deployment can be found here.
To deploy the MDsrv, just follow these 8 steps (for debian-based Linux systems).
- Install MDsrv
- via PyPi:
pip install mdsrv
- via conda:
conda config --add channels conda-forge
conda install mdsrv
- dependencies: mdtraj (incl. cython, numpy, scipy), setuptools, flask
- via PyPi:
Install Apache2 and mod-wsgi:
sudo apt-get install apache2 libapache2-mod-wsgi
Add the content of apache.config into /etc/apache2/sites-available/000-default.conf or replace this file.
Important: Adjust the user and group according to your environment settings and set the python-path or remove it. An example for user and group would be your system name, found on Linux with whoami. For more information, please check the more detailed documentation.
Copy mdsrv.html into the folder /var/www/html/.
Place mdsrv.wsgi into /var/www/mdsrv/mdsrv.wsgi. Add the path of the configuration file (app.cfg) into the mdsrv.wsgi file including the name of the file (APP_CFG = '/home/username/important/app.cfg').
Restart the apache server (additional to whenever the app.cfg file is changed):
sudo service apache2 restart
Access the MDsrv/NGL GUI including your simulations via:
The MDsrv has been tested and can be installed on Linux, Mac OS and Windows. Deployment is excessively tested for Debian-based Linux systems.
The deployed NGL sessions can be viewed on every operating system and browser which supports WebGL.
To get information how to do this, inspect the deployment guide.
If you have any questions, found some bugs, or want to report enhancement requests use the Issue Tracker, use the contact formular or write a mail to email@example.com or firstname.lastname@example.org.
Please give us feedback!