OpenSlides/INSTALL

123 lines
3.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
I. Installation on Windows (32/64bit)
-------------------------------------
1. Install Python 2.7
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
b) Add python dirs to PATH (via Control Panel > System > Advanced):
";C:\Python27;C:\Python27\Scripts"
2. Install Setuptools 0.6c11
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
3. Install required packages
Open command line (cmd) and run:
easy_install django django-mptt reportlab pil
2012-07-15 11:14:05 +02:00
If you, nevertheless, 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
4. Get OpenSlides:
a) Download latest OpenSlides release from http://openslides.org.
OR
b) Clone development version from mercurial repository:
hg clone http://hg.openslides.org
5. Start OpenSlides server and open URL in your default browser:
python start.py
If you run this script the first time new database and admin account
are created. Please change the password after first login!
Username: admin
2012-07-15 11:14:05 +02:00
Password: admin
2012-04-27 16:07:57 +02:00
Use 'python start.py --help' to show all start options.
II. Installation on GNU/Linux and MacOSX
----------------------------------------
Make sure that you have installed python and virtualenv on your
system.
2012-07-15 11:14:05 +02:00
1. OpenSlides requires following programs, which should be
installed first: python 2 (>=2.5), virtualenv, reportlab, pil
E.g. for ubuntu run:
$ sudo apt-get install python python-virtualenv python-reportlab python-imagin
2. Get OpenSlides:
2012-04-27 16:07:57 +02:00
a) Download latest OpenSlides release from http://openslides.org.
OR
b) Clone development version from mercurial repository:
2012-07-15 11:14:05 +02:00
$ hg clone -r 1.2-dev http://hg.openslides.org
You have to install mercurial. For Ubuntu run:
2012-04-27 16:07:57 +02:00
2012-07-15 11:14:05 +02:00
$ sudo apt-get install mercurial
2012-04-27 16:07:57 +02:00
2012-07-15 11:14:05 +02:00
3. Setup 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
2012-07-15 11:14:05 +02:00
$ virtualenv --system-site-packages .venv
Activate the virtualenv environment:
$ . .venv/bin/activate
2012-04-27 16:07:57 +02:00
4. Install required packages:
2012-07-15 11:14:05 +02:00
$ pip install django django-mptt
If you use python 2.5 you also have to install 'simplejson'
$ pip install simplejson
2012-04-27 16:07:57 +02:00
5. Start OpenSlides server and open URL in your default browser:
2012-07-15 11:14:05 +02:00
$ python start.py
2012-04-27 16:07:57 +02:00
If you run this script the first time new database and admin account
are created. Please change the password after first login!
Username: admin
Password: admin
2012-04-27 16:07:57 +02:00
Use 'python start.py --help' to show all start options.
2012-07-15 11:14:05 +02:00
--
2012-04-27 16:07:57 +02:00
If you need help ask on OpenSlides users mailing list.
2012-07-15 11:14:05 +02:00
See http://openslides.org for more information.