Update Install (Oskar and me)

This commit is contained in:
Norman Jäckel 2012-07-15 17:05:36 +02:00
parent 7d803af2db
commit c2ec78c828

122
INSTALL
View File

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