windows.xml

<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">

<article name="שימוש ב nginx במערכת ההפעלה חלונות"
         link="/he/docs/windows.html"
         lang="he">

<section>

<para>
nginx/Windows משתמש ב API הטבעי של חלונות, Win32 API (ולא בשכבת אמולציה של Cygwin).
נכון למועד כתיבת שורות אלה, שיטת היידוע <i>select</i> היא זו שנמצאת בשימוש,
ולכן אין לצפות לרמת ביצועים גבוהה וליכולת גידול.
עקב כך וגם בעקבות בעיות ידועות אחרות, nginx/Windows נחשבת כגירסת <i>בטא</i>.
ישנה פונקציונליות כמעט מלאה ב nginx/Windows ביחס לגירסת Unix, חוץ מפילטר XSLT,
פילטר תמונות, מודול GeoIP ושפת Perl משובצת.</para>

<para>
כדי להתקין את nginx/Windows, יש <link doc="../../en/download.xml">להוריד</link>
את קובץ הזיפ של גירסת הפיתוח האחרונה <mainline_version />,
כיוון שענף הפיתוח מכיל את כל התיקונים הידועים, בייחוד אלו הקשורים לחלונות.
אחרי ההורדה, יש לפרוס את קובץ הזיפ,
להיכנס לתיקיה nginx-<mainline_version />, ולהריץ את nginx.
הנה דוגמא עבור תיקיית השורש של כונן C:

<programlisting>
cd c:\
unzip nginx-<mainline_version />.zip
cd nginx-<mainline_version />
start nginx
</programlisting>

תוכלו להריץ את כלי שורת הפקודה <path>tasklist</path> כדי לראות תהליכים
של nginx:

<programlisting>
C:\nginx-<mainline_version />&gt;tasklist /fi "imagename eq nginx.exe"

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>

אחד מהתהליכים הוא התהליך הראשי (מנהל), והאחר הוא תהליך עובד.
אם nginx לא מתחיל לפעול, יש לעיין בקובץ <path>logs\error.log</path> כדי לבדוק את הסיבה.
אם קובץ הלוג לא נוצר, הסיבה צריכה להיות מדווחת ב Event Log של חלונות.
אם הנכם מקבלים דף שגיאה במקום העמוד הרצוי, עליכם לעיין בקובץ  <path>logs\error.log</path> גם כן,
כדי לראות מה הסיבה.
</para>

<para>
nginx/Windows משתמש בתיקייה שממנה הוא הופעל בתור תיקיית הקידומת לכל
הנתיבים היחסיים שבקובץ התצורה.
בדוגמה שלעיל, תיקיית הקידומת תהיה
<path>C:\nginx-<mainline_version />\</path>.
על נתיבים בקובץ התצורה להיות בסגנון Unix בלבד, באמצעות לוכסנים קדמיים:

<programlisting>
access_log   logs/site.log;
root         C:/web/html;
</programlisting>
</para>

<para>
nginx/Windows רץ כיישום קונסול סטנדרטי, ולא כשירות (service) במערכת,
וניתן לנהלו באמצעות הפקודות הבאות:
<table note="yes">

<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>nginx -s reopen</td>
<td>פתיחה מחדש של קובצי הלוג</td>
</tr>

</table>
</para>

</section>

<section id="known_issues"
        name="בעיות ידועות">

<list type="bullet">

<listitem>
למרות שניתן להפעיל מספר תהליכים עובדים, רק אחד מהם עושה בפועל את העבודה.
</listitem>

<listitem>
תהליך עובד לא יכול לטפל ביותר מ 1024 חיבורים פעילים בו זמנית.
</listitem>

<listitem>
מודול המטמון ומודולים אחרים אשר דורשים תמיכה בזיכרון משותף, לא עובדים בחלונות
ויסטה או גירסאות מאוחרות יותר, עקב הפעלת טכניקת address space layout randomization
המופעלת בגירסאות אלה של חלונות.
</listitem>

</list>

</section>

<section id="possible_future_enhancements"
        name="שיפורים עתידיים אפשריים">

<list type="bullet">

<listitem>
הרצה כשירות במערכת (Service).
</listitem>

<listitem>
שימוש ב I/O completion ports כשיטת יידוע.
</listitem>

<listitem>
שימוש במספר נימי עובדים בתוך תהליך עובד אחד.
</listitem>

</list>

</section>

</article>