Merge pull request #1944 from normanjaeckel/README

Updated README.
This commit is contained in:
Emanuel Schütze 2016-02-05 22:48:22 +01:00
commit 378218e8a5

View File

@ -14,8 +14,8 @@ II. Requirements
================ ================
OpenSlides runs everywhere where Python is running (for example on OpenSlides runs everywhere where Python is running (for example on
GNU/Linux, Mac or Windows (XP or newer)). On each client you need only an GNU/Linux, Mac or Windows (XP or newer)). On each client you need only a
actual webbrowser. current version of a webbrowser.
III. Installation III. Installation
@ -33,23 +33,22 @@ Installation on GNU/Linux or Mac OS X
$ sudo apt-get install python3-dev $ sudo apt-get install python3-dev
2. Setup a virtual environment with Virtual Python Environment builder 2. Setup a virtual Python environment using the virtual environment (venv)
(optional) package for Python (optional)
You can setup a virtual environment to install OpenSlides as non-root You can setup a virtual Python environment to install OpenSlides as
user. Make sure that you have installed Virtual Python Environment non-root user.
builder on your system.
For example for Ubuntu run:: Note: For Ubuntu 14.04 you have to install the pyvenv binary package. Run::
$ sudo apt-get install python-virtualenv $ sudo apt-get install python3.4-venv
Create your OpenSlides directory, change to it, setup and activate the Create your OpenSlides directory, change to it, setup and activate the
virtual environment:: virtual environment::
$ mkdir OpenSlides $ mkdir OpenSlides
$ cd OpenSlides $ cd OpenSlides
$ virtualenv -p /usr/bin/python3 .virtualenv $ python3 -m venv .virtualenv
$ source .virtualenv/bin/activate $ source .virtualenv/bin/activate
3. Install OpenSlides 3. Install OpenSlides
@ -60,7 +59,7 @@ Installation on GNU/Linux or Mac OS X
$ pip install openslides-x.x.tar.gz $ pip install openslides-x.x.tar.gz
OpenSlides will install all required python packages (see OpenSlides will install all required Python packages (see
requirements_production.txt). requirements_production.txt).
@ -68,7 +67,7 @@ Installation on Windows
----------------------- -----------------------
*Note: There is a portable version of OpenSlides for Windows which does not *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 require any install steps. If there is a reason that you can not use the
portable version you should observe the following install steps.* portable version you should observe the following install steps.*
1. Check requirements 1. Check requirements
@ -80,7 +79,7 @@ portable version you should observe the following install steps.*
<https://www.python.org/downloads/windows/>`_. Note <https://www.python.org/downloads/windows/>`_. Note
that the 32-bit MSI installer is required even on a 64-bit Windows that the 32-bit MSI installer is required even on a 64-bit Windows
system. If you use the 64-bit MSI installer, step 3 of this system. If you use the 64-bit MSI installer, step 3 of this
instruction will fail unless you installed the package reportlab instruction will fail unless you installed the package Reportlab
manually. manually.
b. Add python directories to PATH (via Control Panel > System > b. Add python directories to PATH (via Control Panel > System >
@ -91,25 +90,19 @@ portable version you should observe the following install steps.*
ez_setup.py for Setuptools ez_setup.py for Setuptools
<https://pypi.python.org/pypi/setuptools/#installation-instructions>`_. <https://pypi.python.org/pypi/setuptools/#installation-instructions>`_.
2. Setup a virtual environment with Virtual Python Environment builder 2. Setup a virtual Python environment using the virtual environment (venv)
(optional) package for Python (optional)
You can setup a virtual environment to install OpenSlides as non-root You can setup a virtual Python environment to install OpenSlides as
user. Make sure that you have installed Virtual Python Environment non-root user.
builder on your system.
To install latest Virtual Python Environment builder, open command line (cmd)
and run::
> easy_install https://pypi.python.org/packages/source/v/virtualenv/virtualenv-x.y.z.tar.gz
Create your OpenSlides directory, change to it, setup and activate the Create your OpenSlides directory, change to it, setup and activate the
virtual environment:: virtual environment::
> md OpenSlides > md OpenSlides
> cd OpenSlides > cd OpenSlides
> virtualenv .virtualenv > python -m venv .virtualenv
> .virtualenv\Scripts\activate > .virtualenv\Scripts\activate.bat
3. Install OpenSlides 3. Install OpenSlides
@ -117,9 +110,9 @@ portable version you should observe the following install steps.*
<http://openslides.org/download/>`_. Download latest OpenSlides release <http://openslides.org/download/>`_. Download latest OpenSlides release
as compressed tar archive and run:: as compressed tar archive and run::
> easy_install openslides-x.x.tar.gz > pip install openslides-x.x.tar.gz
OpenSlides will install all required python packages (see OpenSlides will install all required Python packages (see
requirements_production.txt). requirements_production.txt).
@ -130,15 +123,15 @@ To start OpenSlides simply run on command line::
openslides openslides
If you run this command the first time, a new database and the admin account If you run this command the first time, a new database and the admin
(Username: `admin`, Password: `admin`) will be created. Please change the password account (Username: `admin`, Password: `admin`) will be created. Please
after first login! change the password after first login!
OpenSlides will start using the integrated Tornado webserver. It will also OpenSlides will start using the integrated Tornado webserver. It will also
try to open the webinterface in your default webbrowser. The server will try to open the webinterface in your default webbrowser. The server will
try to listen on the local ip address on port 8000. That means that the server try to listen on the local ip address on port 8000. That means that the
will be available to everyone on your local network (at least for commonly used server will be available to everyone on your local network (at least for
network configurations). commonly used network configurations).
If you use a virtual environment (see install instructions, step 2), do not If you use a virtual environment (see install instructions, step 2), do not
forget to activate the environment before restart after you have closed the forget to activate the environment before restart after you have closed the
@ -184,10 +177,10 @@ Installation and start of the development version
git clone https://github.com/OpenSlides/OpenSlides.git git clone https://github.com/OpenSlides/OpenSlides.git
cd OpenSlides cd OpenSlides
3. Setup and activate a virtual environment with Virtual Python Environment 3. Setup a virtual Python environment using the virtual environment (venv)
builder (optional) package for Python (optional)
Follow step 2 in the correspondent instruction in section III. See step 2 in the correspondent instruction in section III.
4. Install all required Python packages:: 4. Install all required Python packages::
@ -228,6 +221,11 @@ Installation and start of the development version
python manage.py --help python manage.py --help
Later you might want to start the server with the following command to
avoid opening new browser windows::
python manage.py runserver
VI. Used software VI. Used software
================= =================