Instalação do Dispatcher

Use a página Notas de versão do Dispatcher para obter o arquivo de instalação do Dispatcher mais recente para o seu sistema operacional e servidor Web. As versões do Dispatcher são independentes das versões do Adobe Experience Manager e são compatíveis com as versões do Adobe Experience Manager 6.x, 5.x e Adobe CQ 5.x.

A seguinte convenção de nomenclatura de arquivo é usada:

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

Por exemplo, o arquivo dispatcher-apache2.4-linux-x86_64-ssl-4.3.1.tar.gz contém o Dispatcher versão 4.3.1 para um servidor Web Apache 2.4, que é executado no Linux i686 e empacotado usando o formato tar.

A tabela a seguir lista o identificador do servidor Web usado em nomes de arquivo para cada servidor Web:

Cada repositório contém os seguintes arquivos:

• os módulos 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

Microsoft Internet Information Server

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

• Documentação da Microsoft sobre o Internet Information Server
• “O site oficial do Microsoft IIS”

Componentes necessários do IIS

As versões 8.5 e 10 do IIS exigem a instalação dos seguintes componentes do IIS:

• Extensões ISAPI

Além disso, você deve adicionar a função Servidor Web (IIS). Use o Gerenciador de Servidores 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:

Use o procedimento a seguir para copiar os arquivos do Dispatcher para o local correto.

1. Use o Windows Explorer para criar o diretório <IIS_INSTALLDIR>/Scripts, por exemplo, C:\inetpub\Scripts.

2. Extraia os seguintes arquivos do pacote do Dispatcher para o diretório Scripts:

   • disp_iis.dll
   • disp_iis.ini
   • Um dos arquivos a seguir, dependendo se o Dispatcher está trabalhando com uma instância de autor do AEM ou instância 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 arquivo disp_iis.ini para configurar a instalação do Dispatcher. O formato básico do arquivo .ini é 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.

Um exemplo de configuração:

[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 ISAPI do Dispatcher. No IIS, é usado mapeamento de aplicativo curinga.

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

O agente de replicação de limpeza padrão na instância do autor é configurado para que ele não envie credenciais de segurança com solicitações de limpeza. Portanto, o site que você está usando no cache do Dispatcher deve permitir acesso anônimo.

Se o site usar um método de autenticação, o agente de replicação de limpeza deverá ser configurado adequadamente.

1. Abra o Gerenciador do IIS e selecione o site que você está usando como cache do Dispatcher.
2. Usando o modo Exibição de recursos, na seção do IIS, clique duas vezes em Autenticação.
3. Selecione Autenticação anônima, caso esta opção não esteja ativada, e na área Ações, clique em Ativar.

Integração do Módulo ISAPI do Dispatcher ao IIS 8.5 e 10

Use o procedimento a seguir para adicionar o Módulo ISAPI do Dispatcher ao IIS.

1. Abra o Gerenciador do IIS.

2. Selecione o site que você está usando como cache do Dispatcher.

3. Usando o modo Exibição de recursos, na seção do IIS, clique duas vezes em Mapeamentos do manipulador.

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_iis.dll à lista de Restrições do ISAPI e do CGI, clique em Sim.

   Para o IIS 7.0 e 7.5, a configuração é concluída. Continue com as etapas restantes se estiver configurando o IIS 8.0.

6. (IIS 8.0) Na lista de mapeamentos do manipulador, selecione aquele que 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 foram armazenados em cache, desmarque a opção Invocar manipulador somente se a solicitação estiver mapeada para, 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 Pool de aplicativos 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 Localizações, 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 de 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, com exceção de Controle completo, e clique em OK. Clique em OK para fechar a caixa de diálogo Propriedades da pasta.

Registro do 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 Exibição de recursos, clique duas vezes em Tipos MIME.

2. Se a extensão JSON não estiver na lista, no painel Ações, clique em Adicionar, insira os seguintes valores de propriedade e clique em OK:

   • Extensão de nome do arquivo: .json
   • Tipo MIME: application/json

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

Use o procedimento a seguir para remover o segmento oculto bin. Os sites que não são novos podem conter esse segmento oculto.

1. No Gerenciador do IIS, selecione seu site e usando a Exibição de recursos, clique duas vezes em Solicitar filtragem.
2. Selecione o segmento bin, clique em Remover e, na caixa de diálogo de confirmação, clique em Sim.

Registro de 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 gravar no log de Eventos do Windows. Você precisa 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 de 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 Localizações, 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 de 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, com exceção de Controle completo, 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 arquivo disp_iis.ini.

10. Adicione uma linha de texto semelhante ao exemplo a seguir para configurar o local do arquivo de log. Em seguida, salve o arquivo:

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

Próximas etapas

Antes de começar a usar o Dispatcher, você deve saber:

• Configurar o Dispatcher
• Configurar o AEM para funcionar com o Dispatcher.

Apache Web Server

Instalação do Apache Web Server

Para informações sobre como instalar o Apache Web Server, leia o manual de instalação online ou na distribuição.

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 do Dispatcher

O Dispatcher vem como uma das opções:

• Windows: Biblioteca de Link Dinâmica (DLL)
• Unix: Objeto Compartilhado Dinâmico (DSO)

O conjunto de arquivos de instalação contêm os seguintes arquivos - dependendo se você selecionou Windows ou Unix:

Use as seguintes etapas para adicionar o Dispatcher ao seu Apache Web Server:

1. Coloque o arquivo do Dispatcher no diretório adequado do módulo Apache:

   • Windows: Coloque disp_apache<x.y>.dll <APACHE_ROOT>/modules
   • Unix: Localize o diretório <APACHE_ROOT>/libexec ou <APACHE_ROOT>/modules de acordo com a 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 diretório <APACHE_ROOT>/conf.

   Observação: você pode colocar esse arquivo em um local diferente, desde que a propriedade DispatcherLog do módulo Dispatcher esteja configurada adequadamente. (Consulte abaixo Entradas de configuração específica para o Dispatcher.)

Apache Web Server - Configurar propriedades do SELinux

Se você estiver executando o Dispatcher no RedHat Linux Kernel 2.6 com o SELinux ativado, poderá encontrar mensagens de erro como esta 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 se deve a uma segurança ativada do SELinux. Nesse caso, é necessário executar as seguintes tarefas:

• Configure o contexto do SELinux do arquivo de módulo Dispatcher.
• Habilite scripts e módulos HTTPD para fazer conexões de rede.
• Configure o contexto SELinux do docroot, onde os arquivos em cache são armazenados.

Insira 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 docroot 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_rw_content_t [path to the docroot]
semanage fcontext -a -t httpd_sys_rw_content_t "[path to the docroot](/.*)?"

Apache Web Server - Configurar o Apache Web Server para o 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. Abra httpd.conf para edição.

3. As seguintes entradas de configuração devem ser adicionadas na ordem listada:

   • LoadModule para carregar o módulo na inicialização.
   • Entradas de configuração específicas do Dispatcher, incluindo DispatcherConfig, DispatcherLog e DispatcherLogLevel.
   • SetHandler para ativar o Dispatcher. LoadModule.
   • ModMimeUsePathInfo para configurar o comportamento do mod_mime.

4. (Opcional) Recomenda-se alterar o proprietário do diretório htdocs:

   • O servidor Apache é iniciado como raiz, embora os processos secundários sejam iniciados 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 são de acordo com seu Apache Web Server específico:

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 Windows:

Windows e Unix

...
<IfModule 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:

SetHandler

Após essas 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>
...

ModMimeUsePathInfo

Depois da instrução SetHandler, você também deve adicionar a definição ModMimeUsePathInfo.

O parâmetro ModMimeUsePathInfo deve ser definido como On para todas as configurações do Apache:

ModMimeUsePathInfo On

O módulo mod_mime (consulte, por exemplo, Módulo mod_mime do Apache) é 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 parâmetro ModMimeUsePathInfo especifica que mod_mime é para determinar o tipo de conteúdo com base no URL complete; significa que os recursos virtuais terão 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 comunicação segura via HTTP. A partir da versão do Dispatcher 4.2.0, há suporte para OpenSSL 1.0.0 e OpenSSL 1.0.1. O Dispatcher usa o OpenSSL 1.0.0 por padrão. Para usar o OpenSSL 1.0.1, use o seguinte procedimento para criar links simbólicos para 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 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
   

Próximas etapas

Antes de começar a usar o Dispatcher, é necessário agora:

• Configurar o Dispatcher
• Configurar o AEM para funcionar com o Dispatcher.

Sun Java System Servidor Web / iPlanet

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

Para obter informações completas sobre como instalar esses servidores Web, consulte a documentação de cada um deles:

• Sun Java System Web Server
• Servidor Web iPlanet

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

O Dispatcher vem como uma das opções:

• Windows: Biblioteca de Link Dinâmica (DLL)
• Unix: Objeto Compartilhado Dinâmico (DSO)

O conjunto de arquivos de instalação contêm os seguintes arquivos - dependendo se você selecionou Windows ou Unix:

Use as seguintes etapas para adicionar o Dispatcher ao seu servidor Web:

1. Coloque o arquivo do Dispatcher no diretório plugin do servidor 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. Abra obj.conf para edição.

3. Copie a linha que começa:
   Service fn="dispService"
   de obj.conf.disp para a seção de inicialização de obj.conf.

4. Salve as alterações.

5. Abra magnus.conf para edição.

6. Copie as duas linhas que iniciam:
   Init funcs="dispService, dispInit"
   e
   Init fn="dispInit"
   de obj.conf.disp para a seção de inicialização de magnus.conf.

7. Salve as alterações.

Init

A tabela a seguir lista exemplos que podem ser usados; as entradas exatas são de acordo com seu 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:

Dependendo dos seus requisitos, você pode definir o Dispatcher como um serviço para os seus objetos. Para configurar o Dispatcher para todo o seu site, 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 começar a usar o Dispatcher, é necessário agora:

• Configurar o Dispatcher
• Configurar o AEM para funcionar com o Dispatcher.

Recursos do Business.Adobe.com

Ecommerce Integrations Automated Onboarding Cms Cloud Personalized Experiences Customer Communications Asset Collections