comparison xml/it/docs/configure.xml @ 1053:6303d4e343a8

Updated the Italian translation.
author Vladimir Homutov <vl@nginx.com>
date Mon, 27 Jan 2014 19:25:54 +0400
parents
children
comparison
equal deleted inserted replaced
1052:f5b15dfb72a1 1053:6303d4e343a8
1 <!--
2 Copyright (C) Igor Sysoev
3 Copyright (C) Nginx, Inc.
4 -->
5
6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
7
8 <article name="Compilare i sorgenti di nginx"
9 link="/it/docs/configure.html"
10 lang="it"
11 translator="Angelo Papadia"
12 rev="4">
13
14 <section>
15
16 <para>
17 La compilazione si configura tramite il comando <command>configure</command>,
18 che definisce vari aspetti del sistema, fra cui i metodi che nginx puo'
19 usare per processare le connessioni; alla fine viene creato un <path>Makefile</path>.
20 Il comando <command>configure</command> supporta, fra gli altri, i seguenti parametri:
21 <list type="bullet">
22
23 <listitem>
24 <para>
25 <literal>--prefix=<value>path</value></literal>&mdash;
26 definisce la directory che conterra' i file del server.
27 La medesima directory sara' pure usata per tutti i path relativi
28 definiti da <command>configure</command> (a parte i path ai sorgenti
29 delle librerie) e nel file di configurazione <path>nginx.conf</path>.
30 Per default vale <path>/usr/local/nginx</path>.
31 </para>
32 </listitem>
33
34 <listitem>
35 <para>
36 <literal>--sbin-path=<value>path</value></literal>&mdash;
37 stabilisce il nome del file eseguibile di nginx.
38 Tale valore e' usato solo nel corso dell'installazione.
39 Per default il file eseguibile e' chiamato
40 <path><value>prefix</value>/sbin/nginx</path>.
41 </para>
42 </listitem>
43
44 <listitem>
45 <para>
46 <literal>--conf-path=<value>path</value></literal>&mdash;
47 stabilisce il nome del file di configurazione <path>nginx.conf</path>.
48 In ogni caso, nginx puo' sempre essere avviato con un file di
49 configurazione differente, specificando quest'ultimo tramite il parametro
50 a linea di comando <nobr><literal>-c <value>file</value></literal></nobr>.
51 Per default il file di configurazione e'
52 <path><value>prefix</value>/conf/nginx.conf</path>.
53 </para>
54 </listitem>
55
56 <listitem>
57 <para>
58 <literal>--pid-path=<value>path</value></literal>&mdash;
59 stabilisce il nome del file nginx.pid in cui e' registrato l'ID
60 del processo principale.
61 Dopo l'installazione, il nome del file puo' sempre essere modificato
62 tramite la direttiva <link doc="ngx_core_module.xml" id="pid"/>
63 del file di configurazione <path>nginx.conf</path>.
64 Per default il file contenente il pid e'
65 <path><value>prefix</value>/logs/nginx.pid</path>.
66 </para>
67 </listitem>
68
69 <listitem>
70 <para>
71 <literal>--error-log-path=<value>path</value></literal>&mdash;
72 stabilisce il nome del principale file di diagnostica in cui sono
73 registrati gli errori e gli avvisi.
74 Dopo l'installazione, il nome del file puo' sempre essere modificato
75 tramite la direttiva <link doc="ngx_core_module.xml" id="error_log"/>
76 del file di configurazione <path>nginx.conf</path>.
77 Per default il file degli errori e'
78 <path><value>prefix</value>/logs/error.log</path>.
79 </para>
80 </listitem>
81
82 <listitem>
83 <para>
84 <literal>--http-log-path=<value>path</value></literal>&mdash;
85 stabilisce il nome del principale file di log delle richieste
86 al server HTTP.
87 Dopo l'installazione, il nome del file puo' sempre essere modificato tramite
88 la direttiva <link doc="http/ngx_http_log_module.xml" id="access_log"/>
89 del file di configurazione <path>nginx.conf</path>.
90 Per default il file di log delle richieste e'
91 <path><value>prefix</value>/logs/access.log</path>.
92 </para>
93 </listitem>
94
95 <listitem>
96 <para>
97 <literal>--user=<value>name</value></literal>&mdash;
98 stabilisce il nome di un utente non privilegiato le cui credenziali saranno
99 usate dai processi worker.
100 Dopo l'installazione, l'utente puo' sempre essere modificato tramite
101 la direttiva <link doc="ngx_core_module.xml" id="user"/>
102 del file di configurazione <path>nginx.conf</path>.
103 L'utente di default e' nobody.
104 </para>
105 </listitem>
106
107 <listitem>
108 <para>
109 <literal>--group=<value>name</value></literal>&mdash;
110 stabilisce il nome di un gruppo le cui credenziali saranno
111 usate dai processi worker.
112 Dopo l'installazione, il gruppo puo' sempre essere modificato tramite
113 la direttiva <link doc="ngx_core_module.xml" id="user"/>
114 del file di configurazione <path>nginx.conf</path>.
115 Per default il gruppo e scelto fra uno di quelli degli utenti non priviliegiati.
116 </para>
117 </listitem>
118
119 <listitem>
120 <para>
121 <literal>--with-select_module</literal><br/>
122 <literal>--without-select_module</literal>&mdash;
123 abilita o disabilita la compilazione del modulo che consente al server
124 di utilizzare il metodo <c-func>select</c-func>.
125 Tale modulo e' compilato automaticamente nel caso in cui la piattaforma non
126 supporti metodi piu' appropriati, quali kqueue, epoll, rtsig, o /dev/poll.
127 </para>
128 </listitem>
129
130 <listitem>
131 <para>
132 <literal>--with-poll_module</literal><br/>
133 <literal>--without-poll_module</literal>&mdash;
134 abilita o disabilita la compilazione del modulo che consente al server
135 di utilizzare il metodo <c-func>poll</c-func>.
136 Tale modulo e' compilato automaticamente nel caso in cui la piattaforma non
137 supporti metodi piu' appropriati, quali kqueue, epoll, rtsig, o /dev/poll.
138 </para>
139 </listitem>
140
141 <listitem>
142 <para>
143 <literal>--without-http_gzip_module</literal>&mdash;
144 disabilita la compilazione del modulo che
145 <link doc="http/ngx_http_gzip_module.xml">comprime le risposte</link>
146 del server HTTP.
147 Per la compilazione e l'utilizzo di questo modulo e' richiesta la libreria zlib.
148 </para>
149 </listitem>
150
151 <listitem>
152 <para>
153 <literal>--without-http_rewrite_module</literal>&mdash;
154 disabilita la compilazione del modulo che consente al server HTTP di
155 <link doc="http/ngx_http_rewrite_module.xml">redirigere e cambiare l'URI
156 delle richieste</link>.
157 Per la compilazione e l'utilizzo di questo modulo e' richiesta la libreria PCRE.
158 </para>
159 </listitem>
160
161 <listitem>
162 <para>
163 <literal>--without-http_proxy_module</literal>&mdash;
164 disabilita la compilazione del
165 <link doc="http/ngx_http_proxy_module.xml">modulo di proxy</link>
166 del server HTTP.
167 <!--
168 The MD5 library is required to build and run this module.
169 -->
170 </para>
171 </listitem>
172
173 <listitem>
174 <para>
175 <literal>--with-http_ssl_module</literal>&mdash;
176 abilita la compilazione del modulo che aggiunge al server HTTP il
177 <link doc="http/ngx_http_ssl_module.xml">supporto al protocollo HTTPS</link>.
178 Per default tale modulo non e' compilato.
179 Per la compilazione e l'utilizzo di questo modulo e' richiesta la libreria OpenSSL.
180 </para>
181 </listitem>
182
183 <listitem>
184 <para>
185 <literal>--with-pcre=<value>path</value></literal>&mdash;
186 indica il path ai sorgenti della libreria PCRE.
187 E' necessario scaricare dal sito di <link url="http://www.pcre.org">PCRE</link>
188 la distribuzione della libreria (versioni da 4.4 a 8.32), ed estrarla.
189 Al resto ci pensano i comandi <command>./configure</command> e
190 <command>make</command> di nginx.
191 La libreria e' richiesta per il supporto alle espressioni regolari nella
192 direttiva <link doc="http/ngx_http_core_module.xml" id="location"/> e per il
193 modulo <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>.
194 </para>
195 </listitem>
196
197 <listitem>
198 <para>
199 <literal>--with-pcre-jit</literal>&mdash;
200 compila la libreria PCRE con il supporto “just-in-time"
201 (1.1.12, direttiva <link doc="ngx_core_module.xml" id="pcre_jit"/>).
202 </para>
203 </listitem>
204
205 <listitem>
206 <para>
207 <literal>--with-zlib=<value>path</value></literal>&mdash;
208 indica il path ai sorgenti della libreria zlib.
209 E' necessario scaricare dal sito di <link url="http://zlib.net">zlib</link>
210 la distribuzione della libreria (versioni da 1.1.3 a 1.2.7), ed estrarla.
211 Al resto ci pensano i comandi <command>./configure</command> e
212 <command>make</command> di nginx.
213 La libreria e' richiesta per il modulo
214 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>.
215 </para>
216 </listitem>
217
218 <listitem>
219 <para>
220 <literal>--with-cc-opt=<value>parameters</value></literal>&mdash;
221 definisce i parametri che saranno aggiunti alla variabile CFLAGS.
222 Nel caso in cui si stia usando la libreria PCRE in ambiente FreeBSD,
223 bisognerebbe specificare <literal>--with-cc-opt="-I /usr/local/include"</literal>.
224 Se il numero di file supportati da <c-func>select</c-func> deve essere
225 incrementato, e' possibile farlo anche con questo parametro, ad esempio con:
226 <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>.
227 </para>
228 </listitem>
229
230 <listitem>
231 <para>
232 <literal>--with-ld-opt=<value>parameters</value></literal>&mdash;
233 definisce i parametri aggiuntivi che saranno usati durante il linking.
234 Nel caso in cui si stia usando la libreria PCRE in ambiente FreeBSD,
235 bisognerebbe specificare <literal>--with-ld-opt="-L /usr/local/lib"</literal>.
236 </para>
237 </listitem>
238
239 </list>
240
241 </para>
242
243 <para>
244 Un esempio d'uso dei parametri (da scrivere tutti su un'unica linea):
245 <programlisting>
246 ./configure
247 --sbin-path=/usr/local/nginx/nginx
248 --conf-path=/usr/local/nginx/nginx.conf
249 --pid-path=/usr/local/nginx/nginx.pid
250 --with-http_ssl_module
251 --with-pcre=../pcre-4.4
252 --with-zlib=../zlib-1.1.3
253 </programlisting>
254 </para>
255
256 <para>
257 Dopo la configurazione, nginx e' compilato ed installato tramite
258 il comando <command>make</command>.
259 </para>
260
261 </section>
262
263 </article>