diff xml/ru/docs/windows.xml @ 265:4d047c05b7ad

Revised the "nginx for Windows" article.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 22 Dec 2011 09:07:37 +0000
parents 7db449e89e92
children 6135f3c95bf6
line wrap: on
line diff
--- a/xml/ru/docs/windows.xml
+++ b/xml/ru/docs/windows.xml
@@ -1,54 +1,153 @@
 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
 
-<article name="Установка и использование под Windows"
+<article name="nginx под Windows"
          link="/ru/docs/windows.html"
          lang="ru">
 
 <section>
 
 <para>
-nginx/Windows работает с Win32 API (не эмуляция Cygwin).
-В качестве метода обработки соединений используется select,
-поэтому не стоит ожидать высокой производительности и масштабируемости:
-пока это бета-версия.
-На данный момент доступна практически вся функциональность, что и в nginx/Unix,
-за исключением XSLT-фильтра, фильтра изображений, модуля geoip
-и встроенного perl'а.
+Версия nginx под Windows использует “родной” Win32 API (не эмуляцию Cygwin).
+В настоящий момент в качестве метода обработки соединений используется
+только <c-func>select</c-func>,
+поэтому не стоит ожидать высокой производительности и масштабируемости.
+В силу этого и ряда других известных проблем версия nginx под Windows
+рассматривается пока как <i>бета</i>-версия.
+На данный момент в ней доступна практически вся функциональность, что и
+в версии nginx под UNIX, за исключением
+XSLT-фильтра, фильтра изображений, модуля GeoIP и встроенного языка Perl.
 </para>
 
 <para>
-Распаковываем дистрибутив на диск C:, переходим в каталог
-nginx-<development_version/> и запускаем <command>nginx</command>:
+Чтобы установить nginx/Windows, <link doc="../download.xml">скачайте</link>
+дистрибутив последней разрабатываемой версии (<development_version/>),
+поскольку ветвь разработки nginx содержит все известные исправления.
+Затем распакуйте дистрибутив, перейдите в каталог
+nginx-<development_version/>
+и запустите <command>nginx</command>.
+Вот пример для корневого каталога на диске C:
+
 <programlisting>
 cd c:\
 unzip nginx-<development_version/>.zip
 cd nginx-<development_version/>
 start nginx
 </programlisting>
-</para>
+
+Чтобы увидеть процессы nginx, запустите утилиту командной строки
+<command>tasklist</command>:
+
+<programlisting>
+C:\nginx-<development_version/>&gt;tasklist /fi "imagename eq nginx.exe"
 
-<para>
-Если nginx не запустился, нужно смотреть причины в error_log.
-Если же error_log не создался, то об этом сообщается в Event Log.
+Image Name           PID Session Name     Session#    Mem Usage
+=============== ======== ============== ========== ============
+nginx.exe            652 Console                 0      2 780 K
+nginx.exe           1332 Console                 0      3 112 K
+</programlisting>
+
+Один из процессов основной, другой&mdash;рабочий.
+Если nginx не запускается, нужно искать причину в
+в файле лога ошибок <path>logs\error.log</path>.
+Если же лог-файл не создался, то причину этого следует искать
+в Windows Event Log.
+Если вместо ожидаемой страницы выводится страница с ошибкой, нужно также
+искать причины ошибки в файле <path>logs\error.log</path>.
 </para>
 
 <para>
-nginx/Windows работает как обычное приложение (не сервис) и
-управляется следующим образом:
-<note>
-<table>
+nginx/Windows использует каталог, в котором он был запущен, в качестве
+префикса для относительных путей в конфигурации.
+В вышеприведённом примере префиксом является
+<path>C:\nginx-<development_version/>\</path>.
+Пути в конфигурационном файле должны задаваться в UNIX-стиле с использованием
+прямых слэшей:
+
+<programlisting>
+access_log   logs/site.log;
+root         C:/web/html;
+</programlisting>
+</para>
+
+<para>
+nginx/Windows работает как стандартное консольное приложение (не сервис)
+и управляется при помощи следующих команд:
+
+<table note="yes">
 
-<tr><td width="20%">nginx -s stop</td><td>быстрое завершение</td></tr>
-<tr><td width="20%">nginx -s quit</td><td>плавное завершение</td></tr>
-<tr><td width="20%">nginx -s reload</td><td>изменение конфигурации,
+<tr>
+<td width="20%">nginx -s stop</td>
+<td>быстрое завершение</td>
+</tr>
+
+<tr>
+<td>nginx -s quit</td>
+<td>плавное завершение</td>
+</tr>
+
+<tr>
+<td>nginx -s reload</td>
+<td>
+изменение конфигурации,
 запуск новых рабочих процессов с новой конфигурацией,
-плавное завершение старых рабочих процессов</td></tr>
-<tr><td width="20%">nginx -s reopen</td><td>переоткрытие лог-файлов</td></tr>
+плавное завершение старых рабочих процессов
+</td>
+</tr>
+
+<tr>
+<td>nginx -s reopen</td>
+<td>переоткрытие лог-файлов</td>
+</tr>
 
 </table>
-</note>
 </para>
 
 </section>
 
+<section id="known_issues"
+        name="Известные проблемы">
+
+<list>
+
+<item>
+Хоть и возможен запуск нескольких рабочих процессов, только один из них
+реально работает.
+</item>
+
+<item>
+Рабочий процесс может обслуживать не более 1024 одновременных соединений.
+</item>
+
+<item>
+Кэш и другие модули, требующие поддержки разделяемой памяти, не работают
+под Windows Vista и более поздними версиями в связи с тем, что на этих
+версиях Windows включена рандомизация адресного пространства.
+</item>
+
+</list>
+
+</section>
+
+<section id="possible_future_enhancements"
+        name="Возможные усовершенствования в будущем">
+
+<list>
+
+<item>
+Запуск в виде сервиса.
+</item>
+
+<item>
+Использование портов завершения ввода-вывода (I/O completion ports)
+в качестве метода обработки соединений.
+</item>
+
+<item>
+Использование нескольких рабочих нитей внутри одного рабочего процесса.
+</item>
+
+</list>
+
+</section>
+
 </article>