masqmail-0.2
diff docs/old-manual/install.html @ 56:f6a6f55b7b9e
added old manual from the old website
it is dated May/July 2000
| author | meillo@marmaro.de |
|---|---|
| date | Sat, 29 May 2010 21:51:13 +0200 |
| parents | |
| children |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/docs/old-manual/install.html Sat May 29 21:51:13 2010 +0200 1.3 @@ -0,0 +1,219 @@ 1.4 + 1.5 + 1.6 + 1.7 + 1.8 + 1.9 + 1.10 + 1.11 + 1.12 +<HTML> 1.13 +<HEAD> 1.14 +<TITLE>MasqMail - Manual 1.15 +</TITLE> 1.16 +</HEAD> 1.17 + <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff"> 1.18 + 1.19 + <center> 1.20 + <table width="80%"> 1.21 + <tr><td> 1.22 + <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0> 1.23 +<tr> 1.24 + <td> 1.25 + <a href="manual.html"> 1.26 + <img width="20" src = "../images/u_arrow.gif" alt = "manual"> 1.27 + </a> 1.28 + </td> 1.29 +<td align=center width="100%"><font size="6" color = "#ffffff">Installation</font></td> 1.30 +<td> 1.31 + <a href="./options.html"> 1.32 + <img width="20" src = "../images/r_arrow.gif" alt = "Options"> 1.33 + </a> 1.34 +</td> 1.35 +</tr> 1.36 +</table> 1.37 + 1.38 + 1.39 +<p>You need a user and a group for masqmail to run, I suggest user 1.40 +'mail' and group 'trusted'. Say:</p> 1.41 + 1.42 +<pre> 1.43 +groupadd -g 42 trusted 1.44 +useradd -u 42 -g 42 -d / -s /bin/sh -c "Mail Transfer Agent" mail 1.45 +</pre> 1.46 + 1.47 +<p>If you use other names than <i>mail</i> and <i>trusted</i> use the options 1.48 +described below for configure. The 42 is just a suggestion, you can 1.49 +use any number you like, but preferably one < 100. It does not have 1.50 +to be the same for the user 'mail' and the group 'trusted'.</p> 1.51 + 1.52 +<p>Compliling is a matter of the usual procedure:</p> 1.53 + 1.54 +In the source directory, after unpacking do:<br> 1.55 + 1.56 +<pre> 1.57 +./configure 1.58 +make 1.59 +make install 1.60 +</pre> 1.61 + 1.62 +<p>Optionally, after you have called make, you can make some tests in 1.63 +the tests directory. Read the README in that directory for 1.64 +instructions.</p> 1.65 + 1.66 +<h4>Additional options for configure:</h4> 1.67 + 1.68 +<p> 1.69 +<b>--with-user=USER</b> sets the user as which MasqMail will run. Default is 1.70 +<i>mail</i>. USER has to exist before you 'make install'. 1.71 +</p><p> 1.72 +<b>--with-group=GROUP</b> sets the group as which MasqMail will run. Default 1.73 +is <i>trusted</i>. GROUP has to exist before you 'make install'. 1.74 +</p><p> 1.75 +<b>--with-logdir=LOGDIR</b> sets the directory where MasqMail stores its log 1.76 +files. It will be created if it does not exist. Default is /var/masqmail/. 1.77 +</p><p> 1.78 +<b>--with-spooldir=SPOOLDIR</b> sets the directory where MasqMail stores its 1.79 +spool files. It will be created if it does not exist. Default is 1.80 +/var/spool/masqmail/. 1.81 +</p><p> 1.82 +<b>--enable-auth</b> enables ESMTP AUTH support (disabled by default) 1.83 +</p><p> 1.84 +<b>--disable-pop3</b> disables pop3 support (enabled by default) 1.85 +</p> 1.86 + 1.87 +<h4>After make install</h4> 1.88 + 1.89 +<p> 1.90 +You can also use these instructions to omit 'make install' if you do 1.91 +not want to use it. 1.92 +</p><p> 1.93 +Check that 'make install' worked correctly. The following command: 1.94 +</p><p><pre> 1.95 +ls -ld /usr/sbin/masqmail /var/masqmail/ /var/spool/masqmail /var/spool/masqmail/input 1.96 +</pre></p><p> 1.97 +should give output similar to 1.98 +</p><p> 1.99 +<pre> 1.100 +-rwsr-xr-x 1 root root 86955 Oct 14 14:27 /usr/sbin/masqmail 1.101 +drwxr-xr-x 2 mail trusted 1024 Oct 14 14:29 /var/masqmail/ 1.102 +drwxr-xr-x 3 mail trusted 1024 Oct 14 14:27 /var/spool/masqmail 1.103 +drwxr-xr-x 2 mail trusted 1024 Oct 14 18:32 /var/spool/masqmail/input 1.104 +drwxr-xr-x 2 mail trusted 1024 Oct 14 18:32 /var/spool/masqmail/popuidl 1.105 +</pre> 1.106 +</p> 1.107 +<p> 1.108 +(important is the set-user-id bit for /usr/sbin/masqmail and the 1.109 +ownership of all items). 1.110 +</p> 1.111 + 1.112 +<p>Edit the configuration files. You can use the files from the 1.113 +examples directory as a template. Copy masqmail.conf to 1.114 +/etc/maqmail.conf, the others to the location given in 1.115 +masqmail.conf.</p> 1.116 + 1.117 +<p>If you already have an MTA (eg. sendmail) installed, move that to 1.118 +another location:</p> 1.119 + 1.120 +mv /usr/sbin/sendmail /usr/sbin/sendmail.orig<br> 1.121 + 1.122 +<p>Then make a link to the new MTA:</p> 1.123 + 1.124 +<pre> 1.125 +ln -s /usr/sbin/masqmail /usr/sbin/sendmail 1.126 +</pre> 1.127 + 1.128 +<p>Now every mailer that used to call sendmail will now call 1.129 +masqmail. You can now kill your old sendmail if it is running and 1.130 +start masqmail. Usually this is done with the startup scripts. For 1.131 +SuSE this would be (as root):</p> 1.132 + 1.133 +<pre> 1.134 +/sbin/init.d/sendmail stop 1.135 +/sbin/init.d/sendmail start 1.136 +</pre> 1.137 + 1.138 +<p>or shorter:</p> 1.139 + 1.140 +<pre> 1.141 +/sbin/init.d/sendmail restart<br> 1.142 +</pre> 1.143 + 1.144 +<p>You can also start it with:</p> 1.145 + 1.146 +<pre> 1.147 +/usr/sbin/sendmail -bd -q30m<br> 1.148 +</pre> 1.149 + 1.150 +<p>You can also let it be called from inetd (with the -bs option), but 1.151 +this is untested.</p> 1.152 + 1.153 +<h4>Configuring for online delivery</h4> 1.154 + 1.155 +<p>Now you have to set up the online configuration. The trick is to 1.156 +tell your ip-up script the connection name. You could use the IP 1.157 +number of the far side of the ppp link, but this is a pain and may 1.158 +change each time. But you can give it an additional argument via pppd 1.159 +with ipparam. Somewhere in your dial up script you have a line similar 1.160 +to:</p> 1.161 + 1.162 +<pre> 1.163 +/usr/sbin/pppd /dev/ttyS1 connect "/usr/sbin/chat -t 90 -f 1.164 +${CHATFILE}" -d -d -d user user@somewhere file ${OPTIONS} 1.165 +</pre> 1.166 + 1.167 +<p>Just add 'ipparam FastNet' in the command line for pppd if your ISP 1.168 +has the name FastNet. The ip-up script will then get 'FastNet' as a 1.169 +sixth parameter. In your ip-up script you can then call masqmail with</p> 1.170 + 1.171 +<pre> 1.172 +/usr/sbin/masqmail -qo $6 1.173 +</pre> 1.174 + 1.175 +<p>instead of 'sendmail -q', if you had that in the script 1.176 +before. Masqmail will then read the route configuration specified for 1.177 +the connection name 'FastNet' and deliver the mail destined to the 1.178 +internet. See the <a href="config.html">configuration manual</a> on how 1.179 +to write a route configuration or use one of the examples as a 1.180 +template. <em>I do not know how do configure that for an ISDN adapter, 1.181 +but I am sure you will find something similar in the man 1.182 +pages.</em></p> 1.183 + 1.184 +<p>If you want mail that is received by masqmail from your local 1.185 +net to be delivered immediately using the route configuration, you 1.186 +have two possibilities:<p> 1.187 + 1.188 +<p> 1.189 +<ul> 1.190 + 1.191 +<li>if you are using the masqdialer system, you just have to set the 1.192 +variables <b>online_detect</b> to <i>mserver</i> and 1.193 +<b>mserver_iface</b> to the interface mserver is listening to.</li> 1.194 + 1.195 +<li>otherwise you have to add two commands in your ip-up script:<br> 1.196 +echo -n $6 > /tmp/connect_route<br> chmod 644 /tmp/connect_route<br> 1.197 +and you have to remove the file <i>/tmp/connect_route</i> in your 1.198 +ip-down script:<br> rm /tmp/connect_route.<br> Then you have to set 1.199 +<b>online_detect</b> to <i>file</i> and <b>online_file</b> to 1.200 +<i>/tmp/connect_route</i>. </li> 1.201 + 1.202 +</ul> 1.203 +</p> 1.204 + 1.205 +<p>See the route documentation for more.</p> 1.206 + </td></tr> 1.207 + 1.208 + <tr><td> 1.209 + <p> 1.210 + <hr> 1.211 + <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address> 1.212 + Last modified: Tue May 30 15:19:56 CEST 2000 1.213 + <br> 1.214 + This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6 1.215 + </p> 1.216 + 1.217 + </table> 1.218 + </center> 1.219 + 1.220 + </BODY> 1.221 +</HEAD> 1.222 +