annotate contrib/peer2anonet/README.html @ 884:cd9d07046b1c draft

peer2anonet: fix potential for unexecutable rc.local bug, added visual support to README for guys with small terminals.
author d3v11 <d3v11@d3v11.ano>
date Sun, 15 Jan 2012 22:40:56 +0000
parents 1fecd121452d
children c678f1f6a7e3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
1 <html><body bgcolor="#000000"><font color="white">
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
2 <pre>
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
3 <b>DESCRIPTION:</b>
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
4
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
5 peer2anonet is an autoconfiguration utility for
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
6 setting up core services on AnoNet2. Enjoy :-).
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
7
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
8 <b>DEPENDS ON:</b>
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
9
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
10 quicktun, bird, bash for now. it also installs
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
11 some cool shit that you'll use later.
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
12
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
13 <b>AUTHOR:</b>
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
14
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
15 d3v11 from <a href="http://www.d3v11.ano/">www.d3v11.ano</a>, somtimes, maybe, dunno.
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
16
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
17 <b>REPORT BULLSHIT TO:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
18
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
19 /relayhell/d3v11
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
20
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
21 d3v11@d3v11.ano
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
22
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
23 <b>USAGE:</b>
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
24
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
25 ./contrib/peer2anonet/peer2anonet --help
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
26 ./contrib/peer2anonet/peer2anonet --rtfm
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
27
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
28 <b>TORIFY:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
29
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
30 --install-* flags should be compatible with Tor:
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
31
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
32 export http_proxy='http://127.0.0.1:8118/'
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
33 ./contrib/peer2anonet/peer2anonet --install-*
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
34
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
35 torify ./contrib/peer2anonet/peer2anonet --install-*
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
36
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
37 usewithtor ./contrib/peer2anonet/peer2anonet --install-*
878
1fecd121452d added --install-nacl to readme
d3v11 <d3v11@d3v11.ano>
parents: 877
diff changeset
38
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
39 <b>CONFIGURE:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
40
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
41 I highly recommend that before you use peer2anonet
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
42 you ./configure resdb with tinydns support.
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
43
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
44 ./contrib/peer2anonet/peer2anonet --configure
877
682ccfe2ab61 added tor usage note
d3v11 <d3v11@d3v11.ano>
parents: 829
diff changeset
45
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
46 <b>EXAMPLES:</b>
877
682ccfe2ab61 added tor usage note
d3v11 <d3v11@d3v11.ano>
parents: 829
diff changeset
47
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
48 Enter your AnoNet subnet: 1.1.5.0
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
49 Enter your AnoNet router: 1.1.5.1
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
50 Enter your peering ip: 1.1.5.2
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
51 Enter your AnoNet asn: 1150
877
682ccfe2ab61 added tor usage note
d3v11 <d3v11@d3v11.ano>
parents: 829
diff changeset
52
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
53 <b>CONFIGURE PEER:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
54
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
55 ./contrib/peer2anonet/peer2anonet --configure-peer
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
56
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
57 <b>KEY PAIRS:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
58
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
59 before running peer2anonet to configure peers
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
60 you can use quicktun to generate keypairs:
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
61
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
62 quicktun.keypair < /dev/random
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
63
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
64 <b>EXAMPLES:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
65
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
66 Enter your peer's name: d3v11
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
67 Enter your peer's remote ip: 11.11.55.1
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
68 Enter your peer's peering ip: 1.1.5.2
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
69 Enter your peer's remote port: 21150
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
70 Enter your local port: 61150
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
71 Enter your peer's asn: 1150
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
72 Enter your peer's public key: * see KEY PAIRS above *
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
73 Enter your private key: * see KEY PAIRS above *
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
74
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
75 <b>/SERVICE/$PEER/RUN CHANGES:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
76
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
77 peer2anonet exports the /service/$PEER/run file to
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
78 /etc/peer2anonet/peers/$PEER/run. If you need to
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
79 create customizations for peerings then make
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
80 adjustments to that file.
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
81
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
82 <b>CONFIGURATION FILES:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
83
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
84 If /etc/peer2anonet/bird.conf exists, then
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
85 peer2anonet will not create a new bird. Instead
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
86 it will use this bird.conf and append new protocols
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
87 to it.
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
88
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
89 /etc/peer2anonet/peers/$PEER/* contains:
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
90
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
91 asn local_port peering_ip pubkey
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
92 remote_ip remote_port run seckey
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
93
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
94 In the event you want to reconfigure a peer's tunnel
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
95 you can alter the run file and do `--update', rm run
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
96 and modify the above files then use `--update', or
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
97 reconfigure the peering tunnel altogether with
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
98 --configure-peer and choose that peer's name. If you
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
99 think this is absurd then you're probably right! I
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
100 plan on doing something with these files later.
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
101
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
102 <b>CONFIGURE DNS:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
103
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
104 If you did not ./configure resdb with tinydns support
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
105 then you need to do that before using this function.
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
106
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
107 also before using you will need to have installed
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
108 daemontools, djbdns, and ucspi-tcp. peer2anonet
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
109 can do this for you with --install-* options.
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
110
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
111 ./contrib/peer2anonet/peer2anonet --configure-dns
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
112
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
113 <b>UPDATE DNS:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
114
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
115 After a successful `--configure-dns', you can now
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
116 enjoy to use `--update-dns' to bring your AnoNet
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
117 domains up to speed.
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
118
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
119 <b>COMPLAIN:</b>
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
120
884
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
121 If this README doesn't tell you what you need to know
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
122 you can head over to www.d3v11.ano/peering. If that
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
123 doesn't get you what you want then either complain to
cd9d07046b1c peer2anonet:
d3v11 <d3v11@d3v11.ano>
parents: 878
diff changeset
124 me or shoot both of us in the face.
804
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
125
0ab988a1cec7 updates for peer2anonet,
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
126 </pre></font></body></html>