HOWTO install ALTQ on FreeBSD 4.

3
27-May-2001
this howto was used to install altq on a stock standard freebsd 4.3 clean instal
lation, presuming you installed the kernel sources in /usr/src directory
cd /usr/src
fetch or wget is your friend, when downloading files. these urls were for the cu
rrent distribution as of this date
fetch ftp://ftp.csl.sony.co.jp/pub/kjc/altq-3.0.tar.gz
fetch ftp://ftp.csl.sony.co.jp/pub/kjc/altq-3.0-sys-altq-freebsd-4.3.patch
# unpackage the archive
gzip -d altq-3.0.tar.gz
tar -xvf altq-3.0.tar
# rename the new patch for freebsd 4.3
cp altq-3.0-sys-altq-freebsd-4.3.patch
patch

altq-3.0/sys-altq/sys-altq-freebsd-4.3.

# patch the kernel and altq src (a backup is made).

# it helps if you have done a 'make clean' recently (optional).
mkdir sys-altq
cd sys
tar cvf - . | (cd ../sys-altq; tar xf -)
cd /usr/src/sys-altq
Now, apply the actual patch itself
patch -p < /usr/src/altq-3.0/sys-altq/sys-altq-freebsd-4.3.patch
# should say something like this after patching and completing successfully
Hunk #6 succeeded at 2389.
Hunk #7 succeeded at 2846.
mkdir altq
cp /usr/src/altq-3.0/sys-altq/altq/* altq/
kame provides a default kernel config file called ALTQ. you may merge your KERNE
L config with ALTQ, the only options i needed to ensure i was alright so far.. y
mmv or you may not need these. incidentally, some may not approve, but i compile
d in ipfilter support and the two coexist quite happily.
cd i386/conf/
cp ALTQ ALTQ.mybackup

vi ALTQ
options SOFTUPDATES
maxusers 64
:wq
Finish compiling the altq tools
config ALTQ
cd ../../compile/ALTQ
make depend
make clean
make

# keep a backup of your currently booting kernel

cp /kernel /kernel.mybackup
# install the new kernel which should now include altq support
make install
reboot using the new kernel now
sync
reboot
if at this point all succeeded and rebooted
# finish setting up altq
cd /usr/src/altq-3.0
sh MAKEDEV.altq all
make
make install
# now create a suitable configuration for each nic, I used ed1
# save this file as /etc/altq.conf the default configuration file

-------------------------------------------------------------------------------# sample configuration file for 56k link

#
interface ed1 bandwidth 33K cbq

class cbq ed1 root NULL pbandwidth 100

#
# meta classes
#
class cbq ed1 ctl_class root pbandwidth 10 control
# CBQ/TYPE, Iface, Name, Parent/Null
class cbq ed1 fast_class root borrow pbandwidth 70
filter ed1 fast_class 0 0 0 53 17 # dns
filter ed1 fast_class 0 0 0 53 6 # dns
filter ed1 fast_class 0 0 0 6667 6 # irc
filter ed1 fast_class 0 6667 0 0 6 # irc
filter ed1 fast_class 0 0 0 22 6 # ssh
filter ed1 fast_class 0 22 0 0 6 # ssh
class cbq ed1 slow_class root borrow pbandwidth 15 default

-------------------------------------------------------------------------------# at this point you should be able to start using altq

# for bandwidth shaping and prioritising.
# start the daemon
/usr/local/sbin/altqd
# use this to dump statistics occasionally
/usr/local/bin/altqstat -c 2