summaryrefslogtreecommitdiff
path: root/contrib/peer2anonet/README.html
blob: 4fb57218927bf32134be124a114928525f53750f (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
<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-*

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