liquid_feedback_frontend
diff INSTALL.html @ 1244:ae9812d9f653
Updated documentation (removed WebMCP 1.x support)
author | jbe |
---|---|
date | Mon Dec 21 12:21:52 2015 +0100 (2015-12-21) |
parents | 5f9cf5a1d12f |
children | 78d3be54cfe0 |
line diff
1.1 --- a/INSTALL.html Mon Dec 14 17:54:06 2015 +0100 1.2 +++ b/INSTALL.html Mon Dec 21 12:21:52 2015 +0100 1.3 @@ -19,8 +19,7 @@ 1.4 <li>liblua5.2-dev</li> 1.5 <li>postgresql</li> 1.6 <li>libpq-dev</li> 1.7 -<li>lighttpd (only for WebMCP 1.2.x support)</li> 1.8 -<li>pmake or bmake (only for WebMCP 2.x with Moonbridge)</li> 1.9 +<li>pmake or bmake</li> 1.10 <li>imagemagick</li> 1.11 <li>exim4</li> 1.12 <li>markdown2 (<code>apt-get install python-pip; pip install markdown2</code>)</li> 1.13 @@ -92,7 +91,7 @@ 1.14 <pre><code>exit 1.15 </code></pre> 1.16 1.17 -<h2>4. Install Moonbridge (only for WebMCP 2.x)</h2> 1.18 +<h2>4. Install Moonbridge</h2> 1.19 1.20 <pre><code># Download and unpack Moonbridge 1.21 # from http://www.public-software-group.org/pub/projects/moonbridge/ 1.22 @@ -130,77 +129,19 @@ 1.23 <pre><code>chown www-data /opt/liquid_feedback_frontend/tmp 1.24 </code></pre> 1.25 1.26 -<p>Compile binary for fast delivery of member images (only necessary for WebMCP 1.2.x):</p> 1.27 - 1.28 -<pre><code>cd /opt/liquid_feedback_frontend/fastpath 1.29 -vi getpic.c # check and modify #define commands as necessary 1.30 -make 1.31 -</code></pre> 1.32 - 1.33 <h2>7. Configure mail system</h2> 1.34 1.35 <p>It may be necessary to configure your server's mail system, e.g. running 1.36 <code>dpkg-reconfigure exim4-config</code> on a Debian system.</p> 1.37 1.38 -<h2>8. Configure the Webserver for LiquidFeedback (only for WebMCP 1.2.x)</h2> 1.39 - 1.40 -<p>A sample configuration for <code>lighttpd</code> is given below (assuming <code>mod_alias</code> has 1.41 -been included elsewhere):</p> 1.42 - 1.43 -<pre><code>server.modules += ("mod_cgi", "mod_rewrite", "mod_redirect", "mod_setenv") 1.44 - 1.45 -# Enable CGI-Execution of *.lua files through lua binary 1.46 -cgi.assign += ( ".lua" => "/usr/bin/lua5.1" ) 1.47 - 1.48 -alias.url += ( "/lf/fastpath/" => "/opt/liquid_feedback_frontend/fastpath/", 1.49 - "/lf/static" => "/opt/liquid_feedback_frontend/static", 1.50 - "/lf" => "/opt/webmcp/cgi-bin" ) 1.51 - 1.52 -# Configure environment for demo application 1.53 -$HTTP["url"] =~ "^/lf" { 1.54 - setenv.add-environment += ( 1.55 - "LANG" => "en_US.UTF-8", 1.56 - "WEBMCP_APP_BASEPATH" => "/opt/liquid_feedback_frontend/", 1.57 - "WEBMCP_CONFIG_NAME" => "myconfig") 1.58 -} 1.59 - 1.60 -# URL beautification 1.61 -url.rewrite-once += ( 1.62 - # do not rewrite static URLs 1.63 - "^/lf/fastpath/(.*)$" => "/lf/fastpath/$1", 1.64 - "^/lf/static/(.*)$" => "/lf/static/$1", 1.65 - 1.66 - # dynamic URLs 1.67 - "^/lf/([^\?]*)(\?(.*))?$" => "/lf/webmcp-wrapper.lua?_webmcp_path=$1&$3", 1.68 - 1.69 -) 1.70 - 1.71 -$HTTP["url"] =~ "^/lf/fastpath/" { 1.72 - cgi.assign = ( "" => "" ) 1.73 - setenv.add-response-header = ( "Cache-Control" => "private; max-age=86400" ) 1.74 -} 1.75 -</code></pre> 1.76 - 1.77 -<p>If you're using Debian, you may want to create a file with the name 1.78 -<code>/etc/lighttpd/conf-available/60-liquidfeedback.conf</code> and create a softlink in 1.79 -<code>/etc/lighttpd/conf-enabled/</code>.</p> 1.80 - 1.81 -<h2>9. Configure the LiquidFeedback-Frontend</h2> 1.82 +<h2>8. Configure the LiquidFeedback-Frontend</h2> 1.83 1.84 <pre><code>cd /opt/liquid_feedback_frontend/config 1.85 cp example.lua myconfig.lua 1.86 # edit myconfig.lua according to your needs 1.87 </code></pre> 1.88 1.89 -<p>Use the following option in your configuration file to enable fast image 1.90 -loading (only for WebMCP 1.2.x):</p> 1.91 - 1.92 -<pre><code>config.fastpath_url_func = function(member_id, image_type) 1.93 - return request.get_absolute_baseurl() .. "fastpath/getpic?" .. tostring(member_id) .. "+" .. tostring(image_type) 1.94 -end 1.95 -</code></pre> 1.96 - 1.97 -<h2>10. Setup regular execution of <code>lf_update</code> and related commands </h2> 1.98 +<h2>9. Setup regular execution of <code>lf_update</code> and related commands </h2> 1.99 1.100 <p>The executables <code>lf_update</code>, <code>lf_update_issue_order</code>, and 1.101 <code>lf_update_suggestion_order</code> must be executed regularly. This may be achieved 1.102 @@ -234,24 +175,12 @@ 1.103 1.104 <p>And this file should be started automatically at system boot.</p> 1.105 1.106 -<h2>11. Setup notification loop in background (only for WebMCP 1.2.x)</h2> 1.107 - 1.108 -<p>In addition to regular execution of <code>lf_update</code> and 1.109 -<code>lf_update_suggestion_order</code>, the following commands should be executed in 1.110 -background:</p> 1.111 +<h2>10. Start the system</h2> 1.112 1.113 -<pre><code>su www-data -s $SHELL 1.114 -cd /opt/liquid_feedback_frontend/ 1.115 -echo "Event:send_notifications_loop()" | ../webmcp/bin/webmcp_shell myconfig 1.116 -</code></pre> 1.117 +<p>After <code>lf_update</code> has been executed at least once, you should be able to use 1.118 +your LiquidFeedback system.</p> 1.119 1.120 -<h2>12. Start the system</h2> 1.121 - 1.122 -<p>After <code>lf_update</code> has been executed at least once and (in case of WebMCP 1.2.x) 1.123 -the webserver has been restarted (using the configuration above), you should be 1.124 -able to access your LiquidFeedback system.</p> 1.125 - 1.126 -<p>If you use WebMCP 2.x, the server is started by calling:</p> 1.127 +<p>The server is started by calling:</p> 1.128 1.129 <pre><code>su www-data -s $SHELL 1.130 /opt/moonbridge/moonbridge /opt/webmcp/bin/mcp.lua /opt/webmcp/ /opt/liquid_feedback_frontend/ main myconfig