| 1 |
nightmorph 11/03/02 09:53:25 |
| 2 |
|
| 3 |
Modified: ipv6.xml |
| 4 |
Log: |
| 5 |
remove 6to4 chapter for now, given comment #9 and discussion on bug 326771. totd is maintainer-wanted and no-herd, and only available on 2 arches. if 6to4 is really a necessity, and/or there are better cross-platform proxy tools, then maybe we can add a chapter on 6to4 back to the guide. |
| 6 |
|
| 7 |
Revision Changes Path |
| 8 |
1.37 xml/htdocs/doc/en/ipv6.xml |
| 9 |
|
| 10 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/ipv6.xml?rev=1.37&view=markup |
| 11 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/ipv6.xml?rev=1.37&content-type=text/plain |
| 12 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/ipv6.xml?r1=1.36&r2=1.37 |
| 13 |
|
| 14 |
Index: ipv6.xml |
| 15 |
=================================================================== |
| 16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/ipv6.xml,v |
| 17 |
retrieving revision 1.36 |
| 18 |
retrieving revision 1.37 |
| 19 |
diff -u -r1.36 -r1.37 |
| 20 |
--- ipv6.xml 12 Aug 2010 06:20:16 -0000 1.36 |
| 21 |
+++ ipv6.xml 2 Mar 2011 09:53:25 -0000 1.37 |
| 22 |
@@ -1,6 +1,6 @@ |
| 23 |
<?xml version="1.0" encoding="UTF-8"?> |
| 24 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 25 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/ipv6.xml,v 1.36 2010/08/12 06:20:16 nightmorph Exp $ --> |
| 26 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/ipv6.xml,v 1.37 2011/03/02 09:53:25 nightmorph Exp $ --> |
| 27 |
|
| 28 |
<guide> |
| 29 |
<title>Gentoo IPv6 Router Guide</title> |
| 30 |
@@ -34,8 +34,8 @@ |
| 31 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 32 |
<license/> |
| 33 |
|
| 34 |
-<version>3</version> |
| 35 |
-<date>2010-08-11</date> |
| 36 |
+<version>4</version> |
| 37 |
+<date>2011-03-02</date> |
| 38 |
|
| 39 |
<chapter> |
| 40 |
<title>Preliminaries</title> |
| 41 |
@@ -742,166 +742,6 @@ |
| 42 |
</chapter> |
| 43 |
|
| 44 |
<chapter> |
| 45 |
-<title>Using 6to4 Conversion</title> |
| 46 |
-<section> |
| 47 |
-<title>Basic principles</title> |
| 48 |
-<body> |
| 49 |
- |
| 50 |
-<p> |
| 51 |
-6to4 conversion can be used if you want to have hosts that talk to IPv4 |
| 52 |
-hosts over a purely IPv6 connection. Thus you can have an entirely IPv6 |
| 53 |
-internal network, with one host dealing with connecting to the outside |
| 54 |
-IPv4/IPv6 world. |
| 55 |
-</p> |
| 56 |
- |
| 57 |
-</body> |
| 58 |
-</section> |
| 59 |
- |
| 60 |
-<section> |
| 61 |
-<title>DNS configuration</title> |
| 62 |
-<body> |
| 63 |
- |
| 64 |
-<p> |
| 65 |
-To get 6to4 conversion working, a DNS proxy, <c>totd</c>, needs to be |
| 66 |
-configured that will send you AAAA records for sites that really only have |
| 67 |
-A records. These AAAA records will point to IPv6 addresses which don't |
| 68 |
-actually exist, but which will get routed through a 6to4 proxy. |
| 69 |
-</p> |
| 70 |
- |
| 71 |
-<p> |
| 72 |
-First, install <c>totd</c>: |
| 73 |
-</p> |
| 74 |
- |
| 75 |
-<pre caption="Installing totd"> |
| 76 |
-# <i>emerge totd</i> |
| 77 |
-</pre> |
| 78 |
- |
| 79 |
-<p> |
| 80 |
-Next, we need to setup <path>/etc/totd.conf</path> with some basic |
| 81 |
-configuration information. |
| 82 |
-</p> |
| 83 |
- |
| 84 |
-<pre caption="Sample /etc/totd.conf"> |
| 85 |
-<comment>(Points to a real DNS nameserver)</comment> |
| 86 |
-forwarder 192.168.0.2 port 53 |
| 87 |
-<comment>(What prefix to put before faked AAAA records)</comment> |
| 88 |
-prefix 3ffe:abcd:1234:9876:: |
| 89 |
-<comment>(What port to run totd on)</comment> |
| 90 |
-port 5005 |
| 91 |
-<comment>(What PID file to use)</comment> |
| 92 |
-pidfile /var/run/totd.pid |
| 93 |
-<comment>(Actually do 6to4 stuff)</comment> |
| 94 |
-stf |
| 95 |
-</pre> |
| 96 |
- |
| 97 |
-<note> |
| 98 |
-<c>totd</c> must be set to use a port different than port 53 if another |
| 99 |
-nameserver is running on the same machine. |
| 100 |
-</note> |
| 101 |
- |
| 102 |
-</body> |
| 103 |
-</section> |
| 104 |
- |
| 105 |
-<section> |
| 106 |
-<title>6to4 proxy</title> |
| 107 |
-<body> |
| 108 |
- |
| 109 |
-<p> |
| 110 |
-<c>ptrtd</c> will be used as a 6to4 proxy, enabling connections between |
| 111 |
-the internal IPv6 host and the outside IPv4 host. |
| 112 |
-</p> |
| 113 |
- |
| 114 |
-<pre caption="Installing ptrtd"> |
| 115 |
-# <i>emerge ptrtd</i> |
| 116 |
-</pre> |
| 117 |
- |
| 118 |
-<p> |
| 119 |
-We now need to configure <c>ptrtd</c>, telling it what fake prefix |
| 120 |
-(the one we setup <c>totd</c> to use) to create proxy connections for. |
| 121 |
-Edit <path>/etc/conf.d/ptrtd</path> and set <c>IPV6_PREFIX</c>. This |
| 122 |
-should be the same prefix as was configured with <c>totd</c>. |
| 123 |
-</p> |
| 124 |
- |
| 125 |
-<pre caption="Sample /etc/ptrtd.conf"> |
| 126 |
-IPV6_PREFIX="3ffe:abcd:1234:9876::" |
| 127 |
-</pre> |
| 128 |
- |
| 129 |
-<p> |
| 130 |
-You can now start totd, and enable it to start at boot. |
| 131 |
-</p> |
| 132 |
- |
| 133 |
-<pre caption="Starting totd"> |
| 134 |
-# <i>/etc/init.d/totd start</i> |
| 135 |
-# <i>rc-update add totd default</i> |
| 136 |
-</pre> |
| 137 |
- |
| 138 |
-</body> |
| 139 |
-</section> |
| 140 |
- |
| 141 |
-<section> |
| 142 |
-<title>Client configuration and testing</title> |
| 143 |
-<body> |
| 144 |
- |
| 145 |
-<p> |
| 146 |
-Clients may now be configured to connect to both IPv4 and IPv6 hosts |
| 147 |
-through an IPv6 only connection. Assuming that the clients are already |
| 148 |
-receiving an IP address from radvd, we simply need to add a new DNS |
| 149 |
-resolver entry, and add a default route for those "fake addresses". |
| 150 |
-First, add an entry at the top of your <path>/etc/resolv.conf</path> |
| 151 |
-pointing to the machine running <c>totd</c>. |
| 152 |
-</p> |
| 153 |
- |
| 154 |
-<pre caption="/etc/resolv.conf sample"> |
| 155 |
-nameserver 2001:470:1f00:296::1 <comment>(The server running totd)</comment> |
| 156 |
-</pre> |
| 157 |
- |
| 158 |
-<p> |
| 159 |
-To test name resolution, request an AAAA record for a known IPv4 |
| 160 |
-only site. |
| 161 |
-</p> |
| 162 |
- |
| 163 |
-<pre caption="Testing name resolution"> |
| 164 |
-# <i>dig aaaa google.com</i> |
| 165 |
-;; ANSWER SECTION: |
| 166 |
-google.com. 300 IN AAAA 3ffe:abcd:1234:9876::d8ef:3364 |
| 167 |
-google.com. 300 IN AAAA 3ffe:abcd:1234:9876::d8ef:3564 |
| 168 |
-</pre> |
| 169 |
- |
| 170 |
-<p> |
| 171 |
-We will now add a default route for all addresses prefixed with our |
| 172 |
-chosen fake prefix. |
| 173 |
-</p> |
| 174 |
- |
| 175 |
-<pre caption="Adding the default route"> |
| 176 |
-<comment>(Assuming your IPv6 interface is eth0)</comment> |
| 177 |
-# <i>ip route add 3ffe:abcd:1234:9876::/64 via 2001:470:1f00:296::1 dev eth0</i> |
| 178 |
-</pre> |
| 179 |
- |
| 180 |
-<p> |
| 181 |
-Finally, use <c>ping6</c> to ping google.com at it's fake IPv6 location. |
| 182 |
-</p> |
| 183 |
- |
| 184 |
-<pre caption="Testing 6to4"> |
| 185 |
-# <i>ping6 -c 2 google.com</i> |
| 186 |
-PING 3ffe:abcd:1234:9876::d8ef:3364(3ffe:abcd:1234:9876::d8ef:3364) 56 data bytes |
| 187 |
-64 bytes from 3ffe:abcd:1234:9876::d8ef:3364: icmp_seq=1 ttl=54 time=0.106 ms |
| 188 |
-64 bytes from 3ffe:abcd:1234:9876::d8ef:3364: icmp_seq=2 ttl=54 time=0.090 ms |
| 189 |
- |
| 190 |
---- 3ffe:abcd:1234:9876::d8ef:3364 ping statistics --- |
| 191 |
-2 packets transmitted, 2 received, 0% packet loss, time 1000ms |
| 192 |
-rtt min/avg/max/mdev = 0.090/0.098/0.106/0.008 ms |
| 193 |
-</pre> |
| 194 |
- |
| 195 |
-<note> |
| 196 |
-The router running <c>ptrtd</c> is actually replying, but this at least |
| 197 |
-tells us things are working. |
| 198 |
-</note> |
| 199 |
- |
| 200 |
-</body> |
| 201 |
-</section> |
| 202 |
-</chapter> |
| 203 |
- |
| 204 |
-<chapter> |
| 205 |
<title>Other Resources</title> |
| 206 |
<section> |
| 207 |
<body> |
Archives