Show Menu
TÓPICOS×

Instalação do Dispatcher

As versões do Dispatcher são independentes do AEM. Você pode ter sido redirecionado para esta página se tiver seguido um link para a documentação do Dispatcher incorporada à documentação de uma versão anterior do AEM.
Use a página Notas de versão do Dispatcher para obter o arquivo de instalação mais recente do Dispatcher para seu sistema operacional e servidor da Web. Os números de versão do Dispatcher são independentes dos números de versão do Adobe Experience Manager e são compatíveis com as versões Adobe Experience Manager 6.x, 5.x e Adobe CQ 5.x.
A seguinte convenção de nomenclatura de arquivos é usada:
dispatcher-<web-server>-<operating-system>-<dispatcher-version-number>.<file-format>
Por exemplo, o dispatcher-apache2.4-linux-x86_64-ssl-4.3.1.tar.gz arquivo contém a versão 4.3.1 do Dispatcher para um servidor da Web Apache 2.4 que é executado no Linux i686 e é empacotado usando o formato tar .
A tabela a seguir lista o identificador do servidor da Web usado em nomes de arquivos para cada servidor da Web:
Servidor Web
Kit de instalação
Apache 2.4
dispatcher-apache 2.4 -<outros parâmetros>
Microsoft Internet Information Server 7.5, 8, 8.5
dispatcher- iis -<outros parâmetros>
Sun Java Web Server iPlanet
dispatcher- ns -<outros parâmetros>
Instale a versão mais recente do Dispatcher disponível para a sua plataforma. Anualmente, você deve atualizar sua instância do Dispatcher para usar a versão mais recente para aproveitar as melhorias do produto.
Cada arquivo contém os seguintes arquivos:
  • os módulos do Dispatcher
  • um exemplo de arquivo de configuração
  • o arquivo README que contém instruções de instalação e informações de última hora
  • o arquivo CHANGES que lista problemas corrigidos em versões atuais e anteriores
Verifique o arquivo README para ver as alterações de última hora / notas específicas da plataforma antes de iniciar a instalação.

Microsoft Internet Information Server

Para obter informações sobre como instalar este servidor da Web, consulte os seguintes recursos:

Componentes obrigatórios do IIS

As versões 8.5 e 10 do IIS exigem que os seguintes componentes do IIS estejam instalados:
  • Extensões ISAPI
Além disso, você deve adicionar a função Servidor Web (IIS). Use o Server Manager para adicionar a função e os componentes.

Microsoft IIS - Instalação do módulo Dispatcher

O arquivo necessário para o Microsoft Internet Information System é:
  • dispatcher-iis-<operating-system>-<dispatcher-release-number>.zip
O arquivo ZIP contém os seguintes arquivos:
Arquivo
Descrição
disp_iis.dll
O arquivo da biblioteca de links dinâmicos do Dispatcher.
disp_iis.ini
Arquivo de configuração do IIS. Este exemplo pode ser atualizado com seus requisitos. Observação : O arquivo ini deve ter o mesmo nome-raiz da dll.
dispatcher.any
Um arquivo de configuração de exemplo para o Dispatcher.
author_dispatcher.any
Um arquivo de configuração de exemplo para o Dispatcher que trabalha com a instância do autor.
LEIA
Arquivo Leia-me que contém instruções de instalação e informações de última hora. Observação : Verifique este arquivo antes de iniciar a instalação.
ALTERAÇÕES
Altera o arquivo que lista problemas corrigidos em versões atuais e anteriores.
Use o procedimento a seguir para copiar os arquivos do Dispatcher para o local correto.
  1. Use o Windows Explorer para criar o <IIS_INSTALLDIR>/Scripts diretório, por exemplo, C:\inetpub\Scripts .
  2. Extraia os seguintes arquivos do pacote Dispatcher para este diretório Scripts:
    • disp_iis.dll
    • disp_iis.ini
    • Um dos seguintes arquivos, dependendo se o Dispatcher está trabalhando com uma instância de autor AEM ou de publicação:
      • Instância do autor: author_dispatcher.any
      • Instância de publicação: dispatcher.any

Microsoft IIS - Configurar o arquivo INI do Dispatcher

Edite o disp_iis.ini arquivo para configurar a instalação do Dispatcher. O formato básico do .ini arquivo é o seguinte:
[main]
configpath=<path to dispatcher.any>
loglevel=1|2|3
servervariables=0|1
replaceauthorization=0|1

A tabela a seguir descreve cada propriedade.
Parâmetro
Descrição
configpath
O local do dispatcher.any no sistema de arquivos local (caminho absoluto).
ficheiro
A localização do dispatcher.log arquivo. Se isso não estiver definido, as mensagens de registro serão enviadas para o registro de eventos do Windows.
loglevel
Define o Nível de log usado para enviar mensagens para o log de eventos. Os seguintes valores podem ser especificados:Nível de log para o arquivo de log:
0 - somente mensagens de erro.
1 - erros e avisos.
2 - erros, avisos e mensagens informativas
3 - erros, avisos, mensagens informativas e de depuração.
Observação : É recomendável definir o nível de log como 3 durante a instalação e o teste, depois como 0 quando executado em um ambiente de produção.
autorização de substituição
Especifica como os cabeçalhos de autorização na solicitação HTTP são tratados. Os seguintes valores são válidos:
0 - Os cabeçalhos de autorização não são modificados.
1 - Substitui qualquer cabeçalho chamado "Autorização", que não seja "Básica", por seu Basic <IIS:LOGON\_USER> equivalente.
server vervariables
Define como as variáveis do servidor são processadas.
0 - As variáveis do servidor IIS não são enviadas para o Dispatcher nem para o AEM.
1 - todas as variáveis do servidor do IIS (como LOGON\_USER, QUERY\_STRING, ... ) são enviadas ao Dispatcher, juntamente com os cabeçalhos de solicitação (e também à instância AEM, se não forem armazenadas em cache).
As variáveis do servidor incluem AUTH\_USER, LOGON\_USER, HTTPS\_KEYSIZE e muitas outras. Consulte a documentação do IIS para obter a lista completa de variáveis, com detalhes.
enable_chunked_transfer
Define se deve ser ativada (1) ou desabilitada (0) a transferência fragmentada para a resposta do cliente. O valor padrão é 0.
Uma configuração de exemplo:
[main]
configpath=C:\Inetpub\Scripts\dispatcher.any
loglevel=1
servervariables=1
replaceauthorization=0

Configuração do Microsoft IIS

Configure o IIS para integrar o módulo Dispatcher ISAPI. No IIS, você usa o mapeamento de aplicativo curinga.

Configuração do acesso anônimo - IIS 8.5 e 10

O agente de replicação de Liberação padrão na instância Autor está configurado para que não envie credenciais de segurança com solicitações de liberação. Portanto, o site que você está usando um cache do Dispatcher deve permitir acesso anônimo.
Se seu site usa um método de autenticação, o agente de replicação de Flash deve ser configurado de acordo.
  1. Abra o Gerenciador do IIS e selecione o site que você está usando como cache do Disptcher.
  2. Usando o modo de Visualização Recursos, na seção IIS, duplo clique em Autenticação.
  3. Se a Autenticação Anônima não estiver ativada, selecione Autenticação Anônima e, na área Ações, clique em Ativar.

Integração do módulo Dispatcher ISAPI - IIS 8.5 e 10

Use o procedimento a seguir para adicionar o Dispatcher ISAPI Module ao IIS.
  1. Abra o Gerenciador do IIS.
  2. Selecione o site que você está usando como Cache do Dispatcher.
  3. Usando o modo de Visualização Recursos, na seção IIS, duplo clique em Manipuladores.
  4. No painel Ações da página Mapeamentos do manipulador, clique em Adicionar mapa de script curinga, adicione os seguintes valores de propriedade e clique em OK:
    • Caminho da solicitação: *
    • Executável: O caminho absoluto do arquivo disp_is.dll, por exemplo C:\inetpub\Scripts\disp_iis.dll .
    • Nome: Um nome descritivo para o mapeamento do manipulador, por exemplo Dispatcher .
  5. Na caixa de diálogo exibida, para adicionar a biblioteca disp_is.dll à lista ISAPI e restrições CGI, clique em Sim.
    Para o IIS 7.0 e 7.5, a configuração está concluída. Continue com as etapas restantes se você estiver configurando o IIS 8.0.
  6. (IIS 8.0) Na lista dos mapeamentos do manipulador, selecione o que você acabou de criar e, na área Ações, clique em Editar.
  7. (IIS 8.0) Na caixa de diálogo Editar mapa de script, clique no botão Restrições de solicitação.
  8. (IIS 8.0) Para garantir que o manipulador seja usado para arquivos e pastas que ainda não estão em cache, desmarque a opção Chamar manipulador somente se a solicitação estiver mapeada e clique em OK.
  9. (IIS 8.0) Na caixa de diálogo Editar mapa de script, clique em OK.

Configuração do acesso ao cache - IIS 8.5 e 10

Forneça ao usuário padrão do App Pool acesso de gravação à pasta que está sendo usada como cache do Dispatcher.
  1. Clique com o botão direito do mouse na pasta raiz do site que você está usando como cache do Dispatcher e clique em Propriedades, como C:\inetpub\wwwroot .
  2. Na guia Segurança, clique em Editar e, na caixa de diálogo Permissões, clique em Adicionar. Uma caixa de diálogo é aberta para selecionar contas de usuário. Clique no botão Locais, selecione o nome do computador e clique em OK.
    Mantenha essa caixa de diálogo aberta enquanto conclui a próxima etapa.
  3. no Gerenciador do IIS, selecione o site do IIS que você está usando para o cache do Dispatcher e, no lado direito da janela, clique em Configurações avançadas.
  4. Selecione o valor da propriedade Pool de Aplicativos e copie-o para a área de transferência.
  5. Retorne à caixa de diálogo aberta. Na caixa Inserir os nomes dos objetos a serem selecionados, digite IIS AppPool\ e cole o conteúdo da área de transferência. O valor deve ser semelhante ao seguinte exemplo:
    IIS AppPool\DefaultAppPool
  6. Clique no botão Verificar nomes. Quando o Windows resolver a conta de usuário, clique em OK.
  7. Na caixa de diálogo Permissões da pasta do dispatcher, selecione a conta que você acabou de adicionar, ative todas as permissões para a conta, exceto para Controle total, e clique em OK. Clique em OK para fechar a caixa de diálogo Propriedades da pasta.

Registrando o tipo MIME JSON - IIS 8.5 e 10

Use o procedimento a seguir para registrar o tipo MIME JSON, quando quiser que o Dispatcher permita chamadas JSON.
  1. No Gerenciador do IIS, selecione seu site e, usando a Visualização Recursos, clique em Tipos MIME com o duplo pressionado.
  2. Se a extensão JSON não estiver na lista, no painel Ações, clique em Adicionar, digite os seguintes valores de propriedade e clique em OK:
    • Extensão do nome do arquivo: .json
    • Tipo MIME: application/json

Remoção do segmento do compartimento oculto - IIS 8.5 e 10

Use o procedimento a seguir para remover o segmento bin oculto. Os sites que não são novos podem conter esse segmento oculto.
  1. No Gerenciador do IIS, selecione seu site e, usando a Visualização de recursos, clique no duplo em Filtragem de solicitações.
  2. Selecione o bin segmento, clique em Remover e, na caixa de diálogo de confirmação, clique em Sim.

Registrando mensagens do IIS em um arquivo - IIS 8.5 e 10

Use o procedimento a seguir para gravar mensagens de log do Dispatcher em um arquivo de log em vez de no log de Eventos do Windows. É necessário configurar o Dispatcher para usar o arquivo de log e fornecer ao IIS acesso de gravação ao arquivo.
  1. Use o Windows Explorer para criar uma pasta chamada dispatcher abaixo da pasta logs da instalação do IIS. O caminho desta pasta para uma instalação típica é C:\inetpub\logs\dispatcher .
  2. Clique com o botão direito do mouse na pasta dispatcher e clique em Propriedades.
  3. Na guia Segurança, clique em Editar e, na caixa de diálogo Permissões, clique em Adicionar. Uma caixa de diálogo é aberta para selecionar contas de usuário. Clique no botão Locais, selecione o nome do computador e clique em OK.
    Mantenha essa caixa de diálogo aberta enquanto conclui a próxima etapa.
  4. no Gerenciador do IIS, selecione o site do IIS que você está usando para o cache do Dispatcher e, no lado direito da janela, clique em Configurações avançadas.
  5. Selecione o valor da propriedade Pool de Aplicativos e copie-o para a área de transferência.
  6. Retorne à caixa de diálogo aberta. Na caixa Inserir os nomes dos objetos a serem selecionados, digite IIS AppPool\ e cole o conteúdo da área de transferência. O valor deve ser semelhante ao seguinte exemplo:
    IIS AppPool\DefaultAppPool
  7. Clique no botão Verificar nomes. Quando o Windows resolver a conta de usuário, clique em OK.
  8. Na caixa de diálogo Permissões da pasta do dispatcher, selecione a conta que você acabou de adicionar, ative todas as permissões para a conta, exceto para Controle total, e clique em OK. Clique em OK para fechar a caixa de diálogo Propriedades da pasta.
  9. Use um editor de texto para abrir o disp_iis.ini arquivo.
  10. Adicione uma linha de texto semelhante ao exemplo a seguir para configurar o local do arquivo de log e, em seguida, salvar o arquivo:
    logfile=C:\inetpub\logs\dispatcher\dispatcher.log
    
    

Próximas etapas

Antes de poder start usando o Dispatcher, você deve saber:

Servidor Web Apache

As instruções para instalação no Windows e no Unix são abordadas aqui. Tenha cuidado ao executar as etapas.

Instalação do Apache Web Server

Para obter informações sobre como instalar um Apache Web Server, leia o manual de instalação - on-line ou na distribuição.
Se você estiver criando um binário Apache compilando os arquivos de origem, certifique-se de ativar o suporte a módulos dinâmicos. Isso pode ser feito usando qualquer uma das opções —enable-shared . Inclua, no mínimo, o mod_so módulo.
Para obter mais informações, consulte o manual de instalação do Apache Web Server.
Consulte também as Dicas de segurança e os Relatórios de segurança do Apache HTTP Server.

Apache Web Server - Adicionar o módulo Dispatcher

O Dispatcher vem como:
  • Windows : uma DLL (Dynamic Link Library)
  • Unix : um objeto compartilhado dinâmico (DSO)
Os arquivos de arquivamento de instalação contêm os seguintes arquivos - dependendo se você selecionou Windows ou Unix:
Arquivo
Descrição
disp_apache<x.y>.dll
Windows: O arquivo da biblioteca de links dinâmicos do Dispatcher.
dispatcher-apache<x.y>-<rel-nr>.so
Unix: O arquivo da biblioteca de objetos compartilhados do Dispatcher.
mod_dispatcher.so
Unix: Um link de exemplo.
http.conf.disp<x>
Um arquivo de configuração de exemplo para o servidor Apache.
dispatcher.any
Um arquivo de configuração de exemplo para o Dispatcher.
LEIA
Arquivo Leia-me que contém instruções de instalação e informações de última hora. Observação : Verifique este arquivo antes de iniciar a instalação.
ALTERAÇÕES
Altera o arquivo que lista problemas corrigidos nas versões atual e anterior.
Use as seguintes etapas para adicionar o Dispatcher ao seu Apache Web Server:
  1. Coloque o arquivo Dispatcher no diretório do módulo Apache apropriado:
    • Windows : Local disp_apache<x.y>.dll <APACHE_ROOT>/modules
    • Unix : Localize o <APACHE_ROOT>/libexec diretório ou o <APACHE_ROOT>/modules diretório de acordo com sua instalação.\
      Copie dispatcher-apache<options>.so neste diretório. Para simplificar a manutenção de longo prazo, você também pode criar um link simbólico chamado mod_dispatcher.so para o Dispatcher: ln -s dispatcher-apache<x>-<os>-<rel-nr>.so mod_dispatcher.so
  2. Copie o arquivo dispatcher.any para o <APACHE_ROOT>/conf diretório.
    Observação: Você pode colocar esse arquivo em um local diferente, desde que a propriedade DispatcherLog do módulo Dispatcher esteja configurada de acordo. (Consulte Entradas de configuração específicas do Dispatcher abaixo.)

Apache Web Server - Configurar propriedades do SELinux

Se você estiver executando o Dispatcher no RedHat Linux Kernel 2.6 com o SELinux ativado, talvez você esteja executando mensagens de erro como essa no arquivo de log do dispatcher.
Mon Jun 30 00:03:59 2013] [E] [16561(139642697451488)] Unable to connect to backend rend01 (10.122.213.248:4502): Permission denied
Isso provavelmente ocorre devido a uma segurança ativada do SELinux. Em seguida, você precisa executar as seguintes tarefas:
  • Configure o contexto SELinux do arquivo do módulo do dispatcher.
  • Ative scripts e módulos HTTPD para fazer conexões de rede.
  • Configure o contexto SELinux da docroot, onde os arquivos em cache são armazenados.
Digite os seguintes comandos em uma janela de terminal, substituindo [path to the dispatcher.so file] pelo caminho para o módulo Dispatcher que você instalou no Apache Web Server, e path to the docroot pelo caminho onde o ponto está localizado (por exemplo, /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](/.*)?"

Apache Web Server - Configurar o Apache Web Server para Dispatcher

O Apache Web Server precisa ser configurado usando httpd.conf . No kit de instalação do Dispatcher, você encontrará um arquivo de configuração de exemplo chamado httpd.conf.disp<x> .
Estas etapas são obrigatórias:
  1. Vá até <APACHE_ROOT>/conf .
  2. Abrir httpd.conf para edição.
  3. As seguintes entradas de configuração devem ser adicionadas, na ordem listada:
    • LoadModule para carregar o módulo no start para cima.
    • Entradas de configuração específicas do Dispatcher, incluindo DispatcherConfig, DispatcherLog e DispatcherLogLevel .
    • DefinaHandler para ativar o Dispatcher. LoadModule .
    • ModMimeUsePathInfo para configurar o comportamento de mod_mime .
  4. (Opcional) É recomendável alterar o proprietário do diretório htdocs:
    • O servidor apache é start como raiz, embora o filho processe o start como daemon (para fins de segurança). O DocumentRoot ( <APACHE_ROOT>/htdocs ) deve pertencer ao daemon do usuário:
      cd <APACHE_ROOT>  
      chown -R daemon:daemon htdocs
      
      
LoadModule
A tabela a seguir lista exemplos que podem ser usados. as entradas exatas estão de acordo com seu Apache Web Server específico:
Windows
... LoadModule dispatcher_module modules\disp_apache.dll ...
Unix (presumindo link simbólico)
... LoadModule dispatcher_module libexec/mod_dispatcher.so ...
O primeiro parâmetro de cada instrução deve ser escrito exatamente como nos exemplos acima.
Consulte os arquivos de configuração de exemplo fornecidos e a documentação do Apache Web Server para obter detalhes completos sobre esse comando.
Entradas de configuração específicas do Dispatcher
As entradas de configuração específicas do Dispatcher são colocadas após a entrada LoadModule. A tabela a seguir lista uma configuração de exemplo aplicável ao Unix e ao Windows:
Windows e 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>
...

Os parâmetros de configuração individuais:
Parâmetro
Descrição
DispatcherConfig
Localização e nome do arquivo de configuração do Dispatcher.
Quando essa propriedade está localizada na configuração do servidor principal, todos os hosts virtuais herdam o valor da propriedade. No entanto, os hosts virtuais podem incluir uma propriedade DispatcherConfig para substituir a configuração do servidor principal.
DispatcherLog
Localização e nome do arquivo de log.
DispatcherLogLevel
Nível de log do arquivo de log:
0 - Erros
1 - Avisos
2 - Informações
3 -
Nota de depuração: É recomendável definir o nível de log como 3 durante a instalação e o teste, depois como 0 quando executado em um ambiente de produção.
DispatcherNoServerHeader
Esse parâmetro está obsoleto e não tem mais efeito.
Define o Cabeçalho do Servidor a ser usado:
  • undefined or 0 - o cabeçalho do servidor HTTP contém a versão AEM.
  • 1 - o cabeçalho do servidor Apache é usado.
DispatcherDeclineRoot
Define se as solicitações devem ser recusadas para a raiz "/":
0 - aceitar solicitações para /
1 - solicitações para / não são tratadas pelo expedidor; use mod_alias para o mapeamento correto.
DispatcherUseProcessedURL
Define se os URLs pré-processados devem ser usados para todo o processamento adicional pelo Dispatcher:
0 - use o URL original passado para o servidor da Web.
1 - o dispatcher usa o URL já processado pelos manipuladores que precedem o dispatcher (ou seja, mod_rewrite ) em vez do URL original passado para o servidor da Web. Por exemplo, o URL original ou o URL processado corresponde aos filtros do Dispatcher. O URL também é usado como a base para a estrutura do arquivo de cache. Consulte a documentação do site do Apache para obter informações sobre mod_rewrite; por exemplo, Apache 2.4. Ao usar mod_rewrite, é aconselhável usar o sinalizador 'passthrough'
DispatcherPassError
Define como oferecer suporte a códigos de erro para a manipulação de ErrorDocument:
0 - O Dispatcher armazena todas as respostas de erro no cliente.
1 - O Dispatcher não mapeia uma resposta de erro para o cliente (onde o código de status é maior ou igual a 400), mas passa o código de status para o Apache, o que permite que uma diretiva ErrorDocument processe tal código de status.
Intervalo de código - especifique um intervalo de códigos de erro para os quais a resposta é passada para o Apache. Outros códigos de erro são passados para o cliente. Por exemplo, a configuração a seguir envia respostas para o erro 412 para o cliente e todos os outros erros são enviados para o Apache: DispatcherPassError 400-411,413-417
DispatcherKeepAliveTimeout
Especifica o tempo limite de manutenção ativa, em segundos. Começando com a versão 4.2.0 do Dispatcher, o valor padrão de manutenção de atividade é 60. Um valor de 0 desativa o keep-live.
DispatcherNoCanonURL
Definir esse parâmetro como On passará o URL bruto para o backend em vez do canonicalizado e substituirá as configurações de DispatcherUseProcessedURL. O valor padrão é Off.
Observação : As regras de filtro na configuração do Dispatcher sempre serão avaliadas em relação ao URL limpo e não ao URL bruto.
As entradas de caminho são relativas ao diretório raiz do Apache Web Server.
As configurações padrão para o Cabeçalho do servidor são: ServerTokens Full DispatcherNoServerHeader 0 Mostra a versão AEM (para fins estatísticos). Se você quiser desativar a disponibilidade dessas informações no cabeçalho, é possível definir: ServerTokens Prod Consulte a Documentação do Apache sobre a Diretiva ServerTokens (por exemplo, para o Apache 2.4) para obter mais informações.
SetHandler
Depois dessas entradas, você deve adicionar uma instrução SetHandler ao contexto de sua configuração ( <Directory> , <Location> ) para que o Dispatcher manipule as solicitações recebidas. O exemplo a seguir configura o Dispatcher para lidar com solicitações do site completo:
Windows e Unix
...  
<Directory />  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
</IfModule>  
  
Options FollowSymLinks  
AllowOverride None  
</Directory>  
...

O exemplo a seguir configura o Dispatcher para lidar com solicitações de um domínio 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>  
...

O parâmetro da instrução SetHandler deve ser gravado exatamente como nos exemplos acima, pois esse é o nome do manipulador definido no módulo. Consulte os arquivos de configuração de exemplo fornecidos e a documentação do Apache Web Server para obter detalhes completos sobre esse comando.
ModMimeUsePathInfo
Depois da instrução SetHandler , você também deve adicionar a definição ModMimeUsePathInfo .
O ModMimeUsePathInfo parâmetro só deve ser usado e configurado se você estiver usando o Dispatcher versão 4.0.9 ou superior. (Observe que a versão 4.0.9 do Dispatcher foi lançada em 2011. Se você estiver usando uma versão mais antiga, seria apropriado atualizar para uma versão recente do Dispatcher).
O parâmetro ModMimeUsePathInfo deve ser definido On para todas as configurações do Apache:
ModMimeUsePathInfo On
O módulo mod_mime (consulte, por exemplo, Apache Module mod_mime ) é usado para atribuir metadados de conteúdo ao conteúdo selecionado para uma resposta HTTP. A configuração padrão significa que, quando mod_mime determina o tipo de conteúdo, somente a parte do URL que mapeia para um arquivo ou diretório será considerada.
Quando On , o ModMimeUsePathInfo parâmetro especifica que mod_mime é para determinar o tipo de conteúdo com base no URL completo ; isso significa que os recursos virtuais terão as metainformações aplicadas com base em sua extensão.
O exemplo a seguir ativa ModMimeUsePathInfo :
Windows e Unix
...  
<Directory />  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
ModMimeUsePathInfo On  
</IfModule>  
  
Options FollowSymLinks  
AllowOverride None  
</Directory>  
...

Ativar suporte para HTTPS (Unix e Linux)

O Dispatcher usa o OpenSSL para implementar a comunicação segura via HTTP. A partir do Dispatcher versão 4.2.0 , o OpenSSL 1.0.0 e o OpenSSL 1.0.1 são compatíveis. O Dispatcher usa o OpenSSL 1.0.0 por padrão. Para usar o OpenSSL 1.0.1, use o procedimento a seguir para criar links simbólicos, de modo que o Dispatcher use as bibliotecas OpenSSL instaladas.
  1. Abra um terminal e altere o diretório atual para o diretório onde as bibliotecas OpenSSL estão instaladas, por exemplo:
    cd /usr/lib64
    
    
  2. Para criar os links simbólicos, insira os seguintes comandos:
    ln -s libssl.so libssl.so.1.0.1
    ln -s libcrypto.so libcrypto.so.1.0.1
    
    
Se você estiver usando uma versão personalizada do Apache, verifique se o Apache e o Dispatcher estão compilados usando a mesma versão do OpenSSL .

Próximas etapas

Antes de poder start usando o Dispatcher, você deve agora:

Servidor Web Sun Java System / iPlanet

As instruções para ambientes Windows e Unix são abordadas aqui. Tenha cuidado ao selecionar qual executar.

Servidor Web Sun Java System / iPlanet - Instalação do servidor Web

Para obter informações completas sobre como instalar esses servidores da Web, consulte a respectiva documentação:
  • Servidor Web Sun Java System
  • Servidor Web iPlanet

Sun Java System Web Server / iPlanet - Adicionar o módulo Dispatcher

O Dispatcher vem como:
  • Windows : uma DLL (Dynamic Link Library)
  • Unix : um objeto compartilhado dinâmico (DSO)
Os arquivos de arquivamento de instalação contêm os seguintes arquivos - dependendo se você selecionou Windows ou Unix:
Arquivo
Descrição
disp_ns.dll
Windows: O arquivo da biblioteca de links dinâmicos do Dispatcher.
dispatcher.so
Unix: O arquivo da biblioteca de objetos compartilhados do Dispatcher.
dispatcher.so
Unix: Um link de exemplo.
obj.conf.disp
Um arquivo de configuração de exemplo para o servidor Web iPlanet / Sun Java System.
dispatcher.any
Um arquivo de configuração de exemplo para o Dispatcher.
LEIA
Arquivo Leia-me que contém instruções de instalação e informações de última hora. Observação: Verifique este arquivo antes de iniciar a instalação.
ALTERAÇÕES
Altera o arquivo que lista problemas corrigidos nas versões atual e anterior.
Use as seguintes etapas para adicionar o Dispatcher ao servidor da Web:
  1. Coloque o arquivo Dispatcher no plugin diretório do servidor da Web:

Sun Java System Web Server / iPlanet - Configurar para o Dispatcher

O servidor Web precisa ser configurado usando obj.conf . No kit de instalação do Dispatcher, você encontrará um arquivo de configuração de exemplo chamado obj.conf.disp .
  1. Vá até <WEBSERVER_ROOT>/config .
  2. Abrir obj.conf para edição.
  3. Copie a linha que start: Service fn="dispService" da seção obj.conf.disp de inicialização de obj.conf .
  4. Salve as alterações.
  5. Abrir magnus.conf para edição.
  6. Copie as duas linhas que são start: Init funcs="dispService, dispInit" e Init fn="dispInit" da seção obj.conf.disp de inicialização de magnus.conf .
  7. Salve as alterações.
As configurações a seguir devem estar todas em uma linha e o $(SERVER_ROOT) e $(PRODUCT_SUBDIR) devem ser substituídos pelos respectivos valores.
Inicializar
A tabela a seguir lista exemplos que podem ser usados. as entradas exatas estão de acordo com o servidor Web específico:
Windows e 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"  
...

em que:
Parâmetro
Descrição
configuração
Localização e nome do ficheiro de configuração dispatcher.any.
ficheiro
Localização e nome do arquivo de log.
loglevel
Nível de log para ao gravar mensagens no arquivo de log:
0 Erros
1 Avisos
2 Informações
3
Nota de depuração: É recomendável definir o nível de log como 3 durante a instalação e o teste e como 0 quando executado em um ambiente de produção.
keepalivetimeout
Especifica o tempo limite de manutenção ativa, em segundos. Começando com a versão 4.2.0 do Dispatcher, o valor padrão de manutenção de atividade é 60. Um valor de 0 desativa o keep-live.
Dependendo das suas necessidades, você pode definir o Dispatcher como um serviço para seus objetos. Para configurar o Dispatcher para o site inteiro, modifique o objeto padrão:
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="\*/\*"  
...

Próximas etapas

Antes de poder start usando o Dispatcher, você deve agora: