149 lines
4.3 KiB
Plaintext
149 lines
4.3 KiB
Plaintext
Installation Instructions for OpenSlides 1.3
|
|
============================================
|
|
|
|
Content
|
|
-------
|
|
I. Installation on Windows (32/64bit)
|
|
II. Installation on GNU/Linux and MacOSX
|
|
|
|
If you need help ask on OpenSlides users mailing list.
|
|
See http://openslides.org for more information.
|
|
|
|
|
|
I. Installation on Windows (32/64bit)
|
|
-------------------------------------
|
|
|
|
1. Install requirements:
|
|
|
|
OpenSlides requires following programs, which should be
|
|
installed first:
|
|
+ Python Programming Language 2 (>= 2.5),
|
|
+ Setuptools
|
|
+ ReportLab Toolkit
|
|
+ Python Imaging Library (PIL)
|
|
+ Django
|
|
+ django-mptt
|
|
|
|
|
|
a) Download and run 32bit MSI installer from http://www.python.org/:
|
|
|
|
http://python.org/ftp/python/2.7.3/python-2.7.3.msi
|
|
|
|
b) Add python dirs to PATH (via Control Panel > System > Advanced):
|
|
|
|
";C:\Python27;C:\Python27\Scripts"
|
|
|
|
c) Install Setuptools:
|
|
|
|
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
|
|
|
|
d) Install ReportLab Toolkit, Python Imaging Library (PIL), Django
|
|
and django-mptt:
|
|
|
|
Open command line (cmd) and run:
|
|
|
|
easy_install django django-mptt reportlab pil
|
|
|
|
If you use a 64bit version of Python, you have to install reportlab
|
|
and PIL manually - without using easy_install.
|
|
|
|
2. Get OpenSlides:
|
|
|
|
a) Download latest OpenSlides release from http://openslides.org.
|
|
|
|
OR
|
|
|
|
b) Clone development version from OpenSlides' github repository
|
|
https://github.com/OpenSlides/OpenSlides.
|
|
This requires Git, see http://git-scm.com/.
|
|
Open command line (cmd) and run:
|
|
|
|
git clone git://github.com/OpenSlides/OpenSlides.git
|
|
|
|
3. Start OpenSlides server and open URL in your default browser:
|
|
|
|
python start.py
|
|
|
|
If you run this script the first time a new database and the
|
|
admin account are created. Please change the password after
|
|
first login!
|
|
|
|
Username: admin
|
|
Password: admin
|
|
|
|
Use 'python start.py --help' to show all start options.
|
|
|
|
|
|
II. Installation on GNU/Linux and MacOSX
|
|
----------------------------------------
|
|
|
|
1. Install requirements:
|
|
|
|
OpenSlides requires following programs, which should be
|
|
installed first:
|
|
+ Python Programming Language 2 (>= 2.5)
|
|
+ virtualenv (>= 1.4.1)
|
|
+ ReportLab Toolkit
|
|
+ Python Imaging Library (PIL)
|
|
|
|
E.g. for ubuntu run:
|
|
$ sudo apt-get install python python-virtualenv python-reportlab python-imaging
|
|
|
|
2. Get OpenSlides:
|
|
|
|
a) Download latest OpenSlides release from http://openslides.org.
|
|
|
|
OR
|
|
|
|
b) Clone development version from OpenSlides' github repository
|
|
https://github.com/OpenSlides/OpenSlides.
|
|
This requires Git, see http://git-scm.com/.
|
|
Open command line (cmd) and run:
|
|
|
|
git clone git://github.com/OpenSlides/OpenSlides.git
|
|
|
|
3. Setup your virtual environment with virtualenv:
|
|
|
|
Go to the (extracted/cloned) root directory of OpenSlides
|
|
and create virtualenv environment:
|
|
|
|
$ virtualenv .venv
|
|
|
|
For virtualenv >= 1.7 use instead:
|
|
$ virtualenv --system-site-packages .venv
|
|
|
|
4. Activate the virtual environment:
|
|
|
|
$ source .venv/bin/activate
|
|
|
|
5. Install the required python-packages:
|
|
|
|
$ pip install django django-mptt
|
|
|
|
If you use python < 2.6 you also have to install simplejson:
|
|
$ pip install simplejson
|
|
|
|
If requirements reportlab or PIL still missing (see 1.):
|
|
$ pip install reportlab pil
|
|
|
|
6. Start OpenSlides server and open URL in your default browser:
|
|
|
|
$ python start.py
|
|
|
|
If you run this script the first time a new database and the
|
|
admin account are created. Please change the password after
|
|
first login!
|
|
|
|
Username: admin
|
|
Password: admin
|
|
|
|
Use 'python start.py --help' to show all start options.
|
|
|
|
7. Restart OpenSlides:
|
|
|
|
To restart OpenSlides after closing the terminal activate the
|
|
virtual environment (see 4.) before starting the server (see 6.).
|