source: main/waeup.kofa/branches/0.2/docs/INSTALLWIN.txt @ 17952

Installation on Windows (XP, 2000, Vista, 7)
********************************************

.. note:: `waeup.kofa` has been developed to run on Linux servers,
          preferarbly with an Ubuntu OS. The installation on Windows computers
          is for demonstration purposes only.

Install Python
==============

**Step 1.** Install Python. Currently, version 2.6.x is supported.
Note that these links point to installers for the ordinary x86 processor architecture.
We recommend to download the follwoing software and install into ``C:\Python26``:

| http://www.python.org/ftp/python/2.6.0/python-2.6.0.msi
| http://sourceforge.net/project/downloading.php?group_id=78018&filename=pywin32-213.win32-py2.6.exe
| http://pypi.python.org/packages/2.6/s/setuptools/setuptools-0.6c11.win32-py2.6.exe

**Step 2**. Add ``C:\Python26\Scripts\`` to your system path:

- Right-click on the My Computer icon. (Under Windows XP, Vista, or Windows 7, the My Computer Icon may be located in the start menu.)

- Choose Properties from the context menu. Alternatively, you can double-click on the System icon in the Control Panel.

- Click the Advanced tab or "Advanced system settings" on Windows Vista or Windows 7

- Click the Environment Variables button.

- Click on the variable called 'Path' and then click on Edit. Now add ``C:\Python26\Scripts\`` to the value of the variable, using a semi-colon as a separator.

- Reboot Windows

Install a Virtual Python Environment
====================================

**Step 3**. Open up a command window and change to the folder where you want to place the sandbox
that will contain your Kofa project. In this HowTo we will assume and recommend this folder is ``C:\`` ::

  C:\[any_path]> cd c:\

**Step 4**. Install virtualenv by using the command::

 C:\> easy_install virtualenv

**Step 5**. Create an isolated environment (sandbox) using the command::

 C:\> virtualenv winkofa

**Step 6**. Activate the environment::

 C:\> cd winkofa
 C:\winkofa> Scripts\activate

Note that the system prompt has changed.

Run Kofa
========

**Step 7**. Copy the ``waeup.kofa`` folder into ``C:\winkofa``.

**Step 8**. Run the bootstrap script::

 (winkofa) C:\winkofa\waeup.kofa> cd waeup.kofa
 (winkofa) C:\winkofa\waeup.kofa> python bootstrap\bootstrap.py -c buildout-windows.cfg

**Step 9**. Run buildout (this takes a while)::

 C:\winkofa\waeup.kofa> bin\buildout.exe -c buildout-windows.cfg

**Step 10**. You can deactivate your environment again::

 (winkofa) C:\winkofa\waeup.kofa> ..\Scripts\deactivate

**Step 11**. Remove beaker from C:\winkofa\waeup.kofa\src\waeup\kofa\configure.zcml.

**Step 12**. Start your Kofa::

 C:\winkofa\waeup.kofa> bin\paster serve parts\etc\deploy.ini

or from anywhere in your system::

 C:\[any_path]> C:\winkofa\trunk\bin\paster serve C:\winkofa\trunk\parts\etc\deploy.ini

**Step 13**. Visit the Kofa website and create your university instance:

| http://localhost:8080
| user name: grok
| password: grok