<HTML ><HEAD ><TITLE >Installation of lkcd</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.63 "><LINK REL="HOME" TITLE="Linux Crash HOWTO" HREF="index.html"><LINK REL="PREVIOUS" TITLE="How LKCD Works" HREF="howitworks.html"><LINK REL="NEXT" TITLE="Setup, Test, and Running crash" HREF="setup.html"></HEAD ><BODY CLASS="SECT1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >Linux Crash HOWTO</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="howitworks.html" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="setup.html" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="INSTALL" >3. Installation of lkcd</A ></H1 ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN44" >3.1. Installing From Source Code</A ></H2 ><P > Get the <TT CLASS="FILENAME" >lkcdutils-xxx.src.rpm</TT > and install it using <B CLASS="COMMAND" >rpm -i kcdutils-xxx.src.rpm</B > . This will place a file called <TT CLASS="FILENAME" >lkcdutils-xxx.tar.gz</TT > in the <TT CLASS="FILENAME" >/usr/src/redhat/SOURCES</TT > directory. This file is a compressed tar image of the lkcd source tree. Unwind the source in a directory of your choice like "<TT CLASS="FILENAME" >/usr/src</TT >" with <B CLASS="COMMAND" >tar -zxvf kcdutils-xxx.src.rpm</B > . This will create a directory called "<TT CLASS="FILENAME" >kcdutils-xxx</TT >" which will contain the LKCD utilities source. </P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN54" >3.2. Building and Installing LKCD Utilities</A ></H2 ><P > LKCD used the standard GCC compiler and make files. To build the suite, cd to the LKCD src directory and run <B CLASS="COMMAND" >./configure</B > to build configuration files. The next step is to run <B CLASS="COMMAND" >make</B > to build the utilities, and finally run <B CLASS="COMMAND" >make install</B > to install the utilities and man pages. </P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN60" >3.3. What Gets Installed</A ></H2 ><TABLE BORDER="1" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="SCREEN" > /etc/sysconfig/dump # Configuration file for dump /sbin/lcrash # The crash utility /sbin/lkcd # Script to configure and save a crash /sbin/lkcd_config # Configuration utility for dump /sbin/lkcd_ksyms # Utility for reconstructing kernel symbols /usr/include/sial_api.h # Header file for the SIAL API /usr/lib/libsial.a # Simple Image Access Language library /usr/man/man1/lcrash.1 # man page for lcrash /usr/man/man1/lkcd_config.1 # man page for lkcd_config /usr/man/man1/lkcd_ksyms.1 # man page for lkcd_ksyms /usr/share/sial/lcrash/ps.sial # ps command implementation of SIAL </PRE ></FONT ></TD ></TR ></TABLE ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN63" >3.4. Installing LKCD Utilities From RPM</A ></H2 ><P > You can install the pre-built utilities from rpm by running <B CLASS="COMMAND" >rpm -i kcdutils-xxx.rpm</B > . You will still need to patch the kernel and install the startup script patches. However you can bypass building the utilities step. </P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN67" >3.5. Patching the Kernel</A ></H2 ><P > The next step is patching and rebuilding the kernel. You will need to patch the kernel source with the <TT CLASS="FILENAME" >lkcd-xxx.diff</TT > file you downloaded from <A HREF="http://lkcd.sourceforge.net/" TARGET="_top" >http://lkcd.sourceforge.net/</A >. Copy the patch into the same directory as your kernel and run <B CLASS="COMMAND" >patch -p0 < lkcd-kernelxxx.diff</B > . Make sure the patch you use is the same version as the kernel you are patching. Next you will need to configure the kernel to enable crash dump support. By default crash support is turned off after applying the patch. If you use <B CLASS="COMMAND" >make menuconfig</B > or <B CLASS="COMMAND" >make xconfig</B >, the "LKCD support" option is under kernel hacking. You will also need to enable other kernel features you might need. See the <A HREF="http://linuxdoc.org/HOWTO/Kernel-HOWTO.html" TARGET="_top" >The Linux Kernel HOWTO</A > for further details. </P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN76" >3.6. Build and Install the Kernel</A ></H2 ><P > The next is building and installing the crash enabled kernel. In the kernel source directory run the following commands in order. </P ><TABLE BORDER="1" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><FONT COLOR="#000000" ><PRE CLASS="SCREEN" > make depend make install make modules make modules_install </PRE ></FONT ></TD ></TR ></TABLE ><P > This will build and installing the new kernel, you will also need to copy the <TT CLASS="FILENAME" >Kerntypes</TT > file from the kernel source to the <TT CLASS="FILENAME" >/boot</TT > directory. You may also need to edit the <TT CLASS="FILENAME" >lilo.conf</TT > file to point to you new kernel. See <A HREF="http://linuxdoc.org/HOWTO/Kernel-HOWTO.html" TARGET="_top" >http://www.linuxdoc.org/HOWTO/Kernel-HOWTO.html</A > for more information on building and installing a kernel. </P ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="howitworks.html" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="setup.html" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >How LKCD Works</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" > </TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Setup, Test, and Running crash</TD ></TR ></TABLE ></DIV ></BODY ></HTML >