170 lines
4.3 KiB
Plaintext
170 lines
4.3 KiB
Plaintext
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 <port> or <address:port> 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 <port> or <address:port> 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.
|
|
|