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

annotate xml/en/docs/install.xml @ 589:764fbac1b8b4

Added document revision.

author	Ruslan Ermilov <ru@nginx.com>
date	Tue, 17 Jul 2012 05:02:15 +0000
parents	be54c443235a
children	af3f38e349eb

rev	line source
580 be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 486 diff changeset	1 <!--
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 486 diff changeset	2 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 486 diff changeset	3 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 486 diff changeset	4 -->
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 486 diff changeset	5
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	7
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	8 <article name="Installing nginx"
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	9 link="/en/docs/install.html"
589 764fbac1b8b4 Added document revision. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	10 lang="en"
764fbac1b8b4 Added document revision. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	11 rev="1">
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	12
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	13 <section>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	14
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	15 <para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	16 The build is configured using the <command>configure</command> command.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	17 It defines various aspects of the system, including the methods nginx
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	18 is allowed to use for connection processing.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	19 At the end it creates a <path>Makefile</path>.
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	20 The <command>configure</command> command supports the following parameters:
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 289 diff changeset	21 <list type="bullet">
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	22
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	23 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	24 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	25 <literal>--prefix=<value>path</value></literal>—defines
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	26 a directory that will keep server files.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	27 This same directory will also be used for all relative paths set by
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	28 <command>configure</command> (except for paths to libraries sources)
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	29 and in the <path>nginx.conf</path> configuration file.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	30 It is set to the <path>/usr/local/nginx</path> directory by default.
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	31 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	32 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	33
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	34 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	35 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	36 <literal>--sbin-path=<value>path</value></literal>—sets
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	37 the name of an nginx executable file.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	38 This name is used only during installation.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	39 By default the file is named
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	40 <path><value>prefix</value>/sbin/nginx</path>.
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	41 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	42 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	43
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	44 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	45 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	46 <literal>--conf-path=<value>path</value></literal>—sets
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	47 the name of an <path>nginx.conf</path> configuration file.
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	48 If needs be, nginx can always be started with a different configuration file,
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	49 by specifying it in the command-line parameter
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	50 <nobr><literal>-c <value>file</value></literal></nobr>.
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	51 By default the file is named
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	52 <path><value>prefix</value>/conf/nginx.conf</path>.
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	53 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	54 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	55
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	56 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	57 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	58 <literal>--pid-path=<value>path</value></literal>—sets
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	59 the name of an nginx.pid file that will store the process ID
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	60 of the main process.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	61 After installation, the file name can always be changed in the
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	62 <path>nginx.conf</path> configuration file using the
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	63 <link doc="ngx_core_module.xml" id="pid"/> directive.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	64 By default the file is named
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	65 <path><value>prefix</value>/logs/nginx.pid</path>.
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	66 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	67 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	68
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	69 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	70 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	71 <literal>--error-log-path=<value>path</value></literal>—sets
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	72 the name of the primary error, warnings, and diagnostic file.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	73 After installation, the file name can always be changed in the
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	74 <path>nginx.conf</path> configuration file using the
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	75 <link doc="ngx_core_module.xml" id="error_log"/> directive.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	76 By default the file is named
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	77 <path><value>prefix</value>/logs/error.log</path>.
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	78 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	79 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	80
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	81 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	82 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	83 <literal>--http-log-path=<value>path</value></literal>—sets
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	84 the name of the primary request log file of the HTTP server.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	85 After installation, the file name can always be changed in the
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	86 <path>nginx.conf</path> configuration file using the
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	87 <link doc="http/ngx_http_log_module.xml" id="access_log"/> directive.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	88 By default the file is named
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	89 <path><value>prefix</value>/logs/access.log</path>.
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	90 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	91 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	92
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	93 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	94 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	95 <literal>--user=<value>name</value></literal>—sets
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	96 the name of an unprivileged user whose credentials will be used
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	97 by worker processes.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	98 After installation, the name can always be changed in the
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	99 <path>nginx.conf</path> configuration file using the
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	100 <link doc="ngx_core_module.xml" id="user"/> directive.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	101 The default user name is nobody.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	102 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	103 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	104
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	105 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	106 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	107 <literal>--group=<value>name</value></literal>—sets
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	108 the name of a group whose credentials will be used
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	109 by worker processes.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	110 After installation, the name can always be changed in the
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	111 <path>nginx.conf</path> configuration file using the
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	112 <link doc="ngx_core_module.xml" id="user"/> directive.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	113 By default, a group name is set to the name of an unprivileged user.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	114 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	115 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	116
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	117 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	118 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	119 <literal>--with-select_module</literal><br/>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	120 <literal>--without-select_module</literal>—enables or disables
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	121 building a module that allows the server to work with the
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	122 <c-func>select</c-func> method.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	123 This module is built automatically if the platform does not appear
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	124 to support more appropriate methods such as kqueue, epoll, rtsig, or /dev/poll.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	125 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	126 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	127
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	128 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	129 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	130 <literal>--with-poll_module</literal><br/>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	131 <literal>--without-poll_module</literal>—enables or disables
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	132 building a module that allows the server to work with the
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	133 <c-func>poll</c-func> method.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	134 This module is built automatically if the platform does not appear
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	135 to support more appropriate methods such as kqueue, epoll, rtsig, or /dev/poll.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	136 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	137 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	138
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	139 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	140 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	141 <literal>--without-http_gzip_module</literal>—disables building a module
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	142 that <link doc="http/ngx_http_gzip_module.xml">compresses responses</link>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	143 of an HTTP server.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	144 The zlib library is required to build and run this module.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	145 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	146 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	147
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	148 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	149 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	150 <literal>--without-http_rewrite_module</literal>—disables building a
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	151 module that allows an HTTP server to
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	152 <link doc="http/ngx_http_rewrite_module.xml">redirect requests and change URI
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	153 of requests</link>.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	154 The PCRE library is required to build and run this module.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	155 The module is experimental—its directives may change in the future.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	156 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	157 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	158
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	159 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	160 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	161 <literal>--without-http_proxy_module</literal>—disables building an
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	162 HTTP server <link doc="http/ngx_http_proxy_module.xml">proxying module</link>.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	163 <!--
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	164 The MD5 library is required to build and run this module.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	165 -->
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	166 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	167 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	168
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	169 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	170 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	171 <literal>--with-http_ssl_module</literal>—enables building a module
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	172 that adds the <link doc="http/ngx_http_ssl_module.xml">HTTPS protocol
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	173 support</link> to an HTTP server.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	174 This module is not built by default.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	175 The OpenSSL library is required to build and run this module.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	176 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	177 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	178
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	179 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	180 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	181 <literal>--with-pcre=<value>path</value></literal>—sets
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	182 the path to the sources of the PCRE library.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	183 The library distribution (version
486 1bf933a9df8b - Mentioned that --with-pcre-jit has appeared in 1.1.12, and added Ruslan Ermilov <ru@nginx.com> parents: 461 diff changeset	184 4.4—8.30) needs to be downloaded from the
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	185 <link url="http://www.pcre.org">PCRE</link> site and extracted.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	186 The rest is done by nginx's ./configure and make.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	187 The library is required for regular expressions support in the
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	188 <link doc="http/ngx_http_core_module.xml" id="location"/> directive
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	189 and for the
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	190 <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	191 module.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	192 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	193 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	194
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	195 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	196 <para>
289 df261b1ce71f Documented the --with-pcre-jit configuration parameter Ruslan Ermilov <ru@nginx.com> parents: 282 diff changeset	197 <literal>--with-pcre-jit</literal>—builds the PCRE library with
486 1bf933a9df8b - Mentioned that --with-pcre-jit has appeared in 1.1.12, and added Ruslan Ermilov <ru@nginx.com> parents: 461 diff changeset	198 “just-in-time compilation” support (1.1.12, see
1bf933a9df8b - Mentioned that --with-pcre-jit has appeared in 1.1.12, and added Ruslan Ermilov <ru@nginx.com> parents: 461 diff changeset	199 <link doc="ngx_core_module.xml" id="pcre_jit"/>).
289 df261b1ce71f Documented the --with-pcre-jit configuration parameter Ruslan Ermilov <ru@nginx.com> parents: 282 diff changeset	200 </para>
df261b1ce71f Documented the --with-pcre-jit configuration parameter Ruslan Ermilov <ru@nginx.com> parents: 282 diff changeset	201 </listitem>
df261b1ce71f Documented the --with-pcre-jit configuration parameter Ruslan Ermilov <ru@nginx.com> parents: 282 diff changeset	202
df261b1ce71f Documented the --with-pcre-jit configuration parameter Ruslan Ermilov <ru@nginx.com> parents: 282 diff changeset	203 <listitem>
df261b1ce71f Documented the --with-pcre-jit configuration parameter Ruslan Ermilov <ru@nginx.com> parents: 282 diff changeset	204 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	205 <literal>--with-zlib=<value>path</value></literal>—sets
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	206 the path to the sources of the zlib library.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	207 The library distribution (version
282 64107bc400c4 Bumped versions of supported PCRE and zlib libraries. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	208 1.1.3—1.2.5) needs to be downloaded from the
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	209 <link url="http://www.gzip.org/zlib/">zlib</link> site and extracted.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	210 The rest is done by nginx's ./configure and make.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	211 The library is required for the
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	212 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link> module.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	213 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	214 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	215
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	216 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	217 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	218 <literal>--with-cc-opt=<value>parameters</value></literal>—sets
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	219 additional parameters that will be added to the CFLAGS variable.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	220 When using the system PCRE library under FreeBSD,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	221 <literal>--with-cc-opt="-I /usr/local/include"</literal>
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	222 should be specified.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	223 If the number of files supported by <c-func>select</c-func> needs to be
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	224 increased it can also be specified here such as this:
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	225 <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>.
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	226 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	227 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	228
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	229 <listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	230 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	231 <literal>--with-ld-opt=<value>parameters</value></literal>—sets
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	232 additional parameters that will be used during linking.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	233 When using the system PCRE library under FreeBSD,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	234 <literal>--with-ld-opt="-L /usr/local/lib"</literal>
263 be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	235 should be specified.
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	236 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	237 </listitem>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	238
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	239 </list>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	240
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	241 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	242
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	243 <para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	244 Example of parameters usage (all of this needs to be typed in one line):
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	245 <programlisting>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	246 ./configure
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	247 --sbin-path=/usr/local/nginx/nginx
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	248 --conf-path=/usr/local/nginx/nginx.conf
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	249 --pid-path=/usr/local/nginx/nginx.pid
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	250 --with-http_ssl_module
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	251 --with-pcre=../pcre-4.4
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	252 --with-zlib=../zlib-1.1.3
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	253 </programlisting>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	254 </para>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	255
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	256 </section>
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	257
be3772a799a2 English translation of "Installing nginx". Ruslan Ermilov <ru@nginx.com> parents: diff changeset	258 </article>

Mercurial > hg > nginx-site

annotate xml/en/docs/install.xml @ 589:764fbac1b8b4