Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 128 lines (98 sloc) 4.491 kb
4e5a4d6 end of life statement for freebsd[23] (2 is still not maintained to some...
itojun authored
1 Installation procedure - FreeBSD 3.5
916f0a8 copied from freebsd2.
itojun authored
2 KAME project
4e5a4d6 end of life statement for freebsd[23] (2 is still not maintained to some...
itojun authored
3 $Id: INSTALL,v 1.16 2001/02/10 05:17:09 itojun Exp $
916f0a8 copied from freebsd2.
itojun authored
4
5
6 You'll need to follow the steps below. They can be separated into two major
7 sections - kernel build and userland build.
8
9 Be sure to perform "tree preparation" procedure, described in
ac46a82 fixes for freebsd3.
shin authored
10 ../INSTALL, prior to taking the steps below.
916f0a8 copied from freebsd2.
itojun authored
11
4e5a4d6 end of life statement for freebsd[23] (2 is still not maintained to some...
itojun authored
12 Note that, KAME/FreeBSD 3.5 has reached its end of life. We supply it for
13 reference purposes only. The tree may not compile at all.
14 Use newer BSD official releases, or KAME kit on more recent BSD releases.
15
916f0a8 copied from freebsd2.
itojun authored
16
17 A. Backup
18 =========
19 The following procedure replaces, or overwrites, the following
20 files/directories:
21 /kernel
22 /usr/include
23 so you may want to back them up before going through the steps.
24
25 A-1. Backup your kernel file, if you need to.
26 # cp /kernel /kernel.previous
27
28 A-2. Backup /usr/include directory, if you want an untouched tree to be
29 preserved somewhere.
30 # cd /usr
31 # mkdir include.clean
32 # cd include.clean
33 # (cd ../include; tar Bpcf - . ) | tar Bpxf -
34
35
36 B. Kernel build
37 ===============
ddc517c s/NetBSD/FreeBSD/
k-sugyou authored
38 Consult FreeBSD documentations for more detail.
916f0a8 copied from freebsd2.
itojun authored
39
f68528a add B-0 and C-0 (move directory downward)
itojun authored
40 B-0. It is assumed that you are in platform-specific directory (kame/freebsd3).
41 If you are not, chdir to there.
42
916f0a8 copied from freebsd2.
itojun authored
43 B-1. Go down to sys/i386/conf.
44 % cd sys/i386/conf
45
f5484b3 - use full-path for /usr/sbin/config, as many do not have search path
itojun authored
46 B-2. Make a kernel configuration file, and invoke "/usr/sbin/config CONFIGFILE".
916f0a8 copied from freebsd2.
itojun authored
47 GENERIC.v6 should have commonly used IPv6 definitions, so you may want to
48 copy the file to begin with.
ac3107a copy template kernel config file
itojun authored
49 % cp GENERIC.v6 CONFIGFILE
50 % vi CONFIGFILE
f5484b3 - use full-path for /usr/sbin/config, as many do not have search path
itojun authored
51 % /usr/sbin/config CONFIGFILE
916f0a8 copied from freebsd2.
itojun authored
52
f5484b3 - use full-path for /usr/sbin/config, as many do not have search path
itojun authored
53 B-3. Build the kernel. The process will make kernel file named "kernel".
916f0a8 copied from freebsd2.
itojun authored
54 % cd ../../compile/CONFIGFILE
55 % make depend
56 % make
57
ac46a82 fixes for freebsd3.
shin authored
58 B-4. Install the kernel file to root directory, as root.
59 # make install
916f0a8 copied from freebsd2.
itojun authored
60
61
62 C. Userland build
63 =================
f68528a add B-0 and C-0 (move directory downward)
itojun authored
64 C-0. It is assumed that you are in platform-specific directory (kame/freebsd3).
65 If you are not, chdir to there.
66
916f0a8 copied from freebsd2.
itojun authored
67 C-1. Invoke "make includes" as normal user, then "make install-includes"
68 as root. This will populate KAME-ready include files into /usr/include.
69 % make includes
70 # make install-includes
71
72 C-2. As normal user (or root, if you prefer) perform "make".
73 % make
74
75 C-3. As root, perform "make install". This will install necessary userland
76 tools into /usr/local/v6/{bin,sbin,whatever}. This should not replace
77 existing IPv4-only userland tools, so it is safe.
78 # make install
79
80
81 D. Reboot
82 =========
83 D-1. Reboot with the command you like.
84 # fastboot
a0618f6 add short description on configuration.
itojun authored
85
86
87 E. Configurations, in short
88 ===========================
89 E-1. Most of configuration files are placed in /usr/local/v6/etc.
90 You may want to copy those foo.sample files into non-sample (foo),
91 edit as necessary. You may also want to invoke /usr/local/v6/etc/rc.net6
f5484b3 - use full-path for /usr/sbin/config, as many do not have search path
itojun authored
92 from /etc/rc.local, by adding the following into /etc/rc.local:
93 if [ -f /usr/local/v6/etc/rc.net6 ]; then
94 sh /usr/local/v6/etc/rc.net6
95 fi
a0618f6 add short description on configuration.
itojun authored
96
ac46a82 fixes for freebsd3.
shin authored
97 E-2. If you would like to use IPv6-ready inetd, you will need to also invoke
98 /usr/local/v6/sbin/inet46d.
931b6b2 grammatical fix
jinmei authored
99 It can coexist with original /usr/sbin/inetd, but when both of them are
ac46a82 fixes for freebsd3.
shin authored
100 invoked, IPv4 connection accept is always treated by /usr/sbin/inetd.
931b6b2 grammatical fix
jinmei authored
101 When only /usr/local/v6/sbin/inet46d is invoked, it accepts each of
ac46a82 fixes for freebsd3.
shin authored
102 IPv4 and IPv6 connection request.
103 Configuration file is placed in /usr/local/v6/etc/inet6d.conf, but with
104 enhanced syntax. Inet46d accepts either of IPv4 and IPv6 connection by
105 default, but you can configure it to accept only one of those protocols
106 by each daemon basis. Consult manpages for details.
a0618f6 add short description on configuration.
itojun authored
107
c6d351a invoke /dev/MAKEDEV.altq to use altq.
itojun authored
108 E-3. If you wish to use ALTQ, you may need to invoke /dev/MAKEDEV.altq.
109 # cd /dev
110 # sh MAKEDEV.altq all
111
112 E-4. Commands modified by KAME project are placed in /usr/local/v6/{bin,sbin}.
a0618f6 add short description on configuration.
itojun authored
113 For daily use, you will need to add both of (or either of) them
114 into your command search path (consult manpage for your favorite
115 shell). Make sure to make them used before /usr/bin or /usr/sbin,
116 otherwise you end up using OS-supplied (hence not IPv6 nor IPsec capable)
117 commands.
118
c6d351a invoke /dev/MAKEDEV.altq to use altq.
itojun authored
119 E-5. There are batch of documents installed into /usr/local/v6/man
a0618f6 add short description on configuration.
itojun authored
120 and /usr/local/v6/share/doc. Please read them as necessary.
121 If you wish to develop your own programs, we suggest you to read through
122 supplied documents, RFCs, and other documents to learn how.
9c780cd added PAO3 issues as same as freebsd2
shin authored
123
124 F. PAO3 issues
125 =============
856ab08 Removed PAO3 tricky issue. It is about PAO2, not about PAO3.
sumikawa authored
126 Many of FreeBSD3.x users install PAO3 PCMCIA support code. If you would like
9c780cd added PAO3 issues as same as freebsd2
shin authored
127 to use both PAO3 and KAME, you'll need to apply PAO3 patches onto KAME tree.
Something went wrong with that request. Please try again.