348 lines
6.3 KiB
HTML
348 lines
6.3 KiB
HTML
<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
|
|
> |