Changeset 18 for trunk/docs

Timestamp:

Jan 28, 2006, 9:07:52 PM (19 years ago)

Author:

rainer

Message:

Optimized version of tiger algorithm, and basic ingredients for unit testing (part 2)

Location:

trunk/docs

Files:

• Changelog (modified) (1 diff)
• HOWTO-samhain-on-windows.html (modified) (7 diffs)
• README.UPGRADE (modified) (1 diff)
• TODO (modified) (1 diff)

trunk/docs/Changelog

@@ +1 @@
+2.2.0:
+        * added a bit of unit testing
+        * improved the windows howto according to suggestions by 
+          Jorge Morgado
+        * minor optimizations in various places
+        * optimized implementation of tiger checksum algorithm
+        * read in 64k blocks (faster than 4k)
+        * sh_unix.c, sh_hash.c: support file flags on *BSD, update Linux
+          file attribute code
+        * kern_head: fix compilation of kernel check module on OpenBSD
+        * updated samhainrc.linux, samhainrc.freebsd
+        * sh_unix.c: fix setrlimit (RLIMIT_NOFILE, ..)
+        * sh_files.c: fix missing use of flag_err_info
+        * sh_tiger0.c: remove repetitive use of mlock
+        * slib.c: remove fcntl's from sl_read_timeout (caller sets O_NONBLOCK),
+          add function sl_read_timeout_prep
+
+2.1.2 (10-01-2006):
+        * fix startup error with combination of gpg+prelude
 
 2.1.1a (22-12-2005):

trunk/docs/HOWTO-samhain-on-windows.html

@@ -135 +135 @@
 <b>Cygwin</b> POSIX emulation layer, and how to install it as a service. 
 These instructions have been written by Kris Dom,
-who has tested this on WinXP Professional.
+who has tested this on WinXP Professional, with additions by Geries Handal
+and Jorge Morgado.
 </p>
 <div class="block">
@@ -150 +151 @@
 logging) because Interix does not provide some of the required functionality 
 to build the email module. This issue should be fixed as of samhain 
-version 2.0.7 (not tested).<br />[Based on information kindly provided by Geries Handal].
+version 2.0.7 (not tested).<br />
+[Based on information kindly provided by Geries Handal].
 </p>
 </div>
@@ -192 +194 @@
 </li>
 </ul>
+<div class="block">
+<p>
+You don't need to download and install All packages. It is enough to keep
+the Default and then add the following additional packages:
+</p>
+<p>
+  Category Devel -> gcc: C compiler upgrade helper<br/>
+  Category Devel -> make: The GNU version of the 'make' utility<br/>
+  Category Libs  -> minires: A simple synchronous non caching stub resolver<br/>
+</p>
+<p>
+When selecting these packages, Cygwin installer will automatically add
+other packages based on their dependencies.
+The package minires is only necessary for a minimal Cygwin installation
+(below). [Kindly pointed out by Jorge Morgado].
+</p>
+</div>
 
 <h3>Cygwin installation</h3>
@@ -301 +320 @@
  </li>
  </ul>
+</li>
+<li>
+Files needed from c:\Cygwin\bin to create the /etc/passwd and /etc/group files:
+ <ul>
+ <li>
+ mkpasswd.exe
+ </li>
+ <li>
+ mkgroup.exe
+ </li>
+ </ul>
+<p>
+To generate these files on a minimal Cygwin installation execute - on a
+Windows Command Prompt:
+</p><p>
+&nbsp; &nbsp;<tt>mkdir c:\etc</tt><br />
+&nbsp; &nbsp;<tt>path\to\mkpasswd.exe -l > c:\etc\passwd</tt><br />
+&nbsp; &nbsp;<tt>path\to\mkgroup.exe -l > c:\etc\group</tt>
+</p><p>
+IMPORTANT NOTE: You should re-create these two files, each time the
+Windows users and groups accounts database changes. Failing to do this
+might generate critical log messages (depending on your configuration
+file).
+</p>
 </li>
 <li>
@@ -331 +374 @@
   </li>
   <li>Under the newly created &quot;Parameters&quot; key, add a new String 
-  value called &quot;Applications&quot;.<br />
-  &nbsp; &nbsp;The value for &quot;Applications&quot;
+  value called &quot;Application&quot;.<br />
+  &nbsp; &nbsp;The value for &quot;Application&quot;
   should be &quot;c:\usr\local\sbin\samhain.exe&quot;.</li>
   </ul>
@@ -348 +391 @@
 </li>
 </ul>
+<p>
+Also see <a href="http://support.microsoft.com/kb/q137890/">http://support.microsoft.com/kb/q137890/</a> for information regarding the creation of a 
+user-defined service.
+</p>
 <p>
 Note: the first time I tried to install samhain as an NT service, I first
@@ -354 +401 @@
 Samhain as a service.
 </p>
+
+
+<h2>Troubleshooting samhain</h2>
+
+<p>
+[Tip from Jorge Morgado] If you, like me, have a Windows server not part of any domain and (for
+security reasons) you even turn off DNS resolution, you might probably get
+the following error when initializing the baseline database:
+</p>
+<pre>
+  ---------   sh_unix.c  ---   1487 ---------
+  According to uname, your nodename is yourcomputername, but your resolver
+  library cannot resolve this nodename to a FQDN.
+  Rather, it resolves this to yourcomputername.
+  For more information, see the entry about self-resolving under
+  'Most frequently' in the FAQ that you will find in the docs/ subdirectory
+  ----------------------------------------------
+</pre>
+<p>
+To fix this problem open the Registry Editor and create the following
+entries under the key
+HKLM\System\CurrentControlSet\Services\Tcpip\Parameters
+</p>
+<p>
+<tt>
+Name: Domain<br/>
+Type: REG_SZ<br/>
+Data: your.domain.name
+</tt>
+</p><p>
+<tt>
+Name: NV Domain<br/>
+Type: REG_SZ<br/>
+Data: your.domain.name
+</tt>
+</p><p>
+The NV Domain registry value contains the computer's primary DNS suffix
+while the Domain registry value contains the computer's primary DNS
+domain. This will make the warning message go away.
+</p>
 </div>
 </body>

trunk/docs/README.UPGRADE

@@ +1 @@
+since 2.1.0: update and daemon mode can be combined
+
+  -- this implies that '-t update' will start a daemon process if running as
+     daemon is the default specified in the config file. use '--foreground'
+     to avoid starting a daemon process
+
+
 
 from 1.7.x to 1.8.x: client/server encryption protocol has been enhanced

trunk/docs/TODO

@@ -1 +1 @@
 
-Wishlist:
-
- - yule -> yule relay
- - partial checksum of growing logfiles
-