1

2 ################

3 # Installation #

4 ################

5

6

7 1. Choose a directory where to install the software, e.g. /opt :

8

9 $ cd /opt

10

11

12 2. Get the repositories of the core, the frondend and the web application

13 framework WebMCP:

14

15 $ hg clone http://www.public-software-group.org/mercurial/liquid_feedback_core

16 $ hg clone http://www.public-software-group.org/mercurial/liquid_feedback_frontend

17 $ hg clone http://www.public-software-group.org/mercurial/webmcp

18

19

20 3. Install LiquidFeedback Core:

21

22 $ cd /opt/liquid_feedback_core

23 $ make

24 $ createdb liquid_feedback

25 $ psql -v ON_ERROR_STOP=1 -f core.sql liquid_feedback

26

27 You should initiatize your database using the command

28 "psql liquid_feedback" and the examples shown in file "init.sql".

29

30

31 4. Compile WebMCP

32

33 $ cd /opt/webmcp

34 $ make

35

36 If you experience trouble during compilation, you might want to edit the

37 file "Makefile.options" (i.e. to add -fPIC to compiler options) and then

38 retry:

39

40 $ vi Makefile.options

41 $ make clean

42 $ make

43

44

45 5. Install Wiki-to-HTML converters

46

47 Download latest LiquidFeedback Edition of RocketWiki from

48 http://www.public-software-group.org/pub/projects/rocketwiki/liquid_feedback_edition/

49

50 Compile the binaries by calling make, and copy them to a place of your

51 choice, e.g. /opt/rocketwiki-lqfb/

52

53

54 6. Configure the webserver and the LiquidFeedback Frontend application:

55

56 Edit the configuration files in /opt/liquid_feedback_frontend/config/

57

58 Use /opt/webmcp/doc/lighttpd.example.conf (or apache.sample.conf) to setup

59 your webserver appropriatly.

60

61

62 7. Compile help messages from wiki to html

63

64 cd /opt/liquid_feedback_frontend/locale/

65 make

66

67 or by hand:

68

69 for file in *.txt; do /opt/rocketwiki-lqfb/rocketwiki-lqfb < $file > $file.html; done

70

71

72