2011-07-31 10:46:29 +02:00
|
|
|
Installation Instructions for OpenSlides
|
|
|
|
========================================
|
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
Content
|
|
|
|
-------
|
|
|
|
I. Installation on Windows (32/64bit)
|
|
|
|
II. Installation on GNU/Linux and MacOSX
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
|
|
|
|
|
|
|
|
I. Installation on Windows (32/64bit)
|
|
|
|
-------------------------------------
|
2011-07-31 10:46:29 +02:00
|
|
|
|
|
|
|
1. Install Python 2.7
|
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
a) Download and run 32bit MSI installer from http://www.python.org/download/
|
|
|
|
e.g. version 2.7.2:
|
|
|
|
http://www.python.org/ftp/python/2.7.2/python-2.7.2.msi
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
b) Add python dirs to PATH (via Control Panel > System > Advanced):
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
";C:\Python27;C:\Python27\Scripts"
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
2. Install Setuptools 0.6c11
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
Download and run 32bit binary installer from http://pypi.python.org/pypi/setuptools:
|
|
|
|
http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11.win32-py2.7.exe
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
3. Install required packages
|
|
|
|
Open command line (cmd) and run:
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
easy_install django django-mptt reportlab pil
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
4. Get OpenSlides:
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
a) Download latest OpenSlides release from http://openslides.org.
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
OR
|
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
b) Clone development version from mercurial repository
|
|
|
|
(anonymous checkout):
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
hg clone http://hg.openslides.org
|
|
|
|
|
2012-02-20 00:17:53 +01:00
|
|
|
If you have write access use instead:
|
2011-09-08 09:35:53 +02:00
|
|
|
hg clone ssh://hg@openslides.org/openslides
|
2011-08-01 15:31:22 +02:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
5. Copy default.settings.py to settings.py
|
2011-09-08 09:35:53 +02:00
|
|
|
(in subdirectory 'openslides')
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
6. Create OpenSlides database (and follow on screen instruction).
|
2011-10-24 17:55:14 +02:00
|
|
|
Go to the extracted OpenSlides root directory and enter:
|
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!
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
7. Run OpenSlides server:
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2012-02-20 00:17:53 +01:00
|
|
|
python manage.py runserver
|
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
Optional: Add <port> or <address:port> to use server on custom
|
|
|
|
address/port.
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
8. 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
|
|
|
|
|
|
|
|
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
II. Installation on GNU/Linux and MacOSX
|
|
|
|
----------------------------------------
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
Make sure that you have installed python and virtualenv on your
|
2011-07-31 10:46:29 +02:00
|
|
|
system.
|
|
|
|
|
2012-02-20 00:17:53 +01:00
|
|
|
1. Get OpenSlides:
|
2011-09-08 09:35:53 +02:00
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
a) Download latest OpenSlides release from http://openslides.org.
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
OR
|
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
b) Clone development version from mercurial repository (anonymous
|
|
|
|
checkout):
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2011-09-08 09:35:53 +02:00
|
|
|
hg clone http://hg.openslides.org
|
|
|
|
|
2012-02-20 00:17:53 +01:00
|
|
|
If you have write access use instead:
|
2011-09-08 09:35:53 +02:00
|
|
|
hg clone ssh://hg@openslides.org/openslides
|
|
|
|
|
|
|
|
2. Setup virtualenv:
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-11-23 08:49:03 +01:00
|
|
|
# Go to the (extracted/cloned) root directory of OpenSlides
|
|
|
|
# and create virtualenv environment
|
2011-09-08 09:35:53 +02:00
|
|
|
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):
|
2012-02-20 00:17:53 +01:00
|
|
|
|
|
|
|
easy_install pip
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
4. Install required packages:
|
2011-09-08 09:35:53 +02:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
pip install django django-mptt reportlab pil simplejson mercurial
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
5. Copy default.settings.py to settings.py:
|
2011-09-08 09:35:53 +02:00
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
cp openslides/default.settings.py openslides/settings.py
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
6. Create OpenSlides database in the OpenSlides root directory
|
2011-10-24 17:55:14 +02:00
|
|
|
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!
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
7. Run OpenSlides server:
|
2011-07-31 10:46:29 +02:00
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
python manage.py runserver
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2011-10-24 17:55:14 +02:00
|
|
|
Optional: Add <port> or <address:port> to use server on custom
|
|
|
|
address/port.
|
2012-02-20 00:17:53 +01:00
|
|
|
|
2012-02-20 07:56:49 +01:00
|
|
|
8. 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
|
|
|
|
|
|
|
|
|
|
|
--
|
2012-02-20 07:56:49 +01:00
|
|
|
If you need help ask on OpenSlides users mailing list.
|
2011-07-31 10:46:29 +02:00
|
|
|
See www.openslides.org for more information.
|
|
|
|
|