annotate 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
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
535
5965e074d13a added peer2anonet: autoconfig tool for easily setting up peering and bgp on anonet using quicktun, bird, and daemontools
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents:
diff changeset
1 DESCRIPTION:
5965e074d13a added peer2anonet: autoconfig tool for easily setting up peering and bgp on anonet using quicktun, bird, and daemontools
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents:
diff changeset
2 peer2anonet is an autoconfiguration utility to easily establish a
771
d76deb2af72f updated peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 668
diff changeset
3 peering session with BGP on AnoNet2.
535
5965e074d13a added peer2anonet: autoconfig tool for easily setting up peering and bgp on anonet using quicktun, bird, and daemontools
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents:
diff changeset
4
5965e074d13a added peer2anonet: autoconfig tool for easily setting up peering and bgp on anonet using quicktun, bird, and daemontools
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents:
diff changeset
5 DEPENDS ON:
5965e074d13a added peer2anonet: autoconfig tool for easily setting up peering and bgp on anonet using quicktun, bird, and daemontools
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents:
diff changeset
6 quicktun, bird, daemontools(non-deb), bash
5965e074d13a added peer2anonet: autoconfig tool for easily setting up peering and bgp on anonet using quicktun, bird, and daemontools
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents:
diff changeset
7
771
d76deb2af72f updated peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 668
diff changeset
8 USAGE:
535
5965e074d13a added peer2anonet: autoconfig tool for easily setting up peering and bgp on anonet using quicktun, bird, and daemontools
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents:
diff changeset
9
774
5cb0c795b9e6 updated peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 772
diff changeset
10 --configure generate a new local configuration and exit
535
5965e074d13a added peer2anonet: autoconfig tool for easily setting up peering and bgp on anonet using quicktun, bird, and daemontools
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents:
diff changeset
11
774
5cb0c795b9e6 updated peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 772
diff changeset
12 --update regenerate peer configurations
535
5965e074d13a added peer2anonet: autoconfig tool for easily setting up peering and bgp on anonet using quicktun, bird, and daemontools
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents:
diff changeset
13
774
5cb0c795b9e6 updated peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 772
diff changeset
14 --configure-peer generate a new peer configuration and update
537
8e8a01a680b4 peer2anonet changes made:
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents: 535
diff changeset
15
774
5cb0c795b9e6 updated peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 772
diff changeset
16 --rm-peer remove a peer configuration and update
5cb0c795b9e6 updated peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 772
diff changeset
17
5cb0c795b9e6 updated peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 772
diff changeset
18 --install-daemontools installs daemontools
547
76d0f12e2125 peer2anonet: made security enhancements for input data
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents: 545
diff changeset
19
776
cc3ed3f29ec7 updated README
d3v11 <d3v11@d3v11.ano>
parents: 774
diff changeset
20 --install-ucspi-tcp installs ucspi-tcp
cc3ed3f29ec7 updated README
d3v11 <d3v11@d3v11.ano>
parents: 774
diff changeset
21
cc3ed3f29ec7 updated README
d3v11 <d3v11@d3v11.ano>
parents: 774
diff changeset
22 --install-djbdns installs djbdns
cc3ed3f29ec7 updated README
d3v11 <d3v11@d3v11.ano>
parents: 774
diff changeset
23
772
1ba55b415d50 update peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 771
diff changeset
24 NOTES:
1ba55b415d50 update peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 771
diff changeset
25
777
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
26 KEY PAIRS:
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
27
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
28 before running peer2anonet to configure peers you can use
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
29 quicktun to generate keypairs:
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
30
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
31 quicktun.keypair</dev/random
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
32
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
33 RUN CHANGES:
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
34
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
35 peer2anonet exports the /service/$PEER/run file to
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
36 /etc/peer2anonet/peers/$PEER/run. If you need to
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
37 create customizations for peerings then make adjustments
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
38 to that file.
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
39
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
40 EXAMPLES:
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
41
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
42 ./peer2anonet --configure
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
43
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
44 Enter your AnoNet subnet: 1.2.3.0
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
45 Enter your AnoNet router: 1.2.3.1
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
46 Enter your peering ip: 1.2.3.4
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
47 Enter your AnoNet asn: 1234
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
48
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
49
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
50 ./peer2anonet --configure-peer
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
51
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
52 Enter your peer's name: d3v11
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
53 Enter your peer's remote ip: 11.11.55.1
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
54 Enter your peer's peering ip: 1.1.5.2
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
55 Enter your peer's remote port: 201150
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
56 Enter your peer's asn: 1150
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
57 Enter your peer's public key: * see keypairs above *
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
58 Enter your private key: * see keypairs above *
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
59
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
60 # peer2anonet uses the following for port configurations:
b13bf8dc2c0c updated peer2anonet stuff
d3v11 <d3v11@d3v11.ano>
parents: 776
diff changeset
61 LOCAL_PORT=20${PEERASN:0:4}
771
d76deb2af72f updated peer2anonet
d3v11 <d3v11@d3v11.ano>
parents: 668
diff changeset
62
539
7b9a87c560ef peer2anonet:
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents: 538
diff changeset
63
7b9a87c560ef peer2anonet:
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents: 538
diff changeset
64
535
5965e074d13a added peer2anonet: autoconfig tool for easily setting up peering and bgp on anonet using quicktun, bird, and daemontools
d3v1150m471c <d3v11@d3v1150m471c.ano>
parents:
diff changeset
65