/usr/share/doc/samhain/manual.html/installation-configure.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Configuring the source</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="The Samhain Host Integrity Monitoring System"
HREF="index.html"><LINK
REL="UP"
TITLE="Compiling and installing"
HREF="installation.html"><LINK
REL="PREVIOUS"
TITLE="Download and extract"
HREF="installation-download.html"><LINK
REL="NEXT"
TITLE="Build"
HREF="installation-build.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="./docbook.css"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><!--#if expr="! ($HTTP_USER_AGENT = /MSIE/)"--><!--#include virtual="/resources/ssi/header.html"--><!--#endif --><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The Samhain Host Integrity Monitoring System</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="installation-download.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 2. Compiling and installing</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="installation-build.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="INSTALLATION-CONFIGURE"
>2.4. Configuring the source</A
></H1
><P
>Before you can start to compile, it is neccessary to configure the source
for your particular platform and your personal requirements. This
is done by running the <TT
CLASS="FILENAME"
>configure</TT
> in the source directory.
If you type <B
CLASS="COMMAND"
>./configure</B
> with no options, the source will
get configured with the default options. In particular, a standalone version
of <SPAN
CLASS="APPLICATION"
>samhain</SPAN
> will get built which uses the
Filesystem Hierarchy Standard (FHS) for file/directory layout. This is 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>not</I
></SPAN
> the standard GNU layout of 'everything 
under /usr/local'.</P
><DIV
CLASS="TIP"
><P
></P
><TABLE
CLASS="TIP"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/tip.gif"
HSPACE="5"
ALT="Tip"></TD
><TH
ALIGN="LEFT"
VALIGN="MIDDLE"
><B
>Paths</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>   (A) <SPAN
CLASS="APPLICATION"
>samhain</SPAN
> is a Filesystem 
   Hierarchy Standard (FHS)
   compliant application. Thus the default directory layout is 
   <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>not</I
></SPAN
>
   the standard GNU layout (see <A
HREF="layout.html"
>Section 2.10</A
>&#62;).
 </P
><P
>   (B) <SPAN
CLASS="APPLICATION"
>samhain</SPAN
> has a concept of 
   <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>trusted users</I
></SPAN
>, and will refuse to run if
   the path to critical files is writeable by users not in its list
   of trusted users (default: root, and the user who has started
   <SPAN
CLASS="APPLICATION"
>samhain</SPAN
>). Please read 
   <A
HREF="layout.html#DEFTRUST"
>Section 2.10.1</A
>&#62; for details. 
 </P
></TD
></TR
></TABLE
></DIV
><P
>To change the defaults, <B
CLASS="COMMAND"
>./configure</B
> accepts a variety
of command-line options and environment variables 
(use <B
CLASS="COMMAND"
>./configure --help</B
> for a complete list).
The available command line options are listed and explained in 
<A
HREF="compilation-options.html"
>Appendix A</A
>&#62;.</P
><P
>To configure a standalone version of <SPAN
CLASS="APPLICATION"
>samhain</SPAN
>:
<PRE
CLASS="SCREEN"
><SAMP
CLASS="PROMPT"
>sh$ </SAMP
><KBD
CLASS="USERINPUT"
>./configure [more options]</KBD
></PRE
>

<DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="MIDDLE"
><B
>Important remark on client/server use</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>Please read <A
HREF="yule.html"
>Chapter 6</A
>&#62; if you intend to use 
<SPAN
CLASS="APPLICATION"
>samhain</SPAN
> as a client/server system. Things will
not work automagically just because you compiled a client and a server
version of <SPAN
CLASS="APPLICATION"
>samhain</SPAN
>. In particular, clients
need to <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>authenticate</I
></SPAN
> themselves to the server, and
special configure options are required if you want to keep the configuration
file(s) and the baseline database(s) on the central server.</P
></TD
></TR
></TABLE
></DIV
>&#13;</P
><P
>To configure a client version of <SPAN
CLASS="APPLICATION"
>samhain</SPAN
> that
can connect to a central server:
<PRE
CLASS="SCREEN"
><SAMP
CLASS="PROMPT"
>sh$ </SAMP
><KBD
CLASS="USERINPUT"
>./configure --enable-network=client [more options]</KBD
></PRE
>&#13;</P
><P
>To configure a server version of <SPAN
CLASS="APPLICATION"
>samhain</SPAN
> that
will act as a central log server:
<PRE
CLASS="SCREEN"
><SAMP
CLASS="PROMPT"
>sh$ </SAMP
><KBD
CLASS="USERINPUT"
>./configure --enable-network=server [more options]</KBD
></PRE
>&#13;</P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN192"
>2.4.1. Some more configuration options</A
></H2
><P
>If you want to use any options/modules that are not enabled by 
default (e.g. because the majority of users do not require them,
or because they require additional programs and/or libraries), 
at this point you need to specify such options:</P
><P
></P
><UL
><LI
><P
>  To compile in the module to check for SUID files
  (see <A
HREF="suidchk.html"
>Section 5.9</A
>&#62;)
  use <B
CLASS="COMMAND"
>./configure --enable-suidcheck</B
>
  </P
></LI
><LI
><P
>  To compile in the module to detect kernel modifications/rootkits 
  (see <A
HREF="kerneldef.html"
>Section 5.10</A
>&#62;)
  use <B
CLASS="COMMAND"
>./configure --with-kcheck=<TT
CLASS="REPLACEABLE"
><I
>/path/to/System.map</I
></TT
></B
>
  </P
></LI
><LI
><P
>  To compile in the module to monitor login/logout events 
  (see <A
HREF="mondef.html"
>Section 5.11</A
>&#62;)
  use <B
CLASS="COMMAND"
>./configure --enable-login-watch</B
>
  </P
></LI
><LI
><P
>  To compile in the module to check mount options for mounted filesystems 
  (see <A
HREF="mountcheck.html"
>Section 5.12</A
>&#62;)
  use <B
CLASS="COMMAND"
>./configure --enable-mounts-check</B
>
  </P
></LI
><LI
><P
>  To compile in the module to specify files relative to user home directories
  (see <A
HREF="usercheck.html"
>Section 5.13</A
>&#62;)
  use <B
CLASS="COMMAND"
>./configure --enable-userfiles</B
>
  </P
></LI
><LI
><P
>  To compile in code for logging to an RDMS,
  (see <A
HREF="sqldetails.html"
>Section 4.12</A
>&#62;)
  use <B
CLASS="COMMAND"
>./configure --enable-xml-log --with-database=<TT
CLASS="REPLACEABLE"
><I
>oracle/mysql/postgresql</I
></TT
></B
>
  </P
></LI
><LI
><P
>  To compile in code for logging to the Prelude IDS,
  (see <A
HREF="preludedetails.html"
>Section 4.9</A
>&#62;)
  use <B
CLASS="COMMAND"
>./configure --with-prelude</B
>
  </P
></LI
><LI
><P
>  To use PGP-signed configuration files, 
  (see <A
HREF="signed-files.html"
>Chapter 8</A
>&#62;)
  use <B
CLASS="COMMAND"
>./configure --with-gpg=<TT
CLASS="REPLACEABLE"
><I
>/path/to/gpg</I
></TT
></B
>. Please review <A
HREF="signed-files.html"
>Chapter 8</A
>&#62; for further 
  information and additional options to compile in the key fingerprint and/or
  the checksum of the <B
CLASS="COMMAND"
>gpg</B
> executable.
  </P
></LI
><LI
><P
>  To compile samhain for use of the 'stealth' options to hide its presence,
  please review <A
HREF="stealthmode.html"
>Chapter 9</A
>&#62; for the available options.
  </P
></LI
><LI
><P
>  To configure a server version of <SPAN
CLASS="APPLICATION"
>samhain</SPAN
> that
  will act as a central log server, use
  <B
CLASS="COMMAND"
>./configure --enable-network=server</B
>
  </P
></LI
><LI
><P
>  To configure a client version of <SPAN
CLASS="APPLICATION"
>samhain</SPAN
> that
  can connect to a central server, use
  <B
CLASS="COMMAND"
>./configure --enable-network=client</B
>.
  Please refer to the chapter <A
HREF="yule.html"
>Chapter 6</A
> for an explanation of
  the client/server setup, <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>in particular further options that
  you need if you want to store configuration files and baseline databases
  on the server</I
></SPAN
> 
  (see <A
HREF="database-configuration-file-download.html"
>Section 6.5</A
>&#62;).
  </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="installation-download.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="installation-build.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Download and extract</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="installation.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Build</TD
></TR
></TABLE
></DIV
><!--#if expr="! ($HTTP_USER_AGENT = /MSIE/)"--><!--#include virtual="/resources/ssi/footer.html"--><!--#endif --></BODY
></HTML
>
samhain 3.1.0-5ubuntu1 / usr / share / doc / samhain / manual.html / installation-configure.html
