summaryrefslogtreecommitdiff
path: root/contrib/peer2anonet/README.html
blob: 1f6e227ea8c759134f512f6e886e7f7f2990b87b (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
<html><body bgcolor="#000000"><font color="white">
<pre>
<b>DESCRIPTION:</b>

    peer2anonet is an autoconfiguration utility for
    setting up core services on AnoNet2. Enjoy :-).

<b>DEPENDS ON:</b>

    quicktun, bird, bash for now. it also installs
    some cool shit that you'll use later.

<b>AUTHOR:</b>

    d3v11 from <a href="http://www.d3v11.ano/">www.d3v11.ano</a>, somtimes, maybe, dunno.

<b>REPORT BULLSHIT TO:</b>
        
    /relayhell/d3v11

    d3v11@d3v11.ano

<b>USAGE:</b>

    ./contrib/peer2anonet/peer2anonet --help
    ./contrib/peer2anonet/peer2anonet --rtfm

<b>TORIFY:</b>

    --install-* flags should be compatible with Tor:

    export http_proxy='http://127.0.0.1:8118/'
    ./contrib/peer2anonet/peer2anonet --install-*

    You can use torify or usewithtor on most options
    but setting http_proxy is more reliable.

    torify ./contrib/peer2anonet/peer2anonet --install-*

    usewithtor ./contrib/peer2anonet/peer2anonet --install-*

<b>CONFIGURE:</b>

    I highly recommend that before you use peer2anonet
    you ./configure resdb with tinydns support.

    ./contrib/peer2anonet/peer2anonet --configure

    <b>EXAMPLES:</b>

        Enter your AnoNet subnet: 1.1.5.0
        Enter your AnoNet router: 1.1.5.1
        Enter your peering ip: 1.1.5.2
        Enter your AnoNet asn: 1150

<b>CONFIGURE PEER:</b>

    ./contrib/peer2anonet/peer2anonet --configure-peer

    <b>KEY PAIRS:</b>

        before running peer2anonet to configure peers
        you can use quicktun to generate keypairs:

        quicktun.keypair < /dev/random

    <b>EXAMPLES:</b>

        Enter your peer's name: d3v11
        Enter your peer's remote ip: 11.11.55.1
        Enter your peer's peering ip: 1.1.5.2
        Enter your peer's remote port: 21150
        Enter your local port: 61150
        Enter your peer's asn: 1150
        Enter your peer's public key: * see KEY PAIRS above *
        Enter your private key: * see KEY PAIRS above *

    <b>/SERVICE/$PEER/RUN CHANGES:</b>

        peer2anonet exports the /service/$PEER/run file to
        /etc/peer2anonet/peers/$PEER/run. If you need to
        create customizations for peerings then make 
        adjustments to that file.

    <b>CONFIGURATION FILES:</b>

        If /etc/peer2anonet/bird.conf exists, then
        peer2anonet will not create a new bird. Instead
        it will use this bird.conf and append new protocols
        to it. 

        /etc/peer2anonet/peers/$PEER/* contains:
                
        asn  local_port  peering_ip  pubkey
        remote_ip  remote_port  run  seckey

        In the event you want to reconfigure a peer's tunnel
        you can alter the run file and do `--update', rm run
        and modify the above files then use `--update',  or
        reconfigure the peering tunnel altogether with
        --configure-peer and choose that peer's name. If you
        think this is absurd then you're probably right! I 
        plan on doing something with these files later.

<b>CONFIGURE DNS:</b>

    If you did not ./configure resdb with tinydns support
    then you need to do that before using this function.

    also before using you will need to have installed
    daemontools, djbdns, and ucspi-tcp. peer2anonet
    can do this for you with --install-* options.

    ./contrib/peer2anonet/peer2anonet --configure-dns

<b>UPDATE DNS:</b>

    After a successful `--configure-dns', you can now
    enjoy to use `--update-dns' to bring your AnoNet
    domains up to speed.

<b>SETUP QMAIL:</b>

    If you did not ./configure resdb with tinydns support
    then you need to do that before using this function.

    also before using you will need to have installed
    daemontools, djbdns, and ucspi-tcp. peer2anonet
    can do this for you with --install-* options.

    setup-qmail will download and install qmail if it
    isn't already installed and configure your
    mx domain as a.mx.$nick.ano with the ip of your
    resdb git-daemon ip.

    ./contrib/peer2anonet/peer2anonet --setup-qmail

<b>COMPLAIN:</b>

    If this README doesn't tell you what you need to know
    you can head over to www.d3v11.ano/peering. If that
    doesn't get you what you want then either complain to
    me or shoot both of us in the face.

</pre></font></body></html>