granicus.if.org Git - apache/blob - docs/manual/install.xml.es

   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: 1.30 -->
   5
   6 <!--
   7  Copyright 2004 The Apache Software Foundation
   8
   9  Licensed under the Apache License, Version 2.0 (the "License");
  10  you may not use this file except in compliance with the License.
  11  You may obtain a copy of the License at
  12
  13      http://www.apache.org/licenses/LICENSE-2.0
  14
  15  Unless required by applicable law or agreed to in writing, software
  16  distributed under the License is distributed on an "AS IS" BASIS,
  17  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18  See the License for the specific language governing permissions and
  19  limitations under the License.
  20 -->
  21
  22 <manualpage metafile="install.xml.meta">
  23
  24   <title>Compilaci&#243;n e Instalaci&#243;n</title>
  25
  26 <summary>
  27
  28     <p>Este documento explica c&#243;mo compilar e instalar Apache en
  29     sistemas Unix y tipo Unix. Para obtener informaci&#243;n sobre
  30     c&#243;mo compilar e instalar en Windows, consulte la secci&#243;n
  31     <a href="platform/windows.html">Usar Apache en Microsoft
  32     Windows</a>. Para otras plataformas, consulte la
  33     documentaci&#243;n sobre <a href="platform/">plataformas</a>.</p>
  34
  35     <p>El entorno de configuraci&#243;n e instalaci&#243;n de Apache
  36     2.0 ha cambiado completamente respecto al de Apache 1.3. Apache
  37     1.3 usaba un conjunto de scripts a medida para conseguir una
  38     instalaci&#243;n f&#225;cil. Apache 2.0 usa <code>libtool</code> y
  39     <code>autoconf</code> para crear un entorno m&#225;s parecido al
  40     de muchos otros proyectos Open Source.</p>
  41
  42     <p>Si lo que quiere hacer es actualizar su servidor Apache desde
  43     una versi&#243;n menor (por ejemplo, desde la 2.0.50 a la 2.0.51),
  44     pase directamente a la secci&#243;n de <a
  45     href="#upgrading">actualizaci&#243;n</a>.</p>
  46
  47 </summary>
  48
  49 <seealso><a href="programs/configure.html">Configuraci&#243;n de la
  50 estructura de directorios</a></seealso> <seealso><a
  51 href="invoking.html">Iniciar Apache</a></seealso> <seealso><a
  52 href="stopping.html">Parar y reiniciar Apache</a></seealso>
  53
  54 <section id="overview"><title>Visi&#243;n general del proceso para
  55     impacientes</title>
  56
  57     <table>
  58       <columnspec><column width=".13"/><column
  59       width=".80"/></columnspec>
  60       <tr>
  61         <td><a href="#download">Descargar</a></td>
  62
  63         <td><code>$ lynx http://httpd.apache.org/download.cgi</code>
  64         </td>
  65       </tr>
  66
  67       <tr>
  68         <td><a href="#extract">Descomprimir</a></td>
  69
  70         <td><code>$ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
  71          $ tar xvf httpd-2_1_<em>NN</em>.tar</code> </td>
  72       </tr>
  73
  74       <tr>
  75         <td><a href="#configure">Ejecutar el script configure</a></td>
  76
  77         <td><code>$ ./configure --prefix=<em>PREFIX</em></code>
  78         </td>
  79       </tr>
  80
  81       <tr>
  82         <td><a href="#compile">Compilar</a></td>
  83
  84         <td><code>$ make</code> </td>
  85       </tr>
  86
  87       <tr>
  88         <td><a href="#install">Instalar</a></td>
  89
  90         <td><code>$ make install</code> </td>
  91       </tr>
  92
  93       <tr>
  94         <td><a href="#customize">Personalizar</a></td>
  95
  96         <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
  97       </tr>
  98
  99       <tr>
 100         <td><a href="#test">Comprobar que la instalaci&#243;n
 101         funciona</a></td>
 102
 103         <td><code>$ <em>PREFIX</em>/bin/apachectl start</code>
 104         </td>
 105       </tr>
 106     </table>
 107
 108     <p><em>NN</em> hay que reemplazarlo por el n&#250;mero de la
 109     versi&#243;n menor, y <em>PREFIX</em> hay que reemplazarlo por la
 110     ruta en la que se va a instalar Apache. Si no especifica
 111     ning&#250;n valor en <em>PREFIX</em>, el valor por defecto que se
 112     toma es <code>/usr/local/apache2</code>.</p>
 113
 114     <p>Cada parte del proceso de configuraci&#243;n e instalaci&#243;n
 115     se describe detalladamente m&#225;s abajo, empezando por los
 116     requisitos para compilar e instalar Apache.</p>
 117 </section>
 118
 119 <section id="requirements"><title>Requisitos</title>
 120
 121     <p>Estos son los requisitos necesarios para compilar Apache:</p>
 122
 123     <dl>
 124       <dt>Espacio en disco</dt> <dd>Compruebe que tiene disponibles al
 125       menos 50 MB de espacio libre en disco. Despu&#233;s de la
 126       instalaci&#243;n, Apache ocupa aproximadamente 10 MB. No
 127       obstante, la necesidad real de espacio en disco var&#237;a
 128       considerablemente en funci&#243;n de las opciones de
 129       configuraci&#243;n que elija y de los m&#243;dulos externos que
 130       use.</dd>
 131
 132       <dt>Compilador ANSI-C y Build System</dt> <dd>Compruebe que
 133       tiene instalado un compilador de ANSI-C. Se recomienda el <a
 134       href="http://www.gnu.org/software/gcc/gcc.html">Compilador GNU C
 135       (GCC)</a> de la <a href="http://www.gnu.org/">Free Software
 136       Foundation (FSF)</a> (con la versi&#243;n 2.7.2 es
 137       suficiente). Si no tiene instaldo el GCC, entonces compruebe que
 138       el compilador que va a utilizar cumple con los est&#225;ndares
 139       ANSI. Adem&#225;s, su <code>PATH</code> debe contener la
 140       ubicaci&#243;n donde de encuentran las herramientas b&#225;sicas
 141       para compilar tales como <code>make</code>.</dd>
 142
 143       <dt>Ajuste exacto del reloj del sistema</dt> <dd>Los elementos
 144       del protocolo HTTP est&#225;n expresados seg&#250;n la hora del
 145       dia. Por eso, si quiere puede investigar como instalar alguna
 146       utilidad para sincronizar la hora de su sistema. Para esto,
 147       normalmente, se usan los programas <code>ntpdate</code> o
 148       <code>xntpd</code>, que est&#225;n basados en el protocolo
 149       Network Time Protocol (NTP). Consulte el grupo de noticias <a
 150       href="news:comp.protocols.time.ntp">comp.protocols.time.ntp</a>
 151       y el <a href="http://www.eecis.udel.edu/~ntp/">sitio web de NTP
 152       </a> para obtener m&#225;s informaci&#243;n sobre NTP y los
 153       servidores p&#250;blicos de tiempo.</dd>
 154
 155       <dt><a href="http://www.perl.org/">Perl 5</a> [OPCIONAL]</dt>
 156       <dd>Para algunos de los scripts de soporte como <a
 157       href="programs/apxs.html">apxs</a> o <a
 158       href="programs/dbmmanage.html">dbmmanage</a> (que est&#225;n
 159       escritos en Perl) es necesario el int&#233;rprete de Perl 5 (las
 160       versiones 5.003 o posteriores son suficientes). Si el script
 161       `<code>configure</code>' no encuentra ese int&#233;rprete
 162       tampoco pasa nada. A&#250;n puede compilar e instalar Apache
 163       2.0. Lo &#250;nico que ocurrir&#225; es que esos scripts de
 164       soporte no podr&#225;n ser usados. Si usted tiene varios
 165       interpretes de Perl instalados (quiz&#225;s Perl 4 porque estaba
 166       ya incluido en su distribuci&#243;n de Linux y Perl 5 porque lo
 167       ha instalado usted), entonces se recomienda usar la opci&#243;n
 168       <code>--with-perl</code> para asegurarse de que
 169       <code>./configure</code> usa el int&#233;rprete correcto.</dd>
 170     </dl>
 171 </section>
 172
 173 <section id="download"><title>Descargar</title>
 174
 175     <p>Puede descargar Apache desde <a
 176     href="http://httpd.apache.org/download.cgi">la secci&#243;n de
 177     descargas del sitio web de Apache</a> el cual tiene varios
 178     mirrors. Para la mayor&#237;a de los usuarios de Apache que tienen
 179     sistemas tipo Unix, se recomienda que se descarguen y compilen el
 180     c&#243;digo fuente. El proceso de compilaci&#243;n (descrito
 181     m&#225;s abajo) es f&#225;cil, y permite adaptar el servidor
 182     Apache a sus necesidades. Adem&#225;s, las versiones de
 183     disponibles en archivos binarios no est&#225;n siempre actulizadas
 184     con las &#250;ltimas modificaciones en el codigo fuente. Si se
 185     descarga un binario, siga las instrucciones contenidas en el
 186     archivo <code>INSTALL.bindist</code> incluido en la
 187     distribuci&#243;n</p>
 188
 189     <p>Despu&#233;s de la descarga, es importante que verifique que el
 190     archivo descargado del servidor HTTP Apache est&#225; completo y
 191     sin modificaciones.  Esto puede hacerlo comparando el archivo
 192     descargado (.tgz) con su firma PGP. Instrucciones detalladas de
 193     c&#243;mo hacer esto est&#225;n disponibles en <a
 194     href="http://httpd.apache.org/download.cgi#verify"> la
 195     secci&#243;n de descargas</a> junto con un ejemplo de c&#243;mo <a
 196     href="http://httpd.apache.org/dev/verification.html">usar
 197     PGP</a>.</p>
 198
 199 </section>
 200
 201 <section id="extract"><title>Descomprimir</title>
 202
 203     <p>Extraer el c&#243;digo fuente del archivo .tgz que acabada de
 204     descargar es muy f&#225;cil. Ejecute los siguientes comandos:</p>
 205
 206 <example>
 207       $ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
 208        $ tar xvf httpd-2_1_<em>NN</em>.tar
 209 </example>
 210
 211     <p>Estos comandos crear&#225;n un nuevo directorio dentro del
 212     directorio en el que se encuentra y que contendr&#225; el
 213     c&#243;digo fuente de la distribuci&#243;n. Debe cambiarse a ese
 214     directorio con <code>cd</code> para proceder a compilar el
 215     servidor Apache.</p>
 216
 217 </section>
 218
 219 <section id="configure"><title>Configuraci&#243;n de la estructura de
 220 directorios</title>
 221
 222     <p>El siguiente paso es configurar la estructura de directorios
 223     para su plataforma y sus necesidades personales. Esto se hace
 224     usando el script <code>configure</code> incluido en el directorio
 225     raiz de la distribuci&#243;n que acaba de descargar. (Los
 226     desarrolladores que se descarguen la versi&#243;n del CVS de la
 227     estructura de directorios necesitar&#225;n tener instalados
 228     <code>autoconf</code> y <code>libtool</code>, y necesitar&#225;n
 229     ejecutar <code>buildconf</code> antes de continuar con los
 230     siguientes pasos. Esto no es preciso para las versiones
 231     oficiales.)</p>
 232
 233     <p>Para configurar la estructura de directorios a partir del
 234     c&#243;digo fuente usando las opciones por defecto, solo tiene que
 235     ejecutar <code>./configure</code>. Para cambiar las opciones por
 236     defecto, <code>configure</code> acepta una serie de variables y
 237     opciones por la l&#237;nea de comandos.</p>
 238
 239     <p>La opci&#243;n m&#225;s importante es <code>--prefix</code> que
 240     es el directorio en el que Apache va a ser instalado despu&#233;s,
 241     porque Apache tiene que ser configurado para el directorio que se
 242     especifique para que funcione correctamente.  Es posible lograr un
 243     mayor control del lugar donde se van a instalar los ficheros de
 244     Apache con otras <a
 245     href="programs/configure.html#installationdirectories">opciones de
 246     configuraci&#243;n</a>.</p>
 247
 248     <p>En este momento, puede especificar que <a
 249     href="programs/configure.html#optionalfeatures">caracter&#237;sticas
 250     o funcionalidades</a> quiere incluir en Apache activando o
 251     desactivando <a href="mod/">m&#243;dulos</a>.  Apache viene con
 252     una <a href="mod/module-dict.html#Status">selecci&#243;n
 253     b&#225;sica</a> de m&#243;dulos incluidos por defecto.  Se pueden
 254     activar otros m&#243;dulos usando la opci&#243;n
 255     <code>--enable-<var>module</var></code>, donde <var>module</var>
 256     es el nombre del m&#243;dulo sin el <code>mod_</code> y
 257     convirtiendo los guiones bajos que tenga en guiones normales.
 258     Tambi&#233;n puede optar por compilar m&#243;dulos como <a
 259     href="dso.html">objetos din&#225;micos compartidos (DSOs)</a> --
 260     que pueden ser activados o desactivados al ejecutar -- usando la
 261     opci&#243;n <code>--enable-<var>module</var>=shared</code>.  De
 262     igual manera, puede desactivar alguno de los m&#243;dulos que
 263     vienen por defecto en la selecci&#243;n basica con la opci&#243;n
 264     <code>--disable-<var>module</var></code>.  Tenga cuidado cuando
 265     use estas opciones, porque <code>configure</code> no le
 266     avisar&#225; si el m&#243;dulo que especifica no existe;
 267     simplemente ignorar&#225; esa opci&#243;n.</p>
 268
 269     <p>Adem&#225;s, a veces es necesario pasarle al script
 270     <code>configure</code> informaci&#243;n adicional sobre donde esta
 271     su compilador, librerias o ficheros de cabecera.  Esto se puede
 272     hacer, tanto pasando variables de entorno, como pasandole opciones
 273     a <code>configure</code> a trav&#233;s de la l&#237;nea de
 274     comandos.  Para m&#225;s informaci&#243;n, consulte el <a
 275     href="programs/configure.html">Manual del script
 276     configure</a>.</p>
 277
 278     <p>Para que se haga una idea sobre las posibilidades que tiene,
 279     aqu&#237; tiene un ejemplo t&#237;pico que configura Apache para
 280     la ruta <code>/sw/pkg/apache</code> con un compilador y unos flags
 281     determinados, y adem&#225;s, con dos m&#243;dulos adicionales
 282     <module>mod_rewrite</module> y <module>mod_speling</module> para
 283     cargarlos despu&#233;s a trav&#233;s del mecanismo DSO:</p>
 284
 285 <example>
 286       $ CC="pgcc" CFLAGS="-O2" \<br />
 287        ./configure --prefix=/sw/pkg/apache \<br />
 288        --enable-rewrite=shared \<br />
 289        --enable-speling=shared
 290 </example>
 291
 292     <p>Cuando se ejecuta <code>configure</code> se comprueban que
 293     caracter&#237;sticas o funcionalidades est&#225;n disponibles en
 294     su sistema y se crean los Makefiles que ser&#225;n usados luego
 295     para compilar el servidor. Esto tardar&#225; algunos minutos.</p>
 296
 297     <p>La informaci&#243;n sobre todas las opciones de
 298     <code>configure</code> est&#225; disponible en el <a
 299     href="programs/configure.html">Manual del script
 300     configure</a>.</p>
 301
 302 </section>
 303
 304 <section id="compile"><title>Compilar</title>
 305
 306     <p>Ahora puede compilar las diferentes partes que forman Apache
 307     simplemente ejecutando el siguiente comando:</p>
 308
 309 <example>$ make</example>
 310
 311     <p>Por favor, tanga un poco de paciencia ahora, porque una
 312     configuraci&#243;n b&#225;sica tarda aproximadamente 3 minutos en
 313     compilar en un Pentium III con un sistema Linux 2.2, pero este
 314     tiempo puede variar considerablemente en funci&#243;n de su
 315     hardware y del n&#250;mero de m&#243;dulos que haya
 316     seleccionado.</p>
 317 </section>
 318
 319 <section id="install"><title>Instalar</title>
 320
 321     <p>Ahora es el momento de instalar el paquete en el diretorio
 322     elegido en <em>PREFIX</em> (consulte la opci&#243;n
 323     <code>--prefix</code> m&#225;s arriba) ejecutando:</p>
 324
 325 <example>$ make install</example>
 326
 327     <p>Si usted est&#225; solo actualizando una instalaci&#243;n
 328     anterior, la nueva instalaci&#243;n no sobreescribir&#225; sus
 329     ficheros de configuraci&#243;n ni otros documentos.</p>
 330 </section>
 331
 332 <section id="customize"><title>Personalizar</title>
 333
 334     <p>El paso siguiente, es personalizar su servidor Apache editando
 335     los <a href="configuring.html">ficheros de configuraci&#243;n</a>
 336     que est&#225;n en <code><em>PREFIX</em>/conf/</code>.</p>
 337
 338 <example>$ vi <em>PREFIX</em>/conf/httpd.conf</example>
 339
 340     <p>&#233;chele un vistazo al Manual de Apache que est&#225; en <a
 341     href="./">docs/manual/</a> o consulte en <a
 342     href="http://httpd.apache.org/docs-2.1/"
 343     >http://httpd.apache.org/docs-2.1/</a> la versi&#243;n m&#225;s
 344     reciente de este manual y la Guia de Referencia de todas las <a
 345     href="mod/directives.html">directivas de configuraci&#243;n</a>
 346     disponibles.</p>
 347 </section>
 348
 349 <section id="test"><title>Comprobar que la instalaci&#243;n
 350 funciona</title>
 351
 352     <p>Ahora puede <a href="invoking.html">iniciar</a> su servidor
 353     Apache cuando quiera ejecutando:</p>
 354
 355 <example>$ <em>PREFIX</em>/bin/apachectl start</example>
 356
 357     <p>y entonces debe poder acceder al documento que tenga
 358     especificado por defecto usando el siguiente URL:
 359     <code>http://localhost/</code>. El documento que ver&#225;
 360     estar&#225; en <directive module="core">DocumentRoot</directive> y
 361     casi siempre estar&#225; en <code><em>PREFIX</em>/htdocs/</code>.
 362     Si quiere <a href="stopping.html">parar</a> el servidor, puede
 363     hacerlo ejecutando:</p>
 364
 365 <example>$ <em>PREFIX</em>/bin/apachectl stop</example>
 366 </section>
 367 <section id="upgrading"><title>Actualizar una instalaci&#243;n
 368 prrevia</title>
 369
 370     <p>El primer paso para actualizar una instalaci&#243;n anterior es
 371     leer las especificaciones de la versi&#243;n y el fichero
 372     <code>CHANGES</code> en la distribuci&#243;n de c&#243;digo fuente
 373     que ha descargado para encontrar los cambios que puedan afectar a
 374     su instalaci&#243;n actual. Cuando el cambio sea entre versiones
 375     mayores (por ejemplo, de la 1.3 a la 2.0 o de la 2.0 a la 2.2),
 376     entonces es m&#225;s probable que haya diferencias importantes en
 377     la compilaci&#243;n y en la ejecuci&#243;n que necesitar&#225;n
 378     ajustes manuales. Todos los m&#243;dulos necesitar&#225;n
 379     tambi&#233;n ser actualizados para adaptarse a los cambios en el
 380     interfaz de programaci&#243;n (API) de m&#243;dulos.</p>
 381
 382     <p>La actualizaci&#243;n cuando el cambio es entre versiones
 383     menores (por ejemplo, de la 2.0.55 a la 2.0.57) es m&#225;s
 384     f&#225;cil.  El proceso <code>make install</code> no
 385     sobreescribir&#225; ninguno de los documentos existentes, archivos
 386     log, o archivos de configuraci&#243;n.  Adem&#225;s, los
 387     desarrolladores hacen todos los esfuerzos posibles para evitar
 388     cambios que generen incompatibilidades en las opciones de
 389     <code>configure</code>, en la configuraci&#243;n de la
 390     ejecuci&#243;n o en la interfaz de programaci&#243;n de
 391     m&#243;dulos. En la mayor parte de los casos debe poder usar un
 392     comando <code>configure</code> id&#233;ntico, un fichero de
 393     configuraci&#233;n id&#233;ntico, y todos sus m&#243;dulos deben
 394     seguir funcionando.  (Esto es v&#225;lido solo para versiones
 395     posteriores a la 2.0.41; las versiones anteriores contienen
 396     cambios incompatibles.)</p>
 397
 398     <p>Si va a conservar la estructura de directorios de su anterior
 399     instalaci&#243;n, la actualizaci&#243;n es m&#225;s f&#225;cil
 400     incluso.  El fichero <code>config.nice</code> que est&#225; en el
 401     directorio raiz de la estructura de directorios antigua contiene
 402     exactamente el comando <code>configure</code> que usted us&#243;
 403     para configurar la estructura de directorios de Apache.  Entonces,
 404     para actualizar su instalaci&#243;n de una vers&#243;on a la
 405     siguinete, solo tiene que copiar el archivo
 406     <code>config.nice</code> a la estructura de directorios del
 407     c&#243;digo fuente de la nueva versi&#243;n, editarlo, hacer
 408     cualquier cambio que desee, y ejecutarlo :</p>
 409
 410     <example>
 411     $ ./config.nice<br />
 412     $ make<br />
 413     $ make install<br />
 414     $ <em>PREFIX</em>/bin/apachectl stop<br />
 415     $ <em>PREFIX</em>/bin/apachectl start<br />
 416     </example>
 417
 418     <note type="warning">Tenga en cuenta que antes de poner una nueva
 419     versi&#243;n de Apache en producci&#243;n, debe siempre probarla
 420     antes en su entorno. Por ejemplo, puede instalar y ejecutar la
 421     nueva versi&#243;n junto con la antigua usando un
 422     <code>--prefix</code> diferente y un puerto diferente (modificando
 423     la directiva <directive module="mpm_common">Listen</directive>)
 424     para comprobar que no existe ninguna incompatibilidad antes de
 425     hacer la actualizaci&#243;n definitiva.</note>
 426 </section>
 427 </manualpage>
 428