<!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.1//EN" > -->

<!--  This is part of the lcrash HOWTO. -->
<!--  Copyright (C) 2001, 2002 IBM Deutschland Entwicklung GmbH, -->
<!--                           IBM Corporation -->
<!--  See the file lcrash.sgml for copying conditions. -->

<chapter id="cha.installation">
  <title>Installation</title>

  <section id="sec.gettingthesource">
    <title>Where to get the code</title>
    <para>
      As mentioned earlier, lcrash is part of LKCD.
      You can download packages containing the lcrash version of LKCD 4.0 from
      <ulink url="http://lkcd.sourceforge.net/download/4.0/lkcdutils">
	sourceforge</ulink> in form of:
    </para>
    <itemizedlist>
      <listitem>
	<para>
	  <ulink url="http://lkcd.sourceforge.net/download/4.0/lkcdutils/lkcdutils-4.0-1.src.rpm">a source rpm package</ulink>,
	</para>
      </listitem>
      <listitem>
	<para>
	  <ulink url="http://lkcd.sourceforge.net/download/4.0/lkcdutils/lkcdutils-4.0-1.i386.rpm">a rpm package containing binaries for i386</ulink>.
	</para>
      </listitem>
    </itemizedlist>
  </section>

  <section id="sec.installrpmpackages">
    <title>Install rpm packages</title>
    <para>
      To install the binary package, you can use:
    </para>
    <screen>
bash# rpm -ivh lkcdutils-4.0-1.i386.rpm 
    </screen>
    <para>
      This should install lcrash properly. No further installation steps are
      required.
    </para>
    <para>
      Installation of source rpm is done using:
    </para>
    <screen>
bash# rpm -ihv lkcdutils-4.0-1.src.rpm 
    </screen>
    <para>
      This should install <filename>lkcdutils-4.0-1.tar.gz</filename> and
      <filename>lkcdutils.spec</filename> somewhere under <filename>
      /usr/src</filename>. On my SuSE system the files are saved under
      <filename>/usr/src/packages/SOURCES/</filename> and
      <filename>/usr/src/packages/SPECS/</filename>. 
    </para>
    <para>
      Now you can build and install lkcdutils using:
    </para>
    <screen>
bash# cd /usr/src/packages/SPECS/
bash# rpm -bi lkcdutils.spec 
    </screen>
    <para>
      Lcrash should know be built and installed properly as
      <filename>/sbin/lcrash</filename>. The lkcdutils source tree, which
      contains the lcrash sources, can be found under <filename>
	/usr/src/packages/BUILD/lkcdutils-4.0/</filename>.
    </para>
  </section>

  <section id="sec.compilation">
    <title>Compile and Install lcrash</title>
    <para>
      If you have installed the lcrash sources, you can build lcrash using:
    </para>
    <screen>
bash$ cd lkcdutils-4.0
bash$ ./configure
bash$ make
    </screen>
    <para>
      Installation of lcrash and all other programs of lkcdutils package is done
      with:
    </para>
    <screen>
bash# make install
    </screen>
    <para>
      This installs lcrash as <filename>/sbin/lcrash</filename>.
    </para>
  </section>

  <section id="sec.lkcdcvsrepository">
    <title>LKCD CVS Repository</title>
    <para>
      The current code of LKCD and hence the newest lcrash sources are
      located at <ulink url="http://sourceforge.net/projects/lkcd">
	sourceforge</ulink>.
    </para>
    <para>
      Of course you can receive lcrash source code directly from cvs.
      To do so you can run: (Simply press <keycap>Enter</keycap>, when asked
      for a password.)
      <screen>
bash$ cvs -d:pserver:anonymous@cvs.lkcd.sourceforge.net:/cvsroot/lkcd login
(Logging in to anonymous@cvs.lkcd.sourceforge.net)
CVS password: 
bash$ cvs -z3 -d:pserver:anonymous@cvs.lkcd.sourceforge.net:/cvsroot/lkcd co -d lkcdutils_today lkcdutils
      </screen>
    </para>
    <para>
      From this point you can follow instructions given in
      <xref linkend="sec.compilation"> to compile and install lcrash.
    </para>
    <para>
      When using recent lcrash versions from cvs, please keep in mind,
      that this documentation may not yet reflect latest changes of lcrash.
    </para>
  </section>
</chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-always-quote-attributes:t
sgml-auto-insert-required-elements:t
sgml-balanced-tag-edit:t
sgml-exposed-tags:nil
sgml-general-insert-case:lower
sgml-indent-data:t
sgml-indent-step:2
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
sgml-minimize-attributes:nil
sgml-namecase-general:t
sgml-omittag:t
sgml-parent-document:("lcrash.sgml" "book" "chapter")
sgml-shorttag:t
sgml-tag-region-if-active:t
End:
-->
