Directivas Comunes de los MPM de Apache

AcceptMutex Directiva

Las directivas AcceptMutex determinan el m�todo que usa Apache para serializar m�ltiples procesos hijo que aceptan peticiones en las conexiones de red. En las versiones de Apache anteriores a la 2.0, el m�todo era seleccionable solo cuando se compilaba el servidor. El mejor m�todo a usar depende mucho de la arquitectura y de la plataforma que use. Si desea m�s informaci�n, consulte la documentanci�n sobre ajustes para conseguir un mejor rendimiento.

Si el valor especificado en esta directiva es Default, entonces se usar� el m�todo seleccionado cuando se compil� el servidor. M�s abajo puede encontrar una lista con otros m�todos. Tenga en cuenta que no todos los m�todos est�n disponibles en todas las plataformas. Si el m�todo especificado no est� disponible, se escribir� un mensaje en el log de errores con una lista de los m�todos que puede usar.

flock

usa la llamada al sistema flock(2) para bloquear el fichero especificado en la directiva LockFile.

fcntl

usa la llamada al sistema fcntl(2) para bloquear el fichero especificado en la directiva LockFile.

posixsem

usa sem�foros compatibles con POSIX para implementar el mutex.

pthread

Usa mutexes POSIX implementados seg�n la especificaci�n de hebras POSIX (PThreads).

sysvsem

usa sem�foros de tipo SySV para implementar el mutex.

Si quiere ver cu�l es el m�todo por defecto que se seleccion� para usar en su sistema al compilar, especifique el valor debug en la directiva LogLevel. El valor por defecto de la directiva AcceptMutex aparecer� escrito en el ErrorLog.

BS2000Account Directiva

La directiva BS2000Account est� disponible solo en hosts BS2000. Debe usarse para definir el n�mero de cuenta del usuario sin privilegios del servidor Apache (que se configur� usando la directiva User). Esto es un requerimiento del subsistema POSIX BS2000 (@@@@@ para reemplazar el entorno de tareas BS2000 subyaciente haciendo un sub-LOGON) para prevenir que scripts CGI accedan a recursos de la cuenta con privilegios con la que se suele iniciar el servidor, normalmente SYSROOT.

Consulte tambi�n

• Apache EBCDIC port

CoreDumpDirectory Directiva

Esta directiva controla el directorio al cual intenta cambiarse Apache antes de realizar un volcado de memoria. Por defecto, el volcado de memoria se hace en el directorio especificado en la directiva ServerRoot, sin embargo, como el usuario con el que se est� ejecutando Apache podr�a no tener permisos para escribir en ese directorio, los volcados de memoria muchas veces no se hacen en ning�n sitio. Si quiere que el volcado se memoria se guarde para analizar los fallos posteriormente, puede usar esta directiva para especificar un directorio diferente.

EnableExceptionHook Directiva

Por razones de seguridad esta directiva est� disponible solamente si el servidor ha sido configurado con la opci�n --enable-exception-hook. Esto activa un hook que permite que se conecten m�dulos externos y que realicen alguna acci�n despu�s de que un proceso hijo sufra un error irrecuperable.

Hay otros dos m�dulos, mod_whatkilledus y mod_backtrace que usan este hook. Por favor, consulte el siguiente enlace, EnableExceptionHook perteneciente al sitio web de Jeff Trawick para obtener m�s informaci�n sobre el tema.

Group Directiva

La directiva Group determina el grupo con el que el servidor atender� las peticiones. Para usar esta directiva, el servidor debe haber sido iniciado con el usuario root. Si inicia el servidor con un usuario que no sea root, el servidor no podr� cambiarse al grupo especificado, en lugar de esto continuar� ejecut�ndose con el grupo del usuario que lo inici�. Unix-group debe tomar un de los siguiente valores:

El nombre de un grupo

Se refiere al grupo que lleva el nombre que se especifica.

# seguido del n�mero de un grupo.

Se refiere al grupo asociado a ese n�mero.

Se recomienda que cree un nuevo grupo espec�ficamente para ejecutar el servidor. Algunos administradores usan el ususario nobody, pero esto no es siempre posible ni aconsejable.

Importante: El uso de esta directiva en <VirtualHost> no est� permitido ya. Para configurar su servidor para suexec use la directiva SuexecUserGroup.

Listen Directiva

La directiva Listen indica las direcciones IP y los puertos en los que debe escuchar Apache; por defecto, el servidor responde a las peticiones que se reciban en cualquier direcci�n IP de las interfaces de red. El uso de Listen es ahora obligatorio. Si no est� en el fichero de configuraci�n, el servidor no podr� iniciarse. Esto supone un cambio respecto a las versiones anteriores de Apache.

La directiva Listen le especifica al servidor los puertos o las combinaciones de direcciones y puertos cuyas peticiones debe aceptar. Si solamente se especifica un n�mero de puerto, el servidor escuchar� en ese puerto, en todas las interfaces de red. Si se especifica una direcci�n IP y un puerto, el servidor escuchar� solamente en esa direcci�n IP y en ese puerto.

Se pueden usar varias directivas Listen para especificar varias direcciones y puertos de escucha. El servidor responder� a peticiones de cualquiera de esas direcciones y puertos.

Por ejemplo, para hacer que el servidor acepte conexiones en los puertos 80 y 8000, use:

Para hacer que el servidor acepte conexiones en dos direcciones y puertos difrentes, use

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

Consulte tambi�n

• Problemas con DNS
• Especificaci�n de las direcciones y puertos que usa Apache

ListenBackLog Directiva

Longitud m�xima de la cola de conexiones en espera. En general, no es necesario ni deseable hacer ninguna modificaci�n, pero en algunos sistemas es beneficioso incrementar esta longitud cuando se est� sufriendo un ataque TCP SYN flood. Consulte la informaci�n sobre el par�metro backlog de la llamada al sistema listen(2).

Este n�mero estar� la mayor parte de las veces limitado a un valor a�n menor por el sistema operativo. Esto var�a de un sistema operativo a otro. Tenga en cuenta tambi�n que muchos sistemas operativos no usan exactamente lo que se especifica en el backlog, sino que usan un n�mero basado en el valor especificado (aunque normalmente mayor).

LockFile Directiva

La directiva LockFile especifica la ruta al archivo de lock (lockfile) que se utiliza cuando la directiva AcceptMutex tiene valor fcntl o flock. En principio no se debe modificar el valor por defecto de esta directiva. La raz�n principal para moficiarlo es que el directorio de logs est� montado en NFS, porque el archivo de lock debe almacenarse en un disco local. El PID del proceso principal del servidor se a�ade autom�ticamente al nombre del fichero.

Consulte tambi�n

• AcceptMutex

MaxClients Directiva

La directiva MaxClients especifica el l�mite de peticiones simult�neas que ser�n atendidas. Cualquier intento de conexi�n por encima del l�mite MaxClients se pondr� en cola, hasta llegar a un l�mite basado en el valor de la directiva ListenBacklog. Una vez que un proceso hijo termina de atender una petici�n y queda libre, se atender� una conexi�n en cola.

En servidores que no usan hebras (por ejemplo, prefork), el valor especificado en MaxClients se traduce en el n�mero m�ximo de procesos hijo que se crear�n para atender peticiones. El valor por defecto es 256; para incrementarlo, debe incrementar tambi�n el valor especificado en la directiva ServerLimit.

En servidores que usan hebras y en servidores h�bridos (por ejemplo, beos o worker) MaxClients limita el n�mero total de hebras que van a estar disponibles para servir clientes. El valor por defecto para beos es 50. Para MPMs h�bridos el valor por defecto es 16 (ServerLimit) multiplicado por 25 (ThreadsPerChild). Por lo tanto, si va a usar en MaxClients un valor que requiera m�s de 16 procesos deber� tambi�n incrementar el valor de la directiva ServerLimit.

MaxMemFree Directiva

La directiva MaxMemFree especifica el n�mero m�ximo de kbytes libres que el asignador de memoria principal puede tomar sin hacer una llamada al sistema free(). Cuando no se especifica ning�n valor en esta directiva, o cuando se especifica el valor cero, no existir� tal l�mite.

MaxRequestsPerChild Directiva

La directiva MaxRequestsPerChild especifica el n�mero m�ximo de peticiones que un proceso hijo atender� durante su existencia. Despu�s de atender MaxRequestsPerChild peticiones, el proceso hijo se eliminar�. Si el valor especificado en esta directiva MaxRequestsPerChild es 0, no habr� l�mite.

Especificar en la directiva MaxRequestsPerChild un valor distinto de cero tiene dos ventajas:

• limita la cantidad de memoria que un proceso puede consumir en caso de que haya un fuga (accidental) de memoria;
• establece un l�mite finito a la vida de los procesos, lo que ayuda a reducir el n�mero existente de procesos cuando se reduce la carga de trabajo en el servidor.

MaxSpareThreads Directiva

N�mero m�ximo de hebras en espera. Los diferentes MPMs tienen diferentes comportamientos respecto a esta directiva.

En el m�dulo perchild el valor por defecto usado es MaxSpareThreads 10. Este MPM monitoriza el n�mero de hebras en espera por proceso hijo. Si hay demasiadas hebras en espera en un proceso hijo, el servidor empezar� a eliminar las hebras de sobra.

En los m�dulos worker, leader y threadpool el valor por defecto usado es MaxSpareThreads 250. Estos MPMs monitorizan el n�mero del hebras en espera en servidor en conjunto. Si hay demasiadas hebras en espera en el servidor, se eliminan algunos procesos hijo hasta que el n�mero de hebras en espera se ajuste al l�mite especificado.

En el m�dulo mpm_netware el valor por defecto usado es MaxSpareThreads 100. Como este MPM ejecuta �nico proceso, las hebras en espera se calculan tambi�n en base al servidor en conjunto.

Los m�dulos beos y mpmt_os2 funcionan de manera similar a mpm_netware. El valor por defecto para beos es MaxSpareThreads 50. Para mpmt_os2 el valor por defecto es 10.

Consulte tambi�n

• MinSpareThreads
• StartServers

MinSpareThreads Directiva

N�mero m�nimo de hebras en espera para atender picos de demanda en las peticiones. Los diferentes MPMs tratan esta directiva de forma diferente.

El m�dulo perchild usa por defecto MinSpareThreads 5 y calcula el n�mero de hebras en espera en base al n�mero de procesos hijo. Si no hay suficientes hebras en espera en un proceso hijo, el servidor empezar� a crear nuevas hebras dentro de ese proceso hijo. De esta manera, si especifica en la directiva NumServers el valor 10 y en la directiva MinSpareThreads un valor de 5, tendr� como m�nimo 50 hebras en espera en su sistema.

Los m�dulos worker, leader y threadpool usan un valor por defecto MinSpareThreads 75 y calculan el n�mero de hebras en espera en el servidor en conjunto. Si no hay suficientes hebras en espera en el servidor, entonces se crean procesos hijo hasta que el n�mero de hebras en espera sea suficiente.

El m�dulo mpm_netware usa un valor por defecto MinSpareThreads 10 y como es un MPM que trabaja con un �nico proceso, calcula el n�mero de hebras en espera en base al n�mero total que hay en el servidor.

Los m�dulos beos y mpmt_os2 funcionan de modo similar a como lo hace el m�dulo mpm_netware. El valor por defecto que usa beos es MinSpareThreads 1. mpmt_os2 usa por defecto el valor 5.

Consulte tambi�n

• MaxSpareThreads
• StartServers

PidFile Directiva

La directiva PidFile especifica el fichero en el que el servidor guarda el ID del proceso demonio de escucha (daemon). Si el nombre del fichero especificado no es una ruta absoluta, entonces se asume que es relativa al directorio especificado en ServerRoot.

Con frecuencia es �til tener la posibilidad de enviar al servidor una se�al, de manera que cierre y vuelva a abrir el ErrorLog y el TransferLog, y vuelva a leer los ficheros de configuraci�n. Esto es lo que ocurre cuando se env�a la se�al SIGHUP (kill -1) al ID del proceso que aparece en PidFile.

El PidFile est� sujeto a las mismas advertencias que se hicieron para los ficheros log sobre su ubicaci�n y sobre su seguridad.

ScoreBoardFile Directiva

Apache usa un marcador para que los procesos hijo se comuniquen con sus procesos padre. Algunas arquitecturas necesitan un archivo para facilitar esta comunicaci�n. Si no se especifica ning�n fichero, Apache intenta en primer lugar crear el marcador en memoria (usando memoria compartida an�nima) y, si esto falla, intentar� crear el fichero en disco (usando memoria compartida basada en ficheros). Si se especifica un valor en esta directiva, Apache crear� directamente el archivo en disco.

El uso de memoria compartida basada en ficheros es �til para aplicaciones de terceras partes que necesitan acceso directo al marcador.

Si usa la directiva ScoreBoardFile, puede mejorar la velocidad del servidor poniendo el fichero en memoria RAM. Pero tenga cuidado y siga las mismas recomendaciones acerca del lugar donde se almacenan los ficheros log y su seguridad.

Consulte tambi�n

• Parar y reiniciar Apache

SendBufferSize Directiva

El servidor fijar� el tama�o del buffer TCP en los bytes que se especifiquen en esta directiva. Incrementar este valor por encima de los valores est�ndar del sistema operativo es muy �til en situaciones de alta velocidad y gran latencia (por ejemplo, 100ms o as�, como en el caso de conexiones intercontinentales de gran capacidad).

Si se especifica el valor 0, el servidor usar� el valor por defecto del sistema operativo.

ServerLimit Directiva

En el m�dulo MPM prefork, esta directiva significa el valor m�ximo que se puede especificar en la directiva MaxClients sobre el tiempo de vida de un proceso de Apache. En el m�dulo MPM worker, esta diretiva en combinaci�n con la directiva ThreadLimit significa el valor m�ximo que puede especificarse en la directiva MaxClients sobre el tiempo de vida de un proceso de Apache. Los intententos de cambiar el valor de esta directiva durante el reinicio del servidor ser�n ignorados. El valor de MaxClients s� que puede modificarse durante el reinicio.

Cuando se usa esta directiva hay que tener especial cuidado. Si en la directiva ServerLimit se especifica un valor mucho m�s alto de lo necesario, se reservar� memoria compartida que no ser� usada. Si ambas directivas ServerLimit y MaxClients tienen especificados valores mayores que los que el sistema puede manejar, Apache puede que no se inicie o que el sistema se vuelva inestable.

Con el m�dulo MPM prefork, use esta directiva solamente si necesita especificar en la directiva MaxClients un valor mayor a 256 (el valor por defecto). No especifique un valor mayor del que vaya a especificar en la directiva MaxClients.

Con los m�dulos worker, leader y threadpool use esta directiva solamente si los valores especificados en las directivas MaxClients y ThreadsPerChild precisan m�s de 16 procesos del servidor (valor por defecto). No especifique en esta directiva un valor mayor que el n�mero de procesos del servidor requeridos por lo especificado en las directivas MaxClients y ThreadsPerChild.

Con el MPM perchild, use esta directiva solo si tiene que especificar en la directiva NumServers un valor mayor de 8 (el valor por defecto).

Consulte tambi�n

• Parar y reiniciar Apache

StartServers Directiva

La directiva StartServers especifica el n�mero de procesos hijo que se crean al iniciar Apache. Como el n�mero de procesos est� controlado din�micamente seg�n la carga del servidor, no hay normalmente ninguna raz�n para modificar el valor de este par�metro.

El valor por defecto cambia seg�n el MPM de que se trate. Para leader, threadpool y worker el valor por defecto es StartServers 3. Para prefork el valor por defecto es 5 y para mpmt_os2 es 2.

StartThreads Directiva

N�mero de hebras que se crean al iniciar Apache. Como el n�mero de procesos est� controlado din�micamente seg�n la carga del servidor, no hay normalmente ninguna raz�n para modificar el valor de este par�metro.

En el m�dulo perchild el valor por defecto es StartThreads 5 y esta directiva controla el n�mero de hebras por proceso al inicio.

En el m�dulo mpm_netware el valor por defecto es StartThreads 50 y, como solamente hay un proceso, este es el n�mero total de hebras creadas al iniciar el servidor para servir peticiones.

En el m�dulo beos el valor usado por defecto es StartThreads 10. En este caso tambi�n representa el n�mero total de hebras creadas al iniciar el servidor para servir peticiones.

ThreadLimit Directiva

Esta directiva determina el valor m�ximo que puede especificarse en la directiva ThreadsPerChild para el tiempo de vida de un proceso de Apache. Los intentos por modificar este valor durante un reinicio ser�n ingnorados, pero el valor de la directiva ThreadsPerChild puede modificarse durante un reinicio hasta un valor igual al de esta directiva.

Cuando se usa esta directiva hay que poner especial atenci�n. Si en la directiva ThreadLimit se especifica un valor mucho m�s grande que en ThreadsPerChild, se reservar� memoria compartida en exceso que no ser� usada. Si tanto en ThreadLimit como en ThreadsPerChild se especifican valores mayores de los que el sistema puede tratar, Apache podr�a no iniciarse o su funcionamiento podr�a volverse inestable. No especifique en esta directiva un valor mayor del mayor valor posible que piense que va a especificar en ThreadsPerChild para la ejecuci�n de Apache de ese momento.

El valor por defecto de la directiva ThreadLimit es 1920 cuando se usa con mpm_winnt y 64 en otro caso.

ThreadsPerChild Directiva

Esta directiva especifica el n�mero de hebras creadas por cada proceso hijo. El proceso hijo crea estas hebras al inicio y no vuelve a crear m�s. Si se usa un MPM como mpm_winnt, en el que solamente hay un proceso hijo, este n�mero deber�a ser lo suficientemente grande como para atender toda la carga del servidor. Si se usa un m�dulo MPM como worker, en el que hay m�ltiples procesos hijo, el n�mero total de hebras deber�a ser lo suficientemente grande como para atender la carga en circustancias normales del servidor.

El valor por defecto de la directiva ThreadsPerChild es 64 cuando se usa mpm_winnt y 25 en otro caso.

User Directiva

La directiva User especifica el identificador de usuario con el que el servidor responder� a las peticiones. Para usar esta directiva, el servidor debe haber sido iniciado como root. Si se inicia Apache con un usario distinto de root, no se podr� cambiar a un usuario con menores privilegios, y el servidor continuar� ejecut�ndose con el usuario original. Si inicia el servidor como root, entonces es normal que el procedimiento padre siga ejecut�ndose como root. Unix-userid puede tomar uno de los siguientes valores:

Un nombre de ususario

Se refiere al usuario dado por su nombre.

# seguido por un n�mero de usuario.

Se refiere al usuario que corresponde a ese n�mero.

El usuario debe no tener privilegios suficientes para acceder a ficheros que no deban ser visibles para el mundo exterior, y de igual manera, el usuario no debe ser capaz de ejecutar c�digo que no sea susceptible de ser objeto de respuestas a peticiones HTTP. Se recomienda que especifique un nuevo usuario y un nuevo grupo solamente para ejecutar el servidor. Algunos administradores usan el usuario nobody, pero esto no es siempre deseable, porque el usuario nobody puede tener otras funciones en su sistema.

Con el MPM perchild, que est� dise�ado para ejecutar hosts virtuales por diferentes ID de usuario, la directiva User define el ID de usuario para el servidor principal y para el resto de las secciones <VirtualHost> sin una directiva AssignUserID.

Nota especial: El uso de esta directiva en <VirtualHost> no est� ya soportado. Para configurar su servidor para suexec use SuexecUserGroup.