1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
|
<?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:125278 (outdated) -->
<!--
Copyright 2004-2005 The Apache Software Foundation or its licensors,
as applicable.
Licensed 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-2.1/"
>http://httpd.apache.org/docs-2.1/</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>
|