OpenSlides/INSTALL

151 lines
4.3 KiB
Plaintext
Raw Normal View History

2012-04-27 16:07:57 +02:00
Installation Instructions for OpenSlides 1.2
============================================
Content
-------
I. Installation on Windows (32/64bit)
II. Installation on GNU/Linux and MacOSX
2012-07-15 17:05:36 +02:00
If you need help ask on OpenSlides users mailing list.
See http://openslides.org for more information.
2012-04-27 16:07:57 +02:00
I. Installation on Windows (32/64bit)
-------------------------------------
2012-07-15 17:05:36 +02:00
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
2012-07-15 17:05:36 +02:00
a) Download and run 32bit MSI installer from http://www.python.org/:
2012-07-15 17:05:36 +02:00
http://python.org/ftp/python/2.7.3/python-2.7.3.msi
2012-04-27 16:07:57 +02:00
b) Add python dirs to PATH (via Control Panel > System > Advanced):
2012-07-15 17:05:36 +02:00
";C:\Python27;C:\Python27\Scripts"
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
c) Install Setuptools:
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
Download and run 32bit binary installer from
http://pypi.python.org/pypi/setuptools:
2012-07-15 17:05:36 +02:00
http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11.win32-py2.7.exe
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
d) Install ReportLab Toolkit, Python Imaging Library (PIL), Django
and django-mptt:
2012-07-15 17:05:36 +02:00
Open command line (cmd) and run:
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
easy_install django django-mptt reportlab pil
2012-07-15 11:14:05 +02:00
2012-07-15 17:05:36 +02:00
If you use a 64bit version of Python, you have to install reportlab
and pil not by using easy_install but manually.
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
2. Get OpenSlides:
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
a) Download latest OpenSlides release from http://openslides.org.
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
OR
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
b) Clone development version from mercurial repository
http://hg.openslides.org. This requires Mercurial source control
management (hg), see http://mercurial.selenic.com.
2012-07-15 17:05:36 +02:00
Open command line (cmd) and run:
2012-07-15 17:05:36 +02:00
hg clone http://hg.openslides.org OpenSlides
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
3. Start OpenSlides server and open URL in your default browser:
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
python start.py
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
If you run this script the first time a new database and the
admin account are created. Please change the password after
first login!
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
Username: admin
Password: admin
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
Use 'python start.py --help' to show all start options.
2012-04-27 16:07:57 +02:00
II. Installation on GNU/Linux and MacOSX
----------------------------------------
2012-07-15 17:05:36 +02:00
1. Install requirements:
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
OpenSlides requires following programs, which should be
2012-07-18 21:07:13 +02:00
installed first:
+ Python Programming Language 2 (>= 2.5)
+ virtualenv (>= 1.4.1)
+ ReportLab Toolkit
2012-07-18 21:07:13 +02:00
+ Python Imaging Library (PIL)
2012-07-15 11:14:05 +02:00
2012-07-15 17:05:36 +02:00
E.g. for ubuntu run:
2012-07-18 21:07:13 +02:00
$ sudo apt-get install python python-virtualenv python-reportlab python-imaging
2012-07-15 11:14:05 +02:00
2. Get OpenSlides:
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
a) Download latest OpenSlides release from http://openslides.org.
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
OR
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
b) Clone development version from mercurial repository
http://hg.openslides.org. This requires Mercurial source control
management (hg):
2012-07-15 17:05:36 +02:00
E.g. for Ubuntu run:
2012-07-15 11:14:05 +02:00
$ sudo apt-get install mercurial
2012-07-15 17:05:36 +02:00
$ hg clone http://hg.openslides.org OpenSlides
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
3. Setup your virtual environment with virtualenv:
2012-04-27 16:07:57 +02:00
2012-07-15 11:14:05 +02:00
Go to the (extracted/cloned) root directory of OpenSlides
and create virtualenv environment:
2012-04-27 16:07:57 +02:00
$ virtualenv .venv
2012-07-18 22:53:29 +02:00
For virtualenv >= 1.7 use instead:
2012-07-15 11:14:05 +02:00
$ virtualenv --system-site-packages .venv
2012-07-15 17:05:36 +02:00
4. Activate the virtual environment:
2012-07-15 11:14:05 +02:00
$ source .venv/bin/activate
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
5. Install the required python-packages:
2012-04-27 16:07:57 +02:00
2012-07-15 11:14:05 +02:00
$ pip install django django-mptt
2012-07-15 17:05:36 +02:00
If you use python < 2.6 you also have to install simplejson:
2012-07-15 11:14:05 +02:00
$ pip install simplejson
2012-04-27 16:07:57 +02:00
2012-07-18 21:07:13 +02:00
If requirements reportlab or PIL still missing (see 1.):
$ pip install reportlab pil
2012-07-15 17:05:36 +02:00
6. Start OpenSlides server and open URL in your default browser:
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
$ python start.py
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
If you run this script the first time a new database and the
admin account are created. Please change the password after
first login!
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
Username: admin
Password: admin
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
Use 'python start.py --help' to show all start options.
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
7. Restart OpenSlides:
2012-04-27 16:07:57 +02:00
2012-07-15 17:05:36 +02:00
To restart OpenSlides after closing the terminal activate the
virtual environment (see 4.) before starting the server (see 6.).