Installation of a local planop on windows

A Windows installer containing all the necessary dependencies is available on the planop site.

With the instructions below, you can do the same installation manually.

The examples assume you download the necessary files into a folder called C:\Downloads.

1. python

Install python 2.X using a windows installer, which you can find on the python website, eg: python-2.7.3.msi.

The examples in this document assume you installed python 2.7 into the folder C:\planop\Python27.

2. setup tools and pip

To install our packages, we need easy_install, which is part of the setuptools package and pip.

Download the setuptools package for your python version on windows and install it. e.g.:

setuptools-0.6c11.win32-py2.7.exe

Download the latest pip package to C:\Downloads and install it with the following command:

C:\planop\Python27\Scripts\easy_install C:\Downloads\pip-1.2.1.tar.gz

3. optional: wxPython and pyWin32

These two packages are only required if you intend to use the planop 2 conversion program.

Download the packages for your python version from the wxPython and pyWin32 websites. e.g.:

wxPython2.8-win32-unicode-2.8.12.1-py27.exe

pywin32-216.win32-py2.7.exe

4. Python Imaging Library and Reportlab

We will need to install the Python imaging library (PIL).

Download the correct package for your python version and install it. e.g.:

PIL-1.1.7.win32-py2.7.exe

We also need Reportlab:

reportlab-2.5.win32-py2.7.exe

5. planop

Part A of these instructions assumes you have an internet connection available to download the necessary dependencies. In part B we demonstrate how to install without internet connection.

A. Internet connection available

Download planopwin-3.1.zip to C:\Downloads.

To install planop and its dependencies:

C:\planop\Python27\Scripts\pip install C:\Downloads\planopwin-3.1.x.zip

B. No internet connection available

Download the following packages:

Install the dependencies:

C:\planop\Python27\Scripts\pip install C:\Downloads\html5lib-0.90.zip
C:\planop\Python27\Scripts\pip install C:\Downloads\pyPdf-1.13.tar.gz
C:\planop\Python27\Scripts\pip install C:\Downloads\Django-1.4.2.tar.gz
C:\planop\Python27\Scripts\pip install C:\Downloads\South-0.7.6.tar.gz
C:\planop\Python27\Scripts\pip install C:\Downloads\CherryPy-3.2.2.tar.gz
C:\planop\Python27\Scripts\pip install C:\Downloads\Markdown-2.2.0.tar.gz

and finally planop:

C:\planop\Python27\Scripts\pip install C:\Downloads\planopwin-3.1.x.zip

6. Planop configuration

Go to the planop base folder:

cd C:\planop\Python27\Lib\site-packages\planop

Create the local configuration file:

copy local_settings.py.template local_settings.py

Now edit the local settings file:

notepad local_settings.py

Edit the configuration as needed. You can probably leave the database configuration to its default setting.

7. Creating the database

After you configured your database, you can create the necessary database tables:

C:\planop\Python27\python manage.py createdb configs/auth_groups.json

Now prepare the static files:

python manage.py collectstatic

8. Create a superuser

You should create a user that has admin rights on your planop installation and that you can use to login to planop the first time:

C:\planop\Python27\python manage.py createsuperuser

You can create extra users and manage their permissions via the planop application.

9. Import the suggestion lists

Download the file with the suggestion lists from the planop website.

You can import these suggestion lists with the following command:

C:\planop\Python27\python manage.py loaddata C:\Downloads\planop3_sl_1.0.2_nl.json

10. Convert planop 2 data

You can convert data from your planop 2 application into your new planop 3 databae with the following command. This assumes you installed wxPython and pyWin32 in step 3:

C:\planop\Python27\python manage.py winconvert

11. Starting the webserver

You can start the local webserver like this:

C:\planop\Python27\python manage.py runcpserver

You should be able to access your planop installation in your webbrowser at the url:

http://127.0.0.1:8000/

You will not be able to use the emailing features of planop in this installation.

You may create a shortcut to start your local planop webserver using the following command:

C:\planop\Python27\python C:\planop\Python27\Lib\site-packages\planop\manage.py runcpserver