Topic: Apache 2.2.9 command line build with the Windows 2008 SDK

[tdonovan]

The latest Windows SDK, Windows SDK for Windows Server 2008 and .NET Framework 3.5, contains a command-line compiler suitable for building Apache 2.2.9 on Windows XP or later.

Despite the '2008' name - this freely available SDK is appropriate to use on Windows Server 2003, Windows Server 2008, Windows Vista, and Windows XP.

This SDK contains the Visual C++ 2008 command-line compiler (a.k.a. VC9), the MASM assembler, and the Windows libraries needed to build Apache.

If you will be frequently building or debugging Apache, you might consider using the full Visual Studio 2008 IDE rather than using these command-line tools.

Here are the steps to build Apache 2.2.9 with OpenSSL 0.9.8h and Zlib 1.2.3 using the VC9 command-line compiler in this SDK:

TOOLS NEEDED TO BUILD

Install the Windows SDK for Windows Server 2008 and .NET Framework 3.5 (approx: 450mb)
from: http://www.microsoft.com/downloads/details.aspx?FamilyId=F26B1AA4-741A-433A-9BE5-FA919850BDBF

Install Perl and several GNU utilities: tar, gzip, wget, and awk. These are tools which are needed to build Apache:
http://www.activestate.com/store/download.aspx?prdGUID=81fbce82-6bd5-49bc-a915-08d58c2648ca
http://gnuwin32.sourceforge.net/packages/gtar.htm
http://gnuwin32.sourceforge.net/packages/gzip.htm
http://gnuwin32.sourceforge.net/packages/wget.htm
http://gnuwin32.sourceforge.net/packages/gawk.htm

SETUP THE BUILD ENVIRONMENT

Open a command window and set up the development environment:

Code:

"C:\Program Files\Microsoft Visual Studio 9.0\VC\bin\vcvars32.bat"

Add Perl and the GNU utilities to your PATH environment variable:

Code:

PATH=%PATH%;C:\Program Files\GnuWin32\bin;C:\Perl\bin

DOWNLOAD THE SOURCE CODE

Download and extract the Apache version 2.2.9 Windows source (not the Unix source):

Code:

WGET http://www.apache.org/dist/httpd/httpd-2.2.9-win32-src.zip


Open httpd-2.2.9-win32-src.zip and extract it, creating a httpd-2.2.9 directory

Download and extract the Zlib version 1.2.3 source into httpd-2.2.9\srclib\zlib:

Code:

CD   httpd-2.2.9\srclib WGET http://www.zlib.net/zlib-1.2.3.tar.gz GZIP -d  zlib-1.2.3.tar.gz TAR  xf  zlib-1.2.3.tar RENAME   zlib-1.2.3   zlib


Download and extract the OpenSSL version 0.9.8h source, into httpd-2.2.9\srclib\openssl:

Code:

CD   httpd-2.2.9\srclib WGET http://www.openssl.org/source/openssl-0.9.8h.tar.gz GZIP -d  openssl-0.9.8h.tar.gz TAR  xf  openssl-0.9.8h.tar RENAME   openssl-0.9.8h   openssl

BUILD Zlib

Code:

CD  httpd-2.2.9\srclib\zlib ML /coff /Zi /c contrib\masm686\match.asm NMAKE -f win32\Makefile.msc  LOC="-D_CRT_SECURE_NO_DEPRECATE /wd4996 -DASMV" OBJA="match.obj" MT -manifest zlib1.dll.manifest -outputresource:zlib1.dll;2

BUILD OpenSSL

Quote:

For OpenSSL version 0.9.8h ONLY Edit the file httpd-2.2.9\srclib\openssl\crypto\perlasm\x86ms.pl and remove line 273. Line 273 contains the single word "$extra". This is a known problem with OpenSSL 0.9.8h, and should be fixed in future versions. ref: OpenSSL bug 1681, described here and here

Code:

CD  httpd-2.2.9\srclib\openssl PERL Configure VC-WIN32  enable-camellia  disable-idea ms\do_masm NMAKE -f ms\ntdll.mak

BUILD and INSTALL Apache

Code:

CD  httpd-2.2.9 NMAKE -f Makefile.win installr

This installs Apache 2.2.9 into C:\Apache22

APACHE SSL

You can create a self-signed certificate for testing SSL using this OpenSSL command:

Code:

CD  C:\Apache22\bin OPENSSL.exe req -new -x509 -nodes -extensions v3_req -days 365 -config ..\conf\openssl.cnf -out ..\conf\server.crt -keyout ..\conf\server.key

Be sure to edit C:\Apache22\conf\extra\httpd-ssl.conf and set ServerName to the same name that you entered at the prompt "Common Name (eg, YOUR name) []:". This should be your system name as you will use it in a URL like https://system_name/

TRIMMING APACHE FOR PRODUCTION USE

As installed, C:\Apache22 is approximately 86mb.
* The .pdb files are used for debugging and DrWatson stack traces. You can remove them saving over 60mb.
* The \include and \lib directories are only needed to compile and link additional modules. You can remove them saving about 7mb.
* The \manual directory is only used if httpd.conf includes conf/extra/httpd-manual.conf. You can remove it saving about 9mb.
These steps will reduce the size of C:\Apache22 to approximately 8mb.

If you copy Apache to another machine, remember to install the "Microsoft Visual C++ 2008 Redistributable Package" before running it.

DEBUGGING APACHE

If you need to run Apache under a debugger to diagnose a problem, you can use the freely available Windows WinDbg debugger.

Install "Debugging Tools for Windows" from the [Start] menu: [Microsoft Windows SDK] [Install Debugging Tools for Windows]
-or- Download it from: http://www.microsoft.com/whdc/devtools/debugging/installx86.Mspx and install it.

Create and install an Apache DEBUG build instead of a RELEASE build with:

Code:

CD  httpd-2.2.9 NMAKE -f Makefile.win installd


Start the debugger "C:\Program Files\Debugging Tools for Windows (x86)\WINDBG.exe"

Quote:

[File] [Symbol File Path ...] SRV*C:\WINDOWS\symbols*http://msdl.microsoft.com/download/symbols [File] [Open Executable] C:\Apache22\bin\httpd.exe Arguments: -X Start directory: C:\Apache22\bin [File] [Open Source File] Choose any Apache .c source file that you want to debug [View] [Locals] [View] [Call stack] [Window] [Dock All] Re-arrange the windows as convenient Use F9 to set breakpoints Use F5 to Start Apache, or to Resume execution of Apache after a breakpoint Use F10 to step through lines of code after hitting a breakpoint

When you get the error:"Debug Assertion Failed!" - "Invalid file descriptor. File possibly closed by a different thread." - choose [Ignore].
This is a harmless error which only occurs in Debug builds.

Hope this is helpful. I submitted a shorter version to the httpd wiki.

-tom-

[Mitron]

Awesome Tom,

That works well. In fact, I got a litle bored so I sat down and turned this into a batch file that kind of automates the process and updates the apr, apr-iconv and apr-util as well.

I haven't quite figured out the pcre compile part yet, but I left a spot for it to add later. I'd also like to figure out how to add mod_log_rotate to this as the apxs solution on the authors site doesn't seem to work. The apxs command he has posted produces 26 error LNK2019 messages and falls short of creating the needed .so file. I suspect this might be due to the Math::BigInt: error that pops up when apxs is compiled.

In any case this is a huge time saver for me so I thought I'd share.

TO USE:

Follow Tom's "TOOLS NEEDED TO BUILD" above and also install the http://gnuwin32.sourceforge.net/packages/unzip.htm in order to unzip the sources via this batch file.

Create a work folder at the root of a secondary partition, second drive or C:\ if nothing else is available. For this example we will assume this to be C:\work

Copy and paste the code below into Notepad or Notepad++ and save it as C:\work\gui_apache.bat

Edit lines 5 and 6 to replace with your actual paths to GnuWin32 and Perl bin folders as well as the location where you want Apache installed on line 11, then save the file.

OPTIONAL: If version or revision numbers are updated for httpd, apr, openssl, etc. lines 15-30 can be modified to reflect those changes.

OPTIONAL: If you want to customize Apache at build time edit line 124 to change ports, domain name, etc.

OPTIONAL: If you want to create a SSL certificate after the build process, remove the @REM at the begining of lines 127 and 128.

Open a Visual Studio command prompt and change to your work folder, i.e. CD C:\work then execute the batch file gui_apache.bat

Once the files are retrieved and decompressed the script will pause allowing you to edit x86ms.pl to remove line 273 and save the file before continuing the process. Leave the script at the pause and open My Computer or Windows Explorer to browse to the correct location and make your changes.

Once changes are made and files are saved, return to the command prompt and hit a key to continue building and installing Apache.

If the @REM was removed from lines 127 and 128 prompts will appear asking for certificate information. Follow the prompts to create your SSL certificate and your done. Now edit httpd.conf to enable modules and complete your configuration.

[tdonovan]

The ODBC driver is always built on Windows. No DBD_LIST is needed to get ODBC.

To build the other drivers, you must (of course) have the appropriate database installed on your system, and also add a few extra items to your semicolon-separated INCLUDE and LIB environment variables before you build Apache:

* for MySQL
find the directory which contains mysql.h and add it to your INCLUDE variable,
e.g. SET INCLUDE=%INCLUDE%;C:\Mysql\include
find the directory which contains libmysql.lib and add it to you LIB variable,
e.g. SET LIB=%LIB%;C:\Mysql\lib\opt
add "mysql" to the space-separated DBD_LIST

* for PostgreSQL
find the directory which contains libpq-fe.h and add it to your INCLUDE variable,
e.g. SET INCLUDE=%INCLUDE%;C:\Program Files\PostgreSQL\8.3\include
find the directory which contains libpq.lib and add it to you LIB variable,
e.g. SET LIB=%LIB%;C:\Program Files\PostgreSQL\8.3\lib
add "pgsql" to the space-separated DBD_LIST

* for SQLite3
find the directory which contains sqlite3.h and add it to your INCLUDE variable,
e.g. SET INCLUDE=%INCLUDE%;C:\SQLite
find the directory which contains sqlite3.lib and add it to you LIB variable,
e.g. SET LIB=%LIB%;C:\SQLite
add "sqlite3" to the space-separated DBD_LIST

* for Oracle
find the directory which contains oci.h and add it to your INCLUDE variable,
e.g. SET INCLUDE=%INCLUDE%;C:\oraclexe\app\oracle\product\10.2.0\server\OCI\include
find the directory which contains oci.lib and add it to you LIB variable,
e.g. SET LIB=%LIB%;C:\oraclexe\app\oracle\product\10.2.0\server\OCI\lib\MSVC
add "oracle" to the space-separated DBD_LIST

When you configure httpd.conf, remember to load the runtime .dll for your database (using forward slashes) before the DBDriver directive:

* for MySQL
LoadFile "C:/Mysql/lib/opt/libmysql.dll"
DBDriver mysql

* for PostgreSQL
LoadFile "C:/Program Files/PostgreSQL/8.3/bin/libpq.dll"
DBDriver pgsql

* for SQLite3
LoadFile "C:/SQLite/sqlite3.dll"
DBDriver sqlite3

* for Oracle
LoadFile "C:/oraclexe/app/oracle/product/10.2.0/server/BIN/oci.dll"
DBDriver oracle

The FreeTDS (a Unix ODBC replacement for SQLServer) and SQLite2 (an old version of SQLite) drivers really don't make much sense on Windows.

-tom-

[tdonovan]

mod_log_rotate builds fine for me using apxs from the Apache Lounge download page:

[Mitron]