[www] branch master updated: add OpenWrt install guide

[gnunet]

This is an automated email from the git hooks/post-receive script.

daniel-golle pushed a commit to branch master
in repository www.

The following commit(s) were added to refs/heads/master by this push:
     new 6b211fb  add OpenWrt install guide
6b211fb is described below

commit 6b211fb9598f48b93f5ca23ce7523c06a778b2be
Author: Daniel Golle <address@hidden>
AuthorDate: Sat Dec 28 19:04:01 2019 +0200

    add OpenWrt install guide
---
 static/images/openwrt-logo.svg      |   8 +++
 template/install-on-openwrt.html.j2 | 117 ++++++++++++++++++++++++++++++++++++
 template/install.html.j2            |   2 +
 3 files changed, 127 insertions(+)

diff --git a/static/images/openwrt-logo.svg b/static/images/openwrt-logo.svg
new file mode 100644
index 0000000..f25e9b3
--- /dev/null
+++ b/static/images/openwrt-logo.svg
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd";>
+<svg xmlns="http://www.w3.org/2000/svg"; version="1.1" width="400" height="92" 
viewBox="0 0 40000 9200">
+  <path fill="#A6A6A6" d="M33817 8423c0,63 8,153 50,204 30,35 64,53 110,53 
46,0 81,-16 110,-51 42,-50 49,-148 49,-210 0,-62 -7,-148 -50,-198 -29,-34 
-61,-51 -106,-51 -47,0 -83,17 -113,53 -42,50 -50,137 -50,200l0 0 0 0zm-1567 
-7c0,-55 -7,-130 -44,-174 -27,-31 -57,-45 -98,-45 -34,0 -57,14 -78,40 -35,43 
-40,138 -40,190 0,53 6,137 42,180 22,27 47,42 82,42 39,0 68,-15 93,-44 37,-44 
43,-135 43,-189l0 0zm-1774 -201c-8,-22 -19,-43 -33,-57 -29,-29 -66,-37 -106,-37 
-52,0 -90,19 -122,61 -7,10 -13,2 [...]
+  <path fill="black" d="M35108 7761l474 0 0 192c68,-80 137,-138 207,-171 
69,-34 153,-51 252,-51 106,0 189,19 251,56 62,37 112,93 151,166 80,-86 152,-145 
218,-176 66,-31 147,-47 243,-47 142,0 253,42 332,126 80,84 120,215 120,394l0 
828 -508 0 0 -753c0,-60 -12,-105 -35,-133 -34,-46 -76,-68 -126,-68 -60,0 
-108,22 -144,65 -36,43 -55,113 -55,208l0 682 -509 0 0 -726c0,-58 -3,-97 
-10,-118 -11,-33 -29,-60 -56,-80 -26,-20 -58,-30 -94,-30 -58,0 -106,22 -144,66 
-38,44 -56,116 -56,216l0 673 -509 0 0  [...]
+  <path fill="black" d="M15550 3666c-63,-42 -137,-53 -216,-53 -81,0 -144,17 
-200,53l416 0 0 0zm-5978 810c0,140 16,373 113,486 62,73 127,102 223,102 70,0 
111,-28 155,-82 87,-106 100,-414 100,-541 0,-136 -14,-392 -107,-504 -48,-58 
-92,-92 -168,-92 -90,0 -147,31 -204,99 -97,113 -112,393 -112,532zm-6887 
-820c0,294 31,778 234,1015 156,182 357,244 594,244 231,0 444,-54 597,-234 
201,-237 226,-815 226,-1106 0,-287 -34,-715 -235,-943 -160,-182 -365,-243 
-605,-243 -233,0 -422,68 -576,245 -204,237  [...]
+  <path fill="white" d="M38566 687l0 1629 907 0 0 1207 -907 0 0 1519c0,182 
18,303 53,363 54,91 150,137 286,137 122,0 293,-35 513,-105l122 1137c-409,90 
-791,134 -1146,134 -412,0 -716,-52 -911,-157 -194,-105 -338,-265 -433,-478 
-93,-214 -140,-561 -140,-1039l0 -1511 -608 0 0 -1207 608 0 0 -787 1656 -842 0 0 
0 0zm-6090 1629l1551 0 0 700c150,-305 304,-514 462,-629 160,-114 355,-171 
588,-171 246,0 513,76 803,227l-513 1167c-195,-81 -351,-121 -465,-121 -216,0 
-386,90 -505,267 -171,251 -257,721 - [...]
+</svg>
\ No newline at end of file
diff --git a/template/install-on-openwrt.html.j2 
b/template/install-on-openwrt.html.j2
new file mode 100644
index 0000000..b49104a
--- /dev/null
+++ b/template/install-on-openwrt.html.j2
@@ -0,0 +1,117 @@
+{% extends "common/base.j2" %}
+{% block body_content %}
+<article class="container">
+
+  <header>
+    <h1>{{ _("Tutorial: GNUnet on OpenWrt") }}</h1>
+  </header>
+
+  Welcome to this GNUnet tutorial for <a 
href="https://www.openwrt.org";>OpenWrt</a>.
+
+  Running on OpenWrt allows having a GNUnet node on embedded Linux systems or
+  inside a very tiny virtual machine. This tutorial shows you how to
+  install, run, and operate it.
+
+  <h2>{{ _("Installation") }}</h2>
+
+  <p>To run GNUnet in meaningful way, you will need a system with at least 16MB
+  of flash storage and at least 64MB of RAM (128MB of more recommended).</p>
+
+  <p>OpenWrt ships with up-to-date packages GNUnet, so you can install it right
+  from the OpenWrt packages repository without having to build things
+  yourself.</p>
+  <p>GNUnet has been split into a high number of small packages, allowing to 
select
+  anything between the most simple setup supporting GNS and gnunet-vpn:
+  <p><code>
+  root@OpenWrt:/# opkg update<br/>
+  ...<br/>
+  root@OpenWrt:/# opkg install gnunet gnunet-gns-flat gnunet-peerstore-flat 
gnunet-vpn gnunet-transport-tcp gnunet-transport-http_client
+  </code></p>
+  <p>...and a full blown GNUnet node for filesharing:</p>
+  <p>First of all, setup an external (USB, ...) storage volume to contain 
GNUnet's databases, see <a 
href="https://openwrt.org/docs/guide-user/storage/fstab";>OpenWrt's user guide: 
Fstab Configuration</a>.<br/>Then install PostgreSQL:</p>
+  <p><code>
+  root@OpenWrt:/# opkg update<br/>
+  ...<br/>
+  root@OpenWrt:/# opkg install pgsql-server pgsql-cli<br/>
+  ...
+  </code></p>
+  <p>Now configure PGDATA directory in /etc/config/postgresql to be located on 
your external storage volume. When restarting the postgresql init.d service you 
should see the new database directory being initialized.<br/>Then install 
GNUnet itself:</p>
+  <p><code>
+  root@OpenWrt:/# opkg install gnunet gnunet-dhtcache-pgsql gnunet-fs-pgsql 
gnunet-gns-pgsql gnunet-peerstore-flat gnunet-vpn gnunet-transport-tcp 
gnunet-transport-http_client
+  </code></p>
+
+  <p>Congrats! GNUnet is now installed!</p>
+
+  <p>Alternatively you can also use the OpenWrt ImageBuilder to generate 
ready-made images with those packages pre-installed.</p>
+
+  <h2>{{ _("Configuration") }}</h2>
+
+  <p>GNUnet's configuration is contained in OpenWrt's UCI by a simple 
translation
+  mechanism overlaying options set in UCI on GNUnet's default 
configuration.<br/>
+  In this way, only the options changed by the user are persistent in UCI.
+  Example:</p>
+  <p><code>
+  root@OpenWrt:/# uci show gnunet<br/>
+  gnunet.nse=gnunet-config<br/>
+  gnunet.nse.WORKDELAY='500 ms'<br/>
+  gnunet.dhtcache=gnunet-config<br/>
+  gnunet.dhtcache.DATABASE='postgres'<br/>
+  gnunet.datastore=gnunet-config<br/>
+  gnunet.datastore.DATABASE='postgres'<br/>
+  gnunet.namestore=gnunet-config<br/>
+  gnunet.namestore.DATABASE='postgres'<br/>
+  gnunet.namecache=gnunet-config<br/>
+  gnunet.namecache.DATABASE='postgres'<br/>
+  gnunet.peerstore=gnunet-config<br/>
+  gnunet.peerstore.DATABASE='flat'<br/>
+  gnunet.peerstore_flat=gnunet-config<br/>
+  gnunet.peerstore_flat.FILENAME='/etc/gnunet/peerstore.flat'<br/>
+  gnunet.psycstore=gnunet-config<br/>
+  gnunet.psycstore.DATABASE='postgres'<br/>
+<br/>
+  root@OpenWrt:/# uci set 
gnunet.peerstore_flat.FILENAME='/mnt/sda1/gnunet/peerstore.flat'<br/>
+  root@OpenWrt:/# uci commit gnunet<br/>
+  </code></p>
+
+  <h2>{{ _("Use") }}</h2>
+
+  <p>OpenWrt's procd runs the gnunet-arm service manager which then runs 
GNUnet services. We can list them with the -I option:</p>
+
+  <p><code>
+  root@OpenWrt:/etc# gnunet-arm -I<br/>
+  Services (excluding stopped services):<br/>
+  (started: 24 / stopped: 14 / finished: 1)<br/>
+  ats (binary='gnunet-service-ats', status=started)<br/>
+  cadet (binary='gnunet-service-cadet', status=started)<br/>
+  core (binary='gnunet-service-core', status=started)<br/>
+  datastore (binary='gnunet-service-datastore', status=started)<br/>
+  dht (binary='gnunet-service-dht', status=started)<br/>
+  fs (binary='gnunet-service-fs', status=started)<br/>
+  gns (binary='gnunet-service-gns', status=started)<br/>
+  hostlist (binary='gnunet-daemon-hostlist', status=started)<br/>
+  namecache (binary='gnunet-service-namecache', status=started)<br/>
+  namestore (binary='gnunet-service-namestore', status=started)<br/>
+  nat (binary='gnunet-service-nat', status=started)<br/>
+  nse (binary='gnunet-service-nse', status=started)<br/>
+  peerinfo (binary='gnunet-service-peerinfo', status=started)<br/>
+  peerstore (binary='gnunet-service-peerstore', status=started)<br/>
+  resolver (binary='gnunet-service-resolver', status=started)<br/>
+  rest (binary='gnunet-rest-server', status=started)<br/>
+  revocation (binary='gnunet-service-revocation', status=started)<br/>
+  rps (binary='gnunet-service-rps', status=started)<br/>
+  set (binary='gnunet-service-set', status=started)<br/>
+  statistics (binary='gnunet-service-statistics', status=started)<br/>
+  topology (binary='gnunet-daemon-topology', status=started)<br/>
+  transport (binary='gnunet-service-transport', status=started)<br/>
+  vpn (binary='gnunet-service-vpn', status=started)<br/>
+  zonemaster (binary='gnunet-service-zonemaster', status=started)<br/>
+  zonemaster-monitor (binary='gnunet-service-zonemaster-monitor', 
status=finished)<br/>
+  </code></p>
+
+  <h2>{{ _("Make sure, it works!") }}</h2>
+   <p>
+        Please head over here: <a 
href="https://gnunet.org/en/use.html";>Use!</a>
+   <p>
+
+</article>
+{% endblock body_content %}
diff --git a/template/install.html.j2 b/template/install.html.j2
index 2245b9f..14b4213 100644
--- a/template/install.html.j2
+++ b/template/install.html.j2
@@ -71,6 +71,8 @@
       <h3>Arch Linux/Arch-Pi</h3>
     </div>
     <div class="col-md">
+      <p><a href="install-on-openwrt.html"><img src ="{{ 
url('static/images/openwrt-logo.svg') }}" class="distro-logo" 
style="width:300px;height:auto"></a></pa>
+      <h3>OpenWrt</h3>
     </div>
   </div>
 

-- 
To stop receiving notification emails like this one, please contact
address@hidden.