| 1 | WAeUP Sampleuni |
|---|
| 2 | ############### |
|---|
| 3 | |
|---|
| 4 | `kofacustom.sampleuni` (further referred to as Sampleuni) is a Python package |
|---|
| 5 | providing a student information portal based on WAeUP.Kofa. It is a skeleton |
|---|
| 6 | package which can be used to create customized versions of Kofa. |
|---|
| 7 | |
|---|
| 8 | For generic install instructions please see |
|---|
| 9 | |
|---|
| 10 | http://kofa-doc.waeup.org/userdocs/install.html |
|---|
| 11 | |
|---|
| 12 | |
|---|
| 13 | Quick Install on Ubuntu 14.04 or 16.04 |
|---|
| 14 | ************************************** |
|---|
| 15 | |
|---|
| 16 | If you want to install Sampleuni on a running Ubuntu system, the |
|---|
| 17 | following quick steps might be sufficient:: |
|---|
| 18 | |
|---|
| 19 | ## install neccessary system packages as superuser |
|---|
| 20 | $ sudo apt-get update && apt-get install -y # update system |
|---|
| 21 | $ sudo apt-get install python2.7-dev libxml2-dev libxslt1-dev zlib1g-dev python-virtualenv libssl-dev libffi-dev libjpeg-dev libfreetype6-dev libtiff-dev libopenjpeg-dev |
|---|
| 22 | $ sudo ln -s /usr/include/freetype2 /usr/include/freetype2/freetype |
|---|
| 23 | |
|---|
| 24 | ## unpack sources as regular user (probably already done if you |
|---|
| 25 | ## read this README) |
|---|
| 26 | $ tar xzf waeup.sampleuni |
|---|
| 27 | $ cd waeup.sampleuni |
|---|
| 28 | |
|---|
| 29 | ## create python sandbox and build kofa |
|---|
| 30 | $ virtualenv py27 |
|---|
| 31 | $ source py27/bin/activate |
|---|
| 32 | $ pip install --upgrade pip |
|---|
| 33 | $ python bootstrap.py |
|---|
| 34 | $ ./bin/buildout |
|---|
| 35 | |
|---|
| 36 | To run Sampleuni, now do:: |
|---|
| 37 | |
|---|
| 38 | ## startup Kofa in foreground (recommended for first start) |
|---|
| 39 | $ ./bin/kofactl fg |
|---|
| 40 | ## press CTRL-D to stop the kofa server |
|---|
| 41 | |
|---|
| 42 | ## startup Kofa in background |
|---|
| 43 | $ ./bin/kofactl start |
|---|
| 44 | $ ./bin/kofactl status # check status, running or not |
|---|
| 45 | $ ./bin/kofactl stop # stop running instance (also 'restart' possible) |
|---|
| 46 | |
|---|
| 47 | When Sampleuni is running, you can access the portal on port 8080. Open |
|---|
| 48 | |
|---|
| 49 | http://localhost:8080/ |
|---|
| 50 | |
|---|
| 51 | and enter the credentials (username 'grok', password 'grok' by |
|---|
| 52 | default) and name and add a `University`. |
|---|
| 53 | |
|---|
| 54 | Congratulations, you got Sampleuni running. |
|---|
