contrib/peer2anonet/README


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

DESCRIPTION:
     peer2anonet is an autoconfiguration utility to easily establish a
     peering session with BGP on AnoNet2.

DEPENDS ON:
      quicktun, bird, daemontools(non-deb), bash

USAGE:

    --configure             generate a new local configuration and exit

    --update                regenerate peer configurations

    --configure-peer        generate a new peer configuration and update

    --rm-peer               remove a peer configuration and update

    --install-daemontools   installs daemontools

    --install-ucspi-tcp     installs ucspi-tcp

    --install-djbdns        installs djbdns

NOTES:

    KEY PAIRS:

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

            quicktun.keypair</dev/random

    RUN CHANGES:

        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.

    EXAMPLES:

        ./peer2anonet --configure

            Enter your AnoNet subnet: 1.2.3.0
            Enter your AnoNet router: 1.2.3.1
            Enter your peering ip: 1.2.3.4
            Enter your AnoNet asn: 1234


        ./peer2anonet --configure-peer

            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: 201150
            Enter your peer's asn: 1150
            Enter your peer's public key: * see keypairs above *
            Enter your private key: * see keypairs above *

            # peer2anonet uses the following for port configurations:
            LOCAL_PORT=20${PEERASN:0:4}