liquid_feedback_frontend: 701a5cf6b067 INSTALL.mkd

liquid_feedback_frontend

view INSTALL.mkd @ 1045:701a5cf6b067

Imported LiquidFeedback Frontend 3.0 branch

author	bsw
date	Thu Jul 10 01:19:48 2014 +0200 (2014-07-10)
parents
children	b9300c2e75da

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 * lua5.1

15 * postgresql

16 * build-essential

17 * libpq-dev

18 * liblua5.1-0-dev

19 * lighttpd

20 * ghc

21 * libghc6-parsec3-dev

22 * imagemagick

23 * exim4

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 Whichever useraccount is used by the webserver (usually `www-data`) needs to

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

34 PostgreSQL's shell command `createuser` as database superuser (usually `pgsql`,

35 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 WebMCP

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

99 Note: Using Debian, it may be necessary to append `-I /usr/include/lua5.1` at