framemain.html #2

  • //
  • guest/
  • bryan_costales/
  • docs/
  • init/
  • framemain.html
  • View
  • Commits
  • Open Download .zip Download (3 KB)
<html>
<body>
<h2>The slow.init script</h2>
The <b>slow.init</b> file is used to start, stop, and
restart the <b>slowmilt</b> daemon. It is suitable to
install in, for example, <i>/etc/init.d</i>, or 
<i>/etc/rc.local</i>. The recommended proceedure is
to copy or rename it in the /etc/mail/milter/slow
directory, from <i>slow.init.pat</i> into <i>slow.init</i>.
<p>
Before you may use <b>slow.init</b> in production, you need
to edit it and redefine its contents.
<h3>Whom to run as</h3>
First you need to set who this milter will run as. This setting
is only needed to kill the milter, and is only really needed on
Solaris systems. The value used here, must match the value assigned
to the
<a href="../conf/runasuser.html">RunAsUser</a> configuration item:
<p><code><pre><menu>
MILTERWHO=nobody
</menu></pre></code>
Here, <code>nobody</code> is the login name of the user identity
that the milter will run as if it is executed by <i>root</i>.
<h3>How to kill the milter</h3>
Next you must set the method used to kill the milter. Just uncomment
the appropriate line and comment out the wrong line. The selection
might look like this:
<p><code><pre><menu>
#
# The command to kill the milter. Set to be right for your OS.
#
MILTERKILL="/usr/bin/pkill -x -u ${MILTERWHO} ${MILTER}"
#MILTERKILL="/usr/bin/killall ${MILTER}"
</menu></pre></code>
<h3>Where the milter was installed</h3>
In the event you chose to install the <b>slowmilt</b> system
in a directory other than the default (/etc/mail/milter/slow),
you will need to modify the following define with that new
location:
<p><code><pre><menu>
MILTERDIR=/email/filters/slow
</menu></pre></code>
<h3>Command-line arguments</h3>
If you wish to give the <b>slowmilt</b> milter any command-line
options at startup, you may define them with the following macro:
<p><code><pre><menu>
MILTERARGS="-Dsource"
</menu></pre></code>
Here, <code>-Dsource</code> causes the source file names and line numbers
to be printed and logged as part of any error message or warning.
<h3>Other settings</h3>
Other macros in the <b>slow.init</b> file are obvious from context and
will likely never need to be changed.
<h3>How to run slow.init</h3>
The <b>slow.init</b> script take one of three arguements when it
is run:
<p>
<a name="restart"><table border="1" cellpadding="3"></a>
<tr bgcolor="lightgrey"><td>Command</td><td>Does What</td></tr>
<tr><td align "center" valign="top">start</td><td>Start the milter running. If it is already
running, the new milter will fail to start because its port is
already in use. Creates a semaphore file so that <b>slow.run</b>
can detect a stop command.</td></tr>
<tr><td align "center" valign="top">stop</td><td>Stop the milter. If it is already
stopped, this command will print an error.
This command removes the semaphore file, then signals the
milter to abort. The shutdown of the milter can take a few
seconds.</td></tr>
<tr><td align "center" valign="top">restart</td><td>Restart the milter.
This is the equalivent of stopping and starting the milter
with the <b>stop</b> and <b>start</b> commands by hand.</td></tr>
</table>
<p>
Once you've started the milter, never kill it by hand. If you do,
the <b>slow.run</b> script will automatically restart it. Only use
<b>slow.init stop</b> to stop the milter.
<p>
</body>
</html>	
# Change User Description Committed
#2 4052 bryan_costales Implimented:
    whitelisting
    AddMXHost for MX servers that lie
    Converted to thread safe DNS routines
    garbage collection
    RunAsUser and RunAsGroup for root startups
    rebuild the database
    summarize by IP number
Finished all documentation.
Moved release from alpha to beta
#1 3998 bryan_costales Brought the whole distribution up to V0.9
Added a huge abount of documentation.
Added slowedit find
Created startup scripts to launch for testing
Fixed numerous bugs.
Fixed a few portablity issues.
Installed hooks for whitelisting and IP aliases.