mirror of
https://github.com/apache/httpd.git
synced 2025-05-28 13:41:30 +03:00
ff13b5a693
`build convmap` git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@531943 13f79535-47bb-0310-9956-ffa450edef68
430 lines
19 KiB
JavaScript
430 lines
19 KiB
JavaScript
<?xml version='1.0' encoding='UTF-8' ?>
|
|
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="./style/manual.es.xsl"?>
|
|
<!-- English Revision: 105989:527129 (outdated) -->
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<manualpage metafile="install.xml.meta">
|
|
|
|
<title>Compilación e Instalación</title>
|
|
|
|
<summary>
|
|
|
|
<p>Este documento explica cómo compilar e instalar Apache en
|
|
sistemas Unix y tipo Unix. Para obtener información sobre
|
|
cómo compilar e instalar en Windows, consulte la sección
|
|
<a href="platform/windows.html">Usar Apache en Microsoft
|
|
Windows</a>. Para otras plataformas, consulte la
|
|
documentación sobre <a href="platform/">plataformas</a>.</p>
|
|
|
|
<p>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 <code>libtool</code> y
|
|
<code>autoconf</code> para crear un entorno más parecido al
|
|
de muchos otros proyectos Open Source.</p>
|
|
|
|
<p>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 <a
|
|
href="#upgrading">actualización</a>.</p>
|
|
|
|
</summary>
|
|
|
|
<seealso><a href="programs/configure.html">Configuración de la
|
|
estructura de directorios</a></seealso> <seealso><a
|
|
href="invoking.html">Iniciar Apache</a></seealso> <seealso><a
|
|
href="stopping.html">Parar y reiniciar Apache</a></seealso>
|
|
|
|
<section id="overview"><title>Visión general del proceso para
|
|
impacientes</title>
|
|
|
|
<table>
|
|
<columnspec><column width=".13"/><column
|
|
width=".80"/></columnspec>
|
|
<tr>
|
|
<td><a href="#download">Descargar</a></td>
|
|
|
|
<td><code>$ lynx http://httpd.apache.org/download.cgi</code>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#extract">Descomprimir</a></td>
|
|
|
|
<td><code>$ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
|
|
$ tar xvf httpd-2_1_<em>NN</em>.tar</code> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#configure">Ejecutar el script configure</a></td>
|
|
|
|
<td><code>$ ./configure --prefix=<em>PREFIX</em></code>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#compile">Compilar</a></td>
|
|
|
|
<td><code>$ make</code> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#install">Instalar</a></td>
|
|
|
|
<td><code>$ make install</code> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#customize">Personalizar</a></td>
|
|
|
|
<td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#test">Comprobar que la instalación
|
|
funciona</a></td>
|
|
|
|
<td><code>$ <em>PREFIX</em>/bin/apachectl start</code>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<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 <code>/usr/local/apache2</code>.</p>
|
|
|
|
<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>
|
|
</section>
|
|
|
|
<section id="requirements"><title>Requisitos</title>
|
|
|
|
<p>Estos son los requisitos necesarios para compilar Apache:</p>
|
|
|
|
<dl>
|
|
<dt>Espacio en disco</dt> <dd>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.</dd>
|
|
|
|
<dt>Compilador ANSI-C y Build System</dt> <dd>Compruebe que
|
|
tiene instalado un compilador de ANSI-C. Se recomienda el <a
|
|
href="http://www.gnu.org/software/gcc/gcc.html">Compilador GNU C
|
|
(GCC)</a> de la <a href="http://www.gnu.org/">Free Software
|
|
Foundation (FSF)</a> (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 <code>PATH</code> debe contener la
|
|
ubicación donde de encuentran las herramientas básicas
|
|
para compilar tales como <code>make</code>.</dd>
|
|
|
|
<dt>Ajuste exacto del reloj del sistema</dt> <dd>Los elementos
|
|
del protocolo HTTP están expresados según la hora del
|
|
dia. Por eso, si quiere puede investigar como instalar alguna
|
|
utilidad para sincronizar la hora de su sistema. Para esto,
|
|
normalmente, se usan los programas <code>ntpdate</code> o
|
|
<code>xntpd</code>, que están basados en el protocolo
|
|
Network Time Protocol (NTP). Consulte el grupo de noticias <a
|
|
href="news:comp.protocols.time.ntp">comp.protocols.time.ntp</a>
|
|
y el <a href="http://www.eecis.udel.edu/~ntp/">sitio web de NTP
|
|
</a> para obtener más información sobre NTP y los
|
|
servidores públicos de tiempo.</dd>
|
|
|
|
<dt><a href="http://www.perl.org/">Perl 5</a> [OPCIONAL]</dt>
|
|
<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
|
|
escritos en Perl) es necesario el intérprete de Perl 5 (las
|
|
versiones 5.003 o posteriores son suficientes). Si el script
|
|
`<code>configure</code>' 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
|
|
<code>--with-perl</code> para asegurarse de que
|
|
<code>./configure</code> usa el intérprete correcto.</dd>
|
|
</dl>
|
|
</section>
|
|
|
|
<section id="download"><title>Descargar</title>
|
|
|
|
<p>Puede descargar Apache desde <a
|
|
href="http://httpd.apache.org/download.cgi">la sección de
|
|
descargas del sitio web de Apache</a> 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 <code>INSTALL.bindist</code> incluido en la
|
|
distribución</p>
|
|
|
|
<p>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 <a
|
|
href="http://httpd.apache.org/download.cgi#verify"> la
|
|
sección de descargas</a> junto con un ejemplo de cómo <a
|
|
href="http://httpd.apache.org/dev/verification.html">usar
|
|
PGP</a>.</p>
|
|
|
|
</section>
|
|
|
|
<section id="extract"><title>Descomprimir</title>
|
|
|
|
<p>Extraer el código fuente del archivo .tgz que acabada de
|
|
descargar es muy fácil. Ejecute los siguientes comandos:</p>
|
|
|
|
<example>
|
|
$ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
|
|
$ tar xvf httpd-2_1_<em>NN</em>.tar
|
|
</example>
|
|
|
|
<p>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 <code>cd</code> para proceder a compilar el
|
|
servidor Apache.</p>
|
|
|
|
</section>
|
|
|
|
<section id="configure"><title>Configuración de la estructura de
|
|
directorios</title>
|
|
|
|
<p>El siguiente paso es configurar la estructura de directorios
|
|
para su plataforma y sus necesidades personales. Esto se hace
|
|
usando el script <code>configure</code> 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
|
|
<code>autoconf</code> y <code>libtool</code>, y necesitarán
|
|
ejecutar <code>buildconf</code> antes de continuar con los
|
|
siguientes pasos. Esto no es preciso para las versiones
|
|
oficiales.)</p>
|
|
|
|
<p>Para configurar la estructura de directorios a partir del
|
|
código fuente usando las opciones por defecto, solo tiene que
|
|
ejecutar <code>./configure</code>. Para cambiar las opciones por
|
|
defecto, <code>configure</code> acepta una serie de variables y
|
|
opciones por la línea de comandos.</p>
|
|
|
|
<p>La opción más importante es <code>--prefix</code> 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 <a
|
|
href="programs/configure.html#installationdirectories">opciones de
|
|
configuración</a>.</p>
|
|
|
|
<p>En este momento, puede especificar que <a
|
|
href="programs/configure.html#optionalfeatures">características
|
|
o funcionalidades</a> quiere incluir en Apache activando o
|
|
desactivando <a href="mod/">módulos</a>. Apache viene con
|
|
una <a href="mod/module-dict.html#Status">selección
|
|
básica</a> de módulos incluidos por defecto. Se pueden
|
|
activar otros módulos usando la opción
|
|
<code>--enable-<var>module</var></code>, donde <var>module</var>
|
|
es el nombre del módulo sin el <code>mod_</code> y
|
|
convirtiendo los guiones bajos que tenga en guiones normales.
|
|
También puede optar por compilar módulos como <a
|
|
href="dso.html">objetos dinámicos compartidos (DSOs)</a> --
|
|
que pueden ser activados o desactivados al ejecutar -- usando la
|
|
opción <code>--enable-<var>module</var>=shared</code>. De
|
|
igual manera, puede desactivar alguno de los módulos que
|
|
vienen por defecto en la selección basica con la opción
|
|
<code>--disable-<var>module</var></code>. Tenga cuidado cuando
|
|
use estas opciones, porque <code>configure</code> no le
|
|
avisará si el módulo que especifica no existe;
|
|
simplemente ignorará esa opción.</p>
|
|
|
|
<p>Además, a veces es necesario pasarle al script
|
|
<code>configure</code> información adicional sobre donde esta
|
|
su compilador, librerias o ficheros de cabecera. Esto se puede
|
|
hacer, tanto pasando variables de entorno, como pasandole opciones
|
|
a <code>configure</code> a través de la línea de
|
|
comandos. Para más información, consulte el <a
|
|
href="programs/configure.html">Manual del script
|
|
configure</a>.</p>
|
|
|
|
<p>Para que se haga una idea sobre las posibilidades que tiene,
|
|
aquí tiene un ejemplo típico que configura Apache para
|
|
la ruta <code>/sw/pkg/apache</code> con un compilador y unos flags
|
|
determinados, y además, con dos módulos adicionales
|
|
<module>mod_rewrite</module> y <module>mod_speling</module> para
|
|
cargarlos después a través del mecanismo DSO:</p>
|
|
|
|
<example>
|
|
$ CC="pgcc" CFLAGS="-O2" \<br />
|
|
./configure --prefix=/sw/pkg/apache \<br />
|
|
--enable-rewrite=shared \<br />
|
|
--enable-speling=shared
|
|
</example>
|
|
|
|
<p>Cuando se ejecuta <code>configure</code> 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.</p>
|
|
|
|
<p>La información sobre todas las opciones de
|
|
<code>configure</code> está disponible en el <a
|
|
href="programs/configure.html">Manual del script
|
|
configure</a>.</p>
|
|
|
|
</section>
|
|
|
|
<section id="compile"><title>Compilar</title>
|
|
|
|
<p>Ahora puede compilar las diferentes partes que forman Apache
|
|
simplemente ejecutando el siguiente comando:</p>
|
|
|
|
<example>$ make</example>
|
|
|
|
<p>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.</p>
|
|
</section>
|
|
|
|
<section id="install"><title>Instalar</title>
|
|
|
|
<p>Ahora es el momento de instalar el paquete en el diretorio
|
|
elegido en <em>PREFIX</em> (consulte la opción
|
|
<code>--prefix</code> más arriba) ejecutando:</p>
|
|
|
|
<example>$ make install</example>
|
|
|
|
<p>Si usted está solo actualizando una instalación
|
|
anterior, la nueva instalación no sobreescribirá sus
|
|
ficheros de configuración ni otros documentos.</p>
|
|
</section>
|
|
|
|
<section id="customize"><title>Personalizar</title>
|
|
|
|
<p>El paso siguiente, es personalizar su servidor Apache editando
|
|
los <a href="configuring.html">ficheros de configuración</a>
|
|
que están en <code><em>PREFIX</em>/conf/</code>.</p>
|
|
|
|
<example>$ vi <em>PREFIX</em>/conf/httpd.conf</example>
|
|
|
|
<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/&httpd.docs;/"
|
|
>http://httpd.apache.org/docs/&httpd.docs;/</a> la versión más
|
|
reciente de este manual y la Guia de Referencia de todas las <a
|
|
href="mod/directives.html">directivas de configuración</a>
|
|
disponibles.</p>
|
|
</section>
|
|
|
|
<section id="test"><title>Comprobar que la instalación
|
|
funciona</title>
|
|
|
|
<p>Ahora puede <a href="invoking.html">iniciar</a> su servidor
|
|
Apache cuando quiera ejecutando:</p>
|
|
|
|
<example>$ <em>PREFIX</em>/bin/apachectl start</example>
|
|
|
|
<p>y entonces debe poder acceder al documento que tenga
|
|
especificado por defecto usando el siguiente URL:
|
|
<code>http://localhost/</code>. El documento que verá
|
|
estará en <directive module="core">DocumentRoot</directive> y
|
|
casi siempre estará en <code><em>PREFIX</em>/htdocs/</code>.
|
|
Si quiere <a href="stopping.html">parar</a> el servidor, puede
|
|
hacerlo ejecutando:</p>
|
|
|
|
<example>$ <em>PREFIX</em>/bin/apachectl stop</example>
|
|
</section>
|
|
<section id="upgrading"><title>Actualizar una instalación
|
|
prrevia</title>
|
|
|
|
<p>El primer paso para actualizar una instalación anterior es
|
|
leer las especificaciones de la versión y el fichero
|
|
<code>CHANGES</code> 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.</p>
|
|
|
|
<p>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 <code>make install</code> 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
|
|
<code>configure</code>, 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 <code>configure</code> 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.)</p>
|
|
|
|
<p>Si va a conservar la estructura de directorios de su anterior
|
|
instalación, la actualización es más fácil
|
|
incluso. El fichero <code>config.nice</code> que está en el
|
|
directorio raiz de la estructura de directorios antigua contiene
|
|
exactamente el comando <code>configure</code> que usted usó
|
|
para configurar la estructura de directorios de Apache. Entonces,
|
|
para actualizar su instalación de una versóon a la
|
|
siguinete, solo tiene que copiar el archivo
|
|
<code>config.nice</code> a la estructura de directorios del
|
|
código fuente de la nueva versión, editarlo, hacer
|
|
cualquier cambio que desee, y ejecutarlo :</p>
|
|
|
|
<example>
|
|
$ ./config.nice<br />
|
|
$ make<br />
|
|
$ make install<br />
|
|
$ <em>PREFIX</em>/bin/apachectl stop<br />
|
|
$ <em>PREFIX</em>/bin/apachectl start<br />
|
|
</example>
|
|
|
|
<note type="warning">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
|
|
<code>--prefix</code> diferente y un puerto diferente (modificando
|
|
la directiva <directive module="mpm_common">Listen</directive>)
|
|
para comprobar que no existe ninguna incompatibilidad antes de
|
|
hacer la actualización definitiva.</note>
|
|
</section>
|
|
</manualpage>
|
|
|