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" =&gt; "/usr/bin/lua5.1" )
    1.47 -
    1.48 -alias.url += ( "/lf/fastpath/" =&gt; "/opt/liquid_feedback_frontend/fastpath/",
    1.49 -               "/lf/static"    =&gt; "/opt/liquid_feedback_frontend/static",
    1.50 -               "/lf"           =&gt; "/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" =&gt; "en_US.UTF-8",
    1.56 -    "WEBMCP_APP_BASEPATH" =&gt; "/opt/liquid_feedback_frontend/",
    1.57 -    "WEBMCP_CONFIG_NAME"  =&gt; "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/(.*)$" =&gt; "/lf/fastpath/$1",
    1.64 -      "^/lf/static/(.*)$"   =&gt; "/lf/static/$1",
    1.65 -
    1.66 -  # dynamic URLs
    1.67 -      "^/lf/([^\?]*)(\?(.*))?$" =&gt; "/lf/webmcp-wrapper.lua?_webmcp_path=$1&amp;$3",
    1.68 -
    1.69 -)
    1.70 -
    1.71 -$HTTP["url"] =~ "^/lf/fastpath/" {
    1.72 -  cgi.assign = ( "" =&gt; "" )
    1.73 -  setenv.add-response-header = ( "Cache-Control" =&gt; "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

Impressum / About Us