| [1] | 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 | 
|---|
 | 2 | <html>
 | 
|---|
 | 3 | <head>
 | 
|---|
 | 4 | <title>HOWTO Samhain on Windows</title>
 | 
|---|
 | 5 | <style type="text/css">
 | 
|---|
 | 6 | <!--
 | 
|---|
 | 7 | 
 | 
|---|
 | 8 | html { background: #eee; color: #000; }
 | 
|---|
 | 9 | 
 | 
|---|
 | 10 | body { background: #eee; color: #000; margin: 0; padding: 0;}
 | 
|---|
 | 11 | 
 | 
|---|
 | 12 | div.body {
 | 
|---|
 | 13 |         background: #fff; color: #000;
 | 
|---|
 | 14 |         margin: 0 1em 0 1em; padding: 1em;
 | 
|---|
 | 15 |         font-family: serif;
 | 
|---|
 | 16 |         font-size: 1em; line-height: 1.2em;
 | 
|---|
 | 17 |         border-width: 0 1px 0 1px;
 | 
|---|
 | 18 |         border-style: solid;
 | 
|---|
 | 19 |         border-color: #aaa;
 | 
|---|
 | 20 | }
 | 
|---|
 | 21 | 
 | 
|---|
 | 22 | div.block {
 | 
|---|
 | 23 |         background: #b6c5f2; color: #000;
 | 
|---|
 | 24 |         margin: 1em; padding: 0 1em 0 1em;
 | 
|---|
 | 25 |         border-width: 1px;
 | 
|---|
 | 26 |         border-style: solid;
 | 
|---|
 | 27 |         border-color: #2d4488;
 | 
|---|
 | 28 | }
 | 
|---|
 | 29 | 
 | 
|---|
 | 30 | div.warnblock {
 | 
|---|
 | 31 |         background: #b6c5f2; color: #000;
 | 
|---|
 | 32 |         margin: 1em; padding: 0 1em 0 1em;
 | 
|---|
 | 33 |         border-width: 1px;
 | 
|---|
 | 34 |         border-style: solid;
 | 
|---|
 | 35 |         border-color: #FF9900;
 | 
|---|
 | 36 | }
 | 
|---|
 | 37 | 
 | 
|---|
 | 38 | table {
 | 
|---|
 | 39 |         background: #F8F8F8; color: #000;
 | 
|---|
 | 40 |         margin: 1em;
 | 
|---|
 | 41 |         border-width: 0 0 0 1px;
 | 
|---|
 | 42 |         border-style: solid;
 | 
|---|
 | 43 |         border-color: #C0C0C0;
 | 
|---|
 | 44 | }
 | 
|---|
 | 45 | 
 | 
|---|
 | 46 | td {
 | 
|---|
 | 47 |         border-width: 0 1px 1px 0;
 | 
|---|
 | 48 |         border-style: solid;
 | 
|---|
 | 49 |         border-color: #C0C0C0;
 | 
|---|
 | 50 | }
 | 
|---|
 | 51 | 
 | 
|---|
 | 52 | th {
 | 
|---|
 | 53 |         background: #F8F8FF;
 | 
|---|
 | 54 |         border-width: 1px 1px 2px 0;
 | 
|---|
 | 55 |         border-style: solid;
 | 
|---|
 | 56 |         border-color: #C0C0C0;
 | 
|---|
 | 57 | }
 | 
|---|
 | 58 | 
 | 
|---|
 | 59 | 
 | 
|---|
 | 60 | /* body text, headings, and rules */
 | 
|---|
 | 61 | 
 | 
|---|
 | 62 | p { margin: 0; text-indent: 0em; margin: 0 0 0.5em 0 }
 | 
|---|
 | 63 | 
 | 
|---|
 | 64 | h1, h2, h3, h4, h5, h6 {
 | 
|---|
 | 65 |         color: #206020; background: transparent;
 | 
|---|
 | 66 |         font-family: Optima, Arial, Helvetica, sans-serif;
 | 
|---|
 | 67 |         font-weight: normal;
 | 
|---|
 | 68 | }
 | 
|---|
 | 69 | 
 | 
|---|
 | 70 | h1 { font-size: 1.69em; margin: 1.4em 0 0.4em 0; }
 | 
|---|
 | 71 | h2 { font-size: 1.44em; margin: 1.4em 0 0.4em 0; }
 | 
|---|
 | 72 | h3 { font-size: 1.21em; margin: 1.4em 0 0.4em 0; }
 | 
|---|
 | 73 | h4 { font-size: 1.00em; margin: 1.4em 0 0.4em 0; }
 | 
|---|
 | 74 | h5 { font-size: 0.81em; margin: 1.4em 0 0.4em 0; }
 | 
|---|
 | 75 | h6 { font-size: 0.64em; margin: 1.4em 0 0.4em 0; }
 | 
|---|
 | 76 | 
 | 
|---|
 | 77 | hr {
 | 
|---|
 | 78 |         color: transparent; background: transparent;
 | 
|---|
 | 79 |         height: 0px; margin: 0.6em 0;
 | 
|---|
 | 80 |         border-width: 1px ;
 | 
|---|
 | 81 |         border-style: solid;
 | 
|---|
 | 82 |         border-color: #999;
 | 
|---|
 | 83 | }
 | 
|---|
 | 84 | 
 | 
|---|
 | 85 | /* bulleted lists and definition lists */
 | 
|---|
 | 86 | 
 | 
|---|
 | 87 | ul { margin: 0 1em 0.6em 2em; padding: 0; }
 | 
|---|
 | 88 | li { margin: 0.4em 0 0 0; }
 | 
|---|
 | 89 | 
 | 
|---|
 | 90 | dl { margin: 0.6em 1em 0.6em 2em; }
 | 
|---|
 | 91 | dt { color: #285577; }
 | 
|---|
 | 92 | 
 | 
|---|
 | 93 | tt { color: #602020; }
 | 
|---|
 | 94 | 
 | 
|---|
 | 95 | /* links */
 | 
|---|
 | 96 | 
 | 
|---|
 | 97 | a.link {
 | 
|---|
 | 98 |         color: #33c; background: transparent;
 | 
|---|
 | 99 |         text-decoration: none;
 | 
|---|
 | 100 | }
 | 
|---|
 | 101 | 
 | 
|---|
 | 102 | a:hover {
 | 
|---|
 | 103 |         color: #000; background: transparent;
 | 
|---|
 | 104 | }
 | 
|---|
 | 105 | 
 | 
|---|
 | 106 | body > a {
 | 
|---|
 | 107 |         font-family: Optima, Arial, Helvetica, sans-serif;
 | 
|---|
 | 108 |         font-size: 0.81em;
 | 
|---|
 | 109 | }
 | 
|---|
 | 110 | 
 | 
|---|
 | 111 | h1, h2, h3, h4, h5, h6 {
 | 
|---|
 | 112 |         color: #2d5588; background: transparent;
 | 
|---|
 | 113 |         font-family: Optima, Arial, Helvetica, sans-serif;
 | 
|---|
 | 114 |         font-weight: normal;
 | 
|---|
 | 115 | }
 | 
|---|
 | 116 | 
 | 
|---|
 | 117 |   -->
 | 
|---|
 | 118 | </style></head>
 | 
|---|
 | 119 | <body>
 | 
|---|
 | 120 | <div class="body">
 | 
|---|
 | 121 | <p style="text-align: center; background: #ccc; border: 1px solid #2d5588;"><a 
 | 
|---|
 | 122 |    style="text-decoration: none;" 
 | 
|---|
 | 123 |    href="http://www.la-samhna.de/samhain/">samhain file integrity 
 | 
|---|
 | 124 |    scanner</a> | <a style="text-decoration: none;" 
 | 
|---|
 | 125 |    href="http://www.la-samhna.de/samhain/s_documentation.html">online 
 | 
|---|
 | 126 |    documentation</a></p>
 | 
|---|
 | 127 | <br><center>
 | 
|---|
 | 128 | <h1>Using Samhain on Windows</h1>
 | 
|---|
 | 129 | </center>
 | 
|---|
 | 130 | <br>
 | 
|---|
 | 131 | <hr>
 | 
|---|
 | 132 | <p>
 | 
|---|
 | 133 | This document aims to explain how to compile and run 
 | 
|---|
 | 134 | samhain on Windows with the
 | 
|---|
 | 135 | <b>Cygwin</b> POSIX emulation layer, and how to install it as a service. 
 | 
|---|
 | 136 | These instructions have been written by Kris Dom,
 | 
|---|
| [18] | 137 | who has tested this on WinXP Professional, with additions by Geries Handal
 | 
|---|
 | 138 | and Jorge Morgado.
 | 
|---|
| [1] | 139 | </p>
 | 
|---|
 | 140 | <div class="block">
 | 
|---|
 | 141 | <h3>Interix / Services For UNIX</h3>
 | 
|---|
 | 142 | <p>
 | 
|---|
 | 143 | Samhain can also be used with Interix/SFU 3.5. Note that in Interix, 
 | 
|---|
 | 144 | the Windows
 | 
|---|
 | 145 | filesystem is referred as <tt>/dev/fs/C</tt>, while in Cygwin it 
 | 
|---|
 | 146 | is <tt>/cygdrive/c</tt> (both refers to the <tt>C:</tt> drive; other drives
 | 
|---|
 | 147 | are analogous). 
 | 
|---|
 | 148 | </p><p>
 | 
|---|
 | 149 | Older versions of samhain would need to be built with
 | 
|---|
 | 150 | <tt>./configure --disable-mail</tt> (i.e. without support for email 
 | 
|---|
 | 151 | logging) because Interix does not provide some of the required functionality 
 | 
|---|
 | 152 | to build the email module. This issue should be fixed as of samhain 
 | 
|---|
| [18] | 153 | version 2.0.7 (not tested).<br />
 | 
|---|
 | 154 | [Based on information kindly provided by Geries Handal].
 | 
|---|
| [1] | 155 | </p>
 | 
|---|
 | 156 | </div>
 | 
|---|
 | 157 | 
 | 
|---|
 | 158 | <h2>Cygwin installation procedure to compile samhain</h2>
 | 
|---|
 | 159 | 
 | 
|---|
 | 160 | <h3>Cygwin download</h3>
 | 
|---|
 | 161 | 
 | 
|---|
 | 162 | <ul>
 | 
|---|
 | 163 | <li>
 | 
|---|
 | 164 | Make a temporary directory to store cygwin installer (e.g. c:\temp\cygwin)
 | 
|---|
 | 165 | </li>
 | 
|---|
 | 166 | <li>
 | 
|---|
 | 167 | Surf to <a href="http://www.cygwin.com">http://www.cygwin.com</a> 
 | 
|---|
 | 168 | to download cygwin
 | 
|---|
 | 169 | </li>
 | 
|---|
 | 170 | <li>
 | 
|---|
 | 171 | Use the "install or update now (using setup.exe)" to
 | 
|---|
 | 172 | download the installer in c:\temp\cygwin
 | 
|---|
 | 173 | </li>
 | 
|---|
 | 174 | <li>
 | 
|---|
 | 175 | Execute "setup.exe" in c:\temp\cygwin
 | 
|---|
 | 176 | </li>
 | 
|---|
 | 177 | <li>
 | 
|---|
 | 178 | Choose the "download from the Internet" option
 | 
|---|
 | 179 | </li>
 | 
|---|
 | 180 | <li>
 | 
|---|
 | 181 | Choose "c:\temp\cygwin" as 'Local Package Directory'
 | 
|---|
 | 182 | </li>
 | 
|---|
 | 183 | <li>
 | 
|---|
 | 184 | Choose an FTP site
 | 
|---|
 | 185 | </li>
 | 
|---|
 | 186 | <li>
 | 
|---|
 | 187 | Click on 'Default' just after 'All' to change the installation type
 | 
|---|
 | 188 | from 'Default' to 'Install'. This will most likely install way too much
 | 
|---|
 | 189 | stuff but I am not familiar with Cygwin, so this way I know that all libs and
 | 
|---|
 | 190 | compilers are installed.
 | 
|---|
 | 191 | </li>
 | 
|---|
 | 192 | <li>
 | 
|---|
 | 193 | Let it download the stuff (there is a lot to download so be patient).
 | 
|---|
 | 194 | </li>
 | 
|---|
 | 195 | </ul>
 | 
|---|
| [18] | 196 | <div class="block">
 | 
|---|
 | 197 | <p>
 | 
|---|
 | 198 | You don't need to download and install All packages. It is enough to keep
 | 
|---|
 | 199 | the Default and then add the following additional packages:
 | 
|---|
 | 200 | </p>
 | 
|---|
 | 201 | <p>
 | 
|---|
 | 202 |   Category Devel -> gcc: C compiler upgrade helper<br/>
 | 
|---|
 | 203 |   Category Devel -> make: The GNU version of the 'make' utility<br/>
 | 
|---|
 | 204 |   Category Libs  -> minires: A simple synchronous non caching stub resolver<br/>
 | 
|---|
 | 205 | </p>
 | 
|---|
 | 206 | <p>
 | 
|---|
 | 207 | When selecting these packages, Cygwin installer will automatically add
 | 
|---|
 | 208 | other packages based on their dependencies.
 | 
|---|
 | 209 | The package minires is only necessary for a minimal Cygwin installation
 | 
|---|
 | 210 | (below). [Kindly pointed out by Jorge Morgado].
 | 
|---|
 | 211 | </p>
 | 
|---|
 | 212 | </div>
 | 
|---|
| [1] | 213 | 
 | 
|---|
 | 214 | <h3>Cygwin installation</h3>
 | 
|---|
 | 215 | 
 | 
|---|
 | 216 | <ul>
 | 
|---|
 | 217 | <li>
 | 
|---|
 | 218 | When the download is complete you have the Cygwin software in the
 | 
|---|
 | 219 | temporary directory, however, it still needs to be installed.
 | 
|---|
 | 220 | </li>
 | 
|---|
 | 221 | <li>
 | 
|---|
 | 222 | To install, execute the "setup.exe" in "c:\temp\cygwin"
 | 
|---|
 | 223 | </li>
 | 
|---|
 | 224 | <li>
 | 
|---|
 | 225 | Choose the "Install from local directory" option.
 | 
|---|
 | 226 | </li>
 | 
|---|
 | 227 | <li>
 | 
|---|
 | 228 | Choose "C:\Cygwin" as root directory (this will be the Unix '/')
 | 
|---|
 | 229 | </li>
 | 
|---|
 | 230 | <li>
 | 
|---|
 | 231 | Choose the Local Package Directory: "c:\temp\cygwin"
 | 
|---|
 | 232 | </li>
 | 
|---|
 | 233 | <li>
 | 
|---|
 | 234 | Click on 'Default' just after 'All' to change the installation type
 | 
|---|
 | 235 | from 'Default' to 'Install'.
 | 
|---|
 | 236 | </li>
 | 
|---|
 | 237 | <li>
 | 
|---|
 | 238 | Let it install Cygwin (this will take some time so be patient).
 | 
|---|
 | 239 | </li>
 | 
|---|
 | 240 | </ul>
 | 
|---|
 | 241 | 
 | 
|---|
 | 242 | <h3>Samhain install procedure (used 'samhain 1.8.7a' in this procedure)</h3>
 | 
|---|
 | 243 | <p>
 | 
|---|
 | 244 | (in the following procedure I use my personal preferences)
 | 
|---|
 | 245 | </p>
 | 
|---|
 | 246 | 
 | 
|---|
 | 247 | <ul>
 | 
|---|
 | 248 | <li>
 | 
|---|
 | 249 | Start up Cygwin using the "Cygwin" icon on the desktop (a classic
 | 
|---|
 | 250 | Unix environment will be started).
 | 
|---|
 | 251 | </li>
 | 
|---|
 | 252 | <li>
 | 
|---|
 | 253 | Download the 'samhain' gzip/tar (I always put in my home directory)
 | 
|---|
 | 254 | </li>
 | 
|---|
 | 255 | <li>
 | 
|---|
 | 256 | Make directories to install samhain (taking into account the configure
 | 
|---|
 | 257 | options):<br />
 | 
|---|
 | 258 |    <tt>$ mkdir /usr/local/sbin</tt><br />
 | 
|---|
 | 259 |    <tt>$ mkdir /usr/local/var</tt><br />
 | 
|---|
 | 260 |    <tt>$ mkdir /usr/local/log</tt><br />
 | 
|---|
 | 261 |    <tt>$ mkdir /usr/local/tmp</tt><br />
 | 
|---|
 | 262 | </li>
 | 
|---|
 | 263 | <li>Go to the home directory:<br />
 | 
|---|
 | 264 |    <tt>$ cd $HOME</tt>
 | 
|---|
 | 265 | </li>
 | 
|---|
 | 266 | <li>Un-gzip and untar the samhain package:<br />
 | 
|---|
 | 267 |    <tt>$ gunzip samhain-1.8.7a.tar.gz</tt><br />
 | 
|---|
 | 268 |    <tt>$ tar xvf samhain-1.8.7a.tar</tt><br />
 | 
|---|
 | 269 | </li>
 | 
|---|
 | 270 | <li>Go to the samhain directory:<br />
 | 
|---|
 | 271 |    <tt>$ cd samhain-1.8.7a</tt><br />
 | 
|---|
 | 272 | </li>
 | 
|---|
 | 273 | <li>Configure:<br />
 | 
|---|
 | 274 |    <tt>$ ./configure --enable-xml-log=yes --with-tmp-dir=/usr/local/tmp --with-config-file=/usr/local/etc/samhainrc --with-log-file=/usr/local/log/samhain.log --with-pid-file=/usr/local/var/samhain.pid --with-state-dir=/usr/local/var</tt><br />
 | 
|---|
| [297] | 275 | <div class="block">
 | 
|---|
 | 276 | <p>
 | 
|---|
 | 277 | In my experience, the paths given in the 'configure' command should refer to
 | 
|---|
 | 278 | the Cygwin filesystem view, i.e. <tt>/cygdrive/c/...</tt>, otherwise
 | 
|---|
 | 279 | samhain may not work from a pure DOS shell, and may not run as a Windows 
 | 
|---|
| [307] | 280 | service [Rainer Wichmann].
 | 
|---|
| [297] | 281 | </p>
 | 
|---|
 | 282 | </div>
 | 
|---|
| [1] | 283 | </li>
 | 
|---|
 | 284 | <li>Make the binary:<br />
 | 
|---|
 | 285 |    <tt>$ make</tt><br />
 | 
|---|
 | 286 | </li>
 | 
|---|
 | 287 | <li>Install samhain:<br />
 | 
|---|
 | 288 |    <tt>$ make install</tt><br />
 | 
|---|
 | 289 | </li>
 | 
|---|
 | 290 | <li>Now configure the "/usr/local/etc/samhainrc" file.<br />
 | 
|---|
 | 291 | Remember: "C:\" -> "/cygdrive/c/"
 | 
|---|
 | 292 | </li>
 | 
|---|
 | 293 | <li>Initialize the samhain local baseline database:<br />
 | 
|---|
 | 294 |    <tt>$ /usr/local/sbin/samhain -t init</tt><br />
 | 
|---|
 | 295 | </li>
 | 
|---|
 | 296 | <li>Start it up:<br />
 | 
|---|
 | 297 |    <tt>$ /usr/local/sbin/samhain -t check</tt><br />
 | 
|---|
 | 298 | </li>
 | 
|---|
 | 299 | </ul>
 | 
|---|
 | 300 | 
 | 
|---|
 | 301 | 
 | 
|---|
 | 302 | <h2>Cygwin minimal installation procedure to run samhain</h2>
 | 
|---|
 | 303 | 
 | 
|---|
 | 304 | <ul>
 | 
|---|
 | 305 | <li>
 | 
|---|
 | 306 | Files needed to create a service (from NT/W2K Resource Kit):
 | 
|---|
 | 307 |  <ul>
 | 
|---|
 | 308 |  <li>
 | 
|---|
 | 309 |  instsrv.exe
 | 
|---|
 | 310 |  </li>
 | 
|---|
 | 311 |  <li>
 | 
|---|
 | 312 |  srvany.exe
 | 
|---|
 | 313 |  </li>
 | 
|---|
 | 314 |  </ul>
 | 
|---|
 | 315 | </li>
 | 
|---|
 | 316 | <li>
 | 
|---|
 | 317 | First copy these files to the "%winnt%\system32" directory.
 | 
|---|
 | 318 | </li>
 | 
|---|
 | 319 | <li>
 | 
|---|
 | 320 | Files needed to run the 'samhain.exe'. Copy the following .dll from the
 | 
|---|
 | 321 | Cygwin setup (c:\Cygwin\bin) to the "%winnt%\system32" directory:
 | 
|---|
 | 322 |  <ul>
 | 
|---|
 | 323 |  <li>
 | 
|---|
 | 324 |  cygwin1.dll
 | 
|---|
 | 325 |  </li>
 | 
|---|
 | 326 |  <li>
 | 
|---|
 | 327 |  cygminires.dll
 | 
|---|
 | 328 |  </li>
 | 
|---|
 | 329 |  </ul>
 | 
|---|
 | 330 | </li>
 | 
|---|
 | 331 | <li>
 | 
|---|
| [18] | 332 | Files needed from c:\Cygwin\bin to create the /etc/passwd and /etc/group files:
 | 
|---|
 | 333 |  <ul>
 | 
|---|
 | 334 |  <li>
 | 
|---|
 | 335 |  mkpasswd.exe
 | 
|---|
 | 336 |  </li>
 | 
|---|
 | 337 |  <li>
 | 
|---|
 | 338 |  mkgroup.exe
 | 
|---|
 | 339 |  </li>
 | 
|---|
 | 340 |  </ul>
 | 
|---|
 | 341 | <p>
 | 
|---|
 | 342 | To generate these files on a minimal Cygwin installation execute - on a
 | 
|---|
 | 343 | Windows Command Prompt:
 | 
|---|
 | 344 | </p><p>
 | 
|---|
 | 345 |    <tt>mkdir c:\etc</tt><br />
 | 
|---|
 | 346 |    <tt>path\to\mkpasswd.exe -l > c:\etc\passwd</tt><br />
 | 
|---|
 | 347 |    <tt>path\to\mkgroup.exe -l > c:\etc\group</tt>
 | 
|---|
 | 348 | </p><p>
 | 
|---|
 | 349 | IMPORTANT NOTE: You should re-create these two files, each time the
 | 
|---|
 | 350 | Windows users and groups accounts database changes. Failing to do this
 | 
|---|
 | 351 | might generate critical log messages (depending on your configuration
 | 
|---|
 | 352 | file).
 | 
|---|
 | 353 | </p>
 | 
|---|
 | 354 | </li>
 | 
|---|
 | 355 | <li>
 | 
|---|
| [1] | 356 | Create a directory structure for samhain (following the compilation options
 | 
|---|
 | 357 | you used)<br />
 | 
|---|
 | 358 |    - in a DOS box (or via Windows Explorer)<br />
 | 
|---|
 | 359 |    <tt>mkdir c:\usr</tt><br />
 | 
|---|
 | 360 |    <tt>mkdir c:\usr\local</tt><br />
 | 
|---|
 | 361 |    <tt>mkdir c:\usr\local\sbin</tt><br />
 | 
|---|
 | 362 |    <tt>mkdir c:\usr\local\var</tt><br />
 | 
|---|
 | 363 |    <tt>mkdir c:\usr\local\tmp</tt><br />
 | 
|---|
 | 364 |    <tt>mkdir c:\usr\local\log</tt><br />
 | 
|---|
 | 365 |    <tt>mkdir c:\usr\local\etc</tt><br />
 | 
|---|
 | 366 | </li>
 | 
|---|
 | 367 | <li>
 | 
|---|
 | 368 | Use the "instsrv.exe" binary to create a new service:<br />
 | 
|---|
 | 369 |    <tt>instsrv.exe samhain c:\windows\system32\srvany.exe</tt><br />
 | 
|---|
 | 370 |    (this will create a service called "Samhain" that will
 | 
|---|
 | 371 | start the "srvany.exe" process).
 | 
|---|
 | 372 | </li>
 | 
|---|
 | 373 | <li>Now edit the registry to change the startup parameters for the newly
 | 
|---|
 | 374 | created service:
 | 
|---|
 | 375 |   <ul>
 | 
|---|
 | 376 |   <li>regedit</li>
 | 
|---|
 | 377 |   <li>HKEY_LOCAL_MACHINE->SYSTEM->CurrentControlSet->Services->Samhain</li>
 | 
|---|
 | 378 |   <li>Add a String value (type: REG_SZ called: "Description") under the 'Samhain' key</li>
 | 
|---|
 | 379 |   <li>Open the newly created "Description" value and fill in a description for the 'Samhain' service</li>
 | 
|---|
 | 380 |   <li>Add a key to specify what file the "srvany.exe" process must start:<br />
 | 
|---|
 | 381 |      Edit->New->Key called "Parameters"
 | 
|---|
 | 382 |   </li>
 | 
|---|
 | 383 |   <li>Under the newly created "Parameters" key, add a new String 
 | 
|---|
| [18] | 384 |   value called "Application".<br />
 | 
|---|
 | 385 |      The value for "Application"
 | 
|---|
| [1] | 386 |   should be "c:\usr\local\sbin\samhain.exe".</li>
 | 
|---|
 | 387 |   </ul>
 | 
|---|
 | 388 | </li>
 | 
|---|
 | 389 | <li>
 | 
|---|
 | 390 | Make sure that in the "samhainrc" file, you have used
 | 
|---|
 | 391 | "/cygdrive/c" to refer to "c:"
 | 
|---|
 | 392 | </li>
 | 
|---|
 | 393 | <li>
 | 
|---|
 | 394 | Initialize the samhain baseline database first:<br />
 | 
|---|
 | 395 |    <tt>c:\usr\local\sbin\samhain -t init</tt><br />
 | 
|---|
 | 396 | </li>
 | 
|---|
 | 397 | <li>
 | 
|---|
 | 398 | Reboot (it is Windows so ...)
 | 
|---|
 | 399 | </li>
 | 
|---|
 | 400 | </ul>
 | 
|---|
| [307] | 401 | <div class="block">
 | 
|---|
| [1] | 402 | <p>
 | 
|---|
| [307] | 403 | It seems that start/stop/restart the service does not work if samhain 
 | 
|---|
 | 404 | is configured to run as a daemon, because the Windows service manager
 | 
|---|
 | 405 | cannot track the forked daemon process.
 | 
|---|
 | 406 | </p>
 | 
|---|
 | 407 | <p>Therefore, if you run Samhain as a Windows service, it might be better
 | 
|---|
 | 408 | to configure it as a 'normal' process which does not fork a daemon:
 | 
|---|
 | 409 | <ul>
 | 
|---|
 | 410 |   <li>
 | 
|---|
 | 411 |     Set 'Daemon = no' in the samhainrc configuration file.
 | 
|---|
 | 412 |   </li>
 | 
|---|
 | 413 |   <li>
 | 
|---|
 | 414 |     Edit the key HKEY_LOCAL_MACHINE->SYSTEM->CurrentControlSet->Services->Samhain->Parameters to add a string value named 'AppParameters', with
 | 
|---|
 | 415 |     the value '--forever'.
 | 
|---|
 | 416 |   </li>
 | 
|---|
 | 417 | </ul>
 | 
|---|
 | 418 | [Rainer Wichmann].
 | 
|---|
 | 419 | </p>
 | 
|---|
 | 420 | </div>
 | 
|---|
 | 421 | <p>
 | 
|---|
| [18] | 422 | Also see <a href="http://support.microsoft.com/kb/q137890/">http://support.microsoft.com/kb/q137890/</a> for information regarding the creation of a 
 | 
|---|
 | 423 | user-defined service.
 | 
|---|
 | 424 | </p>
 | 
|---|
 | 425 | <p>
 | 
|---|
| [1] | 426 | Note: the first time I tried to install samhain as an NT service, I first
 | 
|---|
 | 427 | installed a default Cygwin on the system. This however made things much more
 | 
|---|
 | 428 | complex. I think when there is no Cygwin installed, it is more easy to install
 | 
|---|
 | 429 | Samhain as a service.
 | 
|---|
 | 430 | </p>
 | 
|---|
| [18] | 431 | 
 | 
|---|
 | 432 | 
 | 
|---|
 | 433 | <h2>Troubleshooting samhain</h2>
 | 
|---|
 | 434 | 
 | 
|---|
 | 435 | <p>
 | 
|---|
| [297] | 436 | [Rainer Wichmann] I had some problems at first getting it to run as a 
 | 
|---|
 | 437 | Windows service. Some tips:
 | 
|---|
 | 438 | <ul>
 | 
|---|
 | 439 |   <li>
 | 
|---|
 | 440 |     Running samhain from a pure DOS shell (outside the Cygwin environment) 
 | 
|---|
 | 441 |     helps to identify problems, in particular if it refuses to start
 | 
|---|
 | 442 |     as a Windows service.
 | 
|---|
 | 443 |   </li>
 | 
|---|
 | 444 |   <li>
 | 
|---|
 | 445 |     I found it neccessary to put the <tt>cygwin1.dll</tt> DLL into the
 | 
|---|
 | 446 |     same directory as the <tt>samhain.exe</tt> executable. Also, you
 | 
|---|
 | 447 |     can use the command <tt>ldd ./samhain.exe</tt> to identify further
 | 
|---|
 | 448 |     Cygwin-specific DLL that may be required (if any).
 | 
|---|
 | 449 |   </li>
 | 
|---|
 | 450 |   <li>
 | 
|---|
 | 451 |     Also, I found it neccessary to use Cygwin-style paths 
 | 
|---|
 | 452 |     (<tt>/cygdrive/c/...</tt>) in the './configure ..' command when
 | 
|---|
 | 453 |     compiling samhain.
 | 
|---|
 | 454 |   </li>
 | 
|---|
 | 455 | </ul>
 | 
|---|
 | 456 | </p>
 | 
|---|
 | 457 |     
 | 
|---|
 | 458 | <p>
 | 
|---|
| [18] | 459 | [Tip from Jorge Morgado] If you, like me, have a Windows server not part of any domain and (for
 | 
|---|
 | 460 | security reasons) you even turn off DNS resolution, you might probably get
 | 
|---|
 | 461 | the following error when initializing the baseline database:
 | 
|---|
 | 462 | </p>
 | 
|---|
 | 463 | <pre>
 | 
|---|
 | 464 |   ---------   sh_unix.c  ---   1487 ---------
 | 
|---|
 | 465 |   According to uname, your nodename is yourcomputername, but your resolver
 | 
|---|
 | 466 |   library cannot resolve this nodename to a FQDN.
 | 
|---|
 | 467 |   Rather, it resolves this to yourcomputername.
 | 
|---|
 | 468 |   For more information, see the entry about self-resolving under
 | 
|---|
 | 469 |   'Most frequently' in the FAQ that you will find in the docs/ subdirectory
 | 
|---|
 | 470 |   ----------------------------------------------
 | 
|---|
 | 471 | </pre>
 | 
|---|
 | 472 | <p>
 | 
|---|
 | 473 | To fix this problem open the Registry Editor and create the following
 | 
|---|
 | 474 | entries under the key
 | 
|---|
 | 475 | HKLM\System\CurrentControlSet\Services\Tcpip\Parameters
 | 
|---|
 | 476 | </p>
 | 
|---|
 | 477 | <p>
 | 
|---|
 | 478 | <tt>
 | 
|---|
 | 479 | Name: Domain<br/>
 | 
|---|
 | 480 | Type: REG_SZ<br/>
 | 
|---|
 | 481 | Data: your.domain.name
 | 
|---|
 | 482 | </tt>
 | 
|---|
 | 483 | </p><p>
 | 
|---|
 | 484 | <tt>
 | 
|---|
 | 485 | Name: NV Domain<br/>
 | 
|---|
 | 486 | Type: REG_SZ<br/>
 | 
|---|
 | 487 | Data: your.domain.name
 | 
|---|
 | 488 | </tt>
 | 
|---|
 | 489 | </p><p>
 | 
|---|
 | 490 | The NV Domain registry value contains the computer's primary DNS suffix
 | 
|---|
 | 491 | while the Domain registry value contains the computer's primary DNS
 | 
|---|
 | 492 | domain. This will make the warning message go away.
 | 
|---|
 | 493 | </p>
 | 
|---|
| [1] | 494 | </div>
 | 
|---|
 | 495 | </body>
 | 
|---|
 | 496 | </html>
 | 
|---|