/usr/share/doc/cyrus-doc/html/install-sieve.html is in cyrus-doc 2.5.10-3ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<HEAD>
<meta http-equiv="Content-type" content="text/html;charset=UTF-8">
<TITLE>Installing Sieve
</title>
</head>
<body>
<h1>Installing Sieve</h1>
<p>This section assumes that you compiled Cyrus with sieve support. If
you specified <tt>--disable-sieve</tt> when running
<tt>./configure</tt>, you did NOT compile the server with sieve
support.
<h3>Configure outgoing mail</h3>
<p>Some Sieve actions (redirect, vacation) can send outgoing mail.</p>
<p>You'll need to make sure that "<tt>lmtpd</tt>" can send outgoing
messages. Currently, it invokes "<tt>/usr/lib/sendmail</tt>" by
default to send messages. Change this by adding a line like:</p>
<pre>
sendmail: /usr/sbin/sendmail
</pre>
<p>in your "<tt>/etc/imapd.conf</tt>". If you're using Postfix or another
MTA, make sure that the sendmail referenced in
"<tt>/etc/imapd.conf</tt>" is Sendmail-compatible.</p>
<h3>Managing Sieve Scripts</h3>
Since Cyrus is based around the concept of a sealed-server, the normal
way for users to manipulate Sieve scripts is through the
"<tt>sieveshell</tt>" utility.
<p>If, for some reason, you do have user home directories on the
server, you can use the "<tt>sieveusehomedir</tt>" option and have the
sieve script stored in the home directory of the user as
"<tt>~/.sieve</tt>".
<h3>Testing the sieve server</h3>
<ol>
<li>"<tt>timsieved</tt>", is a ManageSieve server used for transporting
user Sieve scripts to the sealed IMAP server. It is incompatible with
the "<tt>sieveusehomedir</tt>" option. It is named after the
principal author, Tim Martin, who desperately wanted something named
after him in the Cyrus distribution.
<li>From your normal account, telnet to the sieve port on the
server you're setting up:
<pre>
<kbd> telnet foobar sieve
</kbd></pre>
<p>If your server is running, you'll get a message similar to the following one:
<pre>
Trying 128.2.10.192...
Connected to foobar.andrew.cmu.edu.
Escape character is '^]'.
"IMPLEMENTATION" "Cyrus timsieved v1.1.0"
"SASL" "ANONYMOUS PLAIN KERBEROS_V4 GSSAPI"
"SIEVE" "fileinto reject envelope vacation imapflags notify subaddress regex"
OK
</pre>
<p>
Any message other than one similar to the one above means there is a
problem. Make sure all of authentication methods you wish to support
are listed. This list should be identical to the one listed by
"<tt>imapd</tt>" earlier. Next terminate the connection, by typing
"<kbd>logout</kbd>".
<li>Next test authenticating to the sieve server. To do this run the
"<tt>sieveshell</tt>" utility. You must specify the server. If you
run this utility from a different machine without the "sieve" entry in
"/etc/services", port 4190 will be used.
<pre>
"<kbd>sieveshell foobar</kbd>"
Please enter your password: ******
> quit
</pre>
This should produce the message "<tt>Authentication failed</tt>" with
a description of the failure if there was a problem.
<p><li>Next you should attempt to place a sieve script on the
server. To do this create a file named "<tt>myscript.script</tt>" with
the following lines. Replace "<tt>foo@example.org</tt>" with an email
address you can send mail from, but that is not the one you are
working on now.
<pre>
require ["reject","fileinto"];
if address :is :all "From" "foo@example.org"
{
reject "testing";
}
</pre>
To place this script on the server run the following command:
<pre>
"<kbd>sieveshell foobar</kbd>"
Please enter your password: ******
> put myscript.script
> activate myscript
> quit
</pre>
This should place your script on the server and make it the active script.
<p>
<li>Test that the sieve script is actually run from deliver. Send
a message to the address you're working on from the address mentioned
in the sieve script. The message should be rejected.
</ol>
<P><HR>
last modified: $Date: 2001/10/23 18:14:48 $
</BODY></HTML>
|