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