Mercurial > hg > nginx-site

comparison xml/en/docs/howto_build_on_win32.xml @ 113:f9fe7330f8e8

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Win32 build instructions added
author Sergey Budnevitch <sb@waeme.net>
date Thu, 20 Oct 2011 13:57:37 +0000
parents
children b66954a49f29
comparison
equal deleted inserted replaced
112:d3e240f7157c 113:f9fe7330f8e8
1 <?xml version="1.0"?>
2
3 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
4
5 <article title="How to build nginx on the Win32 Platform with Visual C"
6 link="/en/docs/howto_build_on_win32.html"
7 lang="en">
8
9 <section title="Prerequisites">
10
11 <para>
12 To build nginx on the Win32 platform you need:
13
14 <list>
15
16 <item>
17 Visuial C compiler. Visual Studio 8 and 10 are known to work.
18 </item>
19
20 <item>
21 <link url="http://www.mingw.org/wiki/MSYS">MSYS</link>.
22 </item>
23
24 <item>
25 Perl, if you want to build openssl and nginx with ssl support.
26 For example <link url="http://www.activestate.com/activeperl">ActivePerl</link>
27 or <link url="http://strawberryperl.com">Strawberry Perl</link>.
28 </item>
29
30 <item>
31 Subversion client. Choose any from <link url="http://subversion.apache.org/packages.html#windows">list</link>
32 </item>
33
34 <item>
35 <link url="http://www.pcre.org">PCRE</link>, <link url="http://zlib.net">zlib</link>
36 and <link url="http://www.openssl.org">openssl</link> libraries sources.
37 </item>
38 </list>
39
40 </para>
41
42 </section>
43
44 <section name="build_steps"
45 title="Build steps">
46
47 <para>
48 Ensure that paths to Perl, Subversion and MSYS bin directories are added to
49 PATH environment variable before you start build. To set Visual C environment
50 run vcvarsall.bat script from Visual C directory.
51 </para>
52
53 <para>
54
55 To build nginx:
56 <list>
57
58 <item>
59 Start MSYS bash
60 </item>
61
62 <item>
63 Check out nginx sources from the svn.nginx.org repository. For example:
64 <programlisting>
65 svn co svn://svn.nginx.org/tags/release-1.1.6
66 </programlisting>
67 </item>
68
69 <item>
70 Create build directory and lib directory, and unpack zlib, PCRE and openssl libraries
71 sources into lib directory:
72 <programlisting>
73 mkdir objs
74 mkdir objs/lib
75 cd objs/lib
76 unzip ../../pcre-8.12.zip
77 tar -xzf ../../zlib-1.2.5.tar.gz
78 tar -xzf ../../openssl-1.0.0e.tar.gz
79 </programlisting>
80 </item>
81
82 <item>
83 Run configure script:
84 <programlisting>
85 auto/configure --with-cc=cl --builddir=objs --prefix= --conf-path=conf/nginx.conf \
86 --pid-path=logs/nginx.pid --http-log-path=logs/access.log --error-log-path=logs/error.log \
87 --sbin-path=nginx.exe --http-client-body-temp-path=temp/client_body_temp \
88 --http-proxy-temp-path=temp/proxy_temp --http-fastcgi-temp-path=temp/fastcgi_temp \
89 --with-cc-opt=-DFD_SETSIZE=1024 --with-pcre=objs/lib/pcre-8.12 \
90 --with-zlib=objs/lib/zlib-1.2.5 --withopenssl=objs/lib/openssl-1.0.0e \
91 --with-select_module --with-http_ssl_module --with-ipv6
92 </programlisting>
93 </item>
94
95 <item>
96 Run make:
97 <programlisting>
98 nmake -f objs/Makefile
99 </programlisting>
100 </item>
101
102
103 </list>
104
105 </para>
106
107 </section>
108
109 <section name="see_also"
110 title="See also">
111
112 <para>
113 <list>
114
115 <item>
116 <a href="/en/docs/windows.xml"/>
117 </item>
118
119 </list>
120 </para>
121
122 </section>
123 </article>