76 lines
3.4 KiB
Plaintext
76 lines
3.4 KiB
Plaintext
E-MailRelay Windows
|
|
===================
|
|
|
|
Setup program
|
|
-------------
|
|
Installing E-MailRelay on Windows should be straightforward if you have
|
|
self-extracting archive program "emailrelay-setup.exe". Make sure that the
|
|
setup program is in a writeable directory with plenty of space on the disk
|
|
because when you run it it will extract an installation GUI program plus
|
|
dependent DLLs in into the same directory.
|
|
|
|
The installation GUI program will take you through the installation options and
|
|
then install the run-time files into your chosen directory.
|
|
|
|
Manual installation
|
|
-------------------
|
|
In summary, the manual installation process for Windows for when you do not have
|
|
the self-extracting setup program, is as follows:
|
|
* Create a new program directory "Program Files\emailrelay"
|
|
* Unzip into "Program Files\emailrelay"
|
|
* Create a new spool directory "<windir>\spool\emailrelay"
|
|
* Create a new text file, eg. "c:\emailrelay.auth", to contain account details
|
|
* Add your ISP account details to "emailrelay.auth" with a line like "login client myaccount mypassword"
|
|
* Drag "emailrelay.exe" onto the desktop to create a shortcut for the server.
|
|
* Drag again to create a shortcut for the forwarding client.
|
|
* Add "--as-server --verbose" to the server shortcut properties.
|
|
* Add "--as-client myisp.net:smtp --hidden --client-auth c:/emailrelay.auth" to the client shortcut.
|
|
|
|
Move shortcuts to "Startup" folders as necessary.
|
|
|
|
Running as a service
|
|
--------------------
|
|
To manually install E-MailRelay as a service so that it starts up automatically
|
|
at boot-time you must first create a one-line batch file called
|
|
"emailrelay-start.bat" in the main E-MailRelay directory containing
|
|
the full E-MailRelay server command-line. Then run "emailrelay-service --install"
|
|
to install the service.
|
|
|
|
When the E-MailRelay server is run in this way it has the "--no-daemon" and
|
|
"--hidden" switches added so that there is no user interface. (The "--no-daemon"
|
|
switch on Windows changes the interface from using the system-tray to using a
|
|
normal window, and the "--hidden" switch suppresses the window and any message
|
|
boxes.)
|
|
|
|
Note that the batch file and the main E-MailRelay executable must be in the same
|
|
directory and that the batch file is only read at install time; if you need to
|
|
change the command-line switches for the service you must edit the service
|
|
properties.
|
|
|
|
Diagnostics
|
|
-----------
|
|
E-MailRelay normally writes errors and warnings into the system event log, which
|
|
you can view by running "eventvwr.exe". You can increase the verbosity by adding
|
|
the "--verbose" switch to the E-MailRelay command-line.
|
|
|
|
The E-MailRelay server also logs to the standard error stream but the
|
|
"--as-server" and "--as-proxy" switches implicitly incorporate "--close-stderr"
|
|
so with these switches the standard error logging will stop soon after startup.
|
|
To get continuous logging you should replace "--as-server" with "--log" and
|
|
"--as-proxy" with "--immediate --forward-to". Then you will be able to redirect
|
|
the standard error stream to a log file.
|
|
|
|
Building from source
|
|
--------------------
|
|
E-MailRelay can be compiled using Microsoft Visual Studio C++ (MSVC) 6 or MinGW,
|
|
although the installation/configuration GUI can only be built with MinGW because
|
|
of its dependence on Qt.
|
|
|
|
There is a Visual Studio workspace file for MSVC 6 in the "src" directory. For
|
|
MinGW please follow the guidelines in "mingw-common.mak" which is also in the
|
|
"src" directory.
|
|
|
|
|
|
|
|
Copyright (C) 2001-2007 Graeme Walker <graeme_walker@users.sourceforge.net>. All rights reserved.
|