2011-07-31 10:46:29 +02:00
|
|
|
Installation Instructions for OpenSlides
|
|
|
|
========================================
|
|
|
|
2011-07-29
|
|
|
|
|
|
|
|
|
|
|
|
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 source code (e.g. via mercurial checkout)
|
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
a) Download OpenSlides as zip archive from http://openslides.org.
|
|
|
|
|
|
|
|
OR
|
|
|
|
|
|
|
|
b) Clone mercurial repository (anonymous checkout):
|
|
|
|
|
|
|
|
hg clone http://hg.openslides.org
|
|
|
|
|
|
|
|
If you have write access use instead:
|
|
|
|
hg clone ssh://hg@openslides.org/openslides
|
2011-08-01 15:31:22 +02:00
|
|
|
|
2011-07-31 10:46:29 +02:00
|
|
|
6. Copy default.settings.py to settings.py
|
2011-09-08 09:35:53 +02:00
|
|
|
(in subdirectory 'openslides')
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
7. Create OpenSlides database (and follow on screen instruction):
|
2011-07-31 10:46:29 +02:00
|
|
|
|
|
|
|
python manage.py syncdb
|
2011-09-08 09:35:53 +02:00
|
|
|
|
|
|
|
-> Note: Answer "yes" to create superuser!
|
2011-07-31 10:46:29 +02:00
|
|
|
|
|
|
|
8. Run OpenSlides server:
|
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
python manage.py runserver [port or address:port]
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
9. Open OpenSlides in your browser:
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
http://127.0.0.1:8000/ (or customized server address:port)
|
2011-07-31 10:46:29 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Installation on Linux and MacOSX
|
|
|
|
--------------------------------
|
|
|
|
|
|
|
|
Make sure that you have python and virtualenv installed on your
|
|
|
|
system.
|
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
1. Get OpenSlides source code
|
|
|
|
|
|
|
|
a) Download OpenSlides as zip archive from http://openslides.org.
|
|
|
|
|
|
|
|
OR
|
|
|
|
|
|
|
|
b) Clone 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:
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
# go to the root directory of OpenSlides
|
|
|
|
cd openslides
|
|
|
|
|
|
|
|
# create virtualenv environment
|
|
|
|
virtualenv --no-site-packages .venv
|
|
|
|
|
|
|
|
# activate virtualenv environment
|
2011-07-31 10:46:29 +02:00
|
|
|
. .venv/bin/activate
|
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
3. Install 'pip' (if not available):
|
2011-07-31 10:46:29 +02:00
|
|
|
|
|
|
|
easy_install pip
|
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
4. Install django packages:
|
2011-07-31 10:46:29 +02:00
|
|
|
|
|
|
|
pip install django django-model-utils
|
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
5. Install packages for building PDF:
|
2011-07-31 10:46:29 +02:00
|
|
|
|
|
|
|
pip install reportlab pil
|
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
6. Install other required packages:
|
|
|
|
|
|
|
|
pip install simplejson mercurial
|
2011-08-01 15:31:22 +02:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
7. Copy default.settings.py to settings.py:
|
|
|
|
|
|
|
|
cp openslides/default.settings.py openslides/settings.py
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
8. Create OpenSlides database (and follow on screen instruction):
|
2011-07-31 10:46:29 +02:00
|
|
|
|
|
|
|
python manage.py syncdb
|
2011-09-08 09:35:53 +02:00
|
|
|
|
|
|
|
-> Note: Answer "yes" to create superuser!
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
9. Run OpenSlides server:
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
python manage.py runserver [port or address:port]
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
10. Open OpenSlides in your browser:
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
http://127.0.0.1:8000/ (or customized server address:port)
|
2011-07-31 10:46:29 +02:00
|
|
|
|
|
|
|
|
|
|
|
--
|
|
|
|
If you need help ask on OpenSlides users mailinglist.
|
|
|
|
See www.openslides.org for more information.
|
|
|
|
|