mirror of
https://github.com/apache/httpd.git
synced 2025-07-08 20:42:01 +03:00
5c1c5c6a03
Submitted by: Luis Gil de Bernabé Pfeiffer <ljgbpfeiffer googlemail.com> Reviewed by: Sergio Ramos git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1737042 13f79535-47bb-0310-9956-ffa450edef68
440 lines
20 KiB
JavaScript
440 lines
20 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: 1685411 -->
|
|
<!-- Spanish Translation by: Luis Gil de Bernabé -->
|
|
<!-- Reviewed by: Sergio Ramos -->
|
|
|
|
<!--
|
|
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>Compilar e Instalar</title>
|
|
|
|
<summary>
|
|
|
|
<p>Éste documento hace referencia a la compilación y la instalación del Apache
|
|
HTTP Server sólo para los sistemas Unix y tipo Unix. Para la compilación e instalación en Windows ir a <a
|
|
href="platform/windows.html">Usando Apache HTTP Server con Microsoft
|
|
Windows</a> y <a
|
|
href="platform/win_compiling.html">Compilando Apache para Microsoft Windows</a>.
|
|
Para otras plataformas visite la documentacion sobre <a
|
|
href="platform/">plataformas</a>.</p>
|
|
|
|
<p>Apache httpd usa <code>libtool</code> y <code>autoconf</code>
|
|
para crear un entorno de compilación que se parece a muchos otros proyectos de código abierto</p>
|
|
|
|
<p>Si está actualizando desde una versión menor a la siguiente (por
|
|
ejemplo, 2.4.8 a 2.4.9), pasa a la sección de <a
|
|
href="#upgrading">actualización</a>.</p>
|
|
|
|
</summary>
|
|
|
|
<seealso><a href="programs/configure.html">Configuración del árbol de las fuentes de código</a></seealso>
|
|
<seealso><a href="invoking.html">Arrancando Apache httpd</a></seealso>
|
|
<seealso><a href="stopping.html">Paranda y Reinicio</a></seealso>
|
|
|
|
<section id="overview"><title>Descripción genelar para los impacientes</title>
|
|
|
|
<table>
|
|
<columnspec><column width=".13"/><column width=".80"/></columnspec>
|
|
<tr>
|
|
<td><a href="#download">Descarga</a></td>
|
|
|
|
<td><code>$ lynx http://httpd.apache.org/download.cgi</code>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#extract">Extrae</a></td>
|
|
|
|
<td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
|
|
$ tar xvf httpd-<em>NN</em>.tar<br />
|
|
$ cd httpd-<em>NN</em></code></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#configure">Configura</a></td>
|
|
|
|
<td><code>$ ./configure --prefix=<em>PREFIX</em></code>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#compile">Compila</a></td>
|
|
|
|
<td><code>$ make</code> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#install">Instala</a></td>
|
|
|
|
<td><code>$ make install</code> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#customize">Personalizalo</a></td>
|
|
|
|
<td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><a href="#test">Prueba</a></td>
|
|
|
|
<td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<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>
|
|
|
|
<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>APR y APR-Util</dt>
|
|
<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
|
|
<a href="http://apr.apache.org/">Apache APR</a>, descomprimelo en
|
|
<code>/httpd_source_tree_root/srclib/apr</code> y /httpd_source_tree_root<code>/srclib/apr-util</code>
|
|
(cerciorate de que no existen directorios con números de versiones; por ejemplo,
|
|
la distribución de APR debe estar en /httpd_source_tree_root/srclib/apr/) y usa el comando
|
|
<code>./configure</code> <code>--con-las-opciones-incluidas-en-apr</code>.
|
|
En algunas plataformas deberás instalar la parte correspondiente a los paquetes
|
|
<code>-dev</code> para permitir que httpd se genere contra la instalación de la copia de APR y APR-Util.</dd>
|
|
|
|
<dt>Libreria Compatible de expresiones regulares de Perl (PCRE)</dt>
|
|
<dd>Esta libreria es requerida, pero ya no incluido con httpd.
|
|
Descarga el código fuente de <a href="http://www.pcre.org/">http://www.pcre.org</a>,
|
|
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,
|
|
deberás instalar la corespondiente versión <code>-dev</code>
|
|
del paquete para permitir a httpd que se genere contra la instalación de la copia del PCRE que se ha instalado.</dd>
|
|
|
|
<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, y como no del tamaño de la página web</dd>
|
|
|
|
<dt>ANSI-C Compiler and Build System</dt>
|
|
<dd>Compruebe que tiene instalado un compilador de ANSI-C. Se recomienda el <a href="http://gcc.gnu.org/">Compilador GNU C
|
|
(GCC)</a> de la <a href="http://www.gnu.org/">Free Software
|
|
Foundation (FSF)</a> es el recomendado. 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
|
|
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 <code>ntpdate</code> o
|
|
<code>xntpd</code>, que están basados en el protocolo
|
|
Network Time Protocol (NTP). Consulte el<a href="http://www.ntp.org">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<program>
|
|
apxs</program> o <program>dbmmanage</program> (que están
|
|
escritos en Perl) es necesario el intérprete de Perl 5 (las
|
|
versiones 5.003 o posteriores son suficientes). Si el escript
|
|
<program>configure</program> no se encuentra, no podrá usar los
|
|
escripts correspondientes que lo necesiten. Pero porsupuesto
|
|
podrás compilar y usar Apache httpd.</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 del Servidor Apache HTTP que acabada
|
|
de descargar es muy fácil. Ejecute los siguientes comandos:</p>
|
|
|
|
<example>
|
|
$ gzip -d httpd-<em>NN</em>.tar.gz<br />
|
|
$ tar xvf httpd-<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 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 <program>configure</program> 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, <program>configure</program> 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>Llegados a este punto, puede especificar que <a
|
|
href="programs/configure.html#optionalfeatures">características
|
|
o funcionalidades</a> quiere incluir en Apache activando o
|
|
desactivando <a href="mod/">modules</a>.Apache vine con una amplia
|
|
selección de módulos incluidos por defecto. Que serán compilados como .
|
|
<a href="dso.html">Objetos Compartidos (DSOs)</a> Que pueden ser activados
|
|
o desactivados en tiempo de ejecución.
|
|
También puede elegir por compilar módulos de forma estática usando las opciones
|
|
<code>--enable-<var>module</var>=static</code>.</p>
|
|
|
|
|
|
|
|
<p>Se pueden activar otros módulos usando la opción
|
|
<code>--enable-<var>module</var></code>, where
|
|
<var>module</var> es el nombre del módulo sin el
|
|
<code>mod_</code> y convirtiendo los guiones bajos que tenga en
|
|
guiones normales. Del mismo modo, puede desactivar los módulos con la
|
|
opción <code>--disable-<var>module</var></code>. Tenga cuidado al utilizar esta opción, ya que
|
|
<program>configure</program> 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
|
|
<program>configure</program> 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 <program>configure</program>. Para más información, consulte el manual de
|
|
<program>configure</program>. O use <program>configure</program> con la
|
|
opción <code>--help</code> option.</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_ldap</module> y <module>mod_ldap</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-ldap=shared \<br />
|
|
--enable-lua=shared
|
|
</example>
|
|
|
|
<p>Cuando se ejecuta <program>configure</program> se comprueban que
|
|
características o funcionalidades están disponibles en
|
|
su sistema y se crean los Makefiles que serán usados a continuación
|
|
para compilar el servidor. Esto tardará algunos minutos.</p>
|
|
|
|
<p>Los detalles de todas las opciones de <program>configure</program> estan disponibles
|
|
en el manual de <program>configure</program> .</p>
|
|
</section>
|
|
<section id="compile"><title>Build</title>
|
|
|
|
<p>Ahora puede compilar las diferentes partes que forman Apache
|
|
simplemente ejecutando el siguiente comando:</p>
|
|
|
|
<example>$ make</example>
|
|
|
|
<p>Por favor sea paciente llegado a este punto, ya que una configuración básica lleva unos minutos
|
|
para su compilación, y el tiempo puede variar mucho dependiendo de su hardware
|
|
y del número de módulos que haya habilitado para la compilación.(Se recomienda añadir al make el
|
|
parámetro -j3 como mínimo para que vaya más rápido)</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 más arriba la opción
|
|
<code>--prefix</code>) ejecutando:</p>
|
|
|
|
<example>$ make install</example>
|
|
|
|
<p>Este paso requiere de forma tipica privilegios de root, ya que
|
|
el directorio de <em>PREFIX</em> es normalmente un directorio con
|
|
restricciones de permisos escritura.</p>
|
|
|
|
<p>Si lo que esta es sólo actualizando, la instalación no sobreescribirá los
|
|
archivos de configuración.</p>
|
|
</section>
|
|
|
|
<section id="customize"><title>Personalizar APACHE</title>
|
|
|
|
<p>Tras la instalación puede personalizarla, editando los
|
|
<a href="configuring.html">archivos de configuracion </a> en el directorio de
|
|
<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
|
|
<code><em>PREFIX</em>/docs/manual/</code> o consulta <a
|
|
href="http://httpd.apache.org/docs/&httpd.docs;/"
|
|
>http://httpd.apache.org/docs/&httpd.docs;/</a> para la versión más
|
|
reciente de este manual y su completa
|
|
referencia de las <a href="mod/directives.html">directivas de configuracion</a> disponibles.</p>
|
|
</section>
|
|
|
|
<section id="test"><title>Comprobar que la instalación
|
|
funciona</title>
|
|
|
|
<p>Ahora puedes <a href="invoking.html">ejecutar</a> tu Apache
|
|
HTTP server ejecutando directamente:</p>
|
|
|
|
<example>$ <em>PREFIX</em>/bin/apachectl -k start</example>
|
|
|
|
<p>Ahora debe poder acceder a su primer documento
|
|
bajo la URL <code>http://localhost/</code>. La página o documento que ve se encuentra en
|
|
<directive module="core">DocumentRoot</directive>,
|
|
que por norma general casi siempre será <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 -k stop</example>
|
|
</section>
|
|
<section id="upgrading"><title>Actualizar una instalación previa</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 2.0 a 2.2 o de la 2.2 a la 2.4),
|
|
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>Actualizando de una versión menor a la siguiente
|
|
(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>
|
|
no sobreescribirá ninguno de tus documentos existentes,archivos
|
|
log, o archivos de configuración. De hecho, los desarrolladores están haciendo los esfuerzos
|
|
necerarios para evitar cambios que generen incompatibilidades en las opciones de
|
|
<program>configure</program>, la configuración al ser ejecutado, o el módulo de la API
|
|
entre versiones menores. En la mayor parte de los casos debe poder usar un
|
|
comando <program>configure</program> idéntico, un fichero de
|
|
configuración idéntico, y todos sus módulos deben
|
|
seguir funcionando.</p>
|
|
|
|
<p>Para actualizar entre versiones menores, empecemos encontrando el archivo de configuración
|
|
<code>config.nice</code> el directorio <code>de instalación</code> del servidor
|
|
o en el directorio raiz del código fuente de tu antigua instalación. Este archivo contendrá
|
|
los parámetros exactos para pasarle al
|
|
<program>configure</program> que usaste anteriormente para configurar tus directorios.
|
|
Entonces, para actualizar su instalación de una versión 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 -k graceful-stop<br />
|
|
$ <em>PREFIX</em>/bin/apachectl -k 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 un entorno de pruebas. 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>
|
|
|
|
<p>Puede pasarle argumentos adicionales a <code>config.nice</code>,
|
|
que se agregarán a susopciones originales de <program>configure</program>:</p>
|
|
|
|
<example>
|
|
$ ./config.nice --prefix=/home/test/apache --with-port=90
|
|
</example>
|
|
</section>
|
|
<section id="thirdp"><title>Paquetes de terceros</title>
|
|
|
|
<p>Un gran número de terceros proporcionan sus propias
|
|
distribuciones empaquetadas del Apache HTTP Server para su
|
|
instalación en plataformas específicas. Esto incluye las distintas
|
|
distribuciones de Linux, varios paquetes de Windows de terceros,
|
|
Mac OS X, Solaris, y muchos más.</p>
|
|
|
|
<p>Nuestra licencia de software no sólo permite, sino que anima,
|
|
este tipo de redistribución. Sin embargo, se da lugar a una situación
|
|
en la que el diseño y la configuración de los valores predeterminados
|
|
de la instalación del servidor pueden diferir de lo que se indica
|
|
en la documentación. Mientras lamentablemente, esta situación no es probable que cambie a corto plazo.</p>
|
|
|
|
<p>Una <a
|
|
href="http://wiki.apache.org/httpd/DistrosDefaultLayout">descripción
|
|
de estas distribuciones de terceros </a> está siendo actualizada en el servidor de la WIKI de HTTP
|
|
Server, y debería reflejar el actual estado de éstas distribuciones de terceros.
|
|
Sin embargo, tendrá que familiarizarse con los procedimientos de gestión
|
|
e instalación de paquetes de su plataforma (SO) en particular.</p>
|
|
|
|
</section>
|
|
</manualpage>
|