summaryrefslogtreecommitdiff
path: root/contrib/peer2anonet/README.html
blob: 7aa031dd887ec1e376ddddff4b059e92826648f5 (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
146
147
<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>

        <b>IRC:</b>
        
            /relayhell/d3v11

        <b>EMAIL:</b>
        
            d3v11@d3v11.ano

<b>USAGE:</b>

    <b>From $RESDB_ROOT do:</b>

        ./contrib/peer2anonet/peer2anonet --configure             generate a new local configuration and exit

        ./contrib/peer2anonet/peer2anonet --update                regenerate peer configurations

        ./contrib/peer2anonet/peer2anonet --configure-peer        generate a new peer configuration and update

        ./contrib/peer2anonet/peer2anonet --rm-peer               remove a peer configuration and update

        ./contrib/peer2anonet/peer2anonet --install-daemontools   installs daemontools

        ./contrib/peer2anonet/peer2anonet --install-ucspi-tcp     installs ucspi-tcp

        ./contrib/peer2anonet/peer2anonet --install-djbdns        installs djbdns

        ./contrib/peer2anonet/peer2anonet --configure-dns         configures dnscache and tinydns zones

        ./contrib/peer2anonet/peer2anonet --update-dns            updates tinydns-ano zone

<b>RTFM:</b>

    <b>TORIFY:</b>

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

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

        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>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>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>