hMailServer

hMailServer is an open source email server for Microsoft Windows.

This page describes how to compile and run hMailServer in debug.

For other information about hMailServer, please go to http://www.hmailserver.com

Building hMailServer

Branches

The master branch contains the latest development version of hMailServer. This version is typically not yet released for production usage. If you want to add new features to hMailServer, use this branch.
The x.y.z (for exampel 5.6.2) contains the code for the version with the same name as the branch. For example, branch 5.6.1 contains hMailServer version 5.6.1. These branches are typically only used for bugfixes or minor features.

Environment set up

Required software:

An installed version of hMailServer 5.7 (configured with a database)
Visual Studio 2013 Update 3
InnoSetup (to build installation program)
Perl ActiveState ActivePerl Community Edition 32 bit works fine

NOTE

You should not be compiling hMailServer on a computer which already runs a production version of hMailServer. When compiling hMailServer, the compilation will stop any already running version of hMailServer, and will register the compiled version as the hMailServer version on the machine (configuring the Windows service). This means that if you are running a production version of hMailServer on the machine, this version will stop running if you compile hMailServer. If this happens, the easiest path is to reinstall the production version.

Configuring Visual Studio 2013 Express Edition

These steps are only required if you are using Visual Studio 2013 Express Edition. The steps are required because Express Edition does not include Active Template Library which hMailServer relies on. ATL therefore needs to be installed separately:

Download the (Windows Driver Kit 7.1 ISO)(http://www.microsoft.com/download/en/details.aspx?id=11800)
Mount the ISO and run the installation. You only need to install "Build Environments"
Open the solution hmailserver\source\Server\hMailServer\hMailServer.sln
In the Solution Explorer, right click on hMailServer and select Properties
Select Configuraton Properties -> VC++ Directories
Add "{PATH-TO-WDK}\inc\atl71;" to the list of Include Directories. (Replace {PATH-TO-WDK} with the location whre you installed it.
Add "{PATH-TO-WDK\lib\ATL\i386" to the list of Library Directories. (Replace {PATH-TO-WDK} with the location whre you installed it.

3rd party libraries

Some 3rd party libraries which hMailServer relies on are large and updated frequently. Rather than including these large libraries into the hMailServer git repository, they have to be downloaded and built, currently manually. When you build hMailServer, Visual Studio will use a system environment variable, named hMailServerLibs, to locate these libraries.

Create an environment variable named hMailServerLibs pointing at a folder where you will store hMailServer libraries, such as C:\Dev\hMailLibs.

Building OpenSSL

Download OpenSSL 1.0.1t from https://www.openssl.org/source/openssl-1.0.1t.tar.gz and put it into %hMailServerLibs%<OpenSSL-Version>.
You should now have a folder named %hMailServerLibs%<OpenSSL-version>, for example C:\Dev\hMailLibs\openssl-1.0.1t
Start a VS2013 x86 Native Tools Command Prompt
Change dir to %hMailServerLibs%<OpenSSL-version>.
Run Perl Configure no-asm VC-WIN32
Run ms\do_ms
Run nmake -f ms\ntdll.mak
Rename the folder out32dll to out32
Remove the tmp32dll folder
Exit the command prompt
Start a VS2013 x64 Native Tools Command Prompt
Change dir to %hMailServerLibs%<OpenSSL-version>
Run Perl Configure no-asm VC-WIN64A
Run ms\do_win64a
Run nmake -f ms\ntdll.mak
Rename the folder out32dll to out64
Delete the tmp32 folder

The folder out32 now contains the 32-bit version of OpenSSL, and out64 contains the 64bit version

Building Boost

Download Boost 1.57.0 from http://www.boost.org/ and put it into %hMailServerLibs%<Boost-Version>.
You should now have a folder named %hMailServerLibs%<Boost-Version>, for example C:\Dev\hMailLibs\boost_1_57_0
Open a Command prompt
Change dir to %hMailServerLibs%<Boost-Version>.
Run bootstrap.bat
Run bjam.exe --toolset=msvc-12.0 --build-type=complete
Rename %hMailServerLibs%<Boost-Version>\stage\lib to lib32
Run bjam.exe --clean
Remove the bin.v2 folder
Run bjam.exe --toolset=msvc-12.0 --build-type=complete address-model=64
Rename %hMailServerLibs%<Boost-Version>\stage\lib to lib64

Building hMailServer

Visual Studio 2013 must be started with Run as Administrator.

Download the source code from this Git repository.
Compile the solution hmailserver\source\Server\hMailServer\hMailServer.sln. This will build the hMailServer server-part (hMailServer.exe)
Compile the solution hmailserver\source\Tools\hMailServer Tools.sln. This will build hMailServer related tools, such as hMailServer Administrator and hMailServer DB Setup.
Compile hmailserver\installation\hMailServer.iss (using InnoSetup) This will build the hMailServer installation program.

Running in Debug

If you want to run hMailServer in debug mode in Visual Studio, add the command argument /debug. You find this setting in the Project properties, under Configuration Properties -> Debugging.

Releasing hMailServer

Without finding any serious issues:

Run all integration tests on supported versions of Windows and the different supported databases.
Run all server stress tests
Enable Gflags (gflags /p /enable hmailserver.exe) and run all integration tests to check for memory issues
Run for at least 1 week in production for hMailServer.com
Wait for at least 500 downloads of the beta version

M0ns1gn0r/hmailserver

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages