1 <?xml version='1.0' encoding='UTF-8' ?>
2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="./style/manual.es.xsl"?>
4 <!-- English Revision: 1760549 -->
5 <!-- Spanish Translation by: Luis Gil de Bernabé -->
6 <!-- Reviewed by: Sergio Ramos -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <manualpage metafile="install.xml.meta">
27 <title>Compilar e Instalar</title>
31 <p>Éste documento hace referencia a la compilación y la instalación del Apache
32 HTTP Server sólo para los sistemas Unix y tipo Unix. Para la compilación e instalación en Windows ir a <a
33 href="platform/windows.html">Usando Apache HTTP Server con Microsoft
35 href="platform/win_compiling.html">Compilando Apache para Microsoft Windows</a>.
36 Para otras plataformas visite la documentación sobre <a
37 href="platform/">plataformas</a>.</p>
39 <p>Apache httpd usa <code>libtool</code> y <code>autoconf</code>
40 para crear un entorno de compilación que se parece a muchos otros proyectos de código abierto</p>
42 <p>Si está actualizando desde una versión menor a la siguiente (por
43 ejemplo, 2.4.8 a 2.4.9), pasa a la sección de <a
44 href="#upgrading">actualización</a>.</p>
48 <seealso><a href="programs/configure.html">Configuración del árbol de las fuentes de código</a></seealso>
49 <seealso><a href="invoking.html">Arrancando Apache httpd</a></seealso>
50 <seealso><a href="stopping.html">Paranda y Reinicio</a></seealso>
52 <section id="overview"><title>Descripción genelar para los impacientes</title>
55 <columnspec><column width=".13"/><column width=".80"/></columnspec>
57 <td><a href="#download">Descarga</a></td>
59 <td>Descarga la última versión
60 desde <a href="http://httpd.apache.org/download.cgi#apache24">
61 http://httpd.apache.org/download.cgi</a>
66 <td><a href="#extract">Extraer</a></td>
68 <td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
69 $ tar xvf httpd-<em>NN</em>.tar<br />
70 $ cd httpd-<em>NN</em></code></td>
74 <td><a href="#configure">Configura</a></td>
76 <td><code>$ ./configure --prefix=<em>PREFIX</em></code>
81 <td><a href="#compile">Compila</a></td>
83 <td><code>$ make</code> </td>
87 <td><a href="#install">Instala</a></td>
89 <td><code>$ make install</code> </td>
93 <td><a href="#customize">Personalizalo</a></td>
95 <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
99 <td><a href="#test">Prueba</a></td>
101 <td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
106 <p><em>NN</em> hay que reemplazarlo por el número de la versión menor, y <em>PREFIX</em> hay que reemplazarlo por la ruta en la que se va a instalar Apache. Si no especifica ningún valor en <em>PREFIX</em>, el valor por defecto que se toma es /usr/local/apache2.</p>
108 <p>Cada parte del proceso de configuración e instalación se describe detalladamente más abajo, empezando por los requisitos para compilar e instalar Apache.</p>
111 <section id="requirements"><title>Requisitos</title>
113 <p>Estos son los requisitos necesarios para compilar Apache:</p>
116 <dt>APR y APR-Util</dt>
117 <dd>Asegúrate de que tiene instalado ya en su sistema APR y APR-Util. Si no es así, o no quiere utilizar la versión que le proporciona el sistema, puede descargar la última versión de ambos APR y APR-Util de
118 <a href="http://apr.apache.org/">Apache APR</a>, descomprimelo en
119 <code>/httpd_source_tree_root/srclib/apr</code> y /httpd_source_tree_root<code>/srclib/apr-util</code>
120 (cerciórate de que no existen directorios con números de versiones; por ejemplo,
121 la distribución de APR debe estar en /httpd_source_tree_root/srclib/apr/) y usa el comando
122 <code>./configure</code> <code>--con-las-opciones-incluidas-en-apr</code>.
123 En algunas plataformas deberás instalar la parte correspondiente a los paquetes
124 <code>-dev</code> para permitir que httpd se genere contra la instalación de la copia de APR y APR-Util.</dd>
126 <dt>Librería Compatible de expresiones regulares de Perl (PCRE)</dt>
127 <dd>Esta librería es requerida, pero ya no incluido con httpd.
128 Descarga el código fuente de <a href="http://www.pcre.org/">http://www.pcre.org</a>,
129 o instala un Port o un Paquete. Si la distrubución de su sistema no puede encontrar el escript pcre-config instalado por PCRE, seleccione utilizando el parámetro<code>--with-pcre</code>.En algunas plataformas,
130 deberás instalar la correspondiente versión <code>-dev</code>
131 del paquete para permitir a httpd que se genere contra la instalación de la copia del PCRE que se ha instalado.</dd>
133 <dt>Espacio en disco</dt>
134 <dd>Compruebe que tiene disponibles al
135 menos 50 MB de espacio libre en disco. Después de la
136 instalación, Apache ocupa aproximadamente 10 MB. No
137 obstante, la necesidad real de espacio en disco varía
138 considerablemente en función de las opciones de
139 configuración que elija y de los módulos externos que
140 use, y como no del tamaño de la página web</dd>
142 <dt>Systema de compilación ANSI-C</dt>
143 <dd>Compruebe que tiene instalado un compilador de ANSI-C. Se recomienda el <a href="http://gcc.gnu.org/">Compilador GNU C
144 (GCC)</a> de la <a href="http://www.gnu.org/">Free Software
145 Foundation (FSF)</a> es el recomendado. Si no tiene instalado el GCC, entonces compruebe que
146 el compilador que va a utilizar cumple con los estándares
147 ANSI. Además, su <code>PATH</code> debe contener la
148 ubicación donde de encuentran las herramientas básicas
149 para compilar tales como <code>make</code>.</dd>
151 <dt>Ajuste exacto del reloj del sistema</dt>
153 del protocolo HTTP están expresados según la hora del
154 día. Por eso, si quiere puede investigar como instalar alguna
155 utilidad para sincronizar la hora de su sistema. Para esto,
156 normalmente, se usan los programas <code>ntpdate</code> o
157 <code>xntpd</code>, que están basados en el protocolo
158 "Network Time Protocol" (NTP). Consulte el<a href="http://www.ntp.org">sitio web de NTP
159 </a> para obtener más información sobre NTP y los
160 servidores públicos de tiempo.</dd>
162 <dt><a href="http://www.perl.org/">Perl 5</a>[OPCIONAL]</dt>
163 <dd>Para algunos de los scripts de soporte como<program>
164 apxs</program> o <program>dbmmanage</program> (que están
165 escritos en Perl) es necesario el intérprete de Perl 5 (las
166 versiones 5.003 o posteriores son suficientes). Si el escript
167 <program>configure</program> no se encuentra, no podrá usar los
168 escripts correspondientes que lo necesiten. Pero por supuesto
169 podrás compilar y usar Apache httpd.</dd>
173 <section id="download"><title>Descargar</title>
175 <p>Puede descargar Apache desde <a
176 href="http://httpd.apache.org/download.cgi">la sección de
177 descargas del sitio web de Apache</a> el cual tiene varios
178 mirrors. Para la mayoría de los usuarios de Apache que tienen
179 sistemas tipo Unix, se recomienda que se descarguen y compilen el
180 código fuente. El proceso de compilación (descrito
181 más abajo) es fácil, y permite adaptar el servidor
182 Apache a sus necesidades. Además, las versiones de
183 disponibles en archivos binarios no están siempre actualizadas
184 con las últimas modificaciones en el código fuente. Si se
185 descarga un binario, siga las instrucciones contenidas en el
186 archivo <code>INSTALL.bindist</code> incluido en la
189 <p>Después de la descarga, es importante que verifique que el
190 archivo descargado del servidor HTTP Apache está completo y
191 sin modificaciones. Esto puede hacerlo comparando el archivo
192 descargado (.tgz) con su firma PGP. Instrucciones detalladas de
193 cómo hacer esto están disponibles en <a
194 href="http://httpd.apache.org/download.cgi#verify"> la
195 sección de descargas</a> junto con un ejemplo de cómo <a
196 href="http://httpd.apache.org/dev/verification.html">usar
201 <section id="extract"><title>Descomprimir</title>
203 <p>Extraer el código fuente del archivo .tgz del Servidor Apache HTTP que acabada
204 de descargar es muy fácil. Ejecute los siguientes comandos:</p>
207 $ gzip -d httpd-<em>NN</em>.tar.gz<br />
208 $ tar xvf httpd-<em>NN</em>.tar
211 <p>Estos comandos crearán un nuevo directorio dentro del
212 directorio en el que se encuentra y que contendrá el
213 código fuente de distribución. Debe cambiarse a ese
214 directorio con <code>cd</code> para proceder a compilar el
218 <section id="configure"><title>Configuración de la estructura de
221 <p>El siguiente paso es configurar la estructura de directorios
222 para su plataforma y sus necesidades personales. Esto se hace
223 usando el script <program>configure</program> incluido en el directorio
224 raíz de la distribución que acaba de descargar. (Los
225 desarrolladores que se descarguen la versión del CVS de la
226 estructura de directorios necesitarán tener instalados
227 <code>autoconf</code> y <code>libtool</code>, y necesitarán
228 ejecutar <code>buildconf</code> antes de continuar con los
229 siguientes pasos. Esto no es preciso para las versiones
232 <p>Para configurar la estructura de directorios a partir del
233 código fuente usando las opciones por defecto, solo tiene que
234 ejecutar <code>./configure</code>.Para cambiar las opciones por
235 defecto, <program>configure</program> acepta una serie de variables y
236 opciones por la línea de comandos.</p>
238 <p>La opción más importante es <code>--prefix</code>
239 que es el directorio en el que Apache va a ser instalado después,
240 porque Apache tiene que ser configurado para el directorio que se
241 especifique para que funcione correctamente. Es posible lograr un
242 mayor control del lugar donde se van a instalar los ficheros de
244 href="programs/configure.html#installationdirectories">opciones de
245 configuración</a>.</p>
247 <p>Llegados a este punto, puede especificar que <a
248 href="programs/configure.html#optionalfeatures">características
249 o funcionalidades</a> quiere incluir en Apache activando o
250 desactivando <a href="mod/">modules</a>.Apache vine con una amplia
251 selección de módulos incluidos por defecto. Que serán compilados como .
252 <a href="dso.html">Objetos Compartidos (DSOs)</a> Que pueden ser activados
253 o desactivados en tiempo de ejecución.
254 También puede elegir por compilar módulos de forma estática usando las opciones
255 <code>--enable-<var>module</var>=static</code>.</p>
259 <p>Se pueden activar otros módulos usando la opción
260 <code>--enable-<var>module</var></code>, where
261 <var>module</var> es el nombre del módulo sin el
262 <code>mod_</code> y convirtiendo los guiones bajos que tenga en
263 guiones normales. Del mismo modo, puede desactivar los módulos con la
264 opción <code>--disable-<var>module</var></code>. Tenga cuidado al utilizar esta opción, ya que
265 <program>configure</program> no le avisará si el módulo que especifica no existe;
266 simplemente ignorará esa opción.</p>
268 <p>Además, a veces es necesario pasarle al script
269 <program>configure</program> información adicional sobre donde esta
270 su compilador, librerías o ficheros de cabecera. Esto se puede
271 hacer, tanto pasando variables de entorno, como pasandole opciones
272 a <program>configure</program>. Para más información, consulte el manual de
273 <program>configure</program>. O use <program>configure</program> con la
274 opción <code>--help</code>.</p>
276 <p>Para que se haga una idea sobre las posibilidades que tiene,
277 aquí tiene un ejemplo típico que configura Apache para
278 la ruta <code>/sw/pkg/apache</code> con un compilador y unos flags
279 determinados, y además, con dos módulos adicionales
280 <module>mod_ldap</module> y <module>mod_ldap</module> para
281 cargarlos después a través del mecanismo DSO:</p>
284 $ CC="pgcc" CFLAGS="-O2" \<br />
285 ./configure --prefix=/sw/pkg/apache \<br />
286 --enable-ldap=shared \<br />
290 <p>Cuando se ejecuta <program>configure</program> se comprueban que
291 características o funcionalidades están disponibles en
292 su sistema y se crean los Makefiles que serán usados a continuación
293 para compilar el servidor. Esto tardará algunos minutos.</p>
295 <p>Los detalles de todas las opciones de <program>configure</program> están disponibles
296 en el manual de <program>configure</program> .</p>
298 <section id="compile"><title>Build</title>
300 <p>Ahora puede compilar las diferentes partes que forman Apache
301 simplemente ejecutando el siguiente comando:</p>
303 <example>$ make</example>
305 <p>Por favor sea paciente llegado a este punto, ya que una configuración básica lleva unos minutos
306 para su compilación, y el tiempo puede variar mucho dependiendo de su hardware
307 y del número de módulos que haya habilitado para la compilación.(Se recomienda añadir al make el
308 parámetro -j3 como mínimo para que vaya más rápido)</p>
311 <section id="install"><title>Instalar</title>
313 <p>Ahora es el momento de instalar el paquete en el diretorio
314 elegido en <em>PREFIX</em> (consulte más arriba la opción
315 <code>--prefix</code>) ejecutando:</p>
317 <example>$ make install</example>
319 <p>Este paso requiere de forma típica privilegios de root, ya que
320 el directorio de <em>PREFIX</em> es normalmente un directorio con
321 restricciones de permisos escritura.</p>
323 <p>Si lo que esta es sólo actualizando, la instalación no sobreescribirá los
324 archivos de configuración.</p>
327 <section id="customize"><title>Personalizar APACHE</title>
329 <p>Tras la instalación puede personalizarla, editando los
330 <a href="configuring.html">archivos de configuracion </a> en el directorio de
331 <code><em>PREFIX</em>/conf/</code>.</p>
333 <example>$ vi <em>PREFIX</em>/conf/httpd.conf</example>
335 <p>Échele un vistazo al Manual de Apache que está en
336 <code><em>PREFIX</em>/docs/manual/</code> o consulta <a
337 href="http://httpd.apache.org/docs/&httpd.docs;/"
338 >http://httpd.apache.org/docs/&httpd.docs;/</a> para la versión más
339 reciente de este manual y su completa
340 referencia de las <a href="mod/directives.html">directivas de configuracion</a> disponibles.</p>
343 <section id="test"><title>Comprobar que la instalación
346 <p>Ahora puedes <a href="invoking.html">ejecutar</a> tu Apache
347 HTTP server ejecutando directamente:</p>
349 <example>$ <em>PREFIX</em>/bin/apachectl -k start</example>
351 <p>Ahora debe poder acceder a su primer documento
352 bajo la URL <code>http://localhost/</code>. La página o documento que ve se encuentra en
353 <directive module="core">DocumentRoot</directive>,
354 que por norma general casi siempre será <code><em>PREFIX</em>/htdocs/</code>.
355 Si quiere <a href="stopping.html">parar</a> el servidor, puede hacerlo ejecutando:</p>
357 <example>$ <em>PREFIX</em>/bin/apachectl -k stop</example>
359 <section id="upgrading"><title>Actualizar una instalación previa</title>
361 <p>El primer paso para actualizar una instalación anterior es
362 leer las especificaciones de la versión y el fichero
363 <code>CHANGES</code> en la distribución de código fuente
364 que ha descargado para encontrar los cambios que puedan afectar a
365 su instalación actual. Cuando el cambio sea entre versiones
366 mayores(por ejemplo, de la 2.0 a 2.2 o de la 2.2 a la 2.4),
367 entonces es más probable que haya diferencias importantes en
368 la compilación y en la ejecución que necesitarán
369 ajustes manuales. Todos los módulos necesitarán
370 también ser actualizados para adaptarse a los cambios en el
371 interfaz de programación (API) de módulos.</p>
373 <p>Actualizando de una versión menor a la siguiente
374 (por ejemplo, de la 2.2.55 a la 2.2.57) es mas fácil. El prodeso de realizar el <code>make install</code>
375 no sobreescribirá ninguno de tus documentos existentes,archivos
376 log, o archivos de configuración. De hecho, los desarrolladores están haciendo los esfuerzos
377 necerarios para evitar cambios que generen incompatibilidades en las opciones de
378 <program>configure</program>, la configuración al ser ejecutado, o el módulo de la API
379 entre versiones menores. En la mayor parte de los casos debe poder usar un
380 comando <program>configure</program> idéntico, un fichero de
381 configuración idéntico, y todos sus módulos deben
382 seguir funcionando.</p>
384 <p>Para actualizar entre versiones menores, empecemos encontrando el archivo de configuración
385 <code>config.nice</code> el directorio <code>de instalación</code> del servidor
386 o en el directorio raiz del código fuente de tu antigua instalación. Este archivo contendrá
387 los parámetros exactos para pasarle al
388 <program>configure</program> que usaste anteriormente para configurar tus directorios.
389 Entonces, para actualizar su instalación de una versión a la
390 siguinete, solo tiene que copiar el archivo
391 <code>config.nice</code> a la estructura de directorios del
392 código fuente de la nueva versión, editarlo, hacer
393 cualquier cambio que desee, y ejecutarlo :</p>
396 $ ./config.nice<br />
399 $ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
400 $ <em>PREFIX</em>/bin/apachectl -k start<br />
403 <note type="warning">Tenga en cuenta que antes de poner una nueva
404 versión de Apache en producción, debe siempre probarla
405 antes en un entorno de pruebas. Por ejemplo, puede instalar y ejecutar la
406 nueva versión junto con la antigua usando un
407 <code>--prefix</code> diferente y un puerto diferente (modificando
408 la directiva <directive module="mpm_common">Listen</directive>)
409 para comprobar que no existe ninguna incompatibilidad antes de
410 hacer la actualización definitiva.</note>
412 <p>Puede pasarle argumentos adicionales a <code>config.nice</code>,
413 que se agregarán a susopciones originales de <program>configure</program>:</p>
416 $ ./config.nice --prefix=/home/test/apache --with-port=90
419 <section id="thirdp"><title>Paquetes de terceros</title>
421 <p>Un gran número de terceros proporcionan sus propias
422 distribuciones empaquetadas del Apache HTTP Server para su
423 instalación en plataformas específicas. Esto incluye las distintas
424 distribuciones de Linux, varios paquetes de Windows de terceros,
425 Mac OS X, Solaris, y muchos más.</p>
427 <p>Nuestra licencia de software no sólo permite, sino que anima,
428 este tipo de redistribución. Sin embargo, se da lugar a una situación
429 en la que el diseño y la configuración de los valores predeterminados
430 de la instalación del servidor pueden diferir de lo que se indica
431 en la documentación. Mientras lamentablemente, esta situación no es probable que cambie a corto plazo.</p>
434 href="http://wiki.apache.org/httpd/DistrosDefaultLayout">descripción
435 de estas distribuciones de terceros </a> está siendo actualizada en el servidor de la WIKI de HTTP
436 Server, y debería reflejar el actual estado de éstas distribuciones de terceros.
437 Sin embargo, tendrá que familiarizarse con los procedimientos de gestión
438 e instalación de paquetes de su plataforma (SO) en particular.</p>