diff options
Diffstat (limited to 'template/install-on-ubuntu1804.html.j2')
-rw-r--r-- | template/install-on-ubuntu1804.html.j2 | 63 |
1 files changed, 21 insertions, 42 deletions
diff --git a/template/install-on-ubuntu1804.html.j2 b/template/install-on-ubuntu1804.html.j2 index 687d786f..fb218110 100644 --- a/template/install-on-ubuntu1804.html.j2 +++ b/template/install-on-ubuntu1804.html.j2 | |||
@@ -1,12 +1,12 @@ | |||
1 | {% extends "common/base.j2" %} | 1 | {% extends "common/base.j2" %} |
2 | {% block body_content %} | 2 | {% block body_content %} |
3 | <article class="container"> | 3 | <article class="container"> |
4 | <!--<article> --> | 4 | |
5 | <header> | 5 | <header> |
6 | <h2>{{ _("Tutorial: GNUnet on Ubuntu 18.04") }}</h2> | 6 | <h1>{{ _("Tutorial: GNUnet on Ubuntu 18.04") }}</h1> |
7 | </header> | 7 | </header> |
8 | <section> | 8 | |
9 | <h3>{{ _("Introduction") }}</h3> | 9 | <h2>{{ _("Introduction") }}</h2> |
10 | <p> | 10 | <p> |
11 | Welcome to the hopefully painless GNUnet tutorial for Ubuntu 18.04! | 11 | Welcome to the hopefully painless GNUnet tutorial for Ubuntu 18.04! |
12 | It provides very concrete instructions on how to compile, install | 12 | It provides very concrete instructions on how to compile, install |
@@ -23,9 +23,7 @@ | |||
23 | <p> | 23 | <p> |
24 | Now let's start! | 24 | Now let's start! |
25 | </p> | 25 | </p> |
26 | </section> | 26 | <h2>{{ _("Requirements") }}</h2> |
27 | <section> | ||
28 | <h3>{{ _("Requirements") }}</h3> | ||
29 | <p> | 27 | <p> |
30 | First let's install the following Ubuntu 18.04 packages to use | 28 | First let's install the following Ubuntu 18.04 packages to use |
31 | GNUnet painlessly. Optional dependencies are listed in Appendix | 29 | GNUnet painlessly. Optional dependencies are listed in Appendix |
@@ -39,9 +37,8 @@ | |||
39 | openssl libnss3-tools libmicrohttpd-dev libopus-dev libpulse-dev \<br> | 37 | openssl libnss3-tools libmicrohttpd-dev libopus-dev libpulse-dev \<br> |
40 | libogg-dev | 38 | libogg-dev |
41 | </code> | 39 | </code> |
42 | </section> | 40 | |
43 | <section> | 41 | <h2>{{ _("Make an installation directory") }}</h2> |
44 | <h3>{{ _("Make an installation directory") }}</h3> | ||
45 | <p> | 42 | <p> |
46 | Next we create a directory in our home directory where we store | 43 | Next we create a directory in our home directory where we store |
47 | the source code later. We should keep this directory after | 44 | the source code later. We should keep this directory after |
@@ -52,9 +49,8 @@ | |||
52 | <code> | 49 | <code> |
53 | $ mkdir ~/gnunet_installation | 50 | $ mkdir ~/gnunet_installation |
54 | </code> | 51 | </code> |
55 | </section> | 52 | |
56 | <section> | 53 | <h2>{{ _("Get the source code") }}</h2> |
57 | <h3>{{ _("Get the source code") }}</h3> | ||
58 | <p> | 54 | <p> |
59 | We download the GNUnet source code using git. | 55 | We download the GNUnet source code using git. |
60 | </p> | 56 | </p> |
@@ -62,9 +58,7 @@ | |||
62 | $ cd ~/gnunet_installation<br> | 58 | $ cd ~/gnunet_installation<br> |
63 | $ git clone --depth 1 https://gnunet.org/git/gnunet.git<br> | 59 | $ git clone --depth 1 https://gnunet.org/git/gnunet.git<br> |
64 | </code> | 60 | </code> |
65 | </section> | 61 | <h2>{{ _("Compile and Install") }}</h2> |
66 | <section> | ||
67 | <h3>{{ _("Compile and Install") }}</h3> | ||
68 | <p> | 62 | <p> |
69 | Installing GNUnet is not hard. We have two options: | 63 | Installing GNUnet is not hard. We have two options: |
70 | installing a *production version* and installing a *development version*. If | 64 | installing a *production version* and installing a *development version*. If |
@@ -73,9 +67,7 @@ | |||
73 | debug symbols that can be displayed with a debugger). Otherwise choose the | 67 | debug symbols that can be displayed with a debugger). Otherwise choose the |
74 | production version. | 68 | production version. |
75 | </p> | 69 | </p> |
76 | </section> | 70 | <h3>{{ _("Option 1: GNUnet for production / usage") }}</h3> |
77 | <section> | ||
78 | <h4>{{ _("Option 1: GNUnet for production / usage") }}</h4> | ||
79 | <code> | 71 | <code> |
80 | $ cd ~/gnunet_installation/gnunet<br> | 72 | $ cd ~/gnunet_installation/gnunet<br> |
81 | $ ./bootstrap<br> | 73 | $ ./bootstrap<br> |
@@ -85,9 +77,7 @@ | |||
85 | $ make -j$(nproc || echo -n 1)<br> | 77 | $ make -j$(nproc || echo -n 1)<br> |
86 | $ sudo make install | 78 | $ sudo make install |
87 | </code> | 79 | </code> |
88 | </section> | 80 | <h3>{{ _("Option 2: GNUnet for development") }}</h3> |
89 | <section> | ||
90 | <h4>{{ _("Option 2: GNUnet for development") }}</h4> | ||
91 | 81 | ||
92 | <code> | 82 | <code> |
93 | $ cd ~/gnunet_installation/gnunet<br> | 83 | $ cd ~/gnunet_installation/gnunet<br> |
@@ -99,7 +89,7 @@ | |||
99 | </code> | 89 | </code> |
100 | 90 | ||
101 | <!-- | 91 | <!-- |
102 | <h4>{{ _("Install GNUnet plugin for name resolution") }}</h4> | 92 | <h3>{{ _("Install GNUnet plugin for name resolution") }}</h3> |
103 | So now it gets a bit nasty. It's not so bad. All we have to do is copy a file and edit another one. The file we need to copy is GNUnet's plugin for the Name Service Switch (NSS) in unix systems. Different unixes expect it in different locations and GNUnet's build system does not try to guess. On Ubuntu 18.04 we have to do | 93 | So now it gets a bit nasty. It's not so bad. All we have to do is copy a file and edit another one. The file we need to copy is GNUnet's plugin for the Name Service Switch (NSS) in unix systems. Different unixes expect it in different locations and GNUnet's build system does not try to guess. On Ubuntu 18.04 we have to do |
104 | 94 | ||
105 | <code> | 95 | <code> |
@@ -136,9 +126,7 @@ | |||
136 | 126 | ||
137 | <p>That's it. It wasn't that nasty, was it?</p> | 127 | <p>That's it. It wasn't that nasty, was it?</p> |
138 | --> | 128 | --> |
139 | </section> | 129 | <h2>{{ _("Configuration") }}</h2> |
140 | <section> | ||
141 | <h3>{{ _("Configuration") }}</h3> | ||
142 | 130 | ||
143 | <p> | 131 | <p> |
144 | Congratulations! GNUnet is now installed! Before we start it we | 132 | Congratulations! GNUnet is now installed! Before we start it we |
@@ -212,16 +200,12 @@ | |||
212 | <code> | 200 | <code> |
213 | $ gnunet-arm -e | 201 | $ gnunet-arm -e |
214 | </code> | 202 | </code> |
215 | </section> | 203 | <h2>{{ _("Use GNUnet!") }}</h2> |
216 | <section> | ||
217 | <h3>{{ _("Use GNUnet!") }}</h3> | ||
218 | <p> | 204 | <p> |
219 | Please head over here: <a href="https://gnunet.org/en/use.html">Use!</a> | 205 | Please head over here: <a href="https://gnunet.org/en/use.html">Use!</a> |
220 | <p> | 206 | <p> |
221 | </section> | ||
222 | 207 | ||
223 | <section> | 208 | <h2>{{ _("Uninstall GNUnet and its dependencies") }}</h2> |
224 | <h3>{{ _("Uninstall GNUnet and its dependencies") }}</h3> | ||
225 | 209 | ||
226 | <code> | 210 | <code> |
227 | $ cd ~/gnunet_installation/gnunet<br> | 211 | $ cd ~/gnunet_installation/gnunet<br> |
@@ -236,13 +220,9 @@ | |||
236 | $ sudo mv /etc/nsswitch.conf.original /etc/nsswitch.conf<br> | 220 | $ sudo mv /etc/nsswitch.conf.original /etc/nsswitch.conf<br> |
237 | $ sudo rm /lib/$(uname -m)-linux-gnu/libnss_gns.so.2 | 221 | $ sudo rm /lib/$(uname -m)-linux-gnu/libnss_gns.so.2 |
238 | </code> | 222 | </code> |
239 | </section> | ||
240 | 223 | ||
241 | <section> | 224 | <h2>{{ _("Troubleshooting") }}</h2> |
242 | <h3>{{ _("Troubleshooting") }}</h3> | 225 | <h3>{{ _("You can't reach other people's nodes") }}</h3> |
243 | </section> | ||
244 | <section> | ||
245 | <h4>{{ _("You can't reach other people's nodes") }}</h4> | ||
246 | 226 | ||
247 | <p> | 227 | <p> |
248 | Should our computer not have reached the open GNUnet network automatically, | 228 | Should our computer not have reached the open GNUnet network automatically, |
@@ -273,7 +253,7 @@ | |||
273 | <p>Now our GNUnet nodes can attempt reaching each other directly. This may | 253 | <p>Now our GNUnet nodes can attempt reaching each other directly. This may |
274 | still fail due to NAT traversal issues.</p> | 254 | still fail due to NAT traversal issues.</p> |
275 | 255 | ||
276 | <!--<h4>{{ _("OMG you guys broke my internet") }}</h4> | 256 | <!--<h3>{{ _("OMG you guys broke my internet") }}</h3> |
277 | 257 | ||
278 | <p>We can replace `/etc/nsswitch.conf` with the backup we made earlier | 258 | <p>We can replace `/etc/nsswitch.conf` with the backup we made earlier |
279 | (`/etc/nsswitch.conf.original`). Now DNS resolution should work again without a | 259 | (`/etc/nsswitch.conf.original`). Now DNS resolution should work again without a |
@@ -282,6 +262,5 @@ | |||
282 | <code> | 262 | <code> |
283 | $ cp /etc/nsswitch.conf.original /etc/nsswitch.conf | 263 | $ cp /etc/nsswitch.conf.original /etc/nsswitch.conf |
284 | </code>--> | 264 | </code>--> |
285 | </section> | ||
286 | </article> | 265 | </article> |
287 | {% endblock body_content %} | 266 | {% endblock body_content %} |