Installation Instructions for OpenSlides ======================================== Content ------- I. Installation on Windows (32/64bit) II. Installation on GNU/Linux and MacOSX I. Installation on Windows (32/64bit) ------------------------------------- 1. Install Python 2.7 - 32bit: a) Download and run 32bit MSI installer (python-2.7.2.msi) from http://www.python.org/download/ b) Add python dirs to PATH (via Control Panel > System > Advanced): C:\Python27;C:\Python27\Scripts - 64bit: a) Download and run 64bit MSI installer (python-2.7.2.amd64.msi) from http://www.python.org/download/ b) Add python dirs to PATH (via Control Panel > System > Advanced): C:\Python27;C:\Python27\Scripts 2. Install Setuptools 0.6c11 - 32bit: Download and run 32bit binary installer (setuptools-0.6c11.win32-py2.7.exe) from http://pypi.python.org/pypi/setuptools - 64bit: a) Download 64bit version (ez_setup.py) from http://pypi.python.org/pypi/setuptools b) Open cmd and run to install setuptools: python ez_setup.py 3. Install django packages Open cmd and run: easy_install django django-model-utils 4. Install packages for building PDF (reportlab, PIL) - 32bit: Run on cmd: easy_install reportlab pil - 64bit: a) Download and run Reportlab 64bit binary installer (reportlab-2.5-win-amd64-py2.7.exe) from http://www.reportlab.com/ftp/ b) Download and run PIL 64bit binary installer (PIL-1.1.7.win-amd64-py2.7.exe) from http://www.lfd.uci.edu/~gohlke/pythonlibs/ 5. Get OpenSlides: a) Download latest OpenSlides release from http://openslides.org. OR b) Clone development version from mercurial repository (anonymous checkout): hg clone http://hg.openslides.org If you have write access use instead: hg clone ssh://hg@openslides.org/openslides 6. Copy default.settings.py to settings.py (in subdirectory 'openslides') 7. Create OpenSlides database (and follow on screen instruction). Go to the extracted OpenSlides root directory and enter: python manage.py syncdb -> Note: Answer "yes" to create superuser! 8. Run OpenSlides server: python manage.py runserver Optional: Add or to use server on custom address/port. 9. Open OpenSlides in your browser: http://127.0.0.1:8000/ (or customized server address:port) II. Installation on GNU/Linux and MacOSX ---------------------------------------- Make sure that you have installed python and virtualenv on your system. 1. Get OpenSlides: a) Download latest OpenSlides release from http://openslides.org. OR b) Clone development version from mercurial repository (anonymous checkout): hg clone http://hg.openslides.org If you have write access use instead: hg clone ssh://hg@openslides.org/openslides 2. Setup virtualenv: # Go to the (extracted/cloned) root directory of OpenSlides # and create virtualenv environment virtualenv --no-site-packages .venv # activate virtualenv environment . .venv/bin/activate 3. Install 'pip' (if not available): easy_install pip 4. Install django packages: pip install django django-model-utils 5. Install packages for building PDF: pip install reportlab pil 6. Install other required packages: pip install simplejson mercurial 7. Copy default.settings.py to settings.py: cp openslides/default.settings.py openslides/settings.py 8. Create OpenSlides database in the OpenSlides root directory and follow on screen instruction: python manage.py syncdb -> Note: Answer "yes" to create superuser! 9. Run OpenSlides server: python manage.py runserver Optional: Add or to use server on custom address/port. 10. Open OpenSlides in your browser: http://127.0.0.1:8000/ (or customized server address:port) -- If you need help ask on OpenSlides users mailinglist. See www.openslides.org for more information.