DARIAH Contribute: contribute portal for the Dariah project. This project has been built in Python using the Django framework.

1. Use virtualenv;
2. pip install dariah-contribute-{version no}.tar.gz or pip install --upgrade dariah-contribute-{version no}.tar.gz;
3. In {virtualenv folder}/dariah-contribute/lib/python{versionno.}/site-packages/dariah_contribute/settings/ copy local.py.default to local.py and adjust the settings to the server configuration. Note: pay attention to the commented out # MAINTENANCE_MODE = False. The default is set to true and means you WILL get 503 errors. This setting is used for when users are not allowed to log in due to maintenance;
4. manage.py collectstatic (always);
5. manage.py syncdb (on new install);
6. manage.py migrate (always);

7. Change directory to {virtualenv path}/lib/python{versionno.}/site-packages/dariah_static_data/skos_preflabels_data and execute the following commands (only on new install):

   manage.py import_disciplines
   manage.py import_geonames_countries
   manage.py import_tadirah_activity
   manage.py import_tadirah_object
   manage.py import_tadirah_technique
   manage.py import_tadirah_vcc

1. Clone the Dariah Contribute Git repository locally: git clone {path-to-repository-on-server}dariah-contribute.git;
2. Checkout a specific version by checking out a tag with the version name git checkout [tagname];
3. Build the Python Egg from the repository: python setup.py sdist;
4. Copy the Egg to the server using scp;

5. On the live server make sure you have pip installed: follow the pip Docs, and you will also have to have some other packages installed, so run the following to install everything on a Redhat system:

   sudo yum install python-devel zlib-devel* libjpeg-devel* freetype-devel* python-pip gcc
   sudo pip install virtualenv

6. Run virtualenv dariah-contribute;
7. You should be working on your virtualenv, if not run source dariah-contribute/bin/activate;
8. Run pip install dariah-contribute-{versionno.}.tar.gz;
9. Make sure the local.py settings file is present in {virtualenv folder}/dariah-contribute/lib/python{versionno.}/site-packages/dariah_contribute/settings/ and contains the right info (including the database settings);
10. manage.py syncdb to create the database and the superuser;
11. Then manage.py migrate;
12. Run manage.py collectstatic;
13. Let your IT departement set up Apache;

14. Change directory to {virtualenv path}/lib/python{versionno.}/site-packages/dariah_static_data/skos_preflabels_data and execute the following commands (only on new install):

    manage.py import_disciplines
    manage.py import_geonames_countries
    manage.py import_tadirah_activity
    manage.py import_tadirah_object
    manage.py import_tadirah_technique
    manage.py import_tadirah_vcc

15. When you're done take the project out of maintenance mode by adding MAINTENANCE_MODE = False to the local.py settings file and restarting django by 'touching' {virtualenv folder}/dariah-contribute/bin/wsgi.

Do not create a Python Egg from the repository, but instead you can install all the requirements using pip install -r requirements.pip. You can now run the server using ./manage.py runserver. You probably don't want to use Apache.