This document describes a step by step installation process for installing MDCS 2.0 locally on a Windows operating system.
These instructions support the manual installation process for MDCS software version 2.0 (a.k.a., mdcs located at https://github.com/usnistgov/mdcs .
Installation Parameter | Example Installation Parameter Value |
---|---|
MDCS application installation platform | Windows operating system |
MDCS application installation path | c:\mdcs |
MDCS application IP address | 127.0.0.1 |
MDCS application port number | 8000 |
MDCS virtual environment name | mdcs_env |
MDCS Superuser username | mgi_superuser |
MDCS Superuser email | user_email@institution.com |
MDCS Superuser password | mgi_superuser_pwd |
MongoDB administrative username | mdb_admin_user |
MongoDB administrative password | mdb_admin_pwd |
MongoDB non-administrative username | mdb_user |
MongoDB non-administrative password | mdb_pwd |
Redis configuration file | c:\Program Files\Redis\redis.windows.conf |
Installation Parameter | Parameter Value Used In This Document |
---|---|
MDCS application installation path | <install_path> |
MDCS application IP address | <ip_address> |
MDCS application port number | <port_number> |
MDCS virtual environment name | <mdcs_virtual_environment_name> |
MDCS Superuser username | <mdcs_superuser_username> |
MDCS Superuser email | <mdcs_superuser_email> |
MDCS Superuser password | <mdcs_superuser_password> |
MongoDB administrative username | <mongodb_admin_username> |
MongoDB administrative password | <mongodb_admin_password> |
MongoDB non-administrative username | <mongodb_nonadmin_username> |
MongoDB non-administrative password | <mongodb_nonadmin_password> |
Redis configuration file | <redis_configuratiaon_filename> |
pip install
.$ cmd.exe
NOTE: This enables you to install the MDCS software in Python virtual environments.
Command:
$ pip install virtualenvwrapper-win$ mkdir <install_path>\$ cd <install_path>\$ mkvirtualenv <mdcs_virtual_environment_name>
Example:
$ pip install virtualenvwrapper-win$ mkdir c:\mdcs\$ cd c:\mdcs\$ mkvirtualenv mdcs_env
NOTE: This mkvirtualenv command:
$$ python -m pip install --upgrade pip
$$ cd mdcs-master
$$ mkdir conf
$$ mkdir data\db
NOTE: This instruction asks the user to:
General File Contents:
net:bindIp: <ip_address>security:authorization: enabledstorage:dbPath: <install_path>/mdcs-master/data/db
net:bindIp: 127.0.0.1security:authorization: enabledstorage:dbPath: c:/mdcs/mdcs-master/data/db
$$ pip install -e git://github.com/MongoEngine/django-mongoengine.git@v0.2.1#egg=django-mongoengine$$ pip install --no-cache-dir -r requirements.txt$$ pip install --no-cache-dir -r requirements.core.txt
$$ mongod --config conf\mongodb.conf
$ cmd.exe
$ workon <mdcs_virtual_environment_name>$$ cd <install_path>\mdcs-master\
$ workon mdcs_env$$ cd <install_path>\mdcs-master\
NOTE: Enter your own mongodb administrative username and password here. See the example below.
$$ mongo --port 27017use admindb.createUser({user: "<mongodb_admin_username>",pwd: "<mongodb_admin_password>",roles: [ { role: "userAdminAnyDatabase", db: "admin"},"backup","restore"]})exit
$$ mongo --port 27017use admindb.createUser({user: "mdb_admin_user",pwd: "mdb_admin_pwd",roles: [ { role: "userAdminAnyDatabase", db: "admin"},"backup","restore"]})exit
Command:
$$ mongo --port 27017 -u "<mongodb_admin_username>" -p "<mongodb_admin_username>" --authenticationDatabase adminuse mgidb.createUser({user: "<mongodb_nonadmin_username>",pwd: "<mongodb_nonadmin_password>",roles: ["readWrite"]})exit
$$ mongo --port 27017 -u "mdb_admin_user" -p "mdb_admin_pwd" --authenticationDatabase adminuse mgidb.createUser({user: "mdb_user",pwd: "mdb_pwd",roles: ["readWrite"]})exit
Original settings.py settings:
MONGO_USER = "mgi_user"MONGO_PASSWORD = "mgi_password"
Change to:
Command:
MONGO_USER = "<mongodb_nonadmin_username>"MONGO_PASSWORD = "<mongodb_nonadmin_password>"
Example:
MONGO_USER = "mdb_user"MONGO_PASSWORD = "mdb_pwd"
Command:
$$ redis-server <redis_configuratiaon_filename>
Example:
$$ redis-server "c:\Program Files\Redis\redis.windows.conf"
NOTES:
$$ pip uninstall celery$$ pip install celery==3.1.18
$$ celery -A mdcs worker -l info -Ofair --purge
$ cd <install_path>\mdcs-master\$ workon mdcs_env$$ python manage.py migrate auth$$ python manage.py migrate$$ python manage.py collectstatic --noinput$$ python manage.py createsuperuser
Command:
Example:
Command:
$$ python manage.py runserver <ip_address>:<port_number>
Example:
$$ python manage.py runserver 127.0.0.1:8000
Command:
Example:
$$ mongod --config conf\mongodb.conf
$$ redis-server "c:\Program Files\Redis\redis.windows.conf"
$$ celery -A mdcs worker -l info -Ofair --purge
Command:
$$ python manage.py runserver <ip_address>:<port_number>
Example:
$$ python manage.py runserver 127.0.0.1:8000
Command:
Example:
Command: login with:
Example: login with: