1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>Compiling Apache for Microsoft Windows</title>
</head>
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
<body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
vlink="#000080" alink="#FF0000">
<!--#include virtual="header.html" -->
<h1 align="CENTER">Compiling Apache for Microsoft Windows</h1>
<p>There are many important points before you begin compiling
Apache. See <a href="windows.html">Using Apache with Microsoft
Windows</a> before you begin.</p>
<p>Compiling Apache requires Microsoft Visual C++ 5.0 or 6.0 to
be properly installed. It can be built with command-line tools,
or within the Visual Studio environment. Consult the VC++
manual to determine how to install them. Be especially aware
that the vcvars32.bat file from the Program
Files/DevStudio/VC/bin folder, and the setenv.bat file from the
Platform SDK, may be required to prepare the command-line tools
for command-line builds (e.g. using nmake). To install apache
with the Makefile.win or the InstallBin project in the Visual
Studio IDE, the awk utility is also required. If you use Visual
Studio 7.0 (.net), loading Apache.dsw converts it to .msproj
format. When changes are made to the project (.dsp) files, you
must reconvert Apache.dsw all over again.</p>
<p>First, you should install awk.exe where it can be found in
the path and the DevStudio environment, if you plan to use the
IDE. There are many versions of awk available for Windows; the
easiest to install is available from Brian Kernighan's <a
href="http://cm.bell-labs.com/cm/cs/who/bwk/">http://cm.bell-labs.com/cm/cs/who/bwk/</a>
site. When downloading <a
href="http://cm.bell-labs.com/cm/cs/who/bwk/awk95.exe">http://cm.bell-labs.com/cm/cs/who/bwk/awk95.exe</a>
from this site, you must save it with the name awk.exe rather
than awk95.exe.</p>
<p>Note that Developer Studio IDE will only find awk.exe from
the <u>T</u>ools menu <u>O</u>ptions... Directories tab
(the Projects - VC++ Directories pane in Developer Studio 7.0)
listing Executable file paths. Add the path for awk.exe to this
list, and your system PATH environment variable, as needed.</p>
<p>Then unpack the Apache distribution into an appropriate
directory. Open a command-line prompt, and change to the
<code>src</code> subdirectory of the Apache distribution.</p>
<p>The master Apache makefile instructions are contained in the
<code>Makefile.win</code> file. To compile Apache on Windows
NT, simply use one of the following commands:</p>
<ul>
<li><code>nmake /f Makefile.win _apacher</code> (release
build)</li>
<li><code>nmake /f Makefile.win _apached</code> (debug
build)</li>
</ul>
<p>These will both compile Apache. The latter will include
debugging information in the resulting files, making it easier
to find bugs and track down problems.</p>
<p>If you get an error such as "the name specified is not
recognized..." then you need to run vcvars32.bat first. Enter
the following command;</p>
<pre>
"c:\Program Files\DevStudio\VC\Bin\VCVARS32.BAT"
</pre>
<p>(you will need to adjust this command so it matches the
directory where your VC was installed.)</p>
<p>If you are a Visual C++ 5.0 user, and have installed a
recent Platform SDK, you may also need to enter the following
command (adjusted for the install directory of the Platform SDK
update);</p>
<pre>
"c:\Program Files\Platform SDK\SETENV.BAT"
</pre>
<p>Then try the nmake command again.</p>
<p><strong>Note</strong> that the Windows Platform SDK update
is required to enable all supported mod_isapi features. The SDK
files distributed with Microsoft Visual C++ 5.0 are out of
date. Without a recent update, Apache will issue warnings under
MSVC++ 5.0 that some mod_isapi features will be disabled. Look
for the update at <a
href="http://msdn.microsoft.com/platformsdk/">
http://msdn.microsoft.com/platformsdk/</a>.</p>
<p>Apache can also be compiled using VC++'s Visual Studio
development environment. To simplify this process, a Visual
Studio workspace, Apache.dsw, is provided in the
<code>src</code> folder. This workspace exposes the entire list
of working .dsp projects that are required for the complete
Apache binary release. It includes dependencies between the
projects to assure that they are built in the appropriate
order. InstallBin is the top-level project that will build all
other projects, and install the compiled files into their
proper locations.</p>
<p>These .dsp project files are distributed in Visual C++ 6.0
format. Visual C++ 5.0 (97) will recognize them with the single
exception of the /ZI flag, which corresponds to the VC 5.0 /Zi
flag for debugging symbols. To quickly prepare the .dsp files
for the Visual Studio 5.0 (97), you can use the perl scripts
distributed in the <code>src\helpers</code> folder:</p>
<pre>
cd src\helpers
cvstodsp5.pl
</pre>
<p>This command assumes you have a Perl interpreter installed
and registered for files of type .pl. The list of converted
.dsp project files will be displayed as they are converted. If
you contribute back a patch that offers revised project files,
please convert them back with the script dsp5tocvs.pl, which
puts the projects back to Visual Studio 6.0 format.</p>
<p>The core .dsp projects built by Apache.dsw and makefile.win
are:</p>
<ul>
<li><code>os\win32\ApacheOS.dsp</code></li>
<li><code>os\win32\Win9xConHook.dsp</code></li>
<li><code>regex\regex.dsp</code></li>
<li><code>ap\ap.dsp</code></li>
<li><code>lib\expat-lite\xmltok.dsp</code></li>
<li><code>lib\expat-lite\xmlparse.dsp <em>requires
xmltok</em></code></li>
<li><code>lib\sdbm.dsp</code></li>
<li><code>main\gen_uri_delims.dsp</code></li>
<li><code>main\gen_test_char.dsp</code></li>
<li><code>ApacheCore.dsp <em>requires all of the
above</em></code></li>
<li><code>Apache.dsp <em>requires ApacheCore</em></code></li>
</ul>
<p>In addition, the <code>os\win32</code> subdirectory contains
project files for the optional modules, all of which require
ApacheCore.</p>
<ul>
<li><code>os\win32\mod_auth_anon.dsp</code></li>
<li><code>os\win32\mod_auth_dbm.dsp <em>also requires
sdbm</em></code></li>
<li><code>os\win32\mod_auth_digest.dsp</code></li>
<li><code>os\win32\mod_cern_meta.dsp</code></li>
<li><code>os\win32\mod_digest.dsp</code></li>
<li><code>os\win32\mod_expires.dsp</code></li>
<li><code>os\win32\mod_headers.dsp</code></li>
<li><code>os\win32\mod_info.dsp</code></li>
<li><code>os\win32\mod_mime_magic.dsp</code></li>
<li><code>os\win32\mod_proxy.dsp</code></li>
<li><code>os\win32\mod_rewrite.dsp</code></li>
<li><code>os\win32\mod_speling.dsp</code></li>
<li><code>os\win32\mod_status.dsp</code></li>
<li><code>os\win32\mod_unique_id.dsp</code></li>
<li><code>os\win32\mod_usertrack.dsp</code></li>
<li><code>os\win32\mod_vhost_alias.dsp</code></li>
</ul>
<p>The <code>support\</code> folder contains project files for
additional programs that are not part of the Apache runtime,
but are used by the administrator to maintain password and log
files.</p>
<ul>
<li><code>support\htdigest.dsp</code></li>
<li><code>support\htpasswd.dsp</code></li>
<li><code>support\logresolve.dsp</code></li>
<li><code>support\rotatelogs.dsp</code></li>
</ul>
<p>Once Apache has been compiled, it needs to be installed in
its server root directory. The default is the
<code>\Apache</code> directory, on the current hard drive.</p>
<p>To install the files into the <code>c:\ServerRoot</code>
directory automatically, use one of the following nmake commands
(see above):</p>
<ul>
<li><code>nmake /f Makefile.win installr
INSTDIR=<em>c:\ServerRoot</em></code> (for release
build)</li>
<li><code>nmake /f Makefile.win installd
INSTDIR=<em>c:\ServerRoot</em></code> (for debug build)</li>
</ul>
<p>The <em>c:\ServerRoot</em> argument to INSTDIR gives the
installation directory (it can be omitted if Apache is to be
installed into <samp>\Apache</samp>).</p>
<p>This will install the following:</p>
<ul>
<li><code><em>c:\ServerRoot</em>\Apache.exe</code> - Apache
program</li>
<li><code><em>c:\ServerRoot</em>\ApacheCore.dll</code> -
Apache runtime [shared library]</li>
<li><code><em>c:\ServerRoot</em>\Win9xConHook.dll</code> -
Win9x console fixups [shared library]</li>
<li><code><em>c:\ServerRoot</em>\xmlparse.dll</code> - XML
parser [shared library]</li>
<li><code><em>c:\ServerRoot</em>\xmltok.dll</code> - XML
token engine [shared library]</li>
<li><code><em>c:\ServerRoot</em>\bin\*.exe</code> -
Administration programs</li>
<li><code><em>c:\ServerRoot</em>\cgi-bin</code> - Example CGI
scripts</li>
<li><code><em>c:\ServerRoot</em>\conf</code> - Configuration
files directory</li>
<li><code><em>c:\ServerRoot</em>\icons</code> - Icons for
FancyIndexing</li>
<li><code><em>c:\ServerRoot</em>\include\*.h</code> - Apache
header files</li>
<li><code><em>c:\ServerRoot</em>\htdocs</code> - Welcome
index.html pages</li>
<li><code><em>c:\ServerRoot</em>\htdocs\manual</code> -
Apache documentation</li>
<li><code><em>c:\ServerRoot</em>\lib</code> - Static library
files</li>
<li><code><em>c:\ServerRoot</em>\libexec</code> - Dynamic
link libraries</li>
<li><code><em>c:\ServerRoot</em>\logs</code> - Empty logging
directory</li>
<li><code><em>c:\ServerRoot</em>\modules\mod_*.dll</code> -
Loadable Apache modules</li>
</ul>
<p>If you do not have nmake, or wish to install in a different
directory, be sure to use a similar naming scheme.</p>
<p>To simplify the process, dependencies between all projects
are defined in the Microsoft Visual Studio workspace file:</p>
<pre>
src/Apache.dsw
</pre>
<p>This assures that lower-level sources are rebuilt from
within Visual Studio. The top level project is InstallBin,
which invokes Makefile.win to move the compiled executables and
dlls. You may personalize the INSTDIR= setting by changing the
Settings for InstallBin, Build command line entry under the
General tab. The default from within the InstallBin.dsp project
is one level up (..) from the src tree. Modify the InstallBin
settings and edit the INSTDIR=.. entry to the desired target
directory.</p>
<!--#include virtual="footer.html" -->
</body>
</html>
|
