erg - Contributions de l’utilisateur [fr]

Etherbox

2018-01-30T12:21:45Z

Max : /* Install etherpad */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

The **lite** image has no desktop / windows session.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

== How to find the IP address of the pi ==

Simplest way is to connect on a wired network (plug the pi and your laptop into a router with ethernet cables), then type:

ping raspberrypi.local

And you should be able to see the IP address.

Then you can conenct with ssh with:

ssh pi@raspberrypi.local

or with the IP address in place of "raspberrypi.local" if you are on the wifi.

with the default password "raspberry"

== Make it easier to login, with an ssh key ==

Starting from your laptop (open a new Terminal session if you are connected to the pi):

ssh-keygen

Choose the defaults. This generates an "ssh key" pair.

Use the ssh-copy-id utility to send it to the pi.

ssh-copy-id pi@raspberrypi.local

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default.conf</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /home/pi
<Directory /home/pi>
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /include/HEADER.shtml
ReadmeName README.html</pre>

NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

sudo chmod +x droptoupload.cgi

= HEADER.shtml =
Sample Header that adds javascript to:
* Move the README.html to the TOP of the page
* Includes the "droptoupload.cgi" https://gitlab.constantvzw.org/aa/etherbox/raw/master/usr/lib/cgi-bin/droptoupload.cgi

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>

= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Install etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>

Les fichiers se trouvent dans opt/etherpad/var sous forme d'un seul fichier "dirtyDB" - > You should use a dedicated database such as "mysql", if you are planning on using etherpad-in a production environment.
<pre>sudo apt-get install mysql-server</pre>

Create your setting file.
<pre>sudo cp settings.json.template settings.json</pre>
then, desactivate the dirty.db file and configure the mysql database
<pre>sudo nano settings.json</pre>

Find and change this part :

<pre> //The Type of the database. You can choose between dirty, postgres, sqlite and mysql
//You shouldn't use "dirty" for for anything else than testing or development
/* "dbType" : "dirty",
//the database specific settings
"dbSettings" : {
"filename" : "var/dirty.db"
},
*/
//An Example of MySQL Configuration
"dbType" : "mysql",
"dbSettings" : {
"user" : "etherpaduser",
"host" : "localhost",
"password": "etherpadpass",
"database": "etherpad",
"charset" : "utf8mb4"
},

</pre>

== Set up Mysql ==

First thing to do is to install MySQL :

<pre>sudo apt-get install mysql-server</pre>

Then create the database, for this we need to login with the Root user (super-user) :

<pre>sudo su</pre>

Run mysql :

<pre>mysql</pre>

Then create the database and the user 'etherpaduser' with the password 'etherpadpass' :

<pre>create database etherpad;
grant all on etherpad.* to 'etherpaduser'@'localhost' identified by 'etherpadpass';</pre>

Just to test if it works :

<pre>mysql -u etherpaduser -p etherpad</pre>

==Run etherpad for the first time as the etherpad user...==

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>

= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.

Etherbox

2018-01-30T12:18:44Z

Max : /* Set up Mysql */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

The **lite** image has no desktop / windows session.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

== How to find the IP address of the pi ==

Simplest way is to connect on a wired network (plug the pi and your laptop into a router with ethernet cables), then type:

ping raspberrypi.local

And you should be able to see the IP address.

Then you can conenct with ssh with:

ssh pi@raspberrypi.local

or with the IP address in place of "raspberrypi.local" if you are on the wifi.

with the default password "raspberry"

== Make it easier to login, with an ssh key ==

Starting from your laptop (open a new Terminal session if you are connected to the pi):

ssh-keygen

Choose the defaults. This generates an "ssh key" pair.

Use the ssh-copy-id utility to send it to the pi.

ssh-copy-id pi@raspberrypi.local

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default.conf</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /home/pi
<Directory /home/pi>
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /include/HEADER.shtml
ReadmeName README.html</pre>

NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

sudo chmod +x droptoupload.cgi

= HEADER.shtml =
Sample Header that adds javascript to:
* Move the README.html to the TOP of the page
* Includes the "droptoupload.cgi" https://gitlab.constantvzw.org/aa/etherbox/raw/master/usr/lib/cgi-bin/droptoupload.cgi

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>

= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Install etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>

Les fichiers se trouvent dans opt/etherpad/var sous forme d'un seul fichier "dirtyDB" - > You should use a dedicated database such as "mysql", if you are planning on using etherpad-in a production environment.
<pre>sudo apt-get install mysql-server</pre>

Create your setting file.
<pre>sudo cp settings.json.template settings.json</pre>
then, desactivate the dirty.db file and configure the mysql database
<pre>sudo nano settings.json</pre>

Find and change this part :

<pre> //The Type of the database. You can choose between dirty, postgres, sqlite and mysql
//You shouldn't use "dirty" for for anything else than testing or development
/* "dbType" : "dirty",
//the database specific settings
"dbSettings" : {
"filename" : "var/dirty.db"
},
*/
//An Example of MySQL Configuration
"dbType" : "mysql",
"dbSettings" : {
"user" : "etherpaduser",
"host" : "localhost",
"password": "etherpadpass",
"database": "store",
"charset" : "utf8mb4"
},

</pre>

== Set up Mysql ==

First thing to do is to install MySQL :

<pre>sudo apt-get install mysql-server</pre>

Then create the database, for this we need to login with the Root user (super-user) :

<pre>sudo su</pre>

Run mysql :

<pre>mysql</pre>

Then create the database and the user 'etherpaduser' with the password 'etherpadpass' :

<pre>create database etherpad;
grant all on etherpad.* to 'etherpaduser'@'localhost' identified by 'etherpadpass';</pre>

Just to test if it works :

<pre>mysql -u etherpaduser -p etherpad</pre>

==Run etherpad for the first time as the etherpad user...==

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>

= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.

Etherbox

2018-01-30T12:18:08Z

Max : /* Install etherpad */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

The **lite** image has no desktop / windows session.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

== How to find the IP address of the pi ==

Simplest way is to connect on a wired network (plug the pi and your laptop into a router with ethernet cables), then type:

ping raspberrypi.local

And you should be able to see the IP address.

Then you can conenct with ssh with:

ssh pi@raspberrypi.local

or with the IP address in place of "raspberrypi.local" if you are on the wifi.

with the default password "raspberry"

== Make it easier to login, with an ssh key ==

Starting from your laptop (open a new Terminal session if you are connected to the pi):

ssh-keygen

Choose the defaults. This generates an "ssh key" pair.

Use the ssh-copy-id utility to send it to the pi.

ssh-copy-id pi@raspberrypi.local

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default.conf</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /home/pi
<Directory /home/pi>
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /include/HEADER.shtml
ReadmeName README.html</pre>

NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

sudo chmod +x droptoupload.cgi

= HEADER.shtml =
Sample Header that adds javascript to:
* Move the README.html to the TOP of the page
* Includes the "droptoupload.cgi" https://gitlab.constantvzw.org/aa/etherbox/raw/master/usr/lib/cgi-bin/droptoupload.cgi

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>

= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Install etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>

Les fichiers se trouvent dans opt/etherpad/var sous forme d'un seul fichier "dirtyDB" - > You should use a dedicated database such as "mysql", if you are planning on using etherpad-in a production environment.
<pre>sudo apt-get install mysql-server</pre>

Create your setting file.
<pre>sudo cp settings.json.template settings.json</pre>
then, desactivate the dirty.db file and configure the mysql database
<pre>sudo nano settings.json</pre>

Find and change this part :

<pre> //The Type of the database. You can choose between dirty, postgres, sqlite and mysql
//You shouldn't use "dirty" for for anything else than testing or development
/* "dbType" : "dirty",
//the database specific settings
"dbSettings" : {
"filename" : "var/dirty.db"
},
*/
//An Example of MySQL Configuration
"dbType" : "mysql",
"dbSettings" : {
"user" : "etherpaduser",
"host" : "localhost",
"password": "etherpadpass",
"database": "store",
"charset" : "utf8mb4"
},

</pre>

== Set up Mysql ==

First thing to do is to install MySQL :

<pre>sudo apt-get install mysql-server</pre>

Then create the database, for this we need to login with the Root user (super-user) :

<pre>sudo su</pre>

Run mysql :

<pre>mysql</pre>

Then create the database and the user 'etherpaduser' with the password 'etherpadpass' :

<pre>create database etherpad;
grant all on etherpad.* to 'etherpaduser'@'localhost' identified by 'etherpadpass';</pre>

Just to test if it works :

<pre>mysql -u etherpaduser -p etherpad</pre>

Run etherpad for the first time as the etherpad user...

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>

= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.

Etherbox

2018-01-30T12:16:25Z

Max : /* Install etherpad */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

The **lite** image has no desktop / windows session.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

== How to find the IP address of the pi ==

Simplest way is to connect on a wired network (plug the pi and your laptop into a router with ethernet cables), then type:

ping raspberrypi.local

And you should be able to see the IP address.

Then you can conenct with ssh with:

ssh pi@raspberrypi.local

or with the IP address in place of "raspberrypi.local" if you are on the wifi.

with the default password "raspberry"

== Make it easier to login, with an ssh key ==

Starting from your laptop (open a new Terminal session if you are connected to the pi):

ssh-keygen

Choose the defaults. This generates an "ssh key" pair.

Use the ssh-copy-id utility to send it to the pi.

ssh-copy-id pi@raspberrypi.local

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default.conf</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /home/pi
<Directory /home/pi>
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /include/HEADER.shtml
ReadmeName README.html</pre>

NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

sudo chmod +x droptoupload.cgi

= HEADER.shtml =
Sample Header that adds javascript to:
* Move the README.html to the TOP of the page
* Includes the "droptoupload.cgi" https://gitlab.constantvzw.org/aa/etherbox/raw/master/usr/lib/cgi-bin/droptoupload.cgi

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>

= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Install etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>

Les fichiers se trouvent dans opt/etherpad/var sous forme d'un seul fichier "dirtyDB" - > You should use a dedicated database such as "mysql", if you are planning on using etherpad-in a production environment.
<pre>sudo apt-get install mysql-server</pre>

Create your setting file.
<pre>sudo cp settings.json.template settings.json</pre>
then, desactivate the dirty.db file and configure the mysql database
<pre>sudo nano settings.json</pre>

== Set up Mysql ==

First thing to do is to install MySQL :

<pre>sudo apt-get install mysql-server</pre>

Then create the database, for this we need to login with the Root user (super-user) :

<pre>sudo su</pre>

Run mysql :

<pre>mysql</pre>

Then create the database and the user 'etherpaduser' with the password 'etherpadpass' :

<pre>create database etherpad;
grant all on etherpad.* to 'etherpaduser'@'localhost' identified by 'etherpadpass';</pre>

Just to test if it works :

<pre>mysql -u etherpaduser -p etherpad</pre>

Run etherpad for the first time as the etherpad user...

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>

= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.

Etherbox

2018-01-30T12:10:59Z

Max : /* Set up etherpad */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

The **lite** image has no desktop / windows session.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

== How to find the IP address of the pi ==

Simplest way is to connect on a wired network (plug the pi and your laptop into a router with ethernet cables), then type:

ping raspberrypi.local

And you should be able to see the IP address.

Then you can conenct with ssh with:

ssh pi@raspberrypi.local

or with the IP address in place of "raspberrypi.local" if you are on the wifi.

with the default password "raspberry"

== Make it easier to login, with an ssh key ==

Starting from your laptop (open a new Terminal session if you are connected to the pi):

ssh-keygen

Choose the defaults. This generates an "ssh key" pair.

Use the ssh-copy-id utility to send it to the pi.

ssh-copy-id pi@raspberrypi.local

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default.conf</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /home/pi
<Directory /home/pi>
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /include/HEADER.shtml
ReadmeName README.html</pre>

NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

sudo chmod +x droptoupload.cgi

= HEADER.shtml =
Sample Header that adds javascript to:
* Move the README.html to the TOP of the page
* Includes the "droptoupload.cgi" https://gitlab.constantvzw.org/aa/etherbox/raw/master/usr/lib/cgi-bin/droptoupload.cgi

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>

= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Install etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>

Les fichiers se trouvent dans opt/etherpad/var sous forme d'un seul fichier "dirtyDB" - > You should use a dedicated database such as "mysql", if you are planning on using etherpad-in a production environment.
<pre>sudo apt-get install mysql-server</pre>

Create your setting file.
<pre>sudo cp settings.json.template settings.json</pre>
then, desactivate the dirty.db file and configure the mysql database
<pre>sudo nano settings.json</pre>

Run etherpad for the first time as the etherpad user...

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>

= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.

Etherbox

2018-01-30T11:51:36Z

Max : /* Set up etherpad */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

The **lite** image has no desktop / windows session.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

== How to find the IP address of the pi ==

Simplest way is to connect on a wired network (plug the pi and your laptop into a router with ethernet cables), then type:

ping raspberrypi.local

And you should be able to see the IP address.

Then you can conenct with ssh with:

ssh pi@raspberrypi.local

or with the IP address in place of "raspberrypi.local" if you are on the wifi.

with the default password "raspberry"

== Make it easier to login, with an ssh key ==

Starting from your laptop (open a new Terminal session if you are connected to the pi):

ssh-keygen

Choose the defaults. This generates an "ssh key" pair.

Use the ssh-copy-id utility to send it to the pi.

ssh-copy-id pi@raspberrypi.local

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default.conf</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /home/pi
<Directory /home/pi>
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /include/HEADER.shtml
ReadmeName README.html</pre>

NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

sudo chmod +x droptoupload.cgi

= HEADER.shtml =
Sample Header that adds javascript to:
* Move the README.html to the TOP of the page
* Includes the "droptoupload.cgi" https://gitlab.constantvzw.org/aa/etherbox/raw/master/usr/lib/cgi-bin/droptoupload.cgi

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>

= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Set up etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>
Used password VJ.

Create your setting file.
<pre>sudo cp settings.json.template settings.json</pre>

Run etherpad for the first time as the etherpad user...

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>

= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.

Etherbox

2018-01-30T11:00:59Z

Max : /* Setup apache to serve the root with custom header + readme's */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

The **lite** image has no desktop / windows session.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

== How to find the IP address of the pi ==

Simplest way is to connect on a wired network (plug the pi and your laptop into a router with ethernet cables), then type:

ping raspberrypi.local

And you should be able to see the IP address.

Then you can conenct with ssh with:

ssh pi@raspberrypi.local

or with the IP address in place of "raspberrypi.local" if you are on the wifi.

with the default password "raspberry"

== Make it easier to login, with an ssh key ==

Starting from your laptop (open a new Terminal session if you are connected to the pi):

ssh-keygen

Choose the defaults. This generates an "ssh key" pair.

Use the ssh-copy-id utility to send it to the pi.

ssh-copy-id pi@raspberrypi.local

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default.conf</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /home/pi
<Directory /home/pi>
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /home/pi/include/HEADER.shtml
ReadmeName README.html</pre>
NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

= HEADER.shtml =

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>
= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Set up etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>
Used password VJ.

Run etherpad for the first time as the etherpad user...

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>
= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.

Etherbox

2018-01-30T10:53:05Z

Max : /* Setup apache to serve the root with custom header + readme's */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

The **lite** image has no desktop / windows session.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

== How to find the IP address of the pi ==

Simplest way is to connect on a wired network (plug the pi and your laptop into a router with ethernet cables), then type:

ping raspberrypi.local

And you should be able to see the IP address.

Then you can conenct with ssh with:

ssh pi@raspberrypi.local

or with the IP address in place of "raspberrypi.local" if you are on the wifi.

with the default password "raspberry"

== Make it easier to login, with an ssh key ==

Starting from your laptop (open a new Terminal session if you are connected to the pi):

ssh-keygen

Choose the defaults. This generates an "ssh key" pair.

Use the ssh-copy-id utility to send it to the pi.

ssh-copy-id pi@raspberrypi.local

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default.conf</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /
<Directory />
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /home/pi/include/HEADER.shtml
ReadmeName README.html</pre>
NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

= HEADER.shtml =

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>
= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Set up etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>
Used password VJ.

Run etherpad for the first time as the etherpad user...

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>
= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.

Etherbox

2018-01-30T10:05:06Z

Max : /* Initial image + setup */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /
<Directory />
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /home/pi/include/HEADER.shtml
ReadmeName README.html</pre>
NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

= HEADER.shtml =

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>
= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Set up etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>
Used password VJ.

Run etherpad for the first time as the etherpad user...

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>
= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.

Etherbox

2018-01-30T09:59:07Z

Max : /* Initial image + setup */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

You can also enabled SSH by default after creating the boot SD Card, you just need to create a empty file named SSH and save it the root of your SD Card.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /
<Directory />
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /home/pi/include/HEADER.shtml
ReadmeName README.html</pre>
NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

= HEADER.shtml =

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>
= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Set up etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>
Used password VJ.

Run etherpad for the first time as the etherpad user...

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>
= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.

Etherbox

2018-01-30T09:54:41Z

Max : /* Initial image + setup */

These notes are based on a setup used by the "SOftware observatory" workshop, Constant [[Utilisateur:Michael Murtaugh|Michael Murtaugh]] ([[Discussion utilisateur:Michael Murtaugh|discussion]]) 30 janvier 2018 à 10:48 (CET)

= Initial image + setup =

Downloaded from https://www.raspberrypi.org/downloads/raspbian/

Based on the "lite" image (zip or torrent). As of 20 Jan 2018, this is Raspian "Stretch" lite.

Based on [https://downloads.raspberrypi.org/raspbian_lite_latest.torrent 2017-04-10-raspian-jessie-lite.zip]

<pre>unzip -p 2017-04-10-raspbian-jessie-lite.zip | pv | sudo dd of=/dev/sdc bs=4M</pre>

You could use [https://etcher.io/ Etcher.io] as well

SSH is no longer on by default! So need to connect with a screen first time and turn this on.

<pre>sudo raspi-config</pre>
Enable ssh under connectivity.

Bring the rest of the software up to date.

<pre>sudo apt-get update
sudo apt-get upgrade</pre>

= Setup apache to serve the root with custom header + readme's =

<pre>sudo apt-get install apache2
cd /etc/apache2/sites-available
sudo nano 000-default</pre>
<pre> ServerAdmin webmaster@localhost
# DocumentRoot /var/www/html
DocumentRoot /
<Directory />
Options Indexes FollowSymLinks
AllowOverride none
Require all granted
</Directory>

HeaderName /home/pi/include/HEADER.shtml
ReadmeName README.html</pre>
NB: Sets the [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#headername HeaderName] and [https://httpd.apache.org/docs/current/mod/mod_autoindex.html#readmename ReadmeName] directives (part of mod_autoindex).

<pre>sudo service apache2 reload</pre>
=== droptoupload.cgi ===

<pre>sudo a2enmod cgi
sudo service apache2 restart</pre>
Placed 'droptoupload.cgi' in /usr/lib/cgi-bin and tried running it with:

<pre>./droptoupload.cgi</pre>
Like this is just outputs an HTML form. Looking at http://etherbox.local/cgi-bin/droptoupload.cgi should also display an upload form.

The HEADER.shtml includes a link to this cgi.

= HEADER.shtml =

<pre class="html"><script src="/cgi-bin/droptoupload.cgi"></script>
<style>
body {
background: #38b8e9;
color: black;
}
a {
color: white;
}
#logo {
white-space: pre;
font-family: monospace;
}
</style>
<div class="links" style="margin-bottom: 1em">LOCAL:
<a href="/">&nbsp;/&nbsp;</a>
<a href="/home/pi/">home</a>
<a href="/home/pi/etherdump/">etherdump</a>
PUBLIC:
<a href="http://constantvzw.org/site/-The-Technogalactic-Software-Observatory-.html">constant</a>
<a href="https://gitlab.constantvzw.org/observatory">gitlab</a>
</div>
<style>
.links {
font-family: monospace;
text-transform: uppercase;
</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
var p = document.querySelectorAll(".top"),
t = document.getElementsByTagName("table")[0];
for (var i=0, l=p.length; i<l; i++) {
document.body.insertBefore(p[i], t);
}
});
</script></pre>
= Better permissions with facl =

[http://www.linuxcommand.org/man_pages/setfacl1.html setfacl]

<pre>sudo addgroup pi www-data

sudo setfacl -Rm g:www-data:rwX /home/pi
sudo setfacl -d -Rm g:www-data:rwX /home/pi</pre>
Unfortunately, I had problems then with permissions on the .ssh folder (preventing keys to be used). To remove the fact on just this folder:

<pre>sudo chmod g-w /home/pi</pre>
= Set up etherpad =

And the version of "nodejs" is now 0.10.29~dfsg-2. So let's try it with etherpad...

<pre>sudo apt-get install npm git

sudo ln -s /usr/bin/nodejs /usr/bin/node

cd /opt
sudo git clone https://github.com/ether/etherpad-lite.git
sudo mv etherpad-lite etherpad

# TODO: don't create home folder! ... find option
sudo adduser --system --home=/opt/etherpad --group etherpad
sudo chown -R etherpad:etherpad etherpad</pre>
Used password VJ.

Run etherpad for the first time as the etherpad user...

<pre>cd /opt/etherpad
sudo --user etherpad bin/run.sh</pre>
Following the first recipe on this page about [https://github.com/ether/etherpad-lite/wiki/How-to-deploy-Etherpad-Lite-as-a-service deploying etherpad as a systemd service]

<pre>sudo nano /etc/systemd/system/etherpad.service</pre>
<pre>[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
ExecStart=/usr/bin/nodejs /opt/etherpad/node_modules/ep_etherpad-lite/node/server.js
Restart=always

[Install]
WantedBy=multi-user.target</pre>
After this,

<pre>sudo service etherpad start</pre>
Seems to work! Apparently it's the same as:

<pre>systemctl start etherpad-lite</pre>
And to start on boot:

<pre>systemctl enable etherpad-lite</pre>
= etherdump =

System wide installation of etherdump

Install deps:

<pre>sudo apt install python-pip python-dev
sudo pip install python-dateutil jinja2 html5lib</pre>
Install from repo:

<pre>git clone http://murtaugh@gitlab.constantvzw.org/aa/etherdump.git
cd etherdump
sudo python setup.py install</pre>
=== Setup the folder ===

<pre>cd /home/pi
mkdir etherdump
cd etherdump
etherdump init</pre>
Type in:

<pre>http://etherbox.local:9001/</pre>
And paste the API key. (Look at: http://etherbox.local/opt/etherpad/APIKEY.txt)

=== styles.css + versions.js ===

scp styles.css versions.js pi@etherbox.local:etherdump/lib

The URLs of these files are options to the etherdump pull command and should match.

=== etherdump.sh + cron ===

Make the script that runs automatically.

<pre>nano etherdump.sh</pre>
<pre>#!/bin/bash
# PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/games:/usr/games
cd /home/pi/etherdump
etherdump pull --all --pub /home/pi/etherdump --css lib/styles.css --script lib/versions.js
etherdump index *.meta.json > index.html</pre>
And set it to run every 5 minutes

<pre>crontab -e</pre>
<pre>PATH=/home/pi/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# m h dom mon dow command
*/5 * * * * /home/pi/etherdump.sh > /home/pi/cron.log.txt 2>&1</pre>
The PATH is important. It can also be in the etherdump.sh but basically should match what you see when you "echo $PATH" (for the script to run in the same way as for the pi user).

= Other software =

<pre>sudo apt-get install emacs-nox screen pdftk pandoc texlive-latex-recommended texlive-fonts-recommended
sudo pip install csvkit</pre>
To install

* screen
* pandoc + latex
* pdftk
* csvkit

What about

* texlive-xetex texlive-luatex pandoc-citeproc etoolbox

The current version of pandoc in this raspbian is 1.12.4.2~dfsg-1+b3 We will use latex for PDF generation (via pandoc)

(which is way better than 1.9 of the previous raspian, and even beats the instructions for compiling 1.11.1)

MORE

<pre>sudo apt-get install pandoc texlive-latex-recommended texlive-fonts-recommended </pre>
Was able to:

<pre>pandoc --from markdown hello.markdown -o hello.pdf</pre>
= Access point =

Taken from [https://pzwiki.wdka.nl/mediadesign/The_Ultimate_RPi_Installation_Guide#Access_Point_with_Captive_Portal this "ultimate" guide]

<pre>apt-get install dnsmasq wireless-tools hostapd

# the next wasn't necessary for jessie, but for completeness..
RPI3 broadcom chip
apt-get install firmware-brcm80211
rmmod brcmfmac
modprobe brcmfmac</pre>
Give fixed IP to wlan0 interface, edit /etc/network/interfaces switch off the built in stuff and add (section 2):

<pre>auto eth0
allow-hotplug eth0
iface etho inet dhcp

#################################
# 1. ORIGINAL settings... use wpa_supplicant for client mode
#allow-hotplug wlan0
#iface wlan0 inet manual
# wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
#
#################################
# 2. Fixed IP address (for hotspot / hostapd)
auto wlan0
iface wlan0 inet static
address 10.9.8.7
netmask 255.255.255.0
#################################</pre>
Replace /etc/dnsmasq.conf with:

<pre>interface=wlan0
dhcp-range=10.9.8.10,50.9.8.254,12h
address=/#/10.9.8.7
no-resolv</pre>
Edit /etc/hostapd/hostapd.conf file (adjust depending on driver/hardware)

<pre>interface=wlan0
driver=nl80211
ssid=WiFeels
hw_mode=g
channel=6</pre>
Edit /etc/default/hostapd and add

<pre>DAEMON_CONF="/etc/hostapd/hostapd.conf"</pre>
Make hostapd start at boot

<pre>update-rc.d hostapd defaults</pre>
Reboot.

= Makeserver + etherpad (experimental!) =

Ingredients

* Etherdump's pad.html with <rel> links including LIVE EDIT URLs
* THIS should replace/complement makeserver's EDIT button

Key question: Makeserver as a separate view ?! (probably)

TRY as 2 separate things ... basically AS IS...

Install:

<pre>cd /home/pi/software
git clone http://murtaugh@gitlab.constantvzw.org/aa/makeserver.git
cd makeserver
git submodule init
git submodule update
sudo pip install twisted jinja2</pre>
BUGFIX with twisted / SSL issues:

<pre>sudo pip install twisted[tls]</pre>
DIDN"T FIX sudo pip install twisted==16.0.0

Seems to work!

= TODO =

* Why are the links hardcoded long form in etherdump index (fails then via makeserver based in home)?

= Extra =

Changed dnsmasq.conf

<pre>interface=wlan0
dhcp-range=10.9.10.50,10.9.10.254,12h
#address=/#/10.9.10.7 # no-resolv</pre>
AND added to /etc/hosts

<pre>10.9.10.7 etherbox.local</pre>
and this seems to then work over the direct hotspot connection.