Return-Path: Delivered-To: apmail-httpd-docs-archive@www.apache.org Received: (qmail 33256 invoked from network); 19 Jan 2005 18:32:42 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur-2.apache.org with SMTP; 19 Jan 2005 18:32:42 -0000 Received: (qmail 35271 invoked by uid 500); 19 Jan 2005 18:32:40 -0000 Delivered-To: apmail-httpd-docs-archive@httpd.apache.org Received: (qmail 35130 invoked by uid 500); 19 Jan 2005 18:32:38 -0000 Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: list-post: Reply-To: docs@httpd.apache.org Delivered-To: mailing list docs@httpd.apache.org Received: (qmail 34924 invoked by uid 99); 19 Jan 2005 18:32:37 -0000 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received-SPF: pass (hermes.apache.org: local policy) Received: from mout.perfora.net (HELO mout.perfora.net) (217.160.230.40) by apache.org (qpsmtpd/0.28) with ESMTP; Wed, 19 Jan 2005 10:32:34 -0800 Received: from 64.red-217-217-51.user.auna.net[217.217.51.64] (helo=leviatantwohzp) by mrelay.perfora.net with ESMTP (Nemesis), id 0MKyxe-1CrKd42O4H-0001Ua; Wed, 19 Jan 2005 13:32:30 -0500 From: "Blanco" To: Subject: Apache 2.0 Documentation. Spanish Translation Date: Wed, 19 Jan 2005 19:30:35 +0100 Message-ID: MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="----=_NextPart_000_000A_01C4FE5D.5962B030" X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.2416 (9.0.2911.0) Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1441 Disposition-Notification-To: "Blanco" X-Provags-ID: perfora.net abuse@perfora.net login:0ab4618d890708bbebc210039b4f422d X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N ------=_NextPart_000_000A_01C4FE5D.5962B030 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 8bit Hi, Attached to this mail you will find the following files: manual/bind.xml.es manual/custom-error.xml.es I have also included a patch for the manual/style/lang/es.xml that includes the latest mofications made to the English version and a correction to what a summitted a few months ago. The translation has been reviewed by Daniel Lopez. This is the first time we submit documentation with the new subversion revision numbers. Please let us know anything we are missing. At the moment we are working on and should submit soon: manual/mod/core.xml manual/mod/mpm_common.xml manual/mod/mod_actions.xml manual/dso.xml manual/env.xml manual/sections.xml manual/server-wide.xml manual/dns-caveat.xml Best Regards, -- Jes�s Blanco www.bitrock.com Project Manager e: blanco @ bitrock.com t: +34 669 23 43 57 f:+34 954 502 697 -- No virus found in this outgoing message. Checked by AVG Anti-Virus. Version: 7.0.300 / Virus Database: 265.6.13 - Release Date: 16/01/2005 ------=_NextPart_000_000A_01C4FE5D.5962B030 Content-Type: application/octet-stream; name="es.xml.patch" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="es.xml.patch" Index: style/lang/es.xml=0A= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=0A= --- style/lang/es.xml (revision 125480)=0A= +++ style/lang/es.xml (working copy)=0A= @@ -68,7 +68,7 @@=0A= Sintaxis=0A= Valor por defecto=0A= Contexto=0A= - Sustituye a=0A= + Prevalece sobre=0A= Estado=0A= Módulo=0A= =0A= @@ -92,7 +92,7 @@=0A= Resumen de contenidos=0A= =0A= =0A= - see glossary=0A= + ver glosario=0A= =0A= =0A= =0A= ------=_NextPart_000_000A_01C4FE5D.5962B030 Content-Type: application/octet-stream; name="bind.xml.es" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="bind.xml.es" Direcciones IP y puertos de escucha

Cómo configurar Apache para que escuche en direcciones IP y puertos específicos.

Hosts virtuales Asuntos relacionados con = DNS
Introducción core mpm_common VirtualHost Listen

Cuando Apache se inicia, comienza a esperar peticiones entrantes en determinados puertos y direcciones de la máquina en la que se está ejecutando. Sin embargo, si quiere que Apache escuche solamente en determinados puertos específicos, o solamente en determinadas direcciones, o en una combinación de ambos, debe especificarlo adecuadamente. Esto puede además combinarlo con la posibilidad de usar hosts virtuales, funcionalidad con la que un servidor Apache puede responder a peticiones en diferentes direcciones IP, diferentes nombres de hosts y diferentes puertos.

La directiva Listen le indica al servidor que acepte peticiones entrantes solamente en los puertos y en las combinaciones de puertos y direcciones que se especifiquen. Si solo se especifica un número de puerto en la directiva Listen el servidor escuchará en ese puerto, en todas las interfaces de red de la máquina. Si se especifica una dirección IP y un puerto, el servidor escuchará solamente en la interfaz de red a la que pertenezca esa dirección IP y solamente en el puerto indicado. Se pueden usar varias directivas Listen para especificar varias direcciones IP y puertos de escucha. El servidor responderá a las peticiones de todas las direcciones y puertos que se incluyan.

Por ejemplo, para hacer que el servidor acepte conexiones tanto en el puerto 80 como en el puerto 8000, puede usar:

Listen 80
Listen 8000

Para hacer que el servidor acepte conexiones en dos interfaces de red y puertos específicos, use

Listen 192.170.2.1:80
Listen 192.170.2.5:8000

Las direcciones IPv6 deben escribirse entre corchetes, como en el = siguiente ejemplo:

Listen [fe80::a00:20ff:fea7:ccea]:80
Consideraciones especiales para IPv6

Cada vez más plataformas implementan IPv6, y APR soporta IPv6 en la mayor parte de esas plataformas, permitiendo que Apache use sockets IPv6 y pueda tratar las peticiones que se envían con IPv6.

Un factor de complejidad para los administradores de Apache es si un socket IPv6 puede tratar tanto conexiones IPv4 como IPv6. Para tratar conexiones IPv4 con sockets IPv6 se utiliza un traductor de direcciones IPv4-IPv6, cuyo uso está permitido por defecto en la mayor parte de las plataformas, pero que está desactivado por defecto en FreeBSD, NetBSD, y OpenBSD para cumplir con la política system-wide en esas palaformas. Pero incluso en los sistemas en los que no está permitido su uso por defecto, un parámetro especial de configure puede modificar ese comportamiento.

Si quiere que Apache trate conexiones IPv4 y IPv6 con un mínimo de sockets, lo que requiere traducir direcciones IPv4 a IPv6, especifique la opción de configure --enable-v4-mapped y use directivas Listen genéricas de la siguiente forma:

Listen 80

Con --enable-v4-mapped, las directivas Listen en el fichero de configuración por defecto creado por Apache usarán ese formato. --enable-v4-mapped es el valor por defecto en todas las plataformas excepto en FreeBSD, NetBSD, y OpenBSD, de modo que esa es probablemente la manera en que su servidor Apache fue construido.

Si quiere que Apache solo procese conexiones IPv4, sin tener en cuenta cuál es su plataforma o qué soporta APR, = especifique una dirección IPv4 en todas las directivas Listen, como en estos ejemplos:

Listen 0.0.0.0:80
Listen 192.170.2.1:80

Si quiere que Apache procese conexiones IPv4 y IPv6 en sockets diferentes (es decir, deshabilitar la conversión de direcciones IPv4 a IPv6), especifique la opción de configure --disable-v4-mapped y use directivas Listen específicas como en el siguiente = ejemplo:

Listen [::]:80
Listen 0.0.0.0:80

Con --disable-v4-mapped, las directivas Listen en el fichero de configuración que Apache crea por defecto usarán ese formato. --disable-v4-mapped se usa por defecto en FreeBSD, NetBSD, y OpenBSD.

Cómo funciona este mecanismo en hosts virtuales

Listen no implementa hosts virtuales. Solo le dice al servidor principal en qué direcciones y puertos tiene que escuchar. Si = no se usan directivas VirtualHost, el servidor se comporta de la misma manera con todas las peticiones que se acepten. Sin embargo, VirtualHost puede usarse para especificar un comportamiento diferente en una o varias direcciones y puertos. Para implementar un host virtual, hay que indicarle primero al servidor que escuche en aquellas direcciones y puertos a usar. Entonces se debe crear un una sección VirtualHost en una dirección y puerto específicos para determinar el comportamiento de ese host virtual. Tenga en cuenta que si se especifica en una sección VirtualHost una dirección y puerto en los que el servidor no está escuchando, ese host virtual no podrá ser accedido.

------=_NextPart_000_000A_01C4FE5D.5962B030 Content-Type: application/octet-stream; name="custom-error.xml.es" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="custom-error.xml.es" Respuestas de error personalizadas

Apache ofrece la posibilidad de que los webmasters puedan configurar las respuestas que muestra el servidor Apache cuando se producen algunos errores o problemas.

Las respuestas personalizadas pueden definirse para activarse en caso de que el servidor detecte un error o problema.

Si un script termina de forma anormal y se produce una respuesta "500 Server Error", esta respuesta puede ser sustituida por otro texto de su elección o por una redirección a otra URL (local o externa).

Comportamiento
Comportamiento anterior

NCSA httpd 1.3 devolvía mensajes antiguos del error o problema encontrado que con frecuencia no tenían significado alguno para el usuario, y que no incluían en los logs información que diera pistas sobre las causas de lo sucedido.

Comportamiento actual

Se puede hacer que el servidor siga uno de los siguientes comportamientos:

  1. Desplegar un texto diferente, en lugar de los mensajes de la NCSA, o
  2. redireccionar la petición a una URL local, o
  3. redireccionar la petición a una URL externa.

Redireccionar a otra URL puede resultar de utilidad, pero solo si con ello se puede también pasar alguna información que pueda explicar el error o problema y/o registrarlo en el log correspondiente más claramente.

Para conseguir esto, Apache define ahora variables de entorno similares a las de los CGI:

REDIRECT_HTTP_ACCEPT=3D*/*, image/gif, image/x-xbitmap,=20 image/jpeg
REDIRECT_HTTP_USER_AGENT=3DMozilla/1.1b2 (X11; I; HP-UX A.09.05=20 9000/712)
REDIRECT_PATH=3D.:/bin:/usr/local/bin:/etc
REDIRECT_QUERY_STRING=3D
REDIRECT_REMOTE_ADDR=3D121.345.78.123
REDIRECT_REMOTE_HOST=3Dooh.ahhh.com
REDIRECT_SERVER_NAME=3Dcrash.bang.edu
REDIRECT_SERVER_PORT=3D80
REDIRECT_SERVER_SOFTWARE=3DApache/0.8.15
REDIRECT_URL=3D/cgi-bin/buggy.pl

Tenga en cuenta el prefijo REDIRECT_.

Al menos REDIRECT_URL y REDIRECT_QUERY_STRING se pasarán a la nueva URL (asumiendo que es un cgi-script o un cgi-include). Las otras variables existirán solo si existían antes de aparecer el error o problema. Ninguna de estas variables se creará si en la directiva ErrorDocument ha especificado una redirección externa (cualquier cosa que empiece por un nombre de esquema del tipo http:, incluso si se refiere al mismo servidor).

Configuración

El uso de ErrorDocument está activado para los ficheros .htaccess cuando AllowOverride tiene el valor adecuado.

Aquí hay algunos ejemplos más...

ErrorDocument 500 /cgi-bin/crash-recover
ErrorDocument 500 "Sorry, our script crashed. Oh dear"
ErrorDocument 500 http://xxx/
ErrorDocument 404 /Lame_excuses/not_found.html
ErrorDocument 401 /Subscription/how_to_subscribe.html

La sintaxis es,

ErrorDocument <3-digit-code> <action>

donde action puede ser,

  1. Texto a mostrar. Ponga antes del texto que quiere que se muestre unas comillas ("). Lo que sea que siga a las comillas se mostrará. Nota: las comillas (") no se muestran.
  2. Una URL local a la que se redireccionará la petición.
  3. Una URL externa a la que se redireccionará la petición.
Mesajes de error personalizados y redirecciones

El comportamiento de Apache en cuanto a las redirecciones ha cambiado para que puedan usarse más variables de entorno con los script/server-include.

Antiguo comportamiento

Las variables CGI estándar estaban disponibles para el script al que se hacía la redirección. No se = incluía ninguna indicación sobre la precedencia de la redirección.

Nuevo comportamiento

Un nuevo grupo de variables de entorno se inicializa para que las use el script al que ha sido redireccionado. Cada nueva variable tendrá el prefijo REDIRECT_. Las variables de entorno REDIRECT_ se crean a partir de de las variables de entorno CGI que existen antes de la redirección, se les cambia el nombre añadiéndoles el prefijo REDIRECT_, por ejemplo, HTTP_USER_AGENT pasa a ser REDIRECT_HTTP_USER_AGENT. Además, para esas nuevas variables, Apache definirá REDIRECT_URL y REDIRECT_STATUS para ayudar al script a seguir su origen. Tanto la URL original como la URL a la que es redirigida la petición pueden almacenarse en los logs de acceso.

Si ErrorDocument especifica una redirección local a un script CGI, el script debe incluir una campo de cabeceraa "Status:" en el resultado final para asegurar que es posible hacer llegar al cliente de vuelta la condición de error que lo provocó. Por ejemplo, un script en Perl para usar con ErrorDocument podría incluir lo siguiente:

...
print "Content-type: text/html\n";
printf "Status: %s Condition Intercepted\n", = $ENV{"REDIRECT_STATUS"};
...

Si el script tiene como fin tratar una determinada condición de error, por ejemplo 404 Not Found, se pueden usar los códigos de error y textos específicos en su lugar.

Tenga en cuenta que el script debe incluir un campo de cabecera Status: apropiado (como 302 Found), si la respuesta contiene un campo de cabecera Location: (para poder enviar una redirección que se interprete en el cliente). De otra manera, la cabecera Location: puede que no tenga efecto.

------=_NextPart_000_000A_01C4FE5D.5962B030 Content-Type: text/plain; charset=us-ascii --------------------------------------------------------------------- To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org For additional commands, e-mail: docs-help@httpd.apache.org ------=_NextPart_000_000A_01C4FE5D.5962B030--