view contrib/peer2anonet/README @ 777:b13bf8dc2c0c draft

updated peer2anonet stuff
author d3v11 <d3v11@d3v11.ano>
date Sat, 26 Nov 2011 00:27:46 +0000
parents cc3ed3f29ec7
children 150043713880
line wrap: on
line source

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}