Mercurial > hg > nginx-site
annotate xml/en/docs/windows.xml @ 491:5a3362234a4d
If text of the link given by URL is not provided, the URL is used.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Thu, 19 Apr 2012 12:44:09 +0000 |
parents | 6135f3c95bf6 |
children | 6330ca27a485 |
rev | line source |
---|---|
50 | 1 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd"> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
2 |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
3 <article name="nginx for Windows" |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
4 link="/en/docs/windows.html" |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
5 lang="en"> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
6 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
7 <section> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
8 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
9 <para> |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
10 Version of nginx for Windows uses the native Win32 API (not the Cygwin emulation |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
11 layer). |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
12 Only the <c-func>select</c-func> request processing method is currently used, |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
13 so high performance and scalability should not be expected. |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
14 Due to this and some other known issues version of nginx for Windows |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
15 is considered to be a <i>beta</i> version. |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
16 At this time, it provides almost the same functionality as a UNIX version |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
17 of nginx except for |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
18 XSLT filter, image filter, GeoIP module, and embedded Perl language. |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
19 </para> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
20 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
21 <para> |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
22 To install nginx/Windows, <link doc="../download.xml">download</link> |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
23 the latest development version distribution (<development_version/>), |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
24 since the development branch of nginx contains all known fixes. |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
25 Then unpack the distribution, go to the |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
26 nginx-<development_version/> |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
27 directory, and run <command>nginx</command>. |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
28 Here is an example for the drive C: root directory: |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
29 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
30 <programlisting> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
31 cd c:\ |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
32 unzip nginx-<development_version/>.zip |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
33 cd nginx-<development_version/> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
34 start nginx |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 </programlisting> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
36 |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
37 Run the <command>tasklist</command> command-line utility |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
38 to see nginx processes: |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
39 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
40 <programlisting> |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
41 C:\nginx-<development_version/>>tasklist /fi "imagename eq nginx.exe" |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
42 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
43 Image Name PID Session Name Session# Mem Usage |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
44 =============== ======== ============== ========== ============ |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
45 nginx.exe 652 Console 0 2 780 K |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
46 nginx.exe 1332 Console 0 3 112 K |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
47 </programlisting> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
48 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
49 One of the processes is the master process and another is the worker process. |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
50 If nginx does not start, look for the reason in |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
51 the error log file <path>logs\error.log</path>. |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
52 If the log file has not been created, the reason for this should be reported |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
53 in the Windows Event Log. |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
54 If an error page is displayed instead of the expected page, also look |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
55 for the reason in the <path>logs\error.log</path> file. |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
56 </para> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
57 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
58 <para> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
59 nginx/Windows uses the directory where it has been run as the prefix |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
60 for relative paths in the configuration. |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
61 In the example above, the prefix is |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
62 <path>C:\nginx-<development_version/>\</path>. |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
63 Paths in a configuration file must be specified in UNIX-style using |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
64 forward slashes: |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
65 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
66 <programlisting> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
67 access_log logs/site.log; |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
68 root C:/web/html; |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
69 </programlisting> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
70 </para> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
71 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
72 <para> |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
73 nginx/Windows runs as a standard console application (not a service), |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
74 and it can be managed using the following commands: |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
75 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
76 <table note="yes"> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
77 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
78 <tr> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
79 <td width="20%">nginx -s stop</td> |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
80 <td>fast shutdown</td> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
81 </tr> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
82 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
83 <tr> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
84 <td>nginx -s quit</td> |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
85 <td>graceful shutdown</td> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
86 </tr> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
87 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
88 <tr> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
89 <td>nginx -s reload</td> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
90 <td> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
91 changing configuration, |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
92 starting new worker processes with a new configuration, |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
93 graceful shutdown of old worker processes |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
94 </td> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
95 </tr> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
96 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
97 <tr> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
98 <td>nginx -s reopen</td> |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
99 <td>re-opening log files</td> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
100 </tr> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
101 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
102 </table> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
103 </para> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
104 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
105 </section> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
106 |
121
49443032011c
Unified <section> syntax for "article" and "module" documents.
Ruslan Ermilov <ru@nginx.com>
parents:
50
diff
changeset
|
107 <section id="known_issues" |
49443032011c
Unified <section> syntax for "article" and "module" documents.
Ruslan Ermilov <ru@nginx.com>
parents:
50
diff
changeset
|
108 name="Known issues"> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
109 |
461 | 110 <list type="bullet"> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
111 |
461 | 112 <listitem> |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
113 Although several workers can be started, only one of them |
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
114 actually does any work. |
461 | 115 </listitem> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
116 |
461 | 117 <listitem> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
118 A worker can handle no more than 1024 simultaneous connections. |
461 | 119 </listitem> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
120 |
461 | 121 <listitem> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
122 The cache and other modules which require shared memory support do not work |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
123 on Windows Vista and later versions due to |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
124 address space layout randomization being enabled in these Windows versions. |
461 | 125 </listitem> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
126 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
127 </list> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
128 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
129 </section> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
130 |
121
49443032011c
Unified <section> syntax for "article" and "module" documents.
Ruslan Ermilov <ru@nginx.com>
parents:
50
diff
changeset
|
131 <section id="possible_future_enhancements" |
49443032011c
Unified <section> syntax for "article" and "module" documents.
Ruslan Ermilov <ru@nginx.com>
parents:
50
diff
changeset
|
132 name="Possible future enhancements"> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
133 |
461 | 134 <list type="bullet"> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
135 |
461 | 136 <listitem> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
137 Running as a service. |
461 | 138 </listitem> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
139 |
461 | 140 <listitem> |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
141 Using the I/O completion ports as a request processing method. |
461 | 142 </listitem> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
143 |
461 | 144 <listitem> |
265
4d047c05b7ad
Revised the "nginx for Windows" article.
Ruslan Ermilov <ru@nginx.com>
parents:
148
diff
changeset
|
145 Using multiple worker threads inside a single worker process. |
461 | 146 </listitem> |
0
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
147 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
148 </list> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
149 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
150 </section> |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
151 |
61e04fc01027
Initial import of the nginx.org website.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
152 </article> |