Changeset 13829 for main


Ignore:
Timestamp:
11 Apr 2016, 10:39:08 (9 years ago)
Author:
uli
Message:

Add quick install guide.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • main/waeup.kofa/trunk/docs/INSTALL.txt

    r13826 r13829  
    1717
    1818.. _prerequisites:
     19
     20
     21Quick Install on Ubuntu 14.04
     22*****************************
     23
     24If you want to install Kofa on a running Ubuntu 14.04 system, the
     25following quick steps might be sufficient::
     26
     27  ## install neccessary system packages as superuser
     28  $ sudo apt-get update && apt-get install -y  # update system
     29  $ 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
     30  $ sudo ln -s /usr/include/freetype2 /usr/include/freetype2/freetype
     31
     32  ## get sources as regular user
     33  $ wget https://pypi.python.org/packages/source/w/waeup.kofa/waeup.kofa-1.4.1.tar.gz && tar -xzf waeup.kofa-1.4.1.tar.gz
     34  $ cd waeup.kofa-1.4.1
     35
     36  ## create python sandbox and build kofa
     37  $ virtualenv py27
     38  $ source py27/bin/activate
     39  $ pip install --upgrade pip
     40  $ python bootstrap.py
     41  $ ./bin/buildout
     42
     43To run Kofa, now do::
     44
     45  ## startup Kofa in foreground (recommended for first start)
     46  $ ./bin/kofactl fg
     47  ## press CTRL-D to stop the kofa server
     48
     49  ## startup Kofa in background
     50  $ ./bin/kofactl start
     51  $ ./bin/kofactl status  # check status, running or not
     52  $ ./bin/kofactl stop    # stop running instance (also 'restart' possible)
     53
     54When Kofa is running, you can access the portal on port 8080. Open
     55
     56  http://localhost:8080/
     57
     58and enter the credentials (username 'grok', password 'grok' by
     59default) and name and add a `University`.
     60
     61Congratulations, you got Kofa running.
     62
    1963
    2064Prerequisites
     
    2771Both, Grok_ and Zope_, are written in the `Python`_ programming
    2872language (with parts written in C). You therefore have to have
    29 `Python`_ installed (including `Python`_ headers).
     73`Python`_ installed (including `Python`_ headers) in version 2.7
     74(Python 3.x is currently not supported).
    3075
    3176
Note: See TracChangeset for help on using the changeset viewer.