liquid_feedback_frontend: 9700ce0d5541 INSTALL.mkd

liquid_feedback_frontend

view INSTALL.mkd @ 1190:9700ce0d5541

Update installation instructions regarding Moonbridge command line options; Typo in heading of installation instructions fixed

author	jbe
date	Sun Mar 29 20:31:32 2015 +0200 (2015-03-29)
parents	17b1456d0262
children	8259fb540324

line source

1 LiquidFeedback Installation Instructions

2 ========================================

4 This document gives a short outline about the necessary steps to setup a

5 LiquidFeedback system.

8 1. Install necessary dependencies

9 ---------------------------------

11 If you're using a Debian system, make sure that the following packages are

12 installed:

14 * build-essential

15 * lua5.2

16 * liblua5.2-dev

17 * postgresql

18 * libpq-dev

19 * lighttpd (only for WebMCP 1.2.x support)

20 * pmake or bmake (only for WebMCP 2.x with Moonbridge)

21 * imagemagick

22 * exim4

23 * markdown2 (install with Python's pip)

25 If you're using any other Linux distribution or BSD system, install the

26 necessary software components accordingly.

29 2. Ensure that the user account of your webserver has access to the database

30 ----------------------------------------------------------------------------

32 The useraccount of the webserver (usually `www-data`) or the Moonbridge server

33 process needs to have access to your PostgreSQL installation. This is done by

34 executing PostgreSQL's shell command `createuser` as database superuser

35 (usually `pgsql`, or `postgres` for Debian installations):

37 su - postgres

38 createuser

40 Enter name of role to add: www-data

41 Shall the new role be a superuser? (y/n) n

42 Shall the new role be allowed to create databases? (y/n) y

43 Shall the new role be allowed to create more new roles? (y/n) n

45 exit

48 3. Install and configure LiquidFeedback-Core

49 --------------------------------------------

51 We recommend to create the database with the same user as your webserver

52 (usually `www-data`) to avoid having to setup database privileges.

54 The example below installs the database as `www-data` and stores the two

55 executables `lf_update` and `lf_update_issue_order` in the directory

56 `/opt/liquid_feedback_core/`:

58 # Download and unpack LiquidFeedback-Core

59 # from http://www.public-software-group.org/pub/projects/liquid_feedback/backend/

60 make

61 mkdir /opt/liquid_feedback_core

62 cp core.sql lf_update lf_update_issue_order /opt/liquid_feedback_core

63 su - www-data

64 cd /opt/liquid_feedback_core

65 createdb liquid_feedback

66 createlang plpgsql liquid_feedback # command may be omitted, depending on PostgreSQL version

67 psql -v ON_ERROR_STOP=1 -f core.sql liquid_feedback

69 A simple configuration may look as follows:

71 psql liquid_feedback

73 INSERT INTO system_setting (member_ttl) VALUES ('1 year');

74 INSERT INTO contingent (polling, time_frame, text_entry_limit, initiative_limit) VALUES (false, '1 hour', 20, 6);

75 INSERT INTO contingent (polling, time_frame, text_entry_limit, initiative_limit) VALUES (false, '1 day', 80, 12);

76 INSERT INTO contingent (polling, time_frame, text_entry_limit, initiative_limit) VALUES (true, '1 hour', 200, 60);

77 INSERT INTO contingent (polling, time_frame, text_entry_limit, initiative_limit) VALUES (true, '1 day', 800, 120);

78 INSERT INTO policy (index, name, admission_time, discussion_time, verification_time, voting_time, issue_quorum_num, issue_quorum_den, initiative_quorum_num, initiative_quorum_den) VALUES (1, 'Default policy', '8 days', '15 days', '8 days', '15 days', 10, 100, 10, 100);

79 INSERT INTO unit (name) VALUES ('Our organization');

80 INSERT INTO area (unit_id, name) VALUES (1, 'Default area');

81 INSERT INTO allowed_policy (area_id, policy_id, default_policy) VALUES (1, 1, TRUE);

83 If you want to create an admin user with an empty password (CAUTION!), then execute the following SQL statement:

85 INSERT INTO member (login, name, admin, password) VALUES ('admin', 'Administrator', TRUE, '$1$/EMPTY/$NEWt7XJg2efKwPm4vectc1');

87 Exit the `psql` interface by typing:

89 \q

91 And don't forget to quit the `www-data` shell:

93 exit

96 4. Install Moonbridge (only for WebMCP 2.x)

97 -------------------------------------------

99 # Download and unpack Moonbridge