Browse Source

Debrief WS Copenhagen

Federico Bonelli 2 years ago
parent
commit
597e895e0f
6 changed files with 77 additions and 44 deletions
  1. 4 0
      Nodered/setups.md
  2. 73 44
      guide.md
  3. BIN
      image/devuan_ascii_dowse_raspi2.img.xz
  4. BIN
      image/devuan_ascii_dowse_raspi2.tar.gz
  5. BIN
      logo_full.png
  6. BIN
      logo_small.png

+ 4 - 0
Nodered/setups.md

@@ -0,0 +1,4 @@
1
+# my favourite gource setup :)
2
+
3
+
4
+ssh -l dowse dowse.it /usr/local/dowse/bin/dowse-to-gource | gource --log-format custom -e 0.5 --bloom-multiplier 2.0 --bloom-intensity 0.1 --background F7EFDB --font-size 18 --font-colour 000000 --logo ~/devel/dowse-workshops/logo_small.png -

+ 73 - 44
guide.md

@@ -1,25 +1,44 @@
1
+# Dowse
1 2
 # Notes for Dowse workshops setup and materials
2 3
 
3 4
 
4 5
 # Dowse
5 6
 - Web site is www.dowse.eu
6
-- Dyne is spelled as here; our website is www.dyne.org
7
-- irc channel is irc.dyne.org #dowse, feel welcome also to join in via https://irc.dyne.org
7
+- Dyne is a foundation, non profit, established in The Nederlands
8
+- our website is www.dyne.org were you can see also other projects
9
+- irc channel is irc.dyne.org #dowse, feel welcome.
10
+    - You can also to join in via https://irc.dyne.org
8 11
 - fredd email is fredd@dyne.org
9
-- Mailing list is dowse@dyne.org
12
+- Mailing list is dowser@dyne.org
13
+- https://mailinglists.dyne.org/cgi-bin/mailman/listinfo/dowsers
14
+
10 15
 
11 16
 
12 17
 # How to deploy Dowse on a Raspberry Pi
13 18
 - you need:
14
-- a Raspberry Pi (version 2 or 3)
15
-- a power supply with at least 2A power (the Raspberry Pi 3 needs 2.5A) and a Micro-USB connector
16
-- a MicroSD card with at least 4GB capacity, class 10
17
-- the Dowse image file from http://www.dowse.eu/ (until the new file is up you can take it from here. This is the image that Jaromil gave out at the workshop on September 27: https://www.khm.de/~sievers/devuan_dowse_raspi2.img )
18
-
19
+    - a Raspberry Pi (version 2 or 3)
20
+    - a power supply with at least 2A power (the Raspberry Pi 3 needs 2.5A) and a Micro-USB connector
21
+    - a MicroSD card with at least 4GB capacity, class 10
22
+    - the Dowse image file from http://www.dowse.eu/
23
+        - For now a newer image is available in this workshop
24
+## Wat to do
19 25
 - use your computer to clone the image onto the SD card (https://duckduckgo.com/?q=clone+raspberry+sd+card)
20
-- put the SD card into your Raspberry Pi
26
+    - https://beebom.com/how-clone-raspberry-pi-sd-card-windows-linux-macos/
27
+    - sudo fdisk -l
28
+        - gives you all mounted partitions, check the name of the SD card
29
+    - `sudo mount | grep sdb`
30
+    - were sdb is the name of the partition
31
+    - check wich partitions of the SD are munted and umount them
32
+    - `sudo dd if=~/dowseimagefile.dmg of=/dev/sdb`
33
+### clone on MAC
34
+- `diskutil list`
35
+- `diskutil unmountDisk </dev/disk3>`
36
+- `sudo dd if=~/<dowseIMGname.img> of=</dev/disk3>`
37
+
38
+
39
+## Deploy
21 40
 - connect it to your access point/router via an Ethernet cable
22
-- optional: you can connect a monitor via HDMI and keyboard and mouse, but you'll have to do it before powering it up. This might be useful at the beginning because you can log in to it right away, get its IP address and change settings, etc.
41
+    - optional: you can connect a monitor via HDMI and keyboard and mouse, but you'll have to do it before powering it up. This might be useful at the beginning because you can log in to it right away, get its IP address and change settings, etc.
23 42
 - connect it to power to boot it up
24 43
 - Dowse should now be running!
25 44
 
@@ -28,7 +47,7 @@
28 47
 
29 48
 
30 49
 - The router will give you the Dowse box's IP address. With the default SD card image Dowse takes its IP via DHCP
31
-- Use that to SSH into your Dowse box, i.e. with ssh root@192.168.0.1
50
+- Use that to SSH into your Dowse box, i.e. with `ssh root@192.168.0.1`
32 51
 - set up a static IP address for your dowse box (edit /etc/network/interfaces). After all, you have disabled the router's DHCP, so if you ever reboot the Dowse box (your new DHCP server), it will want to know which IP it should have.
33 52
 
34 53
 There are two users set up, root and dowse. The default password for root is toor, for the user dowse it is dowse. Log in as dowse to go straight to the interactive Dowse console.
@@ -37,11 +56,11 @@ There are two users set up, root and dowse. The default password for root is too
37 56
 - find out its IP address. Your router might tell you if you log in to its web interface, or try an app like https://github.com/adafruit/Adafruit-Pi-Finder/releases/tag/3.0.0
38 57
 
39 58
 - Let's assume it's 10.0.1.10. Open a Terminal and type
40
-ping 10.0.1.10
59
+`ping 10.0.1.10`
41 60
 - or open http://dowse.it in your browser. You should see the captive portal. Enter yourself as the administrator.
42 61
 
43 62
 - another way to check that the captive portal works:
44
-dig 10.0.1.10 dowse.it
63
+`dig 10.0.1.10 dowse.it`
45 64
 
46 65
 ## How to say dowse is running on WIN machines
47 66
 - Open the startmenu and type as a command to run 'cmd' - it will open a commandprompt
@@ -53,16 +72,51 @@ dig 10.0.1.10 dowse.it
53 72
 - Dowse runs your DHCP. If it fails, try to disable the DHCP on your router
54 73
 - Check if there is a seperate DHCPv6 that might cause IPv6 resolving issues (Windows 10 uses IPv6 for DNS)
55 74
 
75
+## Gource
76
+Gource allows to visualize the data using a colorful, dynamic and animated graph. It's processor-intensive so it should be run on a client machine.
77
+- http://gource.io/
78
+
79
+### How to use Gource on a windows machine
80
+- Windows does not come with SSH. It is possible to use an alternative SSH-client called 'Putty' (Download URL: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)
81
+- After installing, there is a ssh console client called plink.exe. It might not be in your 'PATH'. To run it from windows commandline, you need to specify the whole path. E.g. "c:\Program Files\Putty\plink.exe …"
82
+- When piping the output to gource, Windows does not show the interactive prompot for the password. But you can specify the password via the commandline switch -pw
83
+
84
+`<full_path_to_putty>\plink.exe -pw dowse -l dowse dowse.it /usr/local/dowse/bin/dowse-to-gource | <full_path_to_gource>\gource.exe --log-format custom -`
85
+
86
+Alternative:
87
+- Instead of cmd/powershell, use a shell that knows SSH and such tools like 'https://babun.github.io/'
88
+- Untested, please document :-)
89
+
90
+### On Mac:
91
+NB, if you dont have XCODE, is sufficient to have the minimal version of it. Open a terminal and type:
92
+- `xcode-select --install`
93
+-
94
+Then is time to install homebrew
95
+- install via homebrew https://brew.sh/
96
+First install brew if it isn't already, then just do brew install gource
97
+Once installed, start gource on your own laptop with a basic command like:
98
+
99
+`ssh -l dowse 10.0.1.10 /usr/local/dowse/bin/dowse-to-gource | gource --log-format custom - `
100
+
101
+NB you will be asked the password. Default password is
102
+     dowse
103
+
104
+### general
105
+you can also get dns queries listed directly in your shell i.e. with
106
+`ssh -l dowse 10.0.1.10 /usr/local/dowse/bin/dowse-to-gource`
107
+
108
+
56 109
 
57
-# How to start OSC
110
+
111
+## How to start OSC
58 112
 
59 113
 ssh into the dowse box (See 'Putty' further down if you are on Windows)
60 114
 
61 115
 then start:
62 116
 
63
-/usr/local/dowse/bin/dowse-to-osc osc.udp://ip-of-machine-to-send-to:port/path
117
+`/usr/local/dowse/bin/dowse-to-osc osc.udp://ip-of-machine-to-send-to:port/path`
64 118
 
65
-to make it start at every boot, put this line inside the file /etc/rc.local (edit as root)
119
+to make it start at every boot, put this line inside the file `/etc/rc.local` (edit as root)
66 120
 
67 121
 
68 122
 ## Node Red
@@ -82,13 +136,13 @@ after installing node red you can follow a great tutorial :
82 136
 ### Installation Linux
83 137
 - install node.js
84 138
 - in terminal
85
-sudo npm install -g --unsafe-perm node-red
139
+`sudo npm install -g --unsafe-perm node-red`
86 140
 
87 141
 ### Installation Mac
88 142
 - install via homebrew https://brew.sh/
89 143
 First install brew if it isn't already, then follow instructions here: http://flnkr.com/2016/03/node-red-install-on-mac-os-x/
90 144
 
91
-- once installed run: /usr/local/bin/node-red -v
145
+- once installed run: `/usr/local/bin/node-red -v`
92 146
 - then open http://127.0.0.1:1880 in your browser
93 147
 follow instructions on node-red documentation
94 148
 
@@ -97,33 +151,8 @@ go to node.js website and install node.js
97 151
 https://nodejs.org/en/
98 152
 
99 153
 open node terminal
100
-type: sudo npm install -g --unsafe-perm node-red
101
-
102
-
103
-## Gource
104
-Gource allows to visualize the data using a colorful, dynamic and animated graph. It's processor-intensive so it should be run on a client machine.
105
-- http://gource.io/
106
-
107
-### How to use Gource on a windows machine
108
-- Windows does not come with SSH. It is possible to use an alternative SSH-client called 'Putty' (Download URL: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)
109
-- After installing, there is a ssh console client called plink.exe. It might not be in your 'PATH'. To run it from windows commandline, you need to specify the whole path. E.g. "c:\Program Files\Putty\plink.exe …"
110
-- When piping the output to gource, Windows does not show the interactive prompot for the password. But you can specify the password via the commandline switch -pw
111
-
112
-<full_path_to_putty>\plink.exe -pw dowse -l dowse dowse.it /usr/local/dowse/bin/dowse-to-gource | <full_path_to_gource>\gource.exe --log-format custom -
113
-
114
-Alternative:
115
-- Instead of cmd/powershell, use a shell that knows SSH and such tools like 'https://babun.github.io/'
116
-- Untested, please document :-)
117
-
118
-### On Mac:
119
-install via homebrew https://brew.sh/
120
-First install brew if it isn't already, then just do brew install gource
121
-Once installed, start gource on your own laptop with
122
-ssh -l dowse 10.0.1.10 /usr/local/dowse/bin/dowse-to-gource | gource --log-format custom - #password is dowse
154
+type: `sudo npm install -g --unsafe-perm node-red`
123 155
 
124
-### general
125
-you can also get dns queries listed directly in your shell i.e. with
126
-ssh -l dowse 10.0.1.10 /usr/local/dowse/bin/dowse-to-gource
127 156
 
128 157
 
129 158
 

BIN
image/devuan_ascii_dowse_raspi2.img.xz


BIN
image/devuan_ascii_dowse_raspi2.tar.gz


BIN
logo_full.png


BIN
logo_small.png