source: main/waeup.sirp/trunk/docs/source/userdocs/install_on_windows.rst @ 6270

Installing waeup.sirp on Windows (XP, 2000, Vista, 7)
*****************************************************

**Step 1.** Install Python. Currently, version 2.6.x and version 2.5.x are supported.
Note that these links point to installers for the ordinary x86 processor architecture.
We recommend to download the follwoing software and install into 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 (see instruction below).

**Step 3**. Open up a command window and change to the folder where you want to place the sandbox
that will contain your SIRP project. In this HowTo we will assume 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 winsirp

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

 C:\> cd winsirp
 C:\winsirp> Scripts\activate

Note that the system prompt has changed.

**Step 7**. Copy the ``waeup.sirp`` folder into ``C:\winsirp``.

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

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

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

 C:\winsirp\waeup.sirp> bin\buildout.exe -c buildout-windows.cfg

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

 (winsirp) C:\winsirp\waeup.sirp> ..\Scripts\deactivate

**Step 11**. Start your SIRP::

 C:\winsirp\waeup.sirp> bin\paster serve parts\etc\deploy.ini

or from anywhere in your system::

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

**Step 12**. Visit the SIRP website and creata your university instance:

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

Change system path in Windows (XP, 2000, Vista, 7)
--------------------------------------------------

**Step 1**. 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.)

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

**Step 3**. Click the Advanced tab or "Advanced system settings" on Windows Vista or Windows 7

**Step 4**. Click the Environment Variables button.

**Step 5**. 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.

**Step 6**. Reboot Windows