1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>Compilación e Instalación - Servidor HTTP Apache</title>
9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
13 <body id="manual-page"><div id="page-header">
14 <p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="./faq/">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa de este sitio web</a></p>
15 <p class="apache">Versión 2.1 del Servidor HTTP Apache</p>
16 <img alt="" src="./images/feather.gif" /></div>
17 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
19 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs-project/">Documentación</a> > <a href="./">Versión 2.1</a></div><div id="page-content"><div id="preamble"><h1>Compilación e Instalación</h1>
21 <p><span>Idiomas disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
22 <a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
23 <a href="./es/install.html" title="Español"> es </a> |
24 <a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
25 <a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
29 <p>Este documento explica cómo compilar e instalar Apache en
30 sistemas Unix y tipo Unix. Para obtener información sobre
31 cómo compilar e instalar en Windows, consulte la sección
32 <a href="platform/windows.html">Usar Apache en Microsoft
33 Windows</a>. Para otras plataformas, consulte la
34 documentación sobre <a href="platform/">plataformas</a>.</p>
36 <p>El entorno de configuración e instalación de Apache
37 2.0 ha cambiado completamente respecto al de Apache 1.3. Apache
38 1.3 usaba un conjunto de scripts a medida para conseguir una
39 instalación fácil. Apache 2.0 usa <code>libtool</code> y
40 <code>autoconf</code> para crear un entorno más parecido al
41 de muchos otros proyectos Open Source.</p>
43 <p>Si lo que quiere hacer es actualizar su servidor Apache desde
44 una versión menor (por ejemplo, desde la 2.0.50 a la 2.0.51),
45 pase directamente a la sección de <a href="#upgrading">actualización</a>.</p>
48 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Visión general del proceso para
50 <li><img alt="" src="./images/down.gif" /> <a href="#requirements">Requisitos</a></li>
51 <li><img alt="" src="./images/down.gif" /> <a href="#download">Descargar</a></li>
52 <li><img alt="" src="./images/down.gif" /> <a href="#extract">Descomprimir</a></li>
53 <li><img alt="" src="./images/down.gif" /> <a href="#configure">Configuración de la estructura de
55 <li><img alt="" src="./images/down.gif" /> <a href="#compile">Compilar</a></li>
56 <li><img alt="" src="./images/down.gif" /> <a href="#install">Instalar</a></li>
57 <li><img alt="" src="./images/down.gif" /> <a href="#customize">Personalizar</a></li>
58 <li><img alt="" src="./images/down.gif" /> <a href="#test">Comprobar que la instalación
60 <li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Actualizar una instalación
62 </ul><h3>Consulte también</h3><ul class="seealso"><li><a href="programs/configure.html">Configuración de la
63 estructura de directorios</a></li><li><a href="invoking.html">Iniciar Apache</a></li><li><a href="stopping.html">Parar y reiniciar Apache</a></li></ul></div>
64 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
66 <h2><a name="overview" id="overview">Visión general del proceso para
72 <td><a href="#download">Descargar</a></td>
74 <td><code>$ lynx http://httpd.apache.org/download.cgi</code>
79 <td><a href="#extract">Descomprimir</a></td>
81 <td><code>$ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
82 $ tar xvf httpd-2_1_<em>NN</em>.tar</code> </td>
86 <td><a href="#configure">Ejecutar el script configure</a></td>
88 <td><code>$ ./configure --prefix=<em>PREFIX</em></code>
93 <td><a href="#compile">Compilar</a></td>
95 <td><code>$ make</code> </td>
99 <td><a href="#install">Instalar</a></td>
101 <td><code>$ make install</code> </td>
105 <td><a href="#customize">Personalizar</a></td>
107 <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
111 <td><a href="#test">Comprobar que la instalación
114 <td><code>$ <em>PREFIX</em>/bin/apachectl start</code>
119 <p><em>NN</em> hay que reemplazarlo por el número de la
120 versión menor, y <em>PREFIX</em> hay que reemplazarlo por la
121 ruta en la que se va a instalar Apache. Si no especifica
122 ningún valor en <em>PREFIX</em>, el valor por defecto que se
123 toma es <code>/usr/local/apache2</code>.</p>
125 <p>Cada parte del proceso de configuración e instalación
126 se describe detalladamente más abajo, empezando por los
127 requisitos para compilar e instalar Apache.</p>
128 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
129 <div class="section">
130 <h2><a name="requirements" id="requirements">Requisitos</a></h2>
132 <p>Estos son los requisitos necesarios para compilar Apache:</p>
135 <dt>Espacio en disco</dt> <dd>Compruebe que tiene disponibles al
136 menos 50 MB de espacio libre en disco. Después de la
137 instalación, Apache ocupa aproximadamente 10 MB. No
138 obstante, la necesidad real de espacio en disco varía
139 considerablemente en función de las opciones de
140 configuración que elija y de los módulos externos que
143 <dt>Compilador ANSI-C y Build System</dt> <dd>Compruebe que
144 tiene instalado un compilador de ANSI-C. Se recomienda el <a href="http://www.gnu.org/software/gcc/gcc.html">Compilador GNU C
145 (GCC)</a> de la <a href="http://www.gnu.org/">Free Software
146 Foundation (FSF)</a> (con la versión 2.7.2 es
147 suficiente). Si no tiene instaldo el GCC, entonces compruebe que
148 el compilador que va a utilizar cumple con los estándares
149 ANSI. Además, su <code>PATH</code> debe contener la
150 ubicación donde de encuentran las herramientas básicas
151 para compilar tales como <code>make</code>.</dd>
153 <dt>Ajuste exacto del reloj del sistema</dt> <dd>Los elementos
154 del protocolo HTTP están expresados según la hora del
155 dia. Por eso, si quiere puede investigar como instalar alguna
156 utilidad para sincronizar la hora de su sistema. Para esto,
157 normalmente, se usan los programas <code>ntpdate</code> o
158 <code>xntpd</code>, que están basados en el protocolo
159 Network Time Protocol (NTP). Consulte el grupo de noticias <a href="news:comp.protocols.time.ntp">comp.protocols.time.ntp</a>
160 y el <a href="http://www.eecis.udel.edu/~ntp/">sitio web de NTP
161 </a> para obtener más información sobre NTP y los
162 servidores públicos de tiempo.</dd>
164 <dt><a href="http://www.perl.org/">Perl 5</a> [OPCIONAL]</dt>
165 <dd>Para algunos de los scripts de soporte como <a href="programs/apxs.html">apxs</a> o <a href="programs/dbmmanage.html">dbmmanage</a> (que están
166 escritos en Perl) es necesario el intérprete de Perl 5 (las
167 versiones 5.003 o posteriores son suficientes). Si el script
168 `<code>configure</code>' no encuentra ese intérprete
169 tampoco pasa nada. Aún puede compilar e instalar Apache
170 2.0. Lo único que ocurrirá es que esos scripts de
171 soporte no podrán ser usados. Si usted tiene varios
172 interpretes de Perl instalados (quizás Perl 4 porque estaba
173 ya incluido en su distribución de Linux y Perl 5 porque lo
174 ha instalado usted), entonces se recomienda usar la opción
175 <code>--with-perl</code> para asegurarse de que
176 <code>./configure</code> usa el intérprete correcto.</dd>
178 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
179 <div class="section">
180 <h2><a name="download" id="download">Descargar</a></h2>
182 <p>Puede descargar Apache desde <a href="http://httpd.apache.org/download.cgi">la sección de
183 descargas del sitio web de Apache</a> el cual tiene varios
184 mirrors. Para la mayoría de los usuarios de Apache que tienen
185 sistemas tipo Unix, se recomienda que se descarguen y compilen el
186 código fuente. El proceso de compilación (descrito
187 más abajo) es fácil, y permite adaptar el servidor
188 Apache a sus necesidades. Además, las versiones de
189 disponibles en archivos binarios no están siempre actulizadas
190 con las últimas modificaciones en el codigo fuente. Si se
191 descarga un binario, siga las instrucciones contenidas en el
192 archivo <code>INSTALL.bindist</code> incluido en la
195 <p>Después de la descarga, es importante que verifique que el
196 archivo descargado del servidor HTTP Apache está completo y
197 sin modificaciones. Esto puede hacerlo comparando el archivo
198 descargado (.tgz) con su firma PGP. Instrucciones detalladas de
199 cómo hacer esto están disponibles en <a href="http://httpd.apache.org/download.cgi#verify"> la
200 sección de descargas</a> junto con un ejemplo de cómo <a href="http://httpd.apache.org/dev/verification.html">usar
203 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
204 <div class="section">
205 <h2><a name="extract" id="extract">Descomprimir</a></h2>
207 <p>Extraer el código fuente del archivo .tgz que acabada de
208 descargar es muy fácil. Ejecute los siguientes comandos:</p>
210 <div class="example"><p><code>
211 $ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
212 $ tar xvf httpd-2_1_<em>NN</em>.tar
215 <p>Estos comandos crearán un nuevo directorio dentro del
216 directorio en el que se encuentra y que contendrá el
217 código fuente de la distribución. Debe cambiarse a ese
218 directorio con <code>cd</code> para proceder a compilar el
221 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
222 <div class="section">
223 <h2><a name="configure" id="configure">Configuración de la estructura de
226 <p>El siguiente paso es configurar la estructura de directorios
227 para su plataforma y sus necesidades personales. Esto se hace
228 usando el script <code>configure</code> incluido en el directorio
229 raiz de la distribución que acaba de descargar. (Los
230 desarrolladores que se descarguen la versión del CVS de la
231 estructura de directorios necesitarán tener instalados
232 <code>autoconf</code> y <code>libtool</code>, y necesitarán
233 ejecutar <code>buildconf</code> antes de continuar con los
234 siguientes pasos. Esto no es preciso para las versiones
237 <p>Para configurar la estructura de directorios a partir del
238 código fuente usando las opciones por defecto, solo tiene que
239 ejecutar <code>./configure</code>. Para cambiar las opciones por
240 defecto, <code>configure</code> acepta una serie de variables y
241 opciones por la línea de comandos.</p>
243 <p>La opción más importante es <code>--prefix</code> que
244 es el directorio en el que Apache va a ser instalado después,
245 porque Apache tiene que ser configurado para el directorio que se
246 especifique para que funcione correctamente. Es posible lograr un
247 mayor control del lugar donde se van a instalar los ficheros de
248 Apache con otras <a href="programs/configure.html#installationdirectories">opciones de
249 configuración</a>.</p>
251 <p>En este momento, puede especificar que <a href="programs/configure.html#optionalfeatures">características
252 o funcionalidades</a> quiere incluir en Apache activando o
253 desactivando <a href="mod/">módulos</a>. Apache viene con
254 una <a href="mod/module-dict.html#Status">selección
255 básica</a> de módulos incluidos por defecto. Se pueden
256 activar otros módulos usando la opción
257 <code>--enable-<var>module</var></code>, donde <var>module</var>
258 es el nombre del módulo sin el <code>mod_</code> y
259 convirtiendo los guiones bajos que tenga en guiones normales.
260 También puede optar por compilar módulos como <a href="dso.html">objetos dinámicos compartidos (DSOs)</a> --
261 que pueden ser activados o desactivados al ejecutar -- usando la
262 opción <code>--enable-<var>module</var>=shared</code>. De
263 igual manera, puede desactivar alguno de los módulos que
264 vienen por defecto en la selección basica con la opción
265 <code>--disable-<var>module</var></code>. Tenga cuidado cuando
266 use estas opciones, porque <code>configure</code> no le
267 avisará si el módulo que especifica no existe;
268 simplemente ignorará esa opción.</p>
270 <p>Además, a veces es necesario pasarle al script
271 <code>configure</code> información adicional sobre donde esta
272 su compilador, librerias o ficheros de cabecera. Esto se puede
273 hacer, tanto pasando variables de entorno, como pasandole opciones
274 a <code>configure</code> a través de la línea de
275 comandos. Para más información, consulte el <a href="programs/configure.html">Manual del script
278 <p>Para que se haga una idea sobre las posibilidades que tiene,
279 aquí tiene un ejemplo típico que configura Apache para
280 la ruta <code>/sw/pkg/apache</code> con un compilador y unos flags
281 determinados, y además, con dos módulos adicionales
282 <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> y <code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> para
283 cargarlos después a través del mecanismo DSO:</p>
285 <div class="example"><p><code>
286 $ CC="pgcc" CFLAGS="-O2" \<br />
287 ./configure --prefix=/sw/pkg/apache \<br />
288 --enable-rewrite=shared \<br />
289 --enable-speling=shared
292 <p>Cuando se ejecuta <code>configure</code> se comprueban que
293 características o funcionalidades están disponibles en
294 su sistema y se crean los Makefiles que serán usados luego
295 para compilar el servidor. Esto tardará algunos minutos.</p>
297 <p>La información sobre todas las opciones de
298 <code>configure</code> está disponible en el <a href="programs/configure.html">Manual del script
301 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
302 <div class="section">
303 <h2><a name="compile" id="compile">Compilar</a></h2>
305 <p>Ahora puede compilar las diferentes partes que forman Apache
306 simplemente ejecutando el siguiente comando:</p>
308 <div class="example"><p><code>$ make</code></p></div>
310 <p>Por favor, tanga un poco de paciencia ahora, porque una
311 configuración básica tarda aproximadamente 3 minutos en
312 compilar en un Pentium III con un sistema Linux 2.2, pero este
313 tiempo puede variar considerablemente en función de su
314 hardware y del número de módulos que haya
316 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
317 <div class="section">
318 <h2><a name="install" id="install">Instalar</a></h2>
320 <p>Ahora es el momento de instalar el paquete en el diretorio
321 elegido en <em>PREFIX</em> (consulte la opción
322 <code>--prefix</code> más arriba) ejecutando:</p>
324 <div class="example"><p><code>$ make install</code></p></div>
326 <p>Si usted está solo actualizando una instalación
327 anterior, la nueva instalación no sobreescribirá sus
328 ficheros de configuración ni otros documentos.</p>
329 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
330 <div class="section">
331 <h2><a name="customize" id="customize">Personalizar</a></h2>
333 <p>El paso siguiente, es personalizar su servidor Apache editando
334 los <a href="configuring.html">ficheros de configuración</a>
335 que están en <code><em>PREFIX</em>/conf/</code>.</p>
337 <div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
339 <p>échele un vistazo al Manual de Apache que está en <a href="./">docs/manual/</a> o consulte en <a href="http://httpd.apache.org/docs-2.1/">http://httpd.apache.org/docs-2.1/</a> la versión más
340 reciente de este manual y la Guia de Referencia de todas las <a href="mod/directives.html">directivas de configuración</a>
342 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
343 <div class="section">
344 <h2><a name="test" id="test">Comprobar que la instalación
347 <p>Ahora puede <a href="invoking.html">iniciar</a> su servidor
348 Apache cuando quiera ejecutando:</p>
350 <div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl start</code></p></div>
352 <p>y entonces debe poder acceder al documento que tenga
353 especificado por defecto usando el siguiente URL:
354 <code>http://localhost/</code>. El documento que verá
355 estará en <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> y
356 casi siempre estará en <code><em>PREFIX</em>/htdocs/</code>.
357 Si quiere <a href="stopping.html">parar</a> el servidor, puede
358 hacerlo ejecutando:</p>
360 <div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl stop</code></p></div>
361 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
362 <div class="section">
363 <h2><a name="upgrading" id="upgrading">Actualizar una instalación
366 <p>El primer paso para actualizar una instalación anterior es
367 leer las especificaciones de la versión y el fichero
368 <code>CHANGES</code> en la distribución de código fuente
369 que ha descargado para encontrar los cambios que puedan afectar a
370 su instalación actual. Cuando el cambio sea entre versiones
371 mayores (por ejemplo, de la 1.3 a la 2.0 o de la 2.0 a la 2.2),
372 entonces es más probable que haya diferencias importantes en
373 la compilación y en la ejecución que necesitarán
374 ajustes manuales. Todos los módulos necesitarán
375 también ser actualizados para adaptarse a los cambios en el
376 interfaz de programación (API) de módulos.</p>
378 <p>La actualización cuando el cambio es entre versiones
379 menores (por ejemplo, de la 2.0.55 a la 2.0.57) es más
380 fácil. El proceso <code>make install</code> no
381 sobreescribirá ninguno de los documentos existentes, archivos
382 log, o archivos de configuración. Además, los
383 desarrolladores hacen todos los esfuerzos posibles para evitar
384 cambios que generen incompatibilidades en las opciones de
385 <code>configure</code>, en la configuración de la
386 ejecución o en la interfaz de programación de
387 módulos. En la mayor parte de los casos debe poder usar un
388 comando <code>configure</code> idéntico, un fichero de
389 configuracién idéntico, y todos sus módulos deben
390 seguir funcionando. (Esto es válido solo para versiones
391 posteriores a la 2.0.41; las versiones anteriores contienen
392 cambios incompatibles.)</p>
394 <p>Si va a conservar la estructura de directorios de su anterior
395 instalación, la actualización es más fácil
396 incluso. El fichero <code>config.nice</code> que está en el
397 directorio raiz de la estructura de directorios antigua contiene
398 exactamente el comando <code>configure</code> que usted usó
399 para configurar la estructura de directorios de Apache. Entonces,
400 para actualizar su instalación de una versóon a la
401 siguinete, solo tiene que copiar el archivo
402 <code>config.nice</code> a la estructura de directorios del
403 código fuente de la nueva versión, editarlo, hacer
404 cualquier cambio que desee, y ejecutarlo :</p>
406 <div class="example"><p><code>
407 $ ./config.nice<br />
410 $ <em>PREFIX</em>/bin/apachectl stop<br />
411 $ <em>PREFIX</em>/bin/apachectl start<br />
414 <div class="warning">Tenga en cuenta que antes de poner una nueva
415 versión de Apache en producción, debe siempre probarla
416 antes en su entorno. Por ejemplo, puede instalar y ejecutar la
417 nueva versión junto con la antigua usando un
418 <code>--prefix</code> diferente y un puerto diferente (modificando
419 la directiva <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>)
420 para comprobar que no existe ninguna incompatibilidad antes de
421 hacer la actualización definitiva.</div>
423 <div class="bottomlang">
424 <p><span>Idiomas disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
425 <a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
426 <a href="./es/install.html" title="Español"> es </a> |
427 <a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
428 <a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
429 </div><div id="footer">
430 <p class="apache">Copyright 1999-2004 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
431 <p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="./faq/">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa de este sitio web</a></p></div>