206 lines
11 KiB
HTML
206 lines
11 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<html>
|
|
<head>
|
|
<title>E-MailRelay Windows</title>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
|
<link rel="stylesheet" href="emailrelay.css" type="text/css">
|
|
</head>
|
|
<body>
|
|
<!-- index:0::::E-MailRelay Windows -->
|
|
<div class="div-main">
|
|
<h1><a class="a-header" name="H_1">E-MailRelay Windows</a></h1> <!-- index:1:H:1::E-MailRelay Windows -->
|
|
<h2><a class="a-header" name="SH_1_1">Setup program</a></h2> <!-- index:2:SH:1:1:Setup program -->
|
|
<p>
|
|
Installing E-MailRelay on Windows should be straightforward if you have the
|
|
setup program <em class="quote">emailrelay-setup.exe</em> and its associated <em class="quote">payload</em> files.
|
|
</p>
|
|
|
|
<p>
|
|
Run <em class="quote">emailrelay-setup.exe</em> as an administrator if you are going to be installing
|
|
into protected directories like <em class="quote">Program Files</em>.
|
|
</p>
|
|
|
|
<p>
|
|
The setup GUI will take you through the installation options and then install
|
|
the run-time files into your chosen locations.
|
|
</p>
|
|
|
|
<p>
|
|
If anything goes wrong with the installation process then you can still just
|
|
run the main E-MailRelay executable straight out of the distribution zip file.
|
|
Follow the <em class="quote">Manual installation</em> section below for more help.
|
|
</p>
|
|
<h2><a class="a-header" name="SH_1_2">Running the program</a></h2> <!-- index:2:SH:1:2:Running the program -->
|
|
<p>
|
|
After a successful installation you should see E-MailRelay listed in the Windows
|
|
Start Menu. This will run the <em class="quote">emailrelay-start.bat</em> batch file to start
|
|
the E-MailRelay server, and you should then see an icon appear in the Windows
|
|
system tray.
|
|
</p>
|
|
<h2><a class="a-header" name="SH_1_3">Configuration</a></h2> <!-- index:2:SH:1:3:Configuration -->
|
|
<p>
|
|
E-MailRelay is configured though command-line options like <em class="quote">--verbose</em> or
|
|
<em class="quote">--spool-dir=c:/temp</em> in the <em class="quote">emailrelay-startup.bat</em> batch file.
|
|
</p>
|
|
|
|
<p>
|
|
These options are all documented in the reference document, although there are
|
|
some Windows-specific variations:
|
|
</p>
|
|
<ul>
|
|
<li>The <em class="quote">--syslog</em> option refers to the Windows Event Viewer's Application log.</li>
|
|
<li>The <em class="quote">--no-daemon</em> option is used to disable the icon in the system tray.</li>
|
|
<li>The <em class="quote">--hidden</em> option with <em class="quote">--no-daemon</em> hides all windows and suppresses message boxes.</li>
|
|
</ul>
|
|
|
|
<p>
|
|
Account information can be configured by editing the E-MailRelay <em class="quote">secrets</em> file.
|
|
Look for the <em class="quote">--client-auth</em> or <em class="quote">--server-auth</em> options in the startup batch
|
|
file to find out where this is.
|
|
</p>
|
|
<h2><a class="a-header" name="SH_1_4">Manual installation</a></h2> <!-- index:2:SH:1:4:Manual installation -->
|
|
<p>
|
|
The manual installation process for when you do not have the self-extracting
|
|
setup program, goes something like this:
|
|
</p>
|
|
<ul>
|
|
<li>Create a new program directory <em class="quote">c:\Program Files\E-MailRelay</em></li>
|
|
<li>Copy the packaged files into <em class="quote">c:\Program Files\E-MailRelay</em></li>
|
|
<li>Create a new spool directory <em class="quote">c:\ProgramData\E-MailRelay\spool</em></li>
|
|
<li>Create a new text file, eg. <em class="quote">c:\ProgramData\E-MailRelay\emailrelay-auth.txt</em>, to contain account details</li>
|
|
<li>Add your account details to <em class="quote">emailrelay-auth.txt</em> with a line like <em class="quote">client plain myaccount mypassword</em></li>
|
|
<li>Right-drag <em class="quote">emailrelay.exe</em> onto the desktop to create a shortcut for the server.</li>
|
|
<li>Add <em class="quote">--as-server --verbose</em> to the server shortcut properties in the <em class="quote">target</em> box.</li>
|
|
<li>Right-drag again to create a shortcut to do the forwarding.</li>
|
|
<li>Add <em class="quote">--as-client example.com:smtp --client-auth c:\ProgramData\E-MailRelay\emailrelay-auth.txt</em> to the client shortcut.</li>
|
|
</ul>
|
|
|
|
<p>
|
|
Copy the shortcuts to <em class="quote">Start Menu</em> and <em class="quote">Startup</em> folders as necessary.
|
|
</p>
|
|
<h2><a class="a-header" name="SH_1_5">Running as a service</a></h2> <!-- index:2:SH:1:5:Running as a service -->
|
|
<p>
|
|
E-MailRelay can be set up as a service so that it starts up automatically at
|
|
boot-time. If you are setting this up manually you must first have a one-line
|
|
batch file called <em class="quote">emailrelay-start.bat</em> that contains all the command-line
|
|
options for running the E-MailRelay server, and you must have a simple
|
|
configuration file called <em class="quote">emailrelay-service.cfg</em> that points to it. The
|
|
configuration file must be in the same directory as the
|
|
<em class="quote">emailrelay-service.exe</em> executable.
|
|
</p>
|
|
|
|
<p>
|
|
The batch file should contain a single line, something like this:
|
|
</p>
|
|
|
|
<div class="div-pre">
|
|
<pre>start "emailrelay" "C:\Program Files\E-MailRelay\emailrelay.exe" --forward-to smtp.example.com:25 ...
|
|
</pre>
|
|
</div><!-- div-pre -->
|
|
<p>
|
|
There is no need to use <em class="quote">--no-daemon</em> and <em class="quote">--hidden</em>; these are added
|
|
automatically.
|
|
</p>
|
|
|
|
<p>
|
|
The contents of the configuration file can be a single line like this:
|
|
</p>
|
|
|
|
<div class="div-pre">
|
|
<pre>dir-config="C:\ProgramData\E-MailRelay"
|
|
</pre>
|
|
</div><!-- div-pre -->
|
|
<p>
|
|
Then just run <em class="quote">emailrelay-service --install</em> from an Administrator command
|
|
prompt to install the service.
|
|
</p>
|
|
|
|
<p>
|
|
Every time the service starts it reads the configuration file and the startup
|
|
batch file in order to run the E-MailRelelay program.
|
|
</p>
|
|
|
|
<p>
|
|
If you need to run multiple E-MailRelay services then put a unique service
|
|
name and display name on the <em class="quote">emailrelay-service --install <name> <display-name></em>
|
|
command-line. The service name you give is used to derive the name of the
|
|
<em class="quote"><name>-start.bat</em> batch file that contains the E-MailRelay server's
|
|
command-line options, so you will need to create that first.
|
|
</p>
|
|
<h2><a class="a-header" name="SH_1_6">Uninstall</a></h2> <!-- index:2:SH:1:6:Uninstall -->
|
|
<p>
|
|
To uninstall:
|
|
</p>
|
|
<ul>
|
|
<li>Stop the program and/or the service (<em class="quote">ControlPanel</em>-><em class="quote">SystemAndSecurity</em>-><em class="quote">AdministrativeTools</em>-><em class="quote">Services</em>).</li>
|
|
<li>Uninstall the service, if installed (<em class="quote">emailrelay-service --remove</em>).</li>
|
|
<li>Delete the files from the E-MailRelay <em class="quote">program files</em> folder (eg. <em class="quote">C:\Program Files\E-MailRelay</em>).</li>
|
|
<li>Delete the files from the E-MailRelay <em class="quote">program data</em> folder (eg. <em class="quote">C:\ProgramData\E-MailRelay</em>).</li>
|
|
<li>Delete any desktop shortcuts (eg. <em class="quote">%USERPROFILE%\Desktop\E-MailRelay.lnk</em>).</li>
|
|
<li>Delete any start menu shortcuts (eg. <em class="quote">%APPDATA%\Microsoft\Windows\Start Menu\Programs\E-MailRelay.lnk</em>).</li>
|
|
<li>Delete any auto-start shortcuts (eg. <em class="quote">%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\E-MailRelay.lnk</em>).</li>
|
|
<li>Clean up the registry under <em class="quote">HKLM\System\CurrentControlSet\Services\EventLog\Application\emailrelay</em>.</li>
|
|
</ul>
|
|
<h2><a class="a-header" name="SH_1_7">Diagnostics</a></h2> <!-- index:2:SH:1:7:Diagnostics -->
|
|
<p>
|
|
E-MailRelay normally writes errors and warnings into the Windows Event Log,
|
|
which you can view by running <em class="quote">eventvwr.exe</em> or going to
|
|
<em class="quote">ControlPanel</em>-><em class="quote">SystemAndSecurity</em>-><em class="quote">AdministrativeTools</em>-><em class="quote">EventViewer</em>; from
|
|
there look under <em class="quote">Windows Logs</em> and <em class="quote">Application</em>.
|
|
</p>
|
|
|
|
<p>
|
|
You can increase the verbosity of the logging by adding the <em class="quote">--verbose</em> option
|
|
to the E-MailRelay command-line, typically by editing the <em class="quote">emailrelay-start.bat</em>
|
|
batch script.
|
|
</p>
|
|
|
|
<p>
|
|
The Windows Event Log is a bit clunky, so consider using daily log files by
|
|
using the E-MailRelay <em class="quote">--log-file</em> option with the special <em class="quote">%d</em> date
|
|
placeholder. Then turn off the event-log logging with <em class="quote">--no-syslog</em>.
|
|
</p>
|
|
<h2><a class="a-header" name="SH_1_8">Testing with telnet</a></h2> <!-- index:2:SH:1:8:Testing with telnet -->
|
|
<p>
|
|
The <em class="quote">telnet</em> program can be used for testing an E-MailRelay server. You should
|
|
start by enabling the Windows telnet client using
|
|
<em class="quote">ControlPanel</em>-><em class="quote">Programs</em>-><em class="quote">TurnWindowsFeaturesOnAndOff</em>.
|
|
</p>
|
|
|
|
<p>
|
|
Then run telnet from a command prompt, using <em class="quote">localhost</em> and the E-MailRelay
|
|
port number as command-line parameters:
|
|
</p>
|
|
|
|
<div class="div-pre">
|
|
<pre>telnet localhost 25
|
|
</pre>
|
|
</div><!-- div-pre -->
|
|
<p>
|
|
This should show a greeting from the E-MailRelay server and then you can
|
|
start typing SMTP commands like <em class="quote">EHLO</em>, <em class="quote">MAIL FROM:<..></em>, <em class="quote">RCPT TO:<...></em>
|
|
and <em class="quote">DATA</em>.
|
|
</p>
|
|
<h2><a class="a-header" name="SH_1_9">Building from source</a></h2> <!-- index:2:SH:1:9:Building from source -->
|
|
<p>
|
|
E-MailRelay can be compiled on Windows using Microsoft Visual Studio C++ (MSVC)
|
|
or mingw-w64. For MSVC builds there is a perl script (<em class="quote">winbuild</em>) that creates
|
|
<em class="quote">cmake</em> files from the autotools makefiles, runs <em class="quote">cmake</em> to create the MSVC
|
|
project files and then runs <em class="quote">msbuild</em> to compile E-MailRelay. If perl, cmake,
|
|
MSVC, Qt and mbedTLS source are installed in the right way then the
|
|
<em class="quote">winbuild.bat</em> batch file should be able to do a complete MSVC release build
|
|
in one go.
|
|
</p>
|
|
|
|
|
|
|
|
<div class="div-footer">
|
|
<p>
|
|
Copyright (C) 2001-2018 Graeme Walker
|
|
</p>
|
|
</div><!-- div-footer -->
|
|
</div> <!-- div-main -->
|
|
</body>
|
|
</html>
|
|
<!-- Copyright (C) 2001-2018 Graeme Walker <graeme_walker@users.sourceforge.net>. All rights reserved. -->
|