From: Andrew McRory firstname.lastname@example.org
Subject:Iron-Bridge kernel installation notes
Hal Davison of Davison Consulting in Sarasota, Florida sponsored the creation of the following installation guide for Iron-Bridge Communications CSOL2.3 kernel update. He wanted all Caldera users to benefit and requested I post this document on our FTP site along with the updated kernel.
I have created version "f3" of our kernel update which fixes a minor bridge compile error and provides the latest NFSv3 patch. It's located at:
The installation guide follows....
=== begin ===============================================================
Installing Iron-Bridge Communications Kernel 2.2.14 Upgrade
All enhancement rpm packages from Iron-Bridge Communications are designed to follow the "Caldera way of doing things" and should in most cases provide a direct upgrade path from Caldera supplied packages. In the event a feature is replaced with a similar package, installation instructions are provided to help ensure a successful upgrade.
This document is written for users of Caldera eServer version 2.4 and assumes the user has some familiarity with recompiling kernels, can install/upgrade rpms and can perform general file management tasks under the bash shell.
These RPMS are known to work on Caldera OpenLinux 2.3 with the only abnormality being the initial graphical boot screen is that of eServer and not OpenLinux 2.3.
The first step in installing the upgrade kernel for Caldera eServer distribution is to download the upgrade files from our FTP server, ftp.iron-bridge.net. The kernel upgrade files are located in /pub/Caldera/AfterShoCK2.3/linux-2.2.14-XX/ where XX is the release version. As there may be more than one version on the FTP server, please try to use the most current release available.
KERNEL PACKAGES This is the list of kernel upgrade files as of 02.10.00:
linux-kernel-binary-2.2.14-ol23.LSE.f3.i386.rpm linux-kernel-doc-2.2.14-ol23.LSE.f3.i386.rpm linux-kernel-include-2.2.14-ol23.LSE.f3.i386.rpm linux-source-alpha-2.2.14-ol23.LSE.f3.i386.rpm linux-source-arm-2.2.14-ol23.LSE.f3.i386.rpm linux-source-common-2.2.14-ol23.LSE.f3.i386.rpm linux-source-i386-2.2.14-ol23.LSE.f3.i386.rpm linux-source-m68k-2.2.14-ol23.LSE.f3.i386.rpm linux-source-mips-2.2.14-ol23.LSE.f3.i386.rpm linux-source-ppc-2.2.14-ol23.LSE.f3.i386.rpm linux-source-s390-2.2.14-ol23.LSE.f3.i386.rpm linux-source-sparc-2.2.14-ol23.LSE.f3.i386.rpm linux-source-sparc64-2.2.14-ol23.LSE.f3.i386.rpm
SUPPLEMENTARY PACKAGES To help ensure backwards compatibility and provide upgraded functionality, the following supplementary packages are provided.
autofs-4.0.0pre4-ol23.LSE.1.i386.rpm bridge-utils-20000205-ol23.LSE.1.i386.rpm bridge-utils-devel-20000205-ol23.LSE.1.i386.rpm iBCS-2.1-981105-ol23.LSE.1.i386.rpm mount-2.9u-4_nfsv3_0.3.i386.rpm nfs-utils-0.1.6-ol23.LSE.1.i386.rpm pcmcia-cs-3.1.10-ol23.LSE.1.i386.rpm ppp-2.3.11-ol23.LSE.1.i386.rpm ppp-devel-2.3.11-ol23.LSE.1.i386.rpm raidtools-0.90-ol23.LSE.1.i386.rpm reiserfs-3.5.16-ol23.LSE.1.i386.rpm
The following describes the included patches and enhancements. For information regarding these features, please consult their web page, the documentation included with their supplemental package (located in /usr/doc/<package-name>) or in the kernel Documentation directory.
autofs-2.2.14-20000124 http://www.goop.org/~jeremy/autofs/ ---------------------- updates to the automounter - upgrades performance and compatibility with other UNIX
bridge-20000202 ftp://opensource.captech.com/bridge --------------- bridging code rewrite - cleaner bridge code, can be modularized, includes updated utilities
epcav-1.4.1 ftp.digiboard.com/support/drivers/linux/4001450F.tgz ----------- current patch for DigiBoard PC/Xem - feature enhancement
ide.220.127.116.1100124 ftp://ftp.kernel.org/pub/linux/kernel/people/hedrick ------------------- the latest ide/udma66 patch for 2.2.14 - improve your IDE I/O
ip_masq_vpn-2.2.14 ftp://ftp.rubyriver.com/pub/jhardin/masquerade ------------------ patch to add PPTP and IPsec masquerading - allow multiple outgoing PPTP connections from your private network via IP masquerade
linux-2.2.14 ftp://ftp.kernel.org/pub/linux/kernel/v2.2 ------------ upgraded from 2.2.14-4ac3 (prerelease) found in the original eServer RPM.
nfsv3-0.17.0 http://www.fys.uio.no/~trondmy/src/ ------------ latest experimental nfsv3 patches - highly experimental
ppp-2.3.11 ftp://cs.anu.edu.au/pub/software/ppp ---------- latest version of PPP
raid0145-19990824 ftp://ftp.us.kernel.org/pub/linux/daemons/raid/alpha/ ----------------- latest version of RAID drivers - considered extremely stable
reiser-3.5.16 ftp://ftp.suse.com/pub/suse/i386/update/6.3/reiserfs/ ------------- the journaling filesystem patch from SuSe - promises enhanced performance from your system, greater filesystem reliability
shsmod-1.7c http://www7.pos.to/~gonda/linux/serial-e.html ----------- added to enable some onboard serial I/O chip to run in Super High Speed mode This patch should be especially appreciated by ISDN users. In many cases it eliminates the need to purchase an expensive high speed Serial I/O adapter by enabling /dev/ttyS0 to be clocked at a either 230k, 460k or 921k. Many modern motherboards have chips that support Super High Speed mode.
KERNEL INSTALLATION Before you install the upgraded kernel, make a bootable floppy disk in case you run into problems:
1) format a fresh floppy disk (example assumes a 1.44MB disk)
2) data dump your working kernel to a new disk. (You may need to look at your /etc/lilo.conf file to determine which kernel to data dump)
dd if=/vmlinuz of=/dev/fd0
3) Run rdev to make sure your kernel knows which partition is the root partition.
rdev /dev/fd0 /dev/<your_boot_partition>
4) test the floppy before continuing
Once you have verified your boot floppy works, we recommend you install the full kernel source with the following commands:
rpm -Uvh linux-*
This command should be executed in the directory with the upgrade files you downloaded or on the CDROM we provided. If your /usr partition is low on space you may wish to do a minimal kernel source installation using the following packages.
linux-kernel-binary linux-kernel-doc linux-kernel-include linux-source-common linux-source-i386
This upgrade kernel should be recompiled before put into production (instructions follow). One installation noted their LILO configuration file was corrupted after installing linux-kenel-binary. Please make a backup /etc/lilo.conf before installing the linux-kernel-binary package.
autofs (optional) ----------------- This package replaces Caldera's am-utils package and is provided to enhance support for automount file systems v3 and v4 under Linux-2.2.x. Install the package as follows:
rpm -e am-utils rpm -Uvh autofs-4.0.0pre4-ol23.LSE.1.i386.rpm
The configuration files are different from the ones found in am-utils. Please see the man page (man 5 autofs) and /usr/doc/autofs files for information on configuration.
bridge (optional) ----------------- If you are going to test the new bridging code please install the following package:
rpm -ivh bridge-utils-20000205-ol23.LSE.1.i386.rpm
iBCS (optional) --------------- The latest iBCS package is provided to ensure backwards compatibility. Installation is as follows:
rpm -Uvh iBCS-2.1-981105-ol23.LSE.1.i386.rpm
mount (optional) ---------------- This package is provided as a convenience for those wishing to test experimental NFSv3 support. The kernel must be recompiled to support NFSv3. This package replaces files from util-linux package so it must be forcibly installed as follows:
rpm -Uvh --force mount-2.9u-4_nfsv3_0.3.i386.rpm
If you need to revert to the old mount package you will need to forceably install util-linux from your OpenLinux CDROM.
nfs-utils (recommended) ----------------------- Before you can install this package you must remove Caldera's NFS package:
rpm -e nfs-server rpm -e nfs-server-clients
rpm -Uvh nfs-utils-0.1.6-ol23.LSE.1.i386.rpm
pcmcia-cs (optional) -------------------- Is you are using a laptop you will want to install this package.
rpm -Uvh pcmcia-cs-3.1.10-ol23.LSE.1.i386.rpm
ppp (mandatory) --------------- This is the latest version of ppp for Linux. Install as follows:
rpm -Uvh ppp-2.3.11-ol23.i386.rpm
raidtools (optional) -------------------- If you will be installing and using software RAID this package is required. Install as follows.
rpm -Uvh raidtools-0.90-ol23.LSE.1.i386.rpm
reiserfs (optional) ------------------- This package contains the utilities needed for creating and maintaining a reiserfs filesystem. reiserfs is best used on your data partitions - leave your boot partition ext2 until LILO can understand and boot reiserfs filesystems. Install as follows:
rpm -ivh reiserfs-3.5.16-ol23.LSE.1.i386.rpm
RECOMPILING YOUR KERNEL
Please verify you have the following packages installed before you attempt to recompile your kernel:
glibc-devel glibc-devel-static bin86 egcs ncurses-devel make
We recommend you configure your kernel on the command prompt. Follow these steps to successfully configure and recompile the kernel.
1) Change directory to /usr/src/linux and run "make mrproper" to clean up the kernel source directory.
2) Run "make menuconfig" to custom configure your kernel. Select only the options you need for your hardware/networking environment.
Note: When you exit the configuration menu a file named .config is created. This file contains all your kernel configuration options. It's a good idea to backup this file as a reference for future kernel compiles. To make a backup we suggest you copy the .config file to /usr/src/config-<date>. The next time you are going to build a kernel run "make mrproper" to cleanup the kernel source directory then copy /usr/src/config-<date> to /usr/src/linux/.config, run "make oldconfig" and run "make menuconfig" to check/modify the kernel options before you recompile.
3) If you are using LILO to boot the system you can automatically build and install the kernel using the included script:
This document was sponsored by Hal Davison of Davison Consulting in Sarasota, Florida. If you find this helpful please drop him a note of thanks at email@example.com
If you experience any problem installing this kernel package or you would like to see a feature or patch added to future kernel packages, please contact the package maintainer below. Corrections, comments and suggestions are always greatly appreciated.
Andrew McRory <firstname.lastname@example.org>
THIS IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY; WITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
amacc 02.10.00 - 1.00
===== end ================================================================