Servidor HTTP Apache Version 1.3

Usando Apache con Novell Netware

Acentos omitidos intencionadamente.

Este documento explica como instalar, configurar y ejecutar Apache 1.3 en el entorno Novell Netware 5.x o superior. Si usted encuentra algun error, o quiere contribuir de cualquier otra forma, por favor use nuestra pagina de notificacion de errores.

La pagina de notificacion de errores y la lista de correo new-http no ofrecen contestacion a cuestiones sobre configuracion y ejecucion de Apache. Antes de enviar cualquier peticion o notificacion de error, primero consulte este documento, la pagina de preguntas Frecuentes y el resto de puntos importantes de la documentacion.

Si usted todavia tiene una pregunta o problema, tiene varias opciones para resolver sus dudas. Puede enviar sus cuestiones (en ingles) al grupo de noticias novell.devsup.webserver, o bien, suscribirse a la lista de correo technovell.com (en español). En ambos lugares hay muchos usuarios de Netware que estaran dispuestos a contestar sus dudas sobre el uso de Apache en Netware.

La mayor parte de este documento asume que usted esta instalando Apache desde la distribucion binaria. Si desea compilar Apache usted mismo (posiblemente para ayudar con el desarrollo, o para localizar errores), vea la seccion Compilando Apache en Netware mas abajo.

Requerimientos
Descargando Apache para Netware
Instalando Apache para Netware
Ejecutando Apache para Netware
Configurando Apache para NetWare
Compilando Apache para NetWare

Requerimientos

Apache 1.3 esta diseñado para funcionar en Netware 5.x o superior y es instalado por defecto en todos los servidores Netware 6.

Si se ejecuta en Netware 5.0 usted debe instalar el Service Pack (Parche) 5 o superior.

Si se ejecuta en Netware 5.1 usted debe instalar el Service Pack 1 o superior.

Los ultimos parches de NetWare estan disponibles aqui.

Descargando Apache para Netware

La informacion sobre las ultimas versiones de Apache puede ser encontrada en el servidor web de Apache en http://www.apache.org/. Aqui puede encontrar informacion sobre la version actual, cualquier version alpha o beta-test mas reciente, ademas de detalles de web mirror (espejos) y sitios ftp anonimos.

Instalando Apache para Netware

Actualmente no existe un programa de instalacion de Apache para Netware, pero es muy sencillo instalar Apache en Netware. Usted puede descargar la version binaria o compilar apache y copiar los ficheros sobre el servidor manualmente. En el futuro se creara un programa de instalacion. Si usted esta ejecutando Netware 6, Apache para Netware ha sido instalado por defecto en su servidor.

Siga estos pasos para instalar apache en Netware, (asumiendo que usted esta instalando en SYS:/APACHE), desde la descarga del software binario (binary download):

Descomprima el fichero binario descargado en la raiz del volumen SYS: (puede ser instalado en cualquier otro volumen)
Edite el fichero httpd.conf configurando las directivas ServerRoot y ServerName para reflejar la configuracion correcta de su servidor
Añada SYS:APACHE al path de busqueda del servidor. EJEMPLO: SEARCH ADD SYS:\APACHE

Siga estos pasos para instalar Apache en Netware manualmente desde su propia construccion de los fuentes (asumiendo que usted esta instalando en SYS:/APACHE:

Cree un directorio llamado Apache en un volumen Netware
Copie Apache.nlm, Apachec.nlm, htdigest.nlm, htpasswd.nlm, xmlparse.nlm, y xmltok.nlm al directorio SYS:/APACHE
Cree un directorio bajo SYS:/APACHE llamado CONF
Copie todos los archivos *.CONF-DIST-NW al directorio SYS:/APACHE/CONF y renombre todos ellos como ficheros *.CONF
Copie los ficheros MIME.TYPES y ficheros magic al directorio SYS:/APACHE/CONF
Copie todos los ficheros y subdirectorios en \apache-1.3\icons a SYS:/APACHE/ICONS
Cree el directorio SYS:/APACHE/LOGS en el servidor
Cree el directorio SYS:/APACHE/CGI-BIN en el servidor
Cree el directorio SYS:/APACHE/MODULES y copie todos los modulos NLM compilados dentro del directorio MODULES
Edite el fichero httpd.conf configurando las directivas ServerRoot y ServerName para reflejar la configuracion correcta de su servidor
Añada SYS:/APACHE al camino (path) de busqueda. EJEMPLO: SEARCH ADD SYS:\APACHE

Apache puede ser instalado en cualquier otro volumen ademas del volumen por defecto SYS.

Ejecutando Apache para Netware

Para ejecutar Apache tan solo teclee apache en la consola del servidor. Esto cargara apache en el mismo espacio de memoria que el del Sistema Operativo. si usted prefiere cargar Apache en un espacio de memoria protegido usted debe especificar dicho espacio de memoria junto con el comando LOAD como se detalla:

    LOAD ADDRESS SPACE = APACHE APACHE

Esto cargara Apache dentro de un espacio de memoria llamado APACHE. Es posible ejecutar multiples instancias de Apache, al mismo tiempo, en Netware cargando cada instancia dentro de su propio espacio protegido de memoria.

Despues de cargarlo, Apache estara escuchando en el puerto 80 (a menos que usted cambie las directivas Port, Listen o BindAddress en el fichero de configuracion). Para conectar al servidor y acceder a la pagina por defecto, lance un navegador e introduzca el nombre (DNS) de su servidor o la direccion IP. Esto deberia responder con una pagina de bienvenida y un enlace al manual de Apache. Si nada de esto sucede o usted obtiene un error, mire el fichero error_log en el directorio logs.

Una vez que su instalacion basica esta funcionando, usted deberia configurar Apache apropiadamente editando los ficheros existentes en el directorio conf.

Para descargar Apache ejecutandose en el espacio de memoria del Sistema Operativo, tan solo teclee lo siguiente en la consola del servidor:

    UNLOAD APACHE

Si Apache esta ejecutandose en un espacio de memoria protegido, debe especificar la direccion del espacio en el comando UNLOAD:

    UNLOAD ADDRESS SPACE = APACHE APACHE

Cuando se trabaja con Apache es importante conocer como se buscaran los ficheros de configuracion. Usted puede especificar un fichero de configuracion en la linea de comandos de dos formas:

-f especifica un camino (path) a un fichero concreto de configuracion

    APACHE -f "VOLUMEN:/MI_APACHE/conf/mio.conf"

    APACHE -f test/test.conf

En estos casos, una clausula ServerRoot apropiada deberia existir en el fichero de configuracion.

Si usted no especifica un fichero de configuracion con -f, Apache usara el nombre del fichero compilado dentro del software del servidor, usualmente "conf/httpd.conf". Puede consultar este valor invocando Apache con el switch -v y buscando el valor etiquetado como SERVER_CONFIG_FILE. Apache determinara su ServerRoot intentando lo siguiente, en este orden:

Una directiva ServerRoot especificada con el switch -C.
El switch -d en la linea de comando.
Directorio de trabajo actual
La raiz del servidor compilada en el propio software servidor.

La raiz del servidor compilada en el software es, usualmente, sys:/apache. Invocando Apache con el switch -v se mostrara este valor etiquetado como HTTPD_ROOT.

Configurando Apache para Netware

Apache se configura con los ficheros existentes en el directorio conf. Estos son los mismos ficheros usados para configurar la version Unix, pero hay unas pocas directivas que son diferentes para la version de Apache en Netware. En la Documentacion de Apache se recogen todas las directivas disponibles.

Las principales diferencias de Apache para Netware son:

Apache para Netware es multithreaded (multihilo), por lo tanto, no se usa un proceso separado para cada solicitud tal y como Apache hace en Unix. En vez de eso solo hay treads (hilos) ejecutandose: Un hilo padre y un hilo hijo que maneja las peticiones. En el hilo hijo, cada peticion es manejada por un hilo separado.

Asi tenemos que las directivas de gestion de "procesos" son diferentes:

MaxRequestsPerChild - Como en la directiva Unix, se controla cuantas solicitudes servira un proceso antes de finalizar. Sin embargo, a diferencia de Unix, un proceso atiende todas las peticiones a la vez, no solo una, asi que si esta directiva es usada, se recomienda que se utilicen valores muy altos. El valor por defecto recomendado, MaxRequestsPerChild 0, provoca que el proceso nunca finalice.

ThreadsPerChild - Esta directiva es nueva y dice al servidor cuantos hilos de ejecucion deberia usar. Este es el maximo numero de conexiones que el servidor puede manejar a la vez; asegurese y configure este numero lo suficientemente alto para su sitio web si usted tiene muchas visitas. El valor por defecto recomendado es ThreadsPerChild 50.

ThreadStackSize - Esta directiva informa al servidor de cual es el tamaño de pila (stack) a usar para cada hilo individual. El valor por defecto recomendado es ThreadStackSize 65536
.
Las directivas que aceptan nombres de ficheros como argumentos, deben usar nombres de fichero en el estilo Netware en lugar del estilo Unix. Sin embargo, ya que Apache usa estilo Unix internamente, usted debe usar barras normales (/), no contrabarras (\). Es posible utilizar nombres de volumenes; si se omiten, el volumen donde se situa el ejecutable de Apache es asumido como el volumen por defecto.
Apache para Netware tiene la habilidad de cargar modulos en tiempo de ejecucion (runtime), sin recompilar el servidor. Si Apache es compilado normalmente, se instalaran un numero de modulos opcionales in el directorio \Apache\modules. Para activar estos u otros modulos, debe usarse la nueva directiva LoadModule. Por ejemplo, para activar el modulo Status, use lo siguiente (ademas de las directivas de 'activacion de estado' (status-activating) en access.conf):
```
    LoadModule status_module modules/status
```
Informacion sobre como crear modulos cargables tambien esta disponible.

Compilando Apache para Netware

Compilar Apache requiere que MetroWerks CodeWarrior 4.04 o superior este correctamente instalado.

Primero, descomprima la distribucion de Apache dentro de un directorio apropiado. Entonces vaya al directorio src de la distribucion de Apache y descomprima ApacheNW.mcp.gz. Usted puede usar una version reciente de WinZip o gzip para Windows para realizar este trabajo. El proyecto principal de Metrowerks para Apache (ApacheNW.mcp) esta, ahora, listo para ser usado. Tan solo haga doble click desde el Explorador y MetroWerks CodeWarrior deberia ser lanzado automaticamente.

Todos los segmentos principales de Apache pueden ser construidos usando el fichero de proyecto ApacheNW.mcp. Esto incluye modulos tales como status, info, y proxy.

Una vez que Apache ha sido construido, necesita ser instalado en su directorio raiz del servidor. El directorio por defecto es sys:/Apache.

Antes de ejecutar el servidor usted debe completar el directorio conf. Copie los ficheros *.conf-dist-nw desde el directorio conf de la distribucion y renombrelos como *.conf. Edite las entradas de la directiva ServerRoot para que apunte a su raiz del servidor principal (por ejemplo SYS:/APACHE). Copie sobre el, los ficheros conf/magic y conf/mime.types tambien.

Servidor Apache HTTP Version 1.3