Compilación e Instalación

Idiomas disponibles: de | + en | + es | + ja | + ko | + ru | + tr

Esta traducción podría estar + obsoleta. Consulte la versión en inglés de la + documentación para comprobar si se han producido cambios + recientemente.

+ + +

Este documento explica cómo compilar e instalar Apache en + sistemas Unix y tipo Unix. Si lo que busca es información sobre + cómo compilar e instalar Apache en Windows, consulte la sección + Usar Apache en Microsoft + Windows. Para otras plataformas, consulte la + documentación sobre plataformas.

+ +

El entorno de configuración e instalación de Apache + 2.0 ha cambiado completamente respecto al de Apache 1.3. Apache + 1.3 usaba un conjunto de scripts a medida para conseguir una + instalación fácil. Apache 2.0 usa libtool y + autoconf para crear un entorno más parecido al + de muchos otros proyectos Open Source.

+ +

Si lo que quiere hacer es actualizar su servidor Apache desde + una versión menor (por ejemplo, desde la 2.0.50 a la 2.0.51), + pase directamente a la sección de actualización.

+ +

Visión general del proceso para + impacientes
Requisitos
Descargar
Descomprimir
Configuración de la estructura de +directorios
Compilar
Instalar
Personalizar
Comprobar que la instalación +funciona
Actualizar una instalación +prrevia

Consulte también

Visión general del proceso para + impacientes

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Descargar	`$ lynx http://httpd.apache.org/download.cgi` +
Descomprimir	`$ gzip -d httpd-2_0_NN.tar.gz + $ tar xvf httpd-2_0_NN.tar`
Ejecutar el script configure	`$ ./configure --prefix=PREFIX` +
Compilar	`$ make`
Instalar	`$ make install`
Personalizar	`$ vi PREFIX/conf/httpd.conf`
Comprobar que la instalación + funciona	`$ PREFIX/bin/apachectl start` +

+ +

NN hay que reemplazarlo por el número de la + versión menor, y PREFIX hay que reemplazarlo por la + ruta en la que se va a instalar Apache. Si no especifica + ningún valor en PREFIX, el valor que se usa + por defecto es /usr/local/apache2.

+ +

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.

Requisitos

+ +

Requisitos necesarios para compilar Apache:

+ +

Espacio en disco: Compruebe que tiene disponibles al + menos 50 MB de espacio libre en disco. Después de la + instalación, Apache ocupa aproximadamente 10 MB. No + obstante, la necesidad real de espacio en disco varía + considerablemente en función de las opciones de + configuración que elija y de los módulos externos que + use.
Compilador ANSI-C y Build System: Compruebe que + tiene instalado un compilador de ANSI-C. Se recomienda el Compilador GNU C + (GCC) de la Free Software + Foundation (FSF) (con la versión 2.7.2 es + suficiente). Si no tiene instaldo el GCC, entonces compruebe que + el compilador que va a utilizar cumple con los estándares + ANSI. Además, su variable de entorno PATH debe + contener la ubicación en la que se encuentran las + herramientas básicas para compilar, como por ejemplo + make.
Ajuste exacto del reloj del sistema: Los elementos + del protocolo HTTP están expresados según la hora del + día. Por eso, si quiere puede investigar como instalar + alguna utilidad para sincronizar la hora de su sistema. Para + esto, normalmente, se usan los programas ntpdate o + xntpd, que están basados en el protocolo + Network Time Protocol (NTP). Consulte el grupo de noticias comp.protocols.time.ntp + y el sitio web de NTP + para obtener más información sobre NTP y los + servidores públicos de tiempo.
Perl 5 [OPCIONAL]: Para algunos de los scripts de soporte como + apxs o dbmmanage (que + están escritos en Perl) es necesario el intérprete de + Perl 5 (las versiones 5.003 o posteriores son suficientes). Si + el script configure no encuentra ese + intérprete tampoco pasa nada. Aún puede compilar e + instalar Apache 2.0. Lo único que ocurrirá es que esos + scripts de soporte no podrán ser usados. Si usted tiene + varios interpretes de Perl instalados (quizás Perl 4 porque + estaba ya incluido en su distribución de Linux y Perl 5 + porque lo ha instalado usted), entonces se recomienda usar la + opción --with-perl para asegurarse de que + configure usa el intérprete + correcto.

Descargar

+ +

Puede descargar Apache desde la sección de + descargas del sitio web de Apache el cual tiene varios + mirrors. Para la mayoría de los usuarios de Apache que tienen + sistemas tipo Unix, se recomienda que se descarguen y compilen el + código fuente. El proceso de compilación (descrito + más abajo) es fácil, y permite adaptar el servidor + Apache a sus necesidades. Además, las versiones de + disponibles en archivos binarios no están siempre actulizadas + con las últimas modificaciones en el codigo fuente. Si se + descarga un binario, siga las instrucciones contenidas en el + archivo INSTALL.bindist incluido en la + distribución

+ +

Después de la descarga, es importante que verifique que el + archivo descargado del servidor HTTP Apache está completo y + sin modificaciones. Esto puede hacerlo comparando el archivo + descargado (.tgz) con su firma PGP. Instrucciones detalladas de + cómo hacer esto están disponibles en la + sección de descargas junto con un ejemplo de cómo usar + PGP.

+ +

Descomprimir

+ +

Extraer el código fuente del archivo .tgz que acabada de + descargar es muy fácil. Ejecute los siguientes comandos:

+ +

+ $ gzip -d httpd-2_0_NN.tar.gz + $ tar xvf httpd-2_0_NN.tar +

+ +

Estos comandos crearán un nuevo directorio dentro del + directorio en el que se encuentra y que contendrá el + código fuente de la distribución. Debe cambiarse a ese + directorio con cd para proceder a compilar el + servidor Apache.

+ +

Configuración de la estructura de +directorios

+ +

El siguiente paso es configurar la estructura de directorios + para su plataforma y sus necesidades personales. Esto se hace + usando el script configure incluido en el directorio + raiz de la distribución que acaba de descargar. (Los + desarrolladores que se descarguen la versión del CVS de la + estructura de directorios necesitarán tener instalados + autoconf y libtool, y necesitarán + ejecutar buildconf antes de continuar con los + siguientes pasos. Esto no es preciso para las versiones + oficiales.)

+ +

Para configurar la estructura de directorios a partir del + código fuente usando las opciones por defecto, solo tiene que + ejecutar ./configure. Para cambiar las opciones por + defecto, configure acepta una serie de variables y + opciones por la línea de comandos.

+ +

La opción más importante es --prefix que + es el directorio en el que Apache va a ser instalado después, + porque Apache tiene que ser configurado para el directorio que se + especifique para que funcione correctamente. Es posible lograr un + mayor control del lugar donde se van a instalar los ficheros de + Apache con otras opciones de + configuración.

+ +

En este momento, puede especificar que características + o funcionalidades quiere incluir en Apache activando o + desactivando módulos. Apache viene con + una selección + básica de módulos incluidos por defecto. Se pueden + activar otros módulos usando la opción + --enable-module, donde module + es el nombre del módulo sin el mod_ y + convirtiendo los guiones bajos que tenga en guiones normales. + También puede optar por compilar módulos como objetos dinámicos compartidos (DSOs) -- + que pueden ser activados o desactivados al ejecutar -- usando la + opción --enable-module=shared. De + igual manera, puede desactivar alguno de los módulos que + vienen por defecto en la selección basica con la opción + --disable-module. Tenga cuidado cuando + use estas opciones, porque configure no le + avisará si el módulo que especifica no existe; + simplemente ignorará esa opción.

+ +

Además, a veces es necesario pasarle al script + configure información adicional sobre + donde está su compilador, librerías o ficheros de cabecera. Esto + se puede hacer, tanto pasando variables de entorno, como pasándole + opciones a configure a través de la + línea de comandos. Para más información, consulte + la página de ayuda de configure.

+ +

Para que se haga una idea sobre las posibilidades que tiene, + aquí tiene un ejemplo típico que configura Apache para + la ruta /sw/pkg/apache con un compilador y unos flags + determinados, y además, con dos módulos adicionales + mod_rewrite y mod_speling para + cargarlos después a través del mecanismo DSO:

+ +

+ $ CC="pgcc" CFLAGS="-O2" \ + ./configure --prefix=/sw/pkg/apache \ + --enable-rewrite=shared \ + --enable-speling=shared +

+ +

Cuando se ejecuta configure se comprueban + que características o funcionalidades están disponibles + en su sistema y se crean los Makefiles que serán usados luego + para compilar el servidor. Esto tardará algunos minutos.

+ +

La información sobre todas las opciones de + configure está disponible en la + página de ayuda de configure.

+ +

Compilar

+ +

Ahora puede compilar las diferentes partes que forman Apache + simplemente ejecutando el siguiente comando:

+ +

$ make

+ +

Por favor, tanga un poco de paciencia ahora, porque una + configuración básica tarda aproximadamente 3 minutos en + compilar en un Pentium III con un sistema Linux 2.2, pero este + tiempo puede variar considerablemente en función de su + hardware y del número de módulos que haya + seleccionado.

Instalar

+ +

Ahora es el momento de instalar el paquete en el diretorio + elegido en PREFIX (consulte la opción + --prefix más arriba) ejecutando:

+ +

$ make install

+ +

Si usted está solo actualizando una instalación + anterior, la nueva instalación no sobreescribirá sus + ficheros de configuración ni otros documentos.

Personalizar

+ +

El paso siguiente, es personalizar su servidor Apache editando + los ficheros de configuración + que están en PREFIX/conf/.

+ +

$ vi PREFIX/conf/httpd.conf

+ +

échele un vistazo al Manual de Apache que está en docs/manual/ o consulte en http://httpd.apache.org/docs/2.0/ la versión más + reciente de este manual y la Guia de Referencia de todas las directivas de configuración + disponibles.

Comprobar que la instalación +funciona

+ +

Ahora puede iniciar su servidor + Apache cuando quiera ejecutando:

+ +

$ PREFIX/bin/apachectl start

+ +

y entonces debe poder acceder al documento que tenga + especificado por defecto usando el siguiente URL: + http://localhost/. El documento que verá + estará en DocumentRoot y + casi siempre estará en PREFIX/htdocs/. + Si quiere parar el servidor, puede + hacerlo ejecutando:

+ +

$ PREFIX/bin/apachectl stop

Actualizar una instalación +prrevia

+ +

El primer paso para actualizar una instalación anterior es + leer las especificaciones de la versión y el fichero + CHANGES en la distribución de código fuente + que ha descargado para encontrar los cambios que puedan afectar a + su instalación actual. Cuando el cambio sea entre versiones + mayores (por ejemplo, de la 1.3 a la 2.0 o de la 2.0 a la 2.2), + entonces es más probable que haya diferencias importantes en + la compilación y en la ejecución que necesitarán + ajustes manuales. Todos los módulos necesitarán + también ser actualizados para adaptarse a los cambios en el + interfaz de programación (API) de módulos.

+ +

La actualización cuando el cambio es entre versiones + menores (por ejemplo, de la 2.0.55 a la 2.0.57) es más + fácil. El proceso make install no + sobreescribirá ninguno de los documentos existentes, archivos + log, o archivos de configuración. Además, los + desarrolladores hacen todos los esfuerzos posibles para evitar + cambios que generen incompatibilidades en las opciones de + configure, en la configuración de la + ejecución o en la interfaz de programación de + módulos. En la mayor parte de los casos debe poder usar un + comando configure idéntico, un fichero de + configuracién idéntico, y todos sus módulos deben + seguir funcionando. (Esto es válido solo para versiones + posteriores a la 2.0.41; las versiones anteriores contienen + cambios incompatibles.)

+ +

Si la actualización es entre versiones menores (por + ejemplo, de la 2.0.55 a la 2.0.57), lo primero que debe hacer es + encontrar el fichero config.nice en el directorio + build de la instalación antigua de Apache que + desea actualizar o en el directorio raiz de la estructura de + directorios con las fuentes del servidor que uso para su anterior + instalación. Ese fichero contiene el comando + configure exacto que usó originalmente + para configurar la estructura de directorios de las fuentes de + Apache. Para actualizar su instalación de una versión a + la siguiente, solo tiene que copiar el archivo + config.nice a la estructura de directorios que + contiene las fuentes de la nueva versión de Apache, editarlo, + hacer cualquier cambio que desee, y ejecutar:

+ +

+ $ ./config.nice + $ make + $ make install + $ PREFIX/bin/apachectl stop + $ PREFIX/bin/apachectl start +

+ +

Tenga en cuenta que antes de poner una nueva + versión de Apache en producción, debe siempre probarla + antes en su entorno. Por ejemplo, puede instalar y ejecutar la + nueva versión junto con la antigua usando un + --prefix diferente y un puerto diferente (modificando + la directiva Listen) + para comprobar que no existe ninguna incompatibilidad antes de + hacer la actualización definitiva.