Commit c5e0ad39 authored by Astrid Kessler's avatar Astrid Kessler
Browse files

new translation 

Committed by: Jesus Blanco <blanco@bitrock.com>
Reviewed by:  Daniel Lopez


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/APACHE_2_0_BRANCH@103693 13f79535-47bb-0310-9956-ffa450edef68
parent d5c35f81

docs/manual/mod/leader.xml.es

0 → 100644
+105 −0
Changes for docs/manual/mod/leader.xml.es: 105 added lines, 0 removed lines.
Original line number Diff line number Diff line 
<?xml version="1.0"?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>

<!-- English Revision: 1.1.2.7  -->



<!--

 Copyright 2004 The Apache Software Foundation



 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.

-->



<modulesynopsis metafile="leader.xml.meta">

<name>leader</name>

<description>Variante experimental del MPM est&#225;ndar

<module>worker</module></description>

<status>MPM</status>

<sourcefile>leader.c</sourcefile>

<identifier>mpm_leader_module</identifier>



<summary>

    <note type="warning"><title>Warning</title>

      <p>Este m&#243;dulo es todav&#237;a experimental, lo que

      significa que podr&#237;a no funcionar como es debido.</p>

    </note>

    

    <p>Este m&#243;dulo es una variante experimental del m&#243;dulo

    de multiprocesamiento est&#225;ndar <module>worker</module>. Usa

    un patr&#243;n de dise&#241;o Leader/Followers para coordinar el

    trabajo entre las hebras. Para m&#225;s informaci&#243;n, consulte

    <a href="http://deuce.doc.wustl.edu/doc/pspdfs/lf.pdf"

    >http://deuce.doc.wustl.edu/doc/pspdfs/lf.pdf</a>.</p>



    <p>Para usar el MPM <module>leader</module>, a&#241;ada

      <code>--with-mpm=leader</code> como argumento al script

      <code>configure</code> en el momento de compilar

      <code>httpd</code>.</p>

  

    <p>Este m&#243;dulo de multiprocesamiento depende de operaciones

    at&#243;micas compare-and-swap del APR para sicronizar las

    hebras. Si est&#225; compilando el servidor para una m&#225;quina

    x86 y no necesita soportar la arquitectura 386, o est&#225;

    compilando para una m&#225;quina SPARC y no necesita ejecutar el

    servidor en chips pre-UltraSPARC, a&#241;ada

    <code>--enable-nonportable-atomics=yes</code> como argumento al

    script <code>configure</code>. Esto har&#225; que APR implemente

    las operaciones at&#243;micas usando opciones m&#225;s eficientes

    que no est&#225;n presentes en CPUs antiguas.</p>

</summary>



<directivesynopsis location="mpm_common"><name>AcceptMutex</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>EnableExceptionHook</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>Group</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>Listen</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ListenBacklog</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>SendBufferSize</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>LockFile</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxClients</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxMemFree</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxRequestsPerChild</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxSpareThreads</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MinSpareThreads</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>PidFile</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ScoreBoardFile</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ServerLimit</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>StartServers</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ThreadLimit</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ThreadsPerChild</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>User</name>

</directivesynopsis>



</modulesynopsis>

docs/manual/mod/prefork.xml.es

0 → 100644
+190 −0
Changes for docs/manual/mod/prefork.xml.es: 190 added lines, 0 removed lines.
Original line number Diff line number Diff line 
<?xml version="1.0"?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>

<!-- English Revision: 1.8.2.7  -->



<!--

 Copyright 2004 The Apache Software Foundation



 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.

-->



<modulesynopsis metafile="prefork.xml.meta">



<name>prefork</name>

<description>Implementa un servidor web pre-forking y no

hebrado</description>

<status>MPM</status>

<sourcefile>prefork.c</sourcefile>

<identifier>mpm_prefork_module</identifier>



<summary>

    <p>Este M&#243;dulo de MultiProcesamiento (MPM) implementa un

    servidor web pre-forking y no hebrado que trata las peticiones de

    una manera similar a como lo hac&#237;a Apache 1.3.  Esto es

    apropiado para sitios web que necesitan evitar el hebrado para ser

    compatibles con librer&#237;as que no son seguras cuado se usan

    hebras.  Es tambi&#233;n el mejor MPM para aislar cada

    petici&#243;n, de manera que si suge un problema con una

    petici&#243;n, esto no afecte al resto.</p>



    <p>Este MPM est&#225; muy autorregulado, de manera que muy pocas

    veces es necesario ajustar los valores de sus directivas de

    configuraci&#243;n. El valor que se fije en la directiva

    <directive module="mpm_common">MaxClients</directive> debe ser lo

    suficientemente grande para tratar tantas peticiones

    simult&#225;neas como espere recibir su sitio web, pero lo

    suficientemente peque&#241;o para asegurarse de que hay memoria

    RAM suficiente para todos los procesos.</p>

</summary>

<seealso><a href="../bind.html">Especificar las direcciones y los puertos

que usa Apache</a></seealso>



<section id="how-it-works"><title>C&#243;mo funciona</title> <p>Un

    solo proceso de control es el responsable de lanzar los procesos

    hijo que escuchan las peticiones que se puedan producir y las

    sirven cuando llegan. Apache siempre intenta mantener varios

    procesos <dfn>de sobra</dfn> o en espera, que est&#233;n

    disponibles para servir peticiones cuando lleguen. As&#237;, los

    clientes no tienen que esperar a que un nuevo proceso hijo sea

    creado para ser atendidos.</p>



    <p>Las directivas <directive

    module="mpm_common">StartServers</directive>, <directive

    module="prefork">MinSpareServers</directive>, <directive

    module="prefork">MaxSpareServers</directive>, y <directive

    module="mpm_common">MaxClients</directive> regulan la forma en que

    el proceso padre crea hijos para servir peticiones. En general,

    Apache funciona bien sin hacer muchas modificaciones en los

    valores por defecto de estas directivas, de manera que la mayor

    parte de los sitios web no necesitan ajustar esas directivas a

    valores diferentes. Los sitios web que necesiten servir m&#225;s

    de 256 peticiones simult&#225;neas pueden necesitar incrementar el

    valor de <directive module="mpm_common">MaxClients</directive>,

    mientras que los sitios web con memoria limitada pueden necesitar

    decrementar <directive module="mpm_common">MaxClients</directive>

    para evitar que el rendimiento del servidor se degrade (pasando

    los contenidos de memoria al disco y de vuelta a memoria). Puede

    obtener m&#225;s informaci&#243;n sobre como mejorar el

    rendimiento del proceso de creaci&#243;n de procesos en la

    documentaci&#243;n sobre <a href="../misc/perf-tuning.html">mejora

    del rendimiento</a>.</p>



    <p>El proceso padre de Apache se inicia normalmente como usuario

    <code>root</code> en Unix para que escuche en el puerto 80, sin

    embargo, los procesos hijo se crean con menores privilegios de

    usuario. Las directivas <directive

    module="mpm_common">User</directive> y <directive

    module="mpm_common">Group</directive> se usan para determinar los

    privilegios de los procesos hijo de Apache. Los procesos hijo

    deben ser capaces de leer todos los contenidos que van a servir,

    pero deben tener los menores privilegios posibles.</p>



    <p>La directiva <directive

    module="mpm_common">MaxRequestsPerChild</directive> controla

    c&#243;mo el servidor recicla frecuentemente los procesos

    eliminando los antiguos y creando nuevos.</p>

</section>



<directivesynopsis location="mpm_common"><name>BS2000Account</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>EnableExceptionHook</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>PidFile</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>Listen</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ListenBacklog</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>LockFile</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxClients</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxMemFree</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxRequestsPerChild</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ScoreBoardFile</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>SendBufferSize</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ServerLimit</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>StartServers</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>User</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>Group</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>AcceptMutex</name>

</directivesynopsis>



<directivesynopsis>

<name>MaxSpareServers</name>

<description>N&#250;mero m&#225;ximo de procesos hijo en espera que

puede tener el servdor</description>

<syntax>MaxSpareServers <var>number</var></syntax>

<default>MaxSpareServers 10</default>

<contextlist><context>server config</context></contextlist>



<usage>

    <p>La directiva <directive>MaxSpareServers</directive> determina

    el n&#250;mero m&#225;ximo de procesos hijo <em>en espera</em>

    deseado. Un proceso en espera es aquel que no est&#225; atendiendo

    ninguna petici&#243;n. Si hay m&#225;s de

    <directive>MaxSpareServers</directive> procesos hijo en espera,

    entonces el proceso padre elimina el exceso.</p>



    <p>Ajustar este par&#225;metro debe ser necesario solo en sitios

    web con muchas visitas. Fijar un valor alto para este

    par&#225;metro es una mala idea casi siempre. Si fija un valor por

    debajo de <directive module="prefork">MinSpareServers</directive>,

    Apache ajustar&#225; autom&#225;ticamente el valor a <directive

    >MinSpareServers</directive><code> + 1</code>.</p>

</usage>

<seealso><directive module="prefork">MinSpareServers</directive></seealso>

<seealso><directive module="mpm_common">StartServers</directive></seealso>

</directivesynopsis>



<directivesynopsis>

<name>MinSpareServers</name>

<description>N&#250;mero m&#237;nimo de procesos hijo en espera</description>

<syntax>MinSpareServers <var>number</var></syntax>

<default>MinSpareServers 5</default>

<contextlist><context>server config</context></contextlist>



<usage>

    <p>La directiva <directive>MinSpareServers</directive> fija el

    n&#250;mero m&#237;nimo de procesos hijo <em>en espera</em>. Un

    proceso en espera es aquel que no est&#225; atendiendo ninguna

    petici&#243;n. Si hay menos procesos hijo en espera que

    <directive>MinSpareServers</directive>, entonces el proceso padre

    crea nuevos procesos hijo a un ritmo m&#225;ximo de uno por

    segundo.</p>



    <p>Ajustar este par&#225;metro debe ser necesario solo en sitios

    web con muchas visitas. Fijar un valor alto para este

    par&#225;metro es una mala idea casi siempre.</p>

</usage>

<seealso><directive module="prefork">MaxSpareServers</directive></seealso>

<seealso><directive module="mpm_common">StartServers</directive></seealso>

</directivesynopsis>



</modulesynopsis>

docs/manual/mod/worker.xml.es

0 → 100644
+202 −0
Changes for docs/manual/mod/worker.xml.es: 202 added lines, 0 removed lines.
Original line number Diff line number Diff line 
<?xml version="1.0"?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>

<!-- Revision: 1.8.2.10  -->



<!--

 Copyright 2004 The Apache Software Foundation



 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.

-->



<modulesynopsis metafile="worker.xml.meta">

<name>worker</name>

<description>M&#243;dulo de MultiProcesamiento que implementa un

servidor web h&#237;brido multihebra-multiproceso</description>

<status>MPM</status>

<sourcefile>worker.c</sourcefile>

<identifier>mpm_worker_module</identifier>



<summary>

    <p>Este M&#243;dulo de MultiProcesamiento (MPM) implementa un

    servidor h&#237;brido multiproceso-multihebra.  Usando hebras para

    atender peticiones, el servidor puede servir un mayor n&#250;mero

    de peticiones con menos recursos de sistema que un servidor basado

    &#250;nicamente en procesos. No obtante, se mantiene casi por

    completo la estabilidad de un servidor basado en procesos

    manteniendo la capacidad multiproceso, pudiendo cada proceso tener

    muchas hebras.</p>



    <p>Las directivas m&#225;s importantes que se usan para controlar

    este MPM son <directive

    module="mpm_common">ThreadsPerChild</directive>, que controla el

    n&#250;mero de hebras que tiene cada proceso hijo y <directive

    module="mpm_common">MaxClients</directive>, que controla el

    n&#250;mero m&#225;ximo de hebras que pueden crearse.</p>

</summary>

<seealso><a href="../bind.html">Especificar las direcciones y los

puertos que usa Apache</a></seealso>



<section id="how-it-works"><title>C&#243;mo funciona</title> <p>Un

    solo proceso de control (el padre) es el responsable de crear los

    procesos hijo. Cada proceso hijo crea un n&#250;mero fijo de

    hebras del servidor de la forma que se especifica en la directiva

    <directive module="mpm_common">ThreadsPerChild</directive>,

    as&#237; como una hebra de escucha que escuchar&#225; si se

    producen peticiones y las pasar&#225; a una hebra del servidor

    para que la procese.</p>



    <p>Apache siempre intenta mantener en reserva cierto n&#250;mero

    de hebras <dfn>de sobra</dfn> o en espera, que est&#225;n

    preparadas para servir peticiones en el momento en que

    lleguen. As&#237;, los clientes no tienen que esperar a que se

    creen nuevas hebras o procesos para que sean atendidas sus

    peticiones. El n&#250;mero de procesos que se crean al principio

    est&#225; determinado por la directiva <directive

    module="mpm_common">StartServers</directive>. Despu&#233;s durante

    el funcionamiento del servidor, Apache calcula el n&#250;mero

    total de hebras en espera entre todos los procesos, y crea o

    elimina procesos para mantener ese n&#250;mero dentro de los

    l&#237;mites especificados en las directivas <directive

    module="mpm_common">MinSpareThreads</directive> y <directive

    module="mpm_common">MaxSpareThreads</directive>. Como este proceso

    est&#225; bastante autorregulado, no es muy habitual que sea

    necesario modificar los valores que estas directivas traen por

    defecto. El n&#250;mero m&#225;ximo de clientes que pueden ser

    servidos simult&#225;neamente (por ejemplo, el n&#250;mero

    m&#225;ximo de hebras entre todos los procesos) est&#225;

    determinado por la directiva <directive

    module="mpm_common">MaxClients</directive>.  El n&#250;mero

    m&#225;ximo de procesos hijo activos est&#225; determinado por el

    valor especificado en la directiva <directive

    module="mpm_common">MaxClients</directive> dividido por el valor

    especificado en la directiva <directive module="mpm_common">

    ThreadsPerChild</directive>.</p>



    <p>Hay dos directivas que establecen l&#237;mites estrictos al

    n&#250;mero de procesos hijo activos y al n&#250;mero de hebras

    del servidor en un proceso hijo, y puede cambiarse solo parando

    completamente el servidor y volviendo a iniciarlo. La directiva

    <directive module="mpm_common">ServerLimit </directive> marca el

    l&#237;mite estricto de procesos hijo activos posibles, y debe ser

    mayor o igual al valor de la directiva <directive

    module="mpm_common">MaxClients</directive> dividido por el valor

    de la directiva <directive module="mpm_common">

    ThreadsPerChild</directive>.  El valor de la directiva <directive

    module="mpm_common">ThreadLimit</directive> es el l&#237;mite

    estricto del n&#250;mero de hebras del servidor, y debe ser mayor

    o igual al valor de la directiva <directive

    module="mpm_common">ThreadsPerChild</directive>.  Si los valores

    de esas directivas no son los que vienen por defecto, deben

    aparecer antes que el resto de directivas del m&#243;dulo

    <module>worker</module>.</p>



    <p>Adem&#225;s del conjunto de procesos hijo activos, puede haber

    otros procesos hijo que est&#225;n terminando pero en los que al

    menos una hebra del servidor est&#225; todav&#237;a tratando una

    conexi&#243;n con un cliente.  Puede haber hasta <directive

    module="mpm_common">MaxClients</directive> procesos terminando,

    aunque el n&#250;mero real de estos procesos que puede esperarse

    es mucho menor. Este comportamiento puede evitarse desactivando la

    eliminaci&#243;n individual de procesos hijo, lo que se hace de la

    siguiente manera:</p>



    <ul>

      <li>fijar el valor de la directiva <directive module="mpm_common">

      MaxRequestsPerChild</directive> a cero</li>



      <li>fijar el valor de la directiva <directive

      module="mpm_common"> MaxSpareThreads</directive> al mismo valor

      que la directiva <directive

      module="mpm_common">MaxClients</directive></li>

    </ul>



    <p>Una configuraci&#243;n t&#237;pica del sistema de control de

    procesos y hebras del m&#243;dulo de MPM <module>worker</module>

    prodr&#237;a ser como sigue:</p>



    <example>

      ServerLimit         16<br />

      StartServers         2<br />

      MaxClients         150<br />

      MinSpareThreads     25<br />

      MaxSpareThreads     75<br />

      ThreadsPerChild     25

    </example>



    <p>Mientras que el proceso padre se inicia con privilegios de

    usuario <code>root</code> en Unix para usar el puerto de escucha

    80, los procesos hijo y las hebras se inician con menores

    privilegios de usuario. Las directivas <directive

    module="mpm_common">User</directive> y <directive

    module="mpm_common">Group</directive> se usan para determinar los

    privilegios con los que se iniciar&#225;n los procesos hijo. Los

    procesos hijo deben ser capaces de leer los contenidos que van a

    servir, pero solo los permisos extrictamente necesarios para

    cumplir su tarea. Adem&#225;s. a menos que se use <a

    href="../suexec.html">suexec</a>, los privilegios fijados en estas

    directivas son los que que van a heredar los scripts CGI.</p>



    <p>La directiva <directive

    module="mpm_common">MaxRequestsPerChild</directive> controla con

    qu&#233; frecuencia el servidor recicla los procesos eliminando

    los antiguos y creando nuevos.</p>

</section>



<directivesynopsis location="mpm_common"><name>AcceptMutex</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>EnableExceptionHook</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>Group</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>PidFile</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>Listen</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ListenBacklog</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>LockFile</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxClients</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxMemFree</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxRequestsPerChild</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MaxSpareThreads</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>MinSpareThreads</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ScoreBoardFile</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>SendBufferSize</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ServerLimit</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>StartServers</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ThreadLimit</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>ThreadsPerChild</name>

</directivesynopsis>

<directivesynopsis location="mpm_common"><name>User</name>

</directivesynopsis>



</modulesynopsis>

docs/manual/new_features_2_0.xml.es

0 → 100644
+268 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/manual/upgrading.xml.es

0 → 100644
+225 −0

File added.

Preview size limit exceeded, changes collapsed.