1 | Installation on Windows (XP, 2000, Vista, 7) |
---|
2 | ******************************************** |
---|
3 | |
---|
4 | .. note:: `waeup.kofa` has been developed to run on Linux servers, |
---|
5 | preferarbly with an Ubuntu OS. The installation on Windows computers |
---|
6 | is for demonstration purposes only. |
---|
7 | |
---|
8 | Install Python |
---|
9 | ============== |
---|
10 | |
---|
11 | **Step 1.** Install Python. Currently, version 2.6.x is supported. |
---|
12 | Note that these links point to installers for the ordinary x86 processor architecture. |
---|
13 | We recommend to download the follwoing software and install into ``C:\Python26``: |
---|
14 | |
---|
15 | | http://www.python.org/ftp/python/2.6.0/python-2.6.0.msi |
---|
16 | | http://sourceforge.net/project/downloading.php?group_id=78018&filename=pywin32-213.win32-py2.6.exe |
---|
17 | | http://pypi.python.org/packages/2.6/s/setuptools/setuptools-0.6c11.win32-py2.6.exe |
---|
18 | |
---|
19 | **Step 2**. Add ``C:\Python26\Scripts\`` to your system path: |
---|
20 | |
---|
21 | - 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.) |
---|
22 | |
---|
23 | - Choose Properties from the context menu. Alternatively, you can double-click on the System icon in the Control Panel. |
---|
24 | |
---|
25 | - Click the Advanced tab or "Advanced system settings" on Windows Vista or Windows 7 |
---|
26 | |
---|
27 | - Click the Environment Variables button. |
---|
28 | |
---|
29 | - 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. |
---|
30 | |
---|
31 | - Reboot Windows |
---|
32 | |
---|
33 | Install a Virtual Python Environment |
---|
34 | ==================================== |
---|
35 | |
---|
36 | **Step 3**. Open up a command window and change to the folder where you want to place the sandbox |
---|
37 | that will contain your Kofa project. In this HowTo we will assume and recommend this folder is ``C:\`` :: |
---|
38 | |
---|
39 | C:\[any_path]> cd c:\ |
---|
40 | |
---|
41 | **Step 4**. Install virtualenv by using the command:: |
---|
42 | |
---|
43 | C:\> easy_install virtualenv |
---|
44 | |
---|
45 | **Step 5**. Create an isolated environment (sandbox) using the command:: |
---|
46 | |
---|
47 | C:\> virtualenv winkofa |
---|
48 | |
---|
49 | **Step 6**. Activate the environment:: |
---|
50 | |
---|
51 | C:\> cd winkofa |
---|
52 | C:\winkofa> Scripts\activate |
---|
53 | |
---|
54 | Note that the system prompt has changed. |
---|
55 | |
---|
56 | Run Kofa |
---|
57 | ======== |
---|
58 | |
---|
59 | **Step 7**. Copy the ``waeup.kofa`` folder into ``C:\winkofa``. |
---|
60 | |
---|
61 | **Step 8**. Run the bootstrap script:: |
---|
62 | |
---|
63 | (winkofa) C:\winkofa\waeup.kofa> cd waeup.kofa |
---|
64 | (winkofa) C:\winkofa\waeup.kofa> python bootstrap\bootstrap.py -c buildout-windows.cfg |
---|
65 | |
---|
66 | **Step 9**. Run buildout (this takes a while):: |
---|
67 | |
---|
68 | C:\winkofa\waeup.kofa> bin\buildout.exe -c buildout-windows.cfg |
---|
69 | |
---|
70 | **Step 10**. You can deactivate your environment again:: |
---|
71 | |
---|
72 | (winkofa) C:\winkofa\waeup.kofa> ..\Scripts\deactivate |
---|
73 | |
---|
74 | **Step 11**. Start your Kofa:: |
---|
75 | |
---|
76 | C:\winkofa\waeup.kofa> bin\paster serve parts\etc\deploy.ini |
---|
77 | |
---|
78 | or from anywhere in your system:: |
---|
79 | |
---|
80 | C:\[any_path]> C:\winkofa\trunk\bin\paster serve C:\winkofa\trunk\parts\etc\deploy.ini |
---|
81 | |
---|
82 | **Step 12**. Visit the Kofa website and create your university instance: |
---|
83 | |
---|
84 | | http://localhost:8080 |
---|
85 | | user name: grok |
---|
86 | | password: grok |
---|
87 | |
---|