configure.xml

<!--
  Copyright (C) Igor Sysoev
  Copyright (C) Nginx, Inc.
  -->

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

<article name="Compilare i sorgenti di nginx"
         link="/it/docs/configure.html"
         lang="it"
         translator="Angelo Papadia"
         rev="4">

<section>

<para>
La compilazione si configura tramite il comando <command>configure</command>,
che definisce vari aspetti del sistema, fra cui i metodi che nginx puo'
usare per processare le connessioni; alla fine viene creato un <path>Makefile</path>.
Il comando <command>configure</command> supporta, fra gli altri, i seguenti parametri:
<list type="bullet">

<listitem>
<para>
<literal>--prefix=<value>path</value></literal>&mdash;
definisce la directory che conterra' i file del server.
La medesima directory sara' pure usata per tutti i path relativi
definiti da <command>configure</command> (a parte i path ai sorgenti
delle librerie) e nel file di configurazione <path>nginx.conf</path>.
Per default vale <path>/usr/local/nginx</path>.
</para>
</listitem>

<listitem>
<para>
<literal>--sbin-path=<value>path</value></literal>&mdash;
stabilisce il nome del file eseguibile di nginx.
Tale valore e' usato solo nel corso dell'installazione.
Per default il file eseguibile e' chiamato
<path><value>prefix</value>/sbin/nginx</path>.
</para>
</listitem>

<listitem>
<para>
<literal>--conf-path=<value>path</value></literal>&mdash;
stabilisce il nome del file di configurazione <path>nginx.conf</path>.
In ogni caso, nginx puo' sempre essere avviato con un file di
configurazione differente, specificando quest'ultimo tramite il parametro
a linea di comando <nobr><literal>-c <value>file</value></literal></nobr>.
Per default il file di configurazione e'
<path><value>prefix</value>/conf/nginx.conf</path>.
</para>
</listitem>

<listitem>
<para>
<literal>--pid-path=<value>path</value></literal>&mdash;
stabilisce il nome del file nginx.pid in cui e' registrato l'ID
del processo principale.
Dopo l'installazione, il nome del file puo' sempre essere modificato
tramite la direttiva <link doc="ngx_core_module.xml" id="pid"/>
del file di configurazione <path>nginx.conf</path>.
Per default il file contenente il pid e'
<path><value>prefix</value>/logs/nginx.pid</path>.
</para>
</listitem>

<listitem>
<para>
<literal>--error-log-path=<value>path</value></literal>&mdash;
stabilisce il nome del principale file di diagnostica in cui sono
registrati gli errori e gli avvisi.
Dopo l'installazione, il nome del file puo' sempre essere modificato
tramite la direttiva <link doc="ngx_core_module.xml" id="error_log"/>
del file di configurazione <path>nginx.conf</path>.
Per default il file degli errori e'
<path><value>prefix</value>/logs/error.log</path>.
</para>
</listitem>

<listitem>
<para>
<literal>--http-log-path=<value>path</value></literal>&mdash;
stabilisce il nome del principale file di log delle richieste
al server HTTP.
Dopo l'installazione, il nome del file puo' sempre essere modificato tramite
la direttiva <link doc="http/ngx_http_log_module.xml" id="access_log"/>
del file di configurazione <path>nginx.conf</path>.
Per default il file di log delle richieste e'
<path><value>prefix</value>/logs/access.log</path>.
</para>
</listitem>

<listitem>
<para>
<literal>--user=<value>name</value></literal>&mdash;
stabilisce il nome di un utente non privilegiato le cui credenziali saranno
usate dai processi worker.
Dopo l'installazione, l'utente puo' sempre essere modificato tramite
la direttiva <link doc="ngx_core_module.xml" id="user"/>
del file di configurazione <path>nginx.conf</path>.
L'utente di default e' nobody.
</para>
</listitem>

<listitem>
<para>
<literal>--group=<value>name</value></literal>&mdash;
stabilisce il nome di un gruppo le cui credenziali saranno
usate dai processi worker.
Dopo l'installazione, il gruppo puo' sempre essere modificato tramite
la direttiva <link doc="ngx_core_module.xml" id="user"/>
del file di configurazione <path>nginx.conf</path>.
Per default il gruppo e scelto fra uno di quelli degli utenti non priviliegiati.
</para>
</listitem>

<listitem>
<para>
<literal>--with-select_module</literal><br/>
<literal>--without-select_module</literal>&mdash;
abilita o disabilita la compilazione del modulo che consente al server
di utilizzare il metodo <c-func>select</c-func>.
Tale modulo e' compilato automaticamente nel caso in cui la piattaforma non
supporti metodi piu' appropriati, quali kqueue, epoll, rtsig, o /dev/poll.
</para>
</listitem>

<listitem>
<para>
<literal>--with-poll_module</literal><br/>
<literal>--without-poll_module</literal>&mdash;
abilita o disabilita la compilazione del modulo che consente al server
di utilizzare il metodo <c-func>poll</c-func>.
Tale modulo e' compilato automaticamente nel caso in cui la piattaforma non
supporti metodi piu' appropriati, quali kqueue, epoll, rtsig, o /dev/poll.
</para>
</listitem>

<listitem>
<para>
<literal>--without-http_gzip_module</literal>&mdash;
disabilita la compilazione del modulo che
<link doc="http/ngx_http_gzip_module.xml">comprime le risposte</link>
del server HTTP.
Per la compilazione e l'utilizzo di questo modulo e' richiesta la libreria zlib.
</para>
</listitem>

<listitem>
<para>
<literal>--without-http_rewrite_module</literal>&mdash;
disabilita la compilazione del modulo che consente al server HTTP di
<link doc="http/ngx_http_rewrite_module.xml">redirigere e cambiare l'URI
delle richieste</link>.
Per la compilazione e l'utilizzo di questo modulo e' richiesta la libreria PCRE.
</para>
</listitem>

<listitem>
<para>
<literal>--without-http_proxy_module</literal>&mdash;
disabilita la compilazione del
<link doc="http/ngx_http_proxy_module.xml">modulo di proxy</link>
del server HTTP.
<!--
The MD5 library is required to build and run this module.
-->
</para>
</listitem>

<listitem>
<para>
<literal>--with-http_ssl_module</literal>&mdash;
abilita la compilazione del modulo che aggiunge al server HTTP il
<link doc="http/ngx_http_ssl_module.xml">supporto al protocollo HTTPS</link>.
Per default tale modulo non e' compilato.
Per la compilazione e l'utilizzo di questo modulo e' richiesta la libreria OpenSSL.
</para>
</listitem>

<listitem>
<para>
<literal>--with-pcre=<value>path</value></literal>&mdash;
indica il path ai sorgenti della libreria PCRE.
E' necessario scaricare dal sito di <link url="http://www.pcre.org">PCRE</link>
la distribuzione della libreria (versioni da 4.4 a 8.32), ed estrarla.
Al resto ci pensano i comandi <command>./configure</command> e
<command>make</command> di nginx.
La libreria e' richiesta per il supporto alle espressioni regolari nella
direttiva <link doc="http/ngx_http_core_module.xml" id="location"/> e per il
modulo <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>.
</para>
</listitem>

<listitem>
<para>
<literal>--with-pcre-jit</literal>&mdash;
compila la libreria PCRE con il supporto “just-in-time"
(1.1.12, direttiva <link doc="ngx_core_module.xml" id="pcre_jit"/>).
</para>
</listitem>

<listitem>
<para>
<literal>--with-zlib=<value>path</value></literal>&mdash;
indica il path ai sorgenti della libreria zlib.
E' necessario scaricare dal sito di <link url="http://zlib.net">zlib</link>
la distribuzione della libreria (versioni da 1.1.3 a 1.2.7), ed estrarla.
Al resto ci pensano i comandi <command>./configure</command> e
<command>make</command> di nginx.
La libreria e' richiesta per il modulo
<link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>.
</para>
</listitem>

<listitem>
<para>
<literal>--with-cc-opt=<value>parameters</value></literal>&mdash;
definisce i parametri che saranno aggiunti alla variabile CFLAGS.
Nel caso in cui si stia usando la libreria PCRE in ambiente FreeBSD,
bisognerebbe specificare <literal>--with-cc-opt="-I /usr/local/include"</literal>.
Se il numero di file supportati da <c-func>select</c-func> deve essere
incrementato, e' possibile farlo anche con questo parametro, ad esempio con:
<literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>.
</para>
</listitem>

<listitem>
<para>
<literal>--with-ld-opt=<value>parameters</value></literal>&mdash;
definisce i parametri aggiuntivi che saranno usati durante il linking.
Nel caso in cui si stia usando la libreria PCRE in ambiente FreeBSD,
bisognerebbe specificare <literal>--with-ld-opt="-L /usr/local/lib"</literal>.
</para>
</listitem>

</list>

</para>

<para>
Un esempio d'uso dei parametri (da scrivere tutti su un'unica linea):
<programlisting>
./configure
    --sbin-path=/usr/local/nginx/nginx
    --conf-path=/usr/local/nginx/nginx.conf
    --pid-path=/usr/local/nginx/nginx.pid
    --with-http_ssl_module
    --with-pcre=../pcre-4.4
    --with-zlib=../zlib-1.1.3
</programlisting>
</para>

<para>
Dopo la configurazione, nginx e' compilato ed installato tramite
il comando <command>make</command>.
</para>

</section>

</article>