diff --git a/INSTALL.txt b/INSTALL.txt index 512fae243..8a4cdad95 100644 --- a/INSTALL.txt +++ b/INSTALL.txt @@ -3,36 +3,47 @@ Installation Instructions for OpenSlides 1.3 Content ------- -I. Installation on GNU/Linux and MacOSX -II. Installation on Windows (32/64bit) + +I. Installation on GNU/Linux and MacOSX using the Python Package Index (PyPI) +II. Installation on GNU/Linux and MacOSX using the sources +III. Installation on Windows (32/64bit) If you need help ask on OpenSlides users mailing list. See http://openslides.org for more information. -I. Installation on GNU/Linux and MacOSX ----------------------------------------- +I. Installation on GNU/Linux and MacOSX using the Python Package Index (PyPI) +----------------------------------------------------------------------------- -Make sure that you have installed Python (>= 2.5) on your system. + 1. Check requirements: -You can setup a virtualenv environment to install OpenSlides as non-root user. -Run before you start install OpenSlides: + Make sure that you have installed Python (>= 2.5) on your system. - $ virtualenv .venv - $ source .venv/bin/activate + 2. Set up virtual environment with virtualenv (optional): + You can setup a virtual environment to install OpenSlides as + non-root user. + + E. g. for ubuntu run: + $ sudo apt-get install python-virtualenv + + To setup and activate the virtual environment, create your + OpenSlides directory, change to it and run: + + $ virtualenv .venv + $ source .venv/bin/activate + + 3. Install OpenSlides: - 1. Install OpenSlides: - $ pip install openslides - - OpenSlides will installed the following required python packages: + + OpenSlides will install the following required python packages: + Django + django-mptt + ReportLab Toolkit + Python Imaging Library (PIL) - 2. Start OpenSlides server and open URL in your default browser: + 4. Start OpenSlides server and open URL in your default browser: $ openslides @@ -46,8 +57,80 @@ Run before you start install OpenSlides: Use 'openslides --help' to show all start options. -II. Installation on Windows (32/64bit) --------------------------------------- +II. Installation on GNU/Linux and MacOSX using the sources +---------------------------------------------------------- + + 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/. + + E. g. for ubuntu run: + $ sudo apt-get install git + $ git clone git://github.com/OpenSlides/OpenSlides.git OpenSlides + + 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.). + + +III. Installation on Windows (32/64bit) +--------------------------------------- NOTE: There is a portable version of OpenSlides for Windows which does not required any install steps! If there is a reason that you can not use the @@ -65,7 +148,6 @@ portable version you should run the following install steps. + 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 @@ -98,8 +180,9 @@ portable version you should run the following install steps. OR b) Clone development version from OpenSlides' github repository - https://github.com/OpenSlides/OpenSlides. - This requires Git, see http://git-scm.com/. + 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 @@ -116,4 +199,3 @@ portable version you should run the following install steps. Password: admin Use 'python start.py --help' to show all start options. - diff --git a/openslides/main.py b/openslides/main.py index f7818b7ab..bc23fb3bd 100755 --- a/openslides/main.py +++ b/openslides/main.py @@ -27,6 +27,8 @@ import webbrowser import django.conf from django.core.management import execute_from_command_line +from openslides import get_version + CONFIG_TEMPLATE = """#!/usr/bin/env python # -*- coding: utf-8 -*- @@ -78,21 +80,27 @@ def process_options(argv=None): parser = optparse.OptionParser( description="Run openslides using django's builtin webserver") - parser.add_option("-a", "--address", help="IP Address to listen on") - parser.add_option("-p", "--port", type="int", help="Port to listen on") + parser.add_option("-a", "--address", help="IP Address to listen on.") + parser.add_option("-p", "--port", type="int", help="Port to listen on.") parser.add_option( "--syncdb", action="store_true", - help="Update/create database before starting the server") + help="Update/create database before starting the server.") parser.add_option( "--reset-admin", action="store_true", - help="Make sure the user 'admin' exists and uses 'admin' as password") + help="Make sure the user 'admin' exists and uses 'admin' as password.") parser.add_option( "-s", "--settings", help="Path to the openslides configuration.") parser.add_option( "--no-reload", action="store_true", - help="Do not reload the development server") + help="Do not reload the development server.") + parser.add_option( + "--version", action="store_true", + help="Show version and exit.") opts, args = parser.parse_args(argv) + if opts.version: + print get_version() + exit(0) if args: sys.stderr.write("This command does not take arguments!\n\n") parser.print_help() diff --git a/setup.py b/setup.py index ed1c3a018..24973a0bf 100644 --- a/setup.py +++ b/setup.py @@ -7,6 +7,9 @@ :license: GNU GPL, see LICENSE for more details. """ +# for python 2.5 support +from __future__ import with_statement + from setuptools import setup from setuptools import find_packages from openslides import get_version