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: 1685411 -->
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 documentacion 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><code>$ lynx http://httpd.apache.org/download.cgi</code>
64 <td><a href="#extract">Extrae</a></td>
66 <td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
67 $ tar xvf httpd-<em>NN</em>.tar<br />
68 $ cd httpd-<em>NN</em></code></td>
72 <td><a href="#configure">Configura</a></td>
74 <td><code>$ ./configure --prefix=<em>PREFIX</em></code>
79 <td><a href="#compile">Compila</a></td>
81 <td><code>$ make</code> </td>
85 <td><a href="#install">Instala</a></td>
87 <td><code>$ make install</code> </td>
91 <td><a href="#customize">Personalizalo</a></td>
93 <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
97 <td><a href="#test">Prueba</a></td>
99 <td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
104 <p><em>NN</em> hay que reemplazarlo por el número de la versión menor, and <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>
106 <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>
109 <section id="requirements"><title>Requisitos</title>
111 <p>Estos son los requisitos necesarios para compilar Apache:</p>
114 <dt>APR y APR-Util</dt>
115 <dd>Asegurate 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
116 <a href="http://apr.apache.org/">Apache APR</a>, descomprimelo en
117 <code>/httpd_source_tree_root/srclib/apr</code> y /httpd_source_tree_root<code>/srclib/apr-util</code>
118 (cerciorate de que no existen directorios con números de versiones; por ejemplo,
119 la distribución de APR debe estar en /httpd_source_tree_root/srclib/apr/) y usa el comando
120 <code>./configure</code> <code>--con-las-opciones-incluidas-en-apr</code>.
121 En algunas plataformas deberás instalar la parte correspondiente a los paquetes
122 <code>-dev</code> para permitir que httpd se genere contra la instalación de la copia de APR y APR-Util.</dd>
124 <dt>Libreria Compatible de expresiones regulares de Perl (PCRE)</dt>
125 <dd>Esta libreria es requerida, pero ya no incluido con httpd.
126 Descarga el código fuente de <a href="http://www.pcre.org/">http://www.pcre.org</a>,
127 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,
128 deberás instalar la corespondiente versión <code>-dev</code>
129 del paquete para permitir a httpd que se genere contra la instalación de la copia del PCRE que se ha instalado.</dd>
131 <dt>Espacio en disco</dt>
132 <dd>Compruebe que tiene disponibles al
133 menos 50 MB de espacio libre en disco. Después de la
134 instalación, Apache ocupa aproximadamente 10 MB. No
135 obstante, la necesidad real de espacio en disco varía
136 considerablemente en función de las opciones de
137 configuración que elija y de los módulos externos que
138 use, y como no del tamaño de la página web</dd>
140 <dt>ANSI-C Compiler and Build System</dt>
141 <dd>Compruebe que tiene instalado un compilador de ANSI-C. Se recomienda el <a href="http://gcc.gnu.org/">Compilador GNU C
142 (GCC)</a> de la <a href="http://www.gnu.org/">Free Software
143 Foundation (FSF)</a> es el recomendado. Si no tiene instaldo el GCC, entonces compruebe que
144 el compilador que va a utilizar cumple con los estándares
145 ANSI. Además, su <code>PATH</code> debe contener la
146 ubicación donde de encuentran las herramientas básicas
147 para compilar tales como <code>make</code>.</dd>
149 <dt>Ajuste exacto del reloj del sistema</dt>
151 del protocolo HTTP están expresados según la hora del
152 día. Por eso, si quiere puede investigar como instalar alguna
153 utilidad para sincronizar la hora de su sistema. Para esto,
154 normalmente, se usan los programas <code>ntpdate</code> o
155 <code>xntpd</code>, que están basados en el protocolo
156 Network Time Protocol (NTP). Consulte el<a href="http://www.ntp.org">sitio web de NTP
157 </a> para obtener más información sobre NTP y los
158 servidores públicos de tiempo.</dd>
160 <dt><a href="http://www.perl.org/">Perl 5</a>[OPCIONAL]</dt>
161 <dd>Para algunos de los scripts de soporte como<program>
162 apxs</program> o <program>dbmmanage</program> (que están
163 escritos en Perl) es necesario el intérprete de Perl 5 (las
164 versiones 5.003 o posteriores son suficientes). Si el escript
165 <program>configure</program> no se encuentra, no podrá usar los
166 escripts correspondientes que lo necesiten. Pero porsupuesto
167 podrás compilar y usar Apache httpd.</dd>
171 <section id="download"><title>Descargar</title>
173 <p>Puede descargar Apache desde <a
174 href="http://httpd.apache.org/download.cgi">la sección de
175 descargas del sitio web de Apache</a> el cual tiene varios
176 mirrors. Para la mayoría de los usuarios de Apache que tienen
177 sistemas tipo Unix, se recomienda que se descarguen y compilen el
178 código fuente. El proceso de compilación (descrito
179 más abajo) es fácil, y permite adaptar el servidor
180 Apache a sus necesidades. Además, las versiones de
181 disponibles en archivos binarios no están siempre actulizadas
182 con las últimas modificaciones en el codigo fuente. Si se
183 descarga un binario, siga las instrucciones contenidas en el
184 archivo <code>INSTALL.bindist</code> incluido en la
187 <p>Después de la descarga, es importante que verifique que el
188 archivo descargado del servidor HTTP Apache está completo y
189 sin modificaciones. Esto puede hacerlo comparando el archivo
190 descargado (.tgz) con su firma PGP. Instrucciones detalladas de
191 cómo hacer esto están disponibles en <a
192 href="http://httpd.apache.org/download.cgi#verify"> la
193 sección de descargas</a> junto con un ejemplo de cómo <a
194 href="http://httpd.apache.org/dev/verification.html">usar
199 <section id="extract"><title>Descomprimir</title>
201 <p>Extraer el código fuente del archivo .tgz del Servidor Apache HTTP que acabada
202 de descargar es muy fácil. Ejecute los siguientes comandos:</p>
205 $ gzip -d httpd-<em>NN</em>.tar.gz<br />
206 $ tar xvf httpd-<em>NN</em>.tar
209 <p>Estos comandos crearán un nuevo directorio dentro del
210 directorio en el que se encuentra y que contendrá el
211 código fuente de distribución. Debe cambiarse a ese
212 directorio con <code>cd</code> para proceder a compilar el
216 <section id="configure"><title>Configuración de la estructura de
219 <p>El siguiente paso es configurar la estructura de directorios
220 para su plataforma y sus necesidades personales. Esto se hace
221 usando el script <program>configure</program> incluido en el directorio
222 raiz de la distribución que acaba de descargar. (Los
223 desarrolladores que se descarguen la versión del CVS de la
224 estructura de directorios necesitarán tener instalados
225 <code>autoconf</code> y <code>libtool</code>, y necesitarán
226 ejecutar <code>buildconf</code> antes de continuar con los
227 siguientes pasos. Esto no es preciso para las versiones
230 <p>Para configurar la estructura de directorios a partir del
231 código fuente usando las opciones por defecto, solo tiene que
232 ejecutar <code>./configure</code>.Para cambiar las opciones por
233 defecto, <program>configure</program> acepta una serie de variables y
234 opciones por la línea de comandos.</p>
236 <p>La opción más importante es <code>--prefix</code>
237 que es el directorio en el que Apache va a ser instalado después,
238 porque Apache tiene que ser configurado para el directorio que se
239 especifique para que funcione correctamente. Es posible lograr un
240 mayor control del lugar donde se van a instalar los ficheros de
242 href="programs/configure.html#installationdirectories">opciones de
243 configuración</a>.</p>
245 <p>Llegados a este punto, puede especificar que <a
246 href="programs/configure.html#optionalfeatures">características
247 o funcionalidades</a> quiere incluir en Apache activando o
248 desactivando <a href="mod/">modules</a>.Apache vine con una amplia
249 selección de módulos incluidos por defecto. Que serán compilados como .
250 <a href="dso.html">Objetos Compartidos (DSOs)</a> Que pueden ser activados
251 o desactivados en tiempo de ejecución.
252 También puede elegir por compilar módulos de forma estática usando las opciones
253 <code>--enable-<var>module</var>=static</code>.</p>
257 <p>Se pueden activar otros módulos usando la opción
258 <code>--enable-<var>module</var></code>, where
259 <var>module</var> es el nombre del módulo sin el
260 <code>mod_</code> y convirtiendo los guiones bajos que tenga en
261 guiones normales. Del mismo modo, puede desactivar los módulos con la
262 opción <code>--disable-<var>module</var></code>. Tenga cuidado al utilizar esta opción, ya que
263 <program>configure</program> no le avisará si el módulo que especifica no existe;
264 simplemente ignorará esa opción.</p>
266 <p>Además, a veces es necesario pasarle al script
267 <program>configure</program> información adicional sobre donde esta
268 su compilador, librerias o ficheros de cabecera. Esto se puede
269 hacer, tanto pasando variables de entorno, como pasandole opciones
270 a <program>configure</program>. Para más información, consulte el manual de
271 <program>configure</program>. O use <program>configure</program> con la
272 opción <code>--help</code> option.</p>
274 <p>Para que se haga una idea sobre las posibilidades que tiene,
275 aquí tiene un ejemplo típico que configura Apache para
276 la ruta <code>/sw/pkg/apache</code> con un compilador y unos flags
277 determinados, y además, con dos módulos adicionales
278 <module>mod_ldap</module> y <module>mod_ldap</module> para
279 cargarlos después a través del mecanismo DSO:</p>
282 $ CC="pgcc" CFLAGS="-O2" \<br />
283 ./configure --prefix=/sw/pkg/apache \<br />
284 --enable-ldap=shared \<br />
288 <p>Cuando se ejecuta <program>configure</program> se comprueban que
289 características o funcionalidades están disponibles en
290 su sistema y se crean los Makefiles que serán usados a continuación
291 para compilar el servidor. Esto tardará algunos minutos.</p>
293 <p>Los detalles de todas las opciones de <program>configure</program> estan disponibles
294 en el manual de <program>configure</program> .</p>
296 <section id="compile"><title>Build</title>
298 <p>Ahora puede compilar las diferentes partes que forman Apache
299 simplemente ejecutando el siguiente comando:</p>
301 <example>$ make</example>
303 <p>Por favor sea paciente llegado a este punto, ya que una configuración básica lleva unos minutos
304 para su compilación, y el tiempo puede variar mucho dependiendo de su hardware
305 y del número de módulos que haya habilitado para la compilación.(Se recomienda añadir al make el
306 parámetro -j3 como mínimo para que vaya más rápido)</p>
309 <section id="install"><title>Instalar</title>
311 <p>Ahora es el momento de instalar el paquete en el diretorio
312 elegido en <em>PREFIX</em> (consulte más arriba la opción
313 <code>--prefix</code>) ejecutando:</p>
315 <example>$ make install</example>
317 <p>Este paso requiere de forma tipica privilegios de root, ya que
318 el directorio de <em>PREFIX</em> es normalmente un directorio con
319 restricciones de permisos escritura.</p>
321 <p>Si lo que esta es sólo actualizando, la instalación no sobreescribirá los
322 archivos de configuración.</p>
325 <section id="customize"><title>Personalizar APACHE</title>
327 <p>Tras la instalación puede personalizarla, editando los
328 <a href="configuring.html">archivos de configuracion </a> en el directorio de
329 <code><em>PREFIX</em>/conf/</code>.</p>
331 <example>$ vi <em>PREFIX</em>/conf/httpd.conf</example>
333 <p>Échele un vistazo al Manual de Apache que está en
334 <code><em>PREFIX</em>/docs/manual/</code> o consulta <a
335 href="http://httpd.apache.org/docs/&httpd.docs;/"
336 >http://httpd.apache.org/docs/&httpd.docs;/</a> para la versión más
337 reciente de este manual y su completa
338 referencia de las <a href="mod/directives.html">directivas de configuracion</a> disponibles.</p>
341 <section id="test"><title>Comprobar que la instalación
344 <p>Ahora puedes <a href="invoking.html">ejecutar</a> tu Apache
345 HTTP server ejecutando directamente:</p>
347 <example>$ <em>PREFIX</em>/bin/apachectl -k start</example>
349 <p>Ahora debe poder acceder a su primer documento
350 bajo la URL <code>http://localhost/</code>. La página o documento que ve se encuentra en
351 <directive module="core">DocumentRoot</directive>,
352 que por norma general casi siempre será <code><em>PREFIX</em>/htdocs/</code>.
353 Si quiere <a href="stopping.html">parar</a> el servidor, puede hacerlo ejecutando:</p>
355 <example>$ <em>PREFIX</em>/bin/apachectl -k stop</example>
357 <section id="upgrading"><title>Actualizar una instalación previa</title>
359 <p>El primer paso para actualizar una instalación anterior es
360 leer las especificaciones de la versión y el fichero
361 <code>CHANGES</code> en la distribución de código fuente
362 que ha descargado para encontrar los cambios que puedan afectar a
363 su instalación actual. Cuando el cambio sea entre versiones
364 mayores(por ejemplo, de la 2.0 a 2.2 o de la 2.2 a la 2.4),
365 entonces es más probable que haya diferencias importantes en
366 la compilación y en la ejecución que necesitarán
367 ajustes manuales. Todos los módulos necesitarán
368 también ser actualizados para adaptarse a los cambios en el
369 interfaz de programación (API) de módulos.</p>
371 <p>Actualizando de una versión menor a la siguiente
372 (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>
373 no sobreescribirá ninguno de tus documentos existentes,archivos
374 log, o archivos de configuración. De hecho, los desarrolladores están haciendo los esfuerzos
375 necerarios para evitar cambios que generen incompatibilidades en las opciones de
376 <program>configure</program>, la configuración al ser ejecutado, o el módulo de la API
377 entre versiones menores. En la mayor parte de los casos debe poder usar un
378 comando <program>configure</program> idéntico, un fichero de
379 configuración idéntico, y todos sus módulos deben
380 seguir funcionando.</p>
382 <p>Para actualizar entre versiones menores, empecemos encontrando el archivo de configuración
383 <code>config.nice</code> el directorio <code>de instalación</code> del servidor
384 o en el directorio raiz del código fuente de tu antigua instalación. Este archivo contendrá
385 los parámetros exactos para pasarle al
386 <program>configure</program> que usaste anteriormente para configurar tus directorios.
387 Entonces, para actualizar su instalación de una versión a la
388 siguinete, solo tiene que copiar el archivo
389 <code>config.nice</code> a la estructura de directorios del
390 código fuente de la nueva versión, editarlo, hacer
391 cualquier cambio que desee, y ejecutarlo :</p>
394 $ ./config.nice<br />
397 $ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
398 $ <em>PREFIX</em>/bin/apachectl -k start<br />
401 <note type="warning">Tenga en cuenta que antes de poner una nueva
402 versión de Apache en producción, debe siempre probarla
403 antes en un entorno de pruebas. Por ejemplo, puede instalar y ejecutar la
404 nueva versión junto con la antigua usando un
405 <code>--prefix</code> diferente y un puerto diferente (modificando
406 la directiva <directive module="mpm_common">Listen</directive>)
407 para comprobar que no existe ninguna incompatibilidad antes de
408 hacer la actualización definitiva.</note>
410 <p>Puede pasarle argumentos adicionales a <code>config.nice</code>,
411 que se agregarán a susopciones originales de <program>configure</program>:</p>
414 $ ./config.nice --prefix=/home/test/apache --with-port=90
417 <section id="thirdp"><title>Paquetes de terceros</title>
419 <p>Un gran número de terceros proporcionan sus propias
420 distribuciones empaquetadas del Apache HTTP Server para su
421 instalación en plataformas específicas. Esto incluye las distintas
422 distribuciones de Linux, varios paquetes de Windows de terceros,
423 Mac OS X, Solaris, y muchos más.</p>
425 <p>Nuestra licencia de software no sólo permite, sino que anima,
426 este tipo de redistribución. Sin embargo, se da lugar a una situación
427 en la que el diseño y la configuración de los valores predeterminados
428 de la instalación del servidor pueden diferir de lo que se indica
429 en la documentación. Mientras lamentablemente, esta situación no es probable que cambie a corto plazo.</p>
432 href="http://wiki.apache.org/httpd/DistrosDefaultLayout">descripción
433 de estas distribuciones de terceros </a> está siendo actualizada en el servidor de la WIKI de HTTP
434 Server, y debería reflejar el actual estado de éstas distribuciones de terceros.
435 Sin embargo, tendrá que familiarizarse con los procedimientos de gestión
436 e instalación de paquetes de su plataforma (SO) en particular.</p>