Mercurial > hg > anonet-resdb
annotate contrib/peer2anonet/README.html @ 829:3750fcc21c33 draft
updates to peer2anonet, added "static bird"
| author | d3v11 <d3v11@d3v11.ano> |
|---|---|
| date | Wed, 21 Dec 2011 00:10:44 +0000 |
| parents | 452623af8bf0 |
| children | 682ccfe2ab61 |
| rev | line source |
|---|---|
| 804 | 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 | |
| 805 | 29 <b>From $RESDB_ROOT do:</b> |
| 804 | 30 |
| 805 | 31 ./contrib/peer2anonet/peer2anonet --configure generate a new local configuration and exit |
| 804 | 32 |
| 805 | 33 ./contrib/peer2anonet/peer2anonet --update regenerate peer configurations |
| 804 | 34 |
| 805 | 35 ./contrib/peer2anonet/peer2anonet --configure-peer generate a new peer configuration and update |
| 36 | |
| 37 ./contrib/peer2anonet/peer2anonet --rm-peer remove a peer configuration and update | |
| 804 | 38 |
| 805 | 39 ./contrib/peer2anonet/peer2anonet --install-daemontools installs daemontools |
| 804 | 40 |
| 805 | 41 ./contrib/peer2anonet/peer2anonet --install-ucspi-tcp installs ucspi-tcp |
| 804 | 42 |
| 805 | 43 ./contrib/peer2anonet/peer2anonet --install-djbdns installs djbdns |
| 804 | 44 |
| 805 | 45 ./contrib/peer2anonet/peer2anonet --configure-dns configures dnscache and tinydns zones |
| 804 | 46 |
| 805 | 47 ./contrib/peer2anonet/peer2anonet --update-dns updates tinydns-ano zone |
| 804 | 48 |
| 49 <b>RTFM:</b> | |
| 50 | |
| 51 <b>CONFIGURE:</b> | |
| 52 | |
| 53 I highly recommend that before you use peer2anonet | |
| 54 you ./configure resdb with tinydns support. | |
| 55 | |
| 56 ./contrib/peer2anonet/peer2anonet --configure | |
| 57 | |
| 58 <b>EXAMPLES:</b> | |
| 59 | |
| 807 | 60 Enter your AnoNet subnet: 1.1.5.0 |
| 61 Enter your AnoNet router: 1.1.5.1 | |
| 62 Enter your peering ip: 1.1.5.2 | |
| 63 Enter your AnoNet asn: 1150 | |
| 804 | 64 |
| 65 <b>CONFIGURE PEER:</b> | |
| 66 | |
| 67 ./contrib/peer2anonet/peer2anonet --configure-peer | |
| 68 | |
| 69 <b>KEY PAIRS:</b> | |
| 70 | |
| 71 before running peer2anonet to configure peers you can use | |
| 72 quicktun to generate keypairs: | |
| 73 | |
| 74 quicktun.keypair < /dev/random | |
| 75 | |
| 76 <b>EXAMPLES:</b> | |
| 77 | |
| 78 Enter your peer's name: d3v11 | |
| 79 Enter your peer's remote ip: 11.11.55.1 | |
| 80 Enter your peer's peering ip: 1.1.5.2 | |
| 81 Enter your peer's remote port: 21150 | |
| 82 Enter your local port: 61150 | |
| 83 Enter your peer's asn: 1150 | |
| 84 Enter your peer's public key: * see KEY PAIRS above * | |
| 85 Enter your private key: * see KEY PAIRS above * | |
| 86 | |
| 87 <b>RUN CHANGES:</b> | |
| 88 | |
| 89 peer2anonet exports the /service/$PEER/run file to | |
| 90 /etc/peer2anonet/peers/$PEER/run. If you need to | |
| 91 create customizations for peerings then make adjustments | |
| 92 to that file. | |
| 93 | |
| 94 <b>CONFIGURATION FILES:</b> | |
| 95 | |
|
829
3750fcc21c33
updates to peer2anonet, added "static bird"
d3v11 <d3v11@d3v11.ano>
parents:
807
diff
changeset
|
96 If /etc/peer2anonet/bird.conf exists, then peer2anonet |
|
3750fcc21c33
updates to peer2anonet, added "static bird"
d3v11 <d3v11@d3v11.ano>
parents:
807
diff
changeset
|
97 will not create a new bird. Instead it will use this |
|
3750fcc21c33
updates to peer2anonet, added "static bird"
d3v11 <d3v11@d3v11.ano>
parents:
807
diff
changeset
|
98 bird.conf and append new protocols to it. |
|
3750fcc21c33
updates to peer2anonet, added "static bird"
d3v11 <d3v11@d3v11.ano>
parents:
807
diff
changeset
|
99 |
| 804 | 100 /etc/peer2anonet/peers/$PEER/* contains: |
| 101 | |
| 102 asn local_port peering_ip pubkey remote_ip remote_port run seckey | |
| 103 | |
| 104 In the event you want to reconfigure a peer's tunnel you can alter the run | |
| 105 file and do `--update', rm run and modify the above files then use `--update', | |
| 106 or reconfigure the peering tunnel altogether with --configure-peer and choose | |
| 107 that peer's name. If you think this is absurd then you're probably right! I | |
| 108 plan on doing something with these files later. | |
| 109 | |
| 110 <b>CONFIGURE DNS:</b> | |
| 111 | |
| 112 If you did not ./configure resdb with tinydns support | |
| 113 then you need to do that before using this function. | |
| 114 | |
| 115 also before using you will need to have installed | |
| 116 daemontools, djbdns, and ucspi-tcp. peer2anonet | |
| 117 can do this for you with --install-* options. | |
| 118 | |
| 119 ./contrib/peer2anonet/peer2anonet --configure-dns | |
| 120 | |
| 121 <b>UPDATE DNS:</b> | |
| 122 | |
| 123 After a successful `--configure-dns', you can now | |
| 124 enjoy to use `--update-dns' to bring your AnoNet | |
| 125 domains up to speed. | |
| 126 | |
| 127 <b>COMPLAIN:</b> | |
| 128 | |
| 129 If this README doesn't tell you what you need to know | |
| 130 you can head over to www.d3v11.ano/peering. If that | |
| 131 doesn't get you what you want then either complain to | |
| 132 me or shoot both of us in the face. | |
| 133 | |
| 134 | |
| 135 | |
| 136 </pre></font></body></html> |