Mercurial > hg > anonet-resdb

comparison contrib/peer2anonet/README.html @ 804:0ab988a1cec7 draft

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
updates for peer2anonet, ./contrib/peer2anonet/peer2anonet --update-dns can now bring tinydns-ano up to date.
author d3v11 <d3v11@d3v11.ano>
date Tue, 29 Nov 2011 09:23:30 +0000
parents
children 994843bd423f
comparison
equal deleted inserted replaced
803:3761c3e87765 804:0ab988a1cec7
1 <html><body bgcolor="#000000"><font color="white">
2 <pre>
3 <b>DESCRIPTION:</b>
4
5 peer2anonet is an autoconfiguration utility for setting
6 up core services on AnoNet2. Enjoy :-).
7
8 <b>DEPENDS ON:</b>
9
10 quicktun, bird, bash for now. it also installs some cool shit
11 that you'll use later.
12
13 <b>AUTHOR:</b>
14
15 d3v11 from <a href="http://www.d3v11.ano/">www.d3v11.ano</a>, somtimes, maybe, dunno.
16
17 <b>REPORT BULLSHIT TO:</b>
18
19 <b>IRC:</b>
20
21 /relayhell/d3v11
22
23 <b>EMAIL:</b>
24
25 d3v11@d3v11.ano
26
27 <b>USAGE:</b>
28
29 ./contrib/peer2anonet/peer2anonet --configure generate a new local configuration and exit
30
31 ./contrib/peer2anonet/peer2anonet --update regenerate peer configurations
32
33 ./contrib/peer2anonet/peer2anonet --configure-peer generate a new peer configuration and update
34
35 ./contrib/peer2anonet/peer2anonet --rm-peer remove a peer configuration and update
36
37 ./contrib/peer2anonet/peer2anonet --install-daemontools installs daemontools
38
39 ./contrib/peer2anonet/peer2anonet --install-ucspi-tcp installs ucspi-tcp
40
41 ./contrib/peer2anonet/peer2anonet --install-djbdns installs djbdns
42
43 ./contrib/peer2anonet/peer2anonet --configure-dns configures dnscache and tinydns zones
44
45 ./contrib/peer2anonet/peer2anonet --update-dns updates tinydns-ano zone
46
47 <b>RTFM:</b>
48
49 <b>CONFIGURE:</b>
50
51 I highly recommend that before you use peer2anonet
52 you ./configure resdb with tinydns support.
53
54 ./contrib/peer2anonet/peer2anonet --configure
55
56 <b>EXAMPLES:</b>
57
58 Enter your AnoNet subnet: 1.2.3.0
59 Enter your AnoNet router: 1.2.3.1
60 Enter your peering ip: 1.2.3.4
61 Enter your AnoNet asn: 1234
62
63 <b>CONFIGURE PEER:</b>
64
65 ./contrib/peer2anonet/peer2anonet --configure-peer
66
67 <b>KEY PAIRS:</b>
68
69 before running peer2anonet to configure peers you can use
70 quicktun to generate keypairs:
71
72 quicktun.keypair < /dev/random
73
74 <b>EXAMPLES:</b>
75
76 Enter your peer's name: d3v11
77 Enter your peer's remote ip: 11.11.55.1
78 Enter your peer's peering ip: 1.1.5.2
79 Enter your peer's remote port: 21150
80 Enter your local port: 61150
81 Enter your peer's asn: 1150
82 Enter your peer's public key: * see KEY PAIRS above *
83 Enter your private key: * see KEY PAIRS above *
84
85 <b>RUN CHANGES:</b>
86
87 peer2anonet exports the /service/$PEER/run file to
88 /etc/peer2anonet/peers/$PEER/run. If you need to
89 create customizations for peerings then make adjustments
90 to that file.
91
92 <b>CONFIGURATION FILES:</b>
93
94 /etc/peer2anonet/peers/$PEER/* contains:
95
96 asn local_port peering_ip pubkey remote_ip remote_port run seckey
97
98 In the event you want to reconfigure a peer's tunnel you can alter the run
99 file and do `--update', rm run and modify the above files then use `--update',
100 or reconfigure the peering tunnel altogether with --configure-peer and choose
101 that peer's name. If you think this is absurd then you're probably right! I
102 plan on doing something with these files later.
103
104 <b>CONFIGURE DNS:</b>
105
106 If you did not ./configure resdb with tinydns support
107 then you need to do that before using this function.
108
109 also before using you will need to have installed
110 daemontools, djbdns, and ucspi-tcp. peer2anonet
111 can do this for you with --install-* options.
112
113 ./contrib/peer2anonet/peer2anonet --configure-dns
114
115 <b>UPDATE DNS:</b>
116
117 After a successful `--configure-dns', you can now
118 enjoy to use `--update-dns' to bring your AnoNet
119 domains up to speed.
120
121 <b>COMPLAIN:</b>
122
123 If this README doesn't tell you what you need to know
124 you can head over to www.d3v11.ano/peering. If that
125 doesn't get you what you want then either complain to
126 me or shoot both of us in the face.
127
128
129
130 </pre></font></body></html>