Instalación de Dispatcher

Utilice la página Notas de la versión de Dispatcher para obtener el archivo de instalación más reciente de Dispatcher para su sistema operativo y servidor web. Los números de versión de Dispatcher son independientes de los números de versión de Adobe Experience Manager y son compatibles con las versiones de Adobe Experience Manager 6.x, 5.x y Adobe CQ 5.x.

NOTA

Tenga en cuenta que Adobe Experience Manager 6.5 requiere Dispatcher versión 4.3.2 o superior. Dicho esto, las versiones de Dispatcher son independientes de AEM, por ejemplo, Dispatcher versión 4.3.2 también es compatible con Adobe Experience Manager 6.4.

Se utiliza la siguiente convención de nomenclatura de archivos:

dispatcher-<web-server>-<operating-system>-<dispatcher-version-number>.<file-format>

Por ejemplo, el archivo dispatcher-apache2.4-linux-x86_64-ssl-4.3.1.tar.gz contiene la versión 4.3.1 de Dispatcher para un servidor web Apache 2.4 que se ejecuta en Linux i686 y está empaquetado con el formato tar .

La tabla siguiente muestra el identificador de servidor web que se utiliza en los nombres de archivo para cada servidor web:

Servidor web Kit de instalación
Apache 2.4 dispatcher-apache 2.4-<otros parámetros>
Microsoft Internet Information Server 7.5, 8, 8.5 dispatcher-iis-<otros parámetros>
Sun Java Web Server iPlanet dispatcher-ns-<otros parámetros>
PRECAUCIÓN

Debe instalar la versión más reciente de Dispatcher que está disponible para su plataforma. Anualmente, debe actualizar la instancia de Dispatcher para utilizar la versión más reciente y aprovechar las mejoras del producto.

Cada archivo contiene los siguientes archivos:

  • los módulos de Dispatcher
  • un archivo de configuración de ejemplo
  • el archivo README que contiene instrucciones de instalación e información de última hora
  • el archivo CAMBIOS que enumera los problemas corregidos en las versiones actuales y pasadas
NOTA

Compruebe el archivo README para ver si hay cambios de última hora o notas específicas de la plataforma antes de iniciar la instalación.

Servidor de información de Microsoft Internet

Para obtener información sobre cómo instalar este servidor web, consulte los siguientes recursos:

Componentes IIS necesarios

Las versiones 8.5 y 10 de IIS requieren que estén instalados los siguientes componentes de IIS:

  • Extensiones ISAPI

Además, debe agregar el rol Servidor Web (IIS). Utilice el Administrador del servidor para añadir la función y los componentes.

Microsoft IIS: instalación del módulo de Dispatcher

El archivo requerido para Microsoft Internet Information System es:

  • dispatcher-iis-<operating-system>-<dispatcher-release-number>.zip

El archivo ZIP contiene los siguientes archivos:

Archivo Descripción
disp_iis.dll El archivo de biblioteca de vínculos dinámicos de Dispatcher.
disp_iis.ini Archivo de configuración para IIS. Este ejemplo se puede actualizar según sus necesidades. Nota: El archivo ini debe tener el mismo nombre-raíz que el archivo dll.
dispatcher.any Archivo de configuración de ejemplo para Dispatcher.
author_dispatcher.any Archivo de configuración de ejemplo para Dispatcher que trabaja con la instancia de autor.
README Archivo Léame que contiene instrucciones de instalación e información de último minuto. Nota: Compruebe este archivo antes de iniciar la instalación.
CAMBIOS Archivo de cambios que enumera los problemas corregidos en las versiones actuales y pasadas.

Utilice el siguiente procedimiento para copiar los archivos de Dispatcher en la ubicación correcta.

  1. Utilice el Explorador de Windows para crear el directorio <IIS_INSTALLDIR>/Scripts, por ejemplo, C:\inetpub\Scripts.

  2. Extraiga los siguientes archivos del paquete Dispatcher en este directorio Scripts:

    • disp_iis.dll
    • disp_iis.ini
    • Uno de los siguientes archivos depende de si Dispatcher está trabajando con una instancia de autor o publicación AEM:
      • Instancia de autor: author_dispatcher.any
      • Publicar instancia: dispatcher.any

Microsoft IIS: Configurar el archivo INI de Dispatcher

Edite el archivo disp_iis.ini para configurar la instalación de Dispatcher. El formato básico del archivo .ini es el siguiente:

[main]
configpath=<path to dispatcher.any>
loglevel=1|2|3
servervariables=0|1
replaceauthorization=0|1

En la tabla siguiente se describe cada propiedad.

Parámetro Descripción
configpath La ubicación de dispatcher.any dentro del sistema de archivos local (ruta absoluta).
logfile La ubicación del archivo dispatcher.log. Si no se ha configurado, los mensajes de registro se dirigen al registro de eventos de windows.
loglevel Define el nivel de registro utilizado para generar mensajes en el registro de eventos. Se pueden especificar los siguientes valores:Nivel de registro para el archivo de registro:
0 - solo mensajes de error.
1 - errores y advertencias.
2 - errores, advertencias y mensajes informativos
3 - errores, advertencias, mensajes informativos y de depuración.
Nota: Se recomienda establecer el nivel de registro en 3 durante la instalación y la prueba, luego en 0 cuando se ejecuta en un entorno de producción.
replaceauthorization Especifica cómo se gestionan los encabezados de autorización en la solicitud HTTP. Los siguientes valores son válidos:
0 - Los encabezados de autorización no se modifican.
1 - Reemplaza cualquier encabezado denominado "Autorización" que no sea "Básico" por su Basic <IIS:LOGON\_USER> equivalente.
servervariables Define cómo se procesan las variables del servidor.
0 - Las variables del servidor IIS no se envían ni a Dispatcher ni a AEM.
1 - todas las variables del servidor IIS (como LOGON\_USER, QUERY\_STRING, ...) se envían a Dispatcher, junto con los encabezados de solicitud (y también a la instancia de AEM si no se almacenan en caché).
Las variables de servidor incluyen AUTH\_USER, LOGON\_USER, HTTPS\_KEYSIZE y muchas otras. Consulte la documentación de IIS para obtener la lista completa de variables, con detalles.
enable_chunked_transfer Define si se desea habilitar (1) o deshabilitar (0) la transferencia interrumpida para la respuesta del cliente. El valor predeterminado es 0.

Un ejemplo de configuración:

[main]
configpath=C:\Inetpub\Scripts\dispatcher.any
loglevel=1
servervariables=1
replaceauthorization=0

Configuración de Microsoft IIS

Configure IIS para integrar el módulo ISAPI de Dispatcher. En IIS se utiliza la asignación de aplicación comodín.

Configuración del acceso anónimo: IIS 8.5 y 10

El agente de replicación de vaciado predeterminado en la instancia de autor está configurado para que no envíe credenciales de seguridad con solicitudes de vaciado. Por lo tanto, el sitio web que esté utilizando la caché de Dispatcher debe permitir el acceso anónimo.

Si su sitio web utiliza un método de autenticación, el agente de replicación de vaciado debe configurarse en consecuencia.

  1. Abra el Administrador de IIS y seleccione el sitio web que está utilizando como caché de Disptcher.
  2. Con el modo Vista de características, en la sección IIS haga doble clic en Autenticación.
  3. Si la autenticación anónima no está activada, seleccione Autenticación anónima y, en el área Acciones, haga clic en Habilitar.

Integración del módulo ISAPI de Dispatcher - IIS 8.5 y 10

Utilice el siguiente procedimiento para agregar el módulo ISAPI de Dispatcher a IIS.

  1. Abra el Administrador de IIS.

  2. Seleccione el sitio web que está utilizando como caché de Dispatcher.

  3. Con el modo Vista de características, en la sección IIS haga doble clic en Asignaciones de controladores.

  4. En el panel Acciones de la página Asignaciones de controladores , haga clic en Agregar mapa de script comodín, agregue los siguientes valores de propiedad y, a continuación, haga clic en Aceptar:

    • Ruta de solicitud: *
    • Ejecutable: La ruta absoluta del archivo disp_iis.dll, por ejemplo C:\inetpub\Scripts\disp_iis.dll.
    • Nombre: Un nombre descriptivo para la asignación de controladores, por ejemplo Dispatcher.
  5. En el cuadro de diálogo que aparece, para agregar la biblioteca disp_iis.dll a la lista Restricciones ISAPI y CGI, haga clic en Sí.

    Para IIS 7.0 y 7.5, la configuración se ha completado. Continúe con los pasos restantes si está configurando IIS 8.0.

  6. (IIS 8.0) En la lista de asignaciones de controladores, seleccione la que acaba de crear y, en el área Acciones, haga clic en Editar.

  7. (IIS 8.0) En el cuadro de diálogo Editar mapa de secuencia de comandos, haga clic en el botón Solicitar restricciones .

  8. (IIS 8.0) Para asegurarse de que el controlador se utiliza para archivos y carpetas que aún no se han almacenado en caché, anule la selección de Invocar controlador solo si la solicitud está asignada a y, a continuación, haga clic en Aceptar.

  9. (IIS 8.0) En el cuadro de diálogo Editar mapa de script, haga clic en Aceptar.

Configuración del acceso a la caché: IIS 8.5 y 10

Proporcione al usuario predeterminado del grupo de aplicaciones acceso de escritura a la carpeta que se está utilizando como caché de Dispatcher.

  1. Haga clic con el botón derecho en la carpeta raíz del sitio web que esté utilizando como caché de Dispatcher y haga clic en Propiedades, como C:\inetpub\wwwroot.

  2. En la ficha Seguridad, haga clic en Editar y, a continuación, en el cuadro de diálogo Permisos, haga clic en Agregar. Se abre un cuadro de diálogo para seleccionar cuentas de usuario. Haga clic en el botón Ubicaciones, seleccione el nombre del equipo y, a continuación, haga clic en Aceptar.

    Mantenga este cuadro de diálogo abierto mientras completa el paso siguiente.

  3. en el Administrador de IIS, seleccione el sitio de IIS que está utilizando para la caché de Dispatcher y, en el lado derecho de la ventana, haga clic en Configuración avanzada.

  4. Seleccione el valor de la propiedad Grupo de aplicaciones y cópielo en el portapapeles.

  5. Vuelva al cuadro de diálogo abierto. En el cuadro Escriba los nombres de los objetos que desea seleccionar, escriba IIS AppPool\ y pegue el contenido del portapapeles. El valor debe ser similar al siguiente ejemplo:

    IIS AppPool\DefaultAppPool

  6. Haga clic en el botón Comprobar nombres . Cuando Windows resuelva la cuenta de usuario, haga clic en Aceptar.

  7. En el cuadro de diálogo Permisos de la carpeta de Dispatcher, seleccione la cuenta que acaba de agregar, habilite todos los permisos de la cuenta excepto Control total y haga clic en Aceptar. Haga clic en Aceptar para cerrar el cuadro de diálogo Propiedades de la carpeta.

Registro del tipo de MIME de JSON: IIS 8.5 y 10

Utilice el siguiente procedimiento para registrar el tipo MIME JSON, cuando desee que Dispatcher permita llamadas JSON.

  1. En el Administrador de IIS, seleccione el sitio web y, mediante la Vista de características, haga doble clic en Tipos de MIME.

  2. Si la extensión JSON no está en la lista, en el panel Acciones haga clic en Agregar, introduzca los siguientes valores de propiedad y, a continuación, haga clic en Aceptar:

    • Extensión de nombre de archivo: .json
    • Tipo MIME: application/json

Eliminación del segmento oculto bin - IIS 8.5 y 10

Utilice el siguiente procedimiento para eliminar el segmento oculto bin. Los sitios web que no son nuevos pueden contener este segmento oculto.

  1. En el Administrador de IIS, seleccione el sitio web y, mediante la Vista de características, haga doble clic en Solicitar filtrado.
  2. Seleccione el segmento bin, haga clic en Quitar y, en el cuadro de diálogo de confirmación, haga clic en Sí.

Registro de mensajes IIS en un archivo: IIS 8.5 y 10

Utilice el siguiente procedimiento para escribir los mensajes de registro de Dispatcher en un archivo de registro en lugar de en el registro de eventos de Windows. Debe configurar Dispatcher para que utilice el archivo de registro y proporcionar a IIS acceso de escritura al archivo.

  1. Utilice el Explorador de Windows para crear una carpeta denominada dispatcher debajo de la carpeta de registros de la instalación de IIS. La ruta de esta carpeta para una instalación típica es C:\inetpub\logs\dispatcher.

  2. Haga clic con el botón derecho en la carpeta de Dispatcher y haga clic en Propiedades.

  3. En la ficha Seguridad, haga clic en Editar y, a continuación, en el cuadro de diálogo Permisos, haga clic en Agregar. Se abre un cuadro de diálogo para seleccionar cuentas de usuario. Haga clic en el botón Ubicaciones, seleccione el nombre del equipo y, a continuación, haga clic en Aceptar.

    Mantenga este cuadro de diálogo abierto mientras completa el paso siguiente.

  4. en el Administrador de IIS, seleccione el sitio de IIS que está utilizando para la caché de Dispatcher y, en el lado derecho de la ventana, haga clic en Configuración avanzada.

  5. Seleccione el valor de la propiedad Grupo de aplicaciones y cópielo en el portapapeles.

  6. Vuelva al cuadro de diálogo abierto. En el cuadro Escriba los nombres de los objetos que desea seleccionar, escriba IIS AppPool\ y pegue el contenido del portapapeles. El valor debe ser similar al siguiente ejemplo:

    IIS AppPool\DefaultAppPool

  7. Haga clic en el botón Comprobar nombres . Cuando Windows resuelva la cuenta de usuario, haga clic en Aceptar.

  8. En el cuadro de diálogo Permisos de la carpeta de Dispatcher, seleccione la cuenta que acaba de agregar, habilite todos los permisos de la cuenta excepto Control total, y haga clic en Aceptar. Haga clic en Aceptar para cerrar el cuadro de diálogo Propiedades de la carpeta.

  9. Utilice un editor de texto para abrir el archivo disp_iis.ini.

  10. Agregue una línea de texto similar al siguiente ejemplo para configurar la ubicación del archivo de registro y, a continuación, guarde el archivo:

    logfile=C:\inetpub\logs\dispatcher\dispatcher.log
    

Pasos siguientes

Antes de empezar a utilizar Dispatcher, debe saber:

  • 🔗 ConfigureDispatcher
  • Configure AEM para que funcione con Dispatcher.

Servidor web Apache

PRECAUCIÓN

Las instrucciones de instalación en Windows y Unix se tratan aquí. Tenga cuidado al realizar los pasos.

Instalación del servidor web Apache

Para obtener información acerca de cómo instalar un servidor web Apache, lea el manual de instalación: online o en la distribución.

PRECAUCIÓN

Si está creando un binario de Apache compilando los archivos de origen, asegúrese de activar dynamic module support. Esto se puede hacer utilizando cualquiera de las opciones —enable-shared. Como mínimo, incluya el módulo mod_so.

Puede encontrar más información en el manual de instalación de Apache Web Server.

Consulte también los Consejos de seguridad y Informes de seguridad del servidor HTTP de Apache.

Servidor web Apache: Añadir el módulo de Dispatcher

Dispatcher se presenta como:

  • Windows: una biblioteca de vínculos dinámicos (DLL)
  • Unix: un objeto compartido dinámico (DSO)

Los archivos de archivo de instalación contienen los siguientes archivos, en función de si ha seleccionado Windows o Unix:

Archivo Descripción
disp_apache<x.y>.dll Windows: El archivo de biblioteca de vínculos dinámicos de Dispatcher.
dispatcher-apache<x.y>-<rel-nr>.so Unix: El archivo de biblioteca de objetos compartidos de Dispatcher.
mod_dispatcher.so Unix: Un vínculo de ejemplo.
http.conf.disp<x> Archivo de configuración de ejemplo para el servidor Apache.
dispatcher.any Archivo de configuración de ejemplo para Dispatcher.
README Archivo Léame que contiene instrucciones de instalación e información de último minuto. Nota: Compruebe este archivo antes de iniciar la instalación.
CAMBIOS Archivo de cambios que enumera los problemas corregidos en las versiones actual y anterior.

Siga los siguientes pasos para agregar Dispatcher a su servidor web Apache:

  1. Coloque el archivo Dispatcher en el directorio de módulos Apache apropiado:

    • Windows: Lugar disp_apache<x.y>.dll <APACHE_ROOT>/modules

    • Unix: Localice el <APACHE_ROOT>/libexec directorio o <APACHE_ROOT>/modulessegún su instalación.\

      Copie dispatcher-apache<options>.so en este directorio.
      Para simplificar el mantenimiento a largo plazo, también puede crear un vínculo simbólico denominado mod_dispatcher.so al Dispatcher:
      ln -s dispatcher-apache<x>-<os>-<rel-nr>.so mod_dispatcher.so

  2. Copie el archivo dispatcher.any en el directorio <APACHE_ROOT>/conf .

    Nota: Puede colocar este archivo en una ubicación diferente, siempre y cuando la propiedad DispatcherLog del módulo de Dispatcher esté configurada en consecuencia. (Consulte Entradas de configuración específicas de Dispatcher a continuación).

Servidor web Apache: Configurar propiedades de SELinux

Si está ejecutando Dispatcher en RedHat Linux Kernel 2.6 con SELinux habilitado, puede encontrarse con mensajes de error como este en el archivo de registro de Dispatcher.

Mon Jun 30 00:03:59 2013] [E] [16561(139642697451488)] Unable to connect to backend rend01 (10.122.213.248:4502): Permission denied

Esto se debe probablemente a una seguridad SELinux habilitada. A continuación, debe realizar las siguientes tareas:

  • Configure el contexto SELinux del archivo del módulo de Dispatcher.
  • Habilite los scripts y módulos HTTPD para realizar conexiones de red.
  • Configure el contexto SELinux de docroot, donde se almacenan los archivos en caché.

Introduzca los siguientes comandos en una ventana de terminal, reemplazando [path to the dispatcher.so file] por la ruta al módulo de Dispatcher que instaló en el servidor web Apache, y path to the docroot por la ruta donde se encuentra el docroot (por ejemplo, /opt/cq/cache):

semanage fcontext -a -t httpd_modules_t [path to the dispatcher.so file]
setsebool -P httpd_can_network_connect on
chcon -R --type httpd_sys_content_t [path to the docroot]
semanage fcontext -a -t httpd_sys_content_t "[path to the docroot](/.*)?"

Servidor web Apache: Configurar el servidor web Apache para Dispatcher

El servidor web Apache debe configurarse mediante httpd.conf. En el kit de instalación de Dispatcher encontrará un archivo de configuración de ejemplo llamado httpd.conf.disp<x>.

Estos pasos son obligatorios:

  1. Ir a <APACHE_ROOT>/conf.

  2. Abra httpd.confpara editarlo.

  3. Se deben añadir las siguientes entradas de configuración, en el orden indicado:

    • ​LoadModupara cargar el módulo al iniciarlo.
    • Entradas de configuración específicas del Dispatcher, incluidas DispatcherConfig, DispatcherLog y DispatcherLogLevel.
    • ​SetHandler para activar Dispatcher. LoadModule.
    • ​ModMimeUsePathInfoto configure el comportamiento de mod_mime.
  4. (Opcional) Se recomienda cambiar el propietario del directorio htdocs:

    • El servidor Apache se inicia como raíz, aunque los procesos secundarios se inician como daemon (por motivos de seguridad). DocumentRoot (<APACHE_ROOT>/htdocs) debe pertenecer al demonio de usuario:

      cd <APACHE_ROOT>  
      chown -R daemon:daemon htdocs
      

LoadModule

En la tabla siguiente se enumeran los ejemplos que se pueden utilizar; las entradas exactas están según su servidor web Apache específico:

Windows ... LoadModule dispatcher_module modules\disp_apache.dll ...
Unix (suponiendo vínculo simbólico) ... LoadModule dispatcher_module libexec/mod_dispatcher.so ...
NOTA

El primer parámetro de cada instrucción debe escribirse exactamente como en los ejemplos anteriores.

Consulte los archivos de configuración de ejemplo proporcionados y la documentación del servidor web Apache para obtener información detallada sobre este comando.

Entradas de configuración específicas de Dispatcher

Las entradas de configuración específicas de Dispatcher se colocan después de la entrada LoadModule. En la tabla siguiente se muestra un ejemplo de configuración aplicable tanto a Unix como a Windows:

Windows y Unix

...
<fModule disp_apache2.c>
DispatcherConfig conf/dispatcher.any
DispatcherLog logs/dispatcher.log DispatcherLogLevel 3
DispatcherNoServerHeader 0 DispatcherDeclineRoot 0
DispatcherUseProcessedURL 0
DispatcherPassError 0
DispatcherKeepAliveTimeout 60
</IfModule>
...

Los parámetros de configuración individuales:

Parámetro Descripción
DispatcherConfig Ubicación y nombre del archivo de configuración de Dispatcher.
Cuando esta propiedad se encuentra en la configuración del servidor principal, todos los hosts virtuales heredan el valor de la propiedad. Sin embargo, los hosts virtuales pueden incluir una propiedad DispatcherConfig para anular la configuración principal del servidor.
DispatcherLog Ubicación y nombre del archivo de registro.
DispatcherLogLevel Nivel de registro del archivo de registro:
0 - Errores
1 - Advertencias
2 - Infos
3 - Depuración
Nota: Se recomienda establecer el nivel de registro en 3 durante la instalación y la prueba, luego en 0 cuando se ejecuta en un entorno de producción.
DispatcherNoServerHeader Este parámetro está obsoleto y ya no tiene ningún efecto.

Define el encabezado del servidor que se va a utilizar:
  • undefined o 0: el encabezado del servidor HTTP contiene la versión AEM.
  • 1 - se utiliza el encabezado del servidor Apache.
DispatcherDeclineRoot Define si se rechazan las solicitudes en la raíz "/":
0 - aceptar solicitudes a /
1 - las solicitudes a / no son gestionadas por el despachante; utilice mod_alias para la asignación correcta.
DispatcherUseProcessedURL Define si se deben usar direcciones URL preprocesadas para todo el procesamiento posterior de Dispatcher:
0: use la URL original que se pasó al servidor web.
1 : Dispatcher utiliza la dirección URL que ya han procesado los controladores anteriores a Dispatcher (es decir, mod_rewrite) en lugar de la URL original que se pasa al servidor web. Por ejemplo, la dirección URL original o procesada coincide con los filtros de Dispatcher. La URL también se utiliza como base para la estructura de archivos de caché. Consulte la documentación del sitio web de Apache para obtener información sobre mod_rewrite; por ejemplo, Apache 2.4. Al utilizar mod_rewrite, es aconsejable utilizar el indicador 'passthrough'
DispatcherPassError Define cómo se admiten los códigos de error para la gestión de ErrorDocument:
0: Dispatcher pone en cola todas las respuestas de error al cliente.
1 - Dispatcher no envía una respuesta de error al cliente (donde el código de estado es bueno o igual a 400), pero pasa el código de estado a Apache, que, por ejemplo, permite que una directiva ErrorDocument procese dicho código de estado.
Rango de códigos : especifique un rango de códigos de error para los que la respuesta se pasa a Apache. Se pasan otros códigos de error al cliente. Por ejemplo, la siguiente configuración pasa al cliente las respuestas del error 412 y todos los demás errores se pasan a Apache: DispatcherPassError 400-411,413-417
DispatcherKeepAliveTimeout Especifica el tiempo de espera de mantenimiento, en segundos. A partir de la versión 4.2.0 de Dispatcher, el valor predeterminado de mantener vivo es 60. Un valor de 0 deshabilita keep-live.
DispatcherNoCanonURL Si se establece este parámetro en Activado, se pasará la URL sin procesar al servidor en lugar de la canonicalizada y se anulará la configuración de DispatcherUseProcessedURL. El valor predeterminado es Desactivado.
Nota: Las reglas de filtro de la configuración de Dispatcher siempre se evaluarán con la URL saneada, no con la URL sin procesar.
NOTA

Las entradas de ruta son relativas al directorio raíz del servidor web Apache.

NOTA

La configuración predeterminada para el encabezado del servidor es:

ServerTokens Full

DispatcherNoServerHeader 0

que muestra la versión AEM (con fines estadísticos). Si desea deshabilitar que esta información esté disponible en el encabezado, puede establecer:

ServerTokens Prod

Consulte la Documentación de Apache sobre la Directiva de ServerTokens (por ejemplo, para Apache 2.4) para obtener más información.

SetHandler

Después de estas entradas, debe agregar una instrucción SetHandler al contexto de la configuración ( <Directory>, <Location>) para que Dispatcher gestione las solicitudes entrantes. El siguiente ejemplo configura Dispatcher para que gestione las solicitudes del sitio web completo:

Windows y Unix

...  
<Directory />  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
</IfModule>  
  
Options FollowSymLinks  
AllowOverride None  
</Directory>  
...

El siguiente ejemplo configura Dispatcher para que gestione las solicitudes de un dominio virtual:

Windows

...  
<VirtualHost 123.45.67.89>  
ServerName www.mycompany.com  
DocumentRoot _\[cache-path\]_\\docs  
<Directory _\[cache-path\]_\\docs>  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
</IfModule>  
AllowOverride None  
</Directory>  
</VirtualHost>  
...

Unix

...  
<VirtualHost 123.45.67.89>  
ServerName www.mycompany.com  
DocumentRoot /usr/apachecache/docs  
<Directory /usr/apachecache/docs>  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
</IfModule>  
AllowOverride None  
</Directory>  
</VirtualHost>  
...
NOTA

El parámetro de la sentencia SetHandler debe escribirse exactamente como en los ejemplos anteriores, ya que es el nombre del controlador definido en el módulo.

Consulte los archivos de configuración de ejemplo proporcionados y la documentación del servidor web Apache para obtener información detallada sobre este comando.

ModMimeUsePathInfo

Después de la instrucción SetHandler también debe agregar la definición ModMimeUsePathInfo.

NOTA

El parámetro ModMimeUsePathInfo solo debe usarse y configurarse si utiliza la versión 4.0.9 o superior de Dispatcher.

(Tenga en cuenta que la versión 4.0.9 de Dispatcher se publicó en 2011. Si utiliza una versión anterior, sería apropiado actualizar a una versión reciente de Dispatcher).

El parámetro ModMimeUsePathInfo debe establecerse On para todas las configuraciones de Apache:

ModMimeUsePathInfo On

El módulo mod_mime (consulte, por ejemplo, Apache Module mod_mime) se utiliza para asignar metadatos de contenido al contenido seleccionado para una respuesta HTTP. La configuración predeterminada significa que cuando mod_mime determina el tipo de contenido, solo se tendrá en cuenta la parte de la dirección URL que se asigna a un archivo o directorio.

Cuando On, el parámetro ModMimeUsePathInfo especifica que mod_mime es para determinar el tipo de contenido en función de la dirección URL complete; esto significa que los recursos virtuales tendrán información de metadatos aplicada según su extensión.

El siguiente ejemplo activa ModMimeUsePathInfo:

Windows y Unix

...  
<Directory />  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
ModMimeUsePathInfo On  
</IfModule>  
  
Options FollowSymLinks  
AllowOverride None  
</Directory>  
...

Habilitar compatibilidad con HTTPS (Unix y Linux)

Dispatcher utiliza OpenSSL para implementar la comunicación segura a través de HTTP. A partir de la versión de Dispatcher 4.2.0, se admiten OpenSSL 1.0.0 y OpenSSL 1.0.1. Dispatcher utiliza OpenSSL 1.0.0 de forma predeterminada. Para utilizar OpenSSL 1.0.1, utilice el siguiente procedimiento para crear vínculos simbólicos de modo que Dispatcher utilice las bibliotecas OpenSSL instaladas.

  1. Abra un terminal y cambie el directorio actual al directorio donde están instaladas las bibliotecas OpenSSL, por ejemplo:

    cd /usr/lib64
    
  2. Para crear los vínculos simbólicos, introduzca los siguientes comandos:

    ln -s libssl.so libssl.so.1.0.1
    ln -s libcrypto.so libcrypto.so.1.0.1
    
NOTA

Si utiliza una versión personalizada de Apache, asegúrese de que Apache y Dispatcher estén compilados con la misma versión de OpenSSL.

Pasos siguientes

Antes de empezar a utilizar Dispatcher, ahora debe:

  • 🔗 ConfigureDispatcher
  • Configure AEM para que funcione con Dispatcher.

Sun Java System Web Server / iPlanet

NOTA

Las instrucciones para los entornos Windows y Unix se tratan aquí.

Tenga cuidado al seleccionar qué ejecutar.

Sun Java System Web Server / iPlanet - Instalación del servidor web

Para obtener información completa sobre cómo instalar estos servidores web, consulte su documentación correspondiente:

  • Sun Java System Web Server
  • Servidor web iPlanet

Sun Java System Web Server / iPlanet - Añadir el módulo Dispatcher

Dispatcher se presenta como:

  • Windows: una biblioteca de vínculos dinámicos (DLL)
  • Unix: un objeto compartido dinámico (DSO)

Los archivos de archivo de instalación contienen los siguientes archivos, en función de si ha seleccionado Windows o Unix:

Archivo Descripción
disp_ns.dll Windows: El archivo de biblioteca de vínculos dinámicos de Dispatcher.
dispatcher.so Unix: El archivo de biblioteca de objetos compartidos de Dispatcher.
dispatcher.so Unix: Un vínculo de ejemplo.
obj.conf.disp Archivo de configuración de ejemplo para el servidor web iPlanet/Sun Java System.
dispatcher.any Archivo de configuración de ejemplo para Dispatcher.
README Archivo Léame que contiene instrucciones de instalación e información de último minuto. Nota: Compruebe este archivo antes de iniciar la instalación.
CAMBIOS Archivo de cambios que enumera los problemas corregidos en las versiones actual y anterior.

Siga los siguientes pasos para agregar Dispatcher a su servidor web:

  1. Coloque el archivo Dispatcher en el directorio plugin del servidor web:

Sun Java System Web Server / iPlanet - Configurar para Dispatcher

Es necesario configurar el servidor web mediante obj.conf. En el kit de instalación de Dispatcher encontrará un archivo de configuración de ejemplo llamado obj.conf.disp.

  1. Ir a <WEBSERVER_ROOT>/config.

  2. Abra obj.confpara editarlo.

  3. Copie la línea que empieza:
    Service fn="dispService"
    de obj.conf.disp a la sección de inicialización de obj.conf.

  4. Guarde los cambios.

  5. Abra magnus.conf para editarlo.

  6. Copie las dos líneas que empiezan:
    Init funcs="dispService, dispInit"
    y
    Init fn="dispInit"
    de obj.conf.disp a la sección de inicialización de magnus.conf.

  7. Guarde los cambios.

NOTA

Las siguientes configuraciones deben estar todas en una línea y los valores $(SERVER_ROOT) y $(PRODUCT_SUBDIR) deben reemplazarse por los valores respectivos.

Init

En la tabla siguiente se enumeran los ejemplos que se pueden utilizar; las entradas exactas están según el servidor web específico:

Windows y Unix

...  
Init funcs="dispService,dispInit" fn="load-modules" shlib="$(SERVER\_ROOT)/plugins/dispatcher.so"  
Init fn="dispInit" config="$(PRODUCT\_SUBDIR)/dispatcher.any" loglevel="1" logfile="$(PRODUCT\_SUBDIR)/logs/dispatcher.log"  
keepalivetimeout="60"  
...

donde:

Parámetro Descripción
config Ubicación y nombre del archivo de configuración dispatcher.any.
logfile Ubicación y nombre del archivo de registro.
loglevel Nivel de registro para al escribir mensajes en el archivo de registro:
0 Errores
1 Advertencias
2 Infos
3 Depuración
Nota: Se recomienda establecer el nivel de registro en 3 durante la instalación y prueba y en 0 cuando se ejecute en un entorno de producción.
keepalivetimeout Especifica el tiempo de espera de mantenimiento, en segundos. A partir de la versión 4.2.0 de Dispatcher, el valor predeterminado de mantener vivo es 60. Un valor de 0 deshabilita keep-live.

Según sus necesidades, puede definir Dispatcher como un servicio para sus objetos. Para configurar Dispatcher para todo el sitio web, modifique el objeto predeterminado:

Windows

...  
NameTrans fn="document-root" root="$(PRODUCT\_SUBDIR)\\dispcache"  
...  
Service fn="dispService" method="(GET|HEAD|POST)" type="\*\\\*"  
...

Unix

...  
NameTrans fn="document-root" root="$(PRODUCT\_SUBDIR)/dispcache"  
...  
Service fn="dispService" method="(GET|HEAD|POST)" type="\*/\*"  
...

Pasos siguientes

Antes de empezar a utilizar Dispatcher, ahora debe:

  • 🔗 ConfigureDispatcher
  • Configure AEM para que funcione con Dispatcher.

En esta página