nginx-site: xml/en/docs/windows.xml annotate

annotate xml/en/docs/windows.xml @ 553:6330ca27a485

Translated "events" into English.

author	Ruslan Ermilov <ru@nginx.com>
date	Tue, 26 Jun 2012 07:36:58 +0000
parents	6135f3c95bf6
children	be54c443235a

rev	line source
50 9d544687d02c Fixed DOCTYPE declaration. Ruslan Ermilov <ru@nginx.com> parents: 0 diff changeset	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).
553 6330ca27a485 Translated "events" into English. Ruslan Ermilov <ru@nginx.com> parents: 461 diff changeset	12 Only the <c-func>select</c-func> connection processing method is currently used,
265 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 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	110 <list type="bullet">
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	111
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	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 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	115 </listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	116
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	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 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	119 </listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	120
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	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 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	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 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	134 <list type="bullet">
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	135
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	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 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	138 </listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	139
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	140 <listitem>
553 6330ca27a485 Translated "events" into English. Ruslan Ermilov <ru@nginx.com> parents: 461 diff changeset	141 Using the I/O completion ports as a connection processing method.
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	142 </listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	143
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	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 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	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>

Mercurial > hg > nginx-site

annotate xml/en/docs/windows.xml @ 553:6330ca27a485