Installazione di Dispatcher

Utilizza la pagina Note sulla versione di Dispatcher per ottenere il file di installazione di Dispatcher più recente per il tuo sistema operativo e server web. I numeri di versione di Dispatcher sono indipendenti quelli di Adobe Experience Manager e sono compatibili con le versioni di Adobe Experience Manager 6.x, 5.x e Adobe CQ 5.x.

Viene utilizzata la seguente convenzione per la denominazione dei file:

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

Ad esempio, il file dispatcher-apache2.4-linux-x86_64-ssl-4.3.1.tar.gz contiene Dispatcher versione 4.3.1 per un server web Apache 2.4 che viene eseguito su Linux i686 e compattato utilizzando il formato tar.

La tabella che segue riporta gli identificativi utilizzati nei nomi dei file per ciascun server web:

Ogni archivio contiene i seguenti file:

• Moduli di Dispatcher
• Un esempio di file di configurazione
• Il file README contenente le istruzioni di installazione e le informazioni dell’ultimo minuto
• Il file CHANGES in cui sono elencati i problemi risolti in questa e nelle precedenti versioni

Microsoft Internet Information Server

Per informazioni su come installare questo server web, vedi le risorse seguenti:

• Documentazione di Microsoft Internet Information Server
• "Sito ufficiale Microsoft IIS"

Componenti IIS richiesti

Le versioni 8.5 e 10 di IIS richiedono l’installazione dei seguenti componenti IIS:

• Estensioni ISAPI

Inoltre, è necessario aggiungere il ruolo Server web (IIS). Utilizza Server Manager per aggiungere ruolo e componenti.

Microsoft IIS: installazione del modulo Dispatcher

L’archivio richiesto per Microsoft Internet Information System è:

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

Il file ZIP contiene i seguenti file:

Per copiare i file Dispatcher nella posizione corretta, utilizza la procedura descritta di seguito.

1. Utilizza Esplora risorse per creare la directory <IIS_INSTALLDIR>/Scripts, ad esempio C:\inetpub\Scripts.

2. Estrai i seguenti file dal pacchetto di Dispatcher in questa directory Scripts:

   • disp_iis.dll
   • disp_iis.ini
   • Uno dei file seguenti, a seconda che Dispatcher funzioni con un’istanza Autore AEM o AEM Publish:
     • Istanza Autore: author_dispatcher.any
     • Istanza Publish: dispatcher.any

Microsoft IIS: configurare il file INI di Dispatcher

Modifica il file disp_iis.ini per configurare l’installazione di Dispatcher. Il formato di base del file .ini è il seguente:

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

La tabella che segue descrive le singole proprietà.

Esempio di configurazione:

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

Configurazione di Microsoft IIS

Configura IIS in modo da integrare il modulo ISAPI di Dispatcher. In IIS si utilizza il mapping di applicazioni con caratteri jolly.

Configurazione dell’accesso anonimo: IIS 8.5 e 10

L’agente di replica Flush predefinito sull’istanza Autore è configurato in modo da non inviare credenziali di sicurezza con le richieste di flushing. Pertanto, il sito web che utilizzi come cache di Dispatcher deve consentire l’accesso anonimo.

Se il sito web utilizza un metodo di autenticazione, l’agente di replica Flush deve essere configurato di conseguenza.

1. Apri IIS Manager e seleziona il sito web che utilizzi come cache di Dispatcher.
2. Utilizzando la modalità Visualizzazione funzionalità, nella sezione IIS fai doppio clic su Autenticazione.
3. Se l’autenticazione anonima non è abilitata, seleziona Autenticazione anonima e nell’area Azioni fai clic su Abilita.

Integrazione del modulo ISAPI di Dispatcher: IIS 8.5 e 10

Per aggiungere il modulo ISAPI di Dispatcher a IIS, utilizza la procedura descritta di seguito.

1. Apri IIS Manager.

2. Seleziona il sito web che utilizzi come cache di Dispatcher.

3. Utilizzando la modalità Visualizzazione funzionalità, nella sezione IIS fai doppio clic su Mapping gestori.

4. Nel pannello Azioni della pagina Mapping gestori, fai clic su Aggiungi mapping di script con caratteri jolly, inserisci i seguenti valori delle proprietà e fai clic su OK:

   • Percorso richiesta: *
   • Eseguibile: percorso assoluto del file disp_iis.dll, ad esempio C:\inetpub\Scripts\disp_iis.dll.
   • Nome: un nome descrittivo per il mapping del gestore, ad esempio Dispatcher.

5. Nella finestra di dialogo visualizzata, per aggiungere la libreria disp_iis.dll all’elenco delle restrizioni ISAPI e CGI, fai clic su Sì.

   Per IIS 7.0 e 7.5 la configurazione è completa. Se stai configurando IIS 8.0, procedi con i passaggi successivi.

6. (IIS 8.0) Nell’elenco dei mapping dei gestori, seleziona quello appena creato e nell’area Azioni fai clic su Modifica.

7. (IIS 8.0) Nella finestra di dialogo Modifica mapping di script, fai clic sul pulsante Restrizioni richieste.

8. (IIS 8.0) Per garantire che il gestore sia utilizzato per i file e le cartelle che non sono ancora memorizzati in cache, deseleziona Richiama gestore solo se la richiesta è mappata a, quindi fai clic su OK.

9. (IIS 8.0) Nella finestra di dialogo Modifica mapping di script, fai clic su OK.

Configurazione dell’accesso alla cache: IIS 8.5 e 10

Fornisci all’utente del pool di applicazioni predefinito l’accesso in scrittura alla cartella che viene utilizzata come cache di Dispatcher.

1. Fai clic con il pulsante destro del mouse sulla cartella principale del sito web che utilizzi come cache di Dispatcher e fai clic su Proprietà, ad esempio C:\inetpub\wwwroot.

2. Fai clic su Modifica nella scheda Sicurezza, quindi fai clic su Aggiungi nella finestra di dialogo Autorizzazioni. Si apre una finestra di dialogo per la selezione degli account utente. Fai clic sul pulsante Percorsi, seleziona il nome del computer e fai clic su OK.

   Tieni aperta questa finestra di dialogo mentre completi il passaggio successivo.

3. In Gestione IIS, seleziona il sito IIS che utilizzi come cache di Dispatcher e fai clic su Impostazioni avanzate sul lato destro della finestra.

4. Seleziona il valore della proprietà Application Pool e copiala negli Appunti.

5. Torna alla finestra di dialogo già aperta. Nella casella Immettere i nomi degli oggetti da selezionare, digita IIS AppPool\, quindi incolla il contenuto degli Appunti. Il valore deve essere simile al seguente:

   IIS AppPool\DefaultAppPool

6. Fai clic sul pulsante Controlla nomi. Quando Windows risolve l’account utente, fai clic su OK.

7. Nella finestra di dialogo Autorizzazioni per la cartella di Dispatcher, seleziona l’account appena aggiunto, abilita tutte le autorizzazioni per l’account eccetto Controllo completo e fai clic su OK. Fai clic su OK per chiudere la finestra di dialogo Proprietà.

Registrazione del tipo MIME JSON: IIS 8.5 e 10

Utilizza la seguente procedura per registrare il tipo MIME JSON quando vuoi che Dispatcher consenta le chiamate JSON.

1. In IIS Manager, seleziona il sito Web e, utilizzando Visualizzazione funzionalità, fai doppio clic su Tipi MIME.

2. Se l’estensione JSON non è presente nell’elenco, nel pannello Azioni fai clic su Aggiungi, immetti i seguenti valori delle proprietà, quindi fai clic su OK:

   • Estensione nome file: .json
   • Tipo MIME: application/json

Rimozione del segmento nascosto bin: IIS 8.5 e 10

Per rimuovere il segmento nascosto bin, utilizza la procedura descritta di seguito. I siti Web che non sono nuovi possono contenere questo segmento nascosto.

1. In IIS Manager, seleziona il sito Web e, utilizzando Visualizzazione funzionalità, fai doppio clic su Filtro richieste.
2. Seleziona il segmento bin, fai clic su Rimuovi e nella finestra di dialogo di conferma fai clic su Sì.

Registrazione dei messaggi IIS in un file: IIS 8.5 e 10

Utilizza la procedura seguente per scrivere i messaggi di registro di Dispatcher in un file di registro invece che nel registro eventi di Windows. È necessario configurare Dispatcher in modo che utilizzi il file di registro e fornire a IIS l’accesso in scrittura al file.

1. Utilizza Esplora risorse per creare una cartella denominata dispatcher sotto la cartella dei registri dell’installazione di IIS. Il percorso di questa cartella per un’installazione tipica è C:\inetpub\logs\dispatcher.

2. Fai clic con il pulsante destro del mouse sulla cartella di Dispatcher e fai clic su Proprietà.

3. Fai clic su Modifica nella scheda Sicurezza, quindi fai clic su Aggiungi nella finestra di dialogo Autorizzazioni. Si apre una finestra di dialogo per la selezione degli account utente. Fai clic sul pulsante Percorsi, seleziona il nome del computer e fai clic su OK.

   Tieni aperta questa finestra di dialogo mentre completi il passaggio successivo.

4. In Gestione IIS, seleziona il sito IIS che utilizzi come cache di Dispatcher e fai clic su Impostazioni avanzate sul lato destro della finestra.

5. Seleziona il valore della proprietà Application Pool e copiala negli Appunti.

6. Torna alla finestra di dialogo già aperta. Nella casella Immettere i nomi degli oggetti da selezionare, digita IIS AppPool\, quindi incolla il contenuto degli Appunti. Il valore deve essere simile al seguente:

   IIS AppPool\DefaultAppPool

7. Fai clic sul pulsante Controlla nomi. Quando Windows risolve l’account utente, fai clic su OK.

8. Nella finestra di dialogo Autorizzazioni per la cartella di Dispatcher, seleziona l’account appena aggiunto, abilita tutte le autorizzazioni per l’account eccetto Controllo completo e fai clic su OK. Fai clic su OK per chiudere la finestra di dialogo Proprietà.

9. Utilizza un editor di testo per aprire il file disp_iis.ini.

10. Aggiungi una riga di testo simile all’esempio seguente per configurare il percorso del file di registro, quindi salva il file:

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

Passaggi successivi

Prima di poter iniziare a utilizzare Dispatcher è necessario conoscere:

• Configurare Dispatcher
• Configurare AEM per funzionare con Dispatcher.

Server web Apache

Installazione del server web Apache

Per informazioni sull’installazione di un server web Apache, leggere il manuale di installazione online o nella distribuzione.

Vedi anche i suggerimenti sulla sicurezza e i rapporti sulla sicurezza di Apache HTTP Server.

Server web Apache: aggiungi il modulo Dispatcher

Dispatcher viene fornito per:

• Windows: una DLL (Dynamic Link Library)
• oppure Unix: un DSO (Dynamic Shared Object)

L’archivio di installazione contiene i seguenti file, a seconda che sia stato selezionato Windows o Unix:

Per aggiungere Dispatcher al server web Apache, fai quanto segue:

1. Posiziona il file di Dispatcher nella directory appropriata del modulo Apache:

   • Windows: posiziona disp_apache<x.y>.dll in <APACHE_ROOT>/modules
   • Unix: individua la directory <APACHE_ROOT>/libexec o <APACHE_ROOT>/modulesin base al tipo di installazione.
     Copia il file dispatcher-apache<options>.so in questa directory.
     Per semplificare la manutenzione a lungo termine, puoi anche creare un collegamento simbolico denominato mod_dispatcher.so a Dispatcher:
     ln -s dispatcher-apache<x>-<os>-<rel-nr>.so mod_dispatcher.so

2. Copia il file dispatcher.any nella directory <APACHE_ROOT>/conf.

   Nota: puoi posizionare il file in una posizione diversa, purché la proprietà DispatcherLog del modulo Dispatcher sia configurata di conseguenza. (Vedi qui di seguito Voci di configurazione specifiche per Dispatcher).

Server web Apache: configura le proprietà SELinux

Se esegui Dispatcher su RedHat Linux Kernel 2.6 con SELinux abilitato, potresti avere messaggi di errore come questo nel file di registro di Dispatcher.

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

Ciò è probabilmente dovuto a una qualche opzione di sicurezza abilitata in SELinux. Quindi devi effettuare le seguenti attività:

• Configura il contesto SELinux del file del modulo di Dispatcher.
• Abilita gli script e i moduli HTTPD per effettuare le connessioni di rete.
• Configura il contesto SELinux della directory principale dei documenti, nella quale vengono archiviati i file memorizzati in cache.

Immettere i seguenti comandi in una finestra del terminale, sostituendo [path to the dispatcher.so file] con il percorso del modulo di Dispatcher installato sul server web Apache e path to the docroot con il percorso in cui si trova la directory principale dei documenti (ad esempio, /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](/.*)?"

Server web Apache: configurazione del server web Apache per Dispatcher

È necessario configurare il server web Apache utilizzando il file httpd.conf. Il kit di installazione di Dispatcher contiene un esempio di file di configurazione denominato httpd.conf.disp<x>.

I seguenti passaggi sono obbligatori:

1. Accedi a <APACHE_ROOT>/conf.

2. Apri httpd.conf per la modifica.

3. È necessario aggiungere le seguenti voci di configurazione, nell’ordine indicato:

   • LoadModule per caricare il modulo all’avvio.
   • Voci di configurazione specifiche per Dispatcher, tra cui DispatcherConfig, DispatcherLog e DispatcherLogLevel.
   • SetHandler per attivare Dispatcher. LoadModule.
   • ModMimeUsePathInfo per configurare il comportamento di mod_mime.

4. (Facoltativo) È consigliabile modificare il proprietario della directory htdocs:

   • Il server Apache viene avviato come radice, anche se i processi figlio iniziano come daemon (per motivi di sicurezza). DocumentRoot (<APACHE_ROOT>/htdocs) deve appartenere al daemon utente:

     cd <APACHE_ROOT>
     chown -R daemon:daemon htdocs
     

LoadModule

La tabella che segue riporta alcuni esempi che possono essere utilizzati; le voci esatte dipendono dal tipo di server web Apache in uso:

Voci di configurazione specifiche per Dispatcher

Le voci di configurazione specifiche per Dispatcher vanno inserite dopo la voce LoadModule. La tabella che segue riporta un esempio di configurazione applicabile sia per Unix che per 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>
...

I singoli parametri di configurazione:

SetHandler

Dopo queste voci è necessario aggiungere un’istruzione SetHandler al contesto della configurazione (<Directory>, <Location>) affinché Dispatcher possa gestire le richieste in ingresso. L’esempio che segue configura Dispatcher per gestire le richieste dell’intero sito web:

Windows e Unix

...
<Directory />
<IfModule disp\_apache2.c>
SetHandler dispatcher-handler
</IfModule>

Options FollowSymLinks
AllowOverride None
</Directory>
...

L’esempio che segue configura Dispatcher per gestire le richieste di un dominio virtuale:

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

Dopo l’istruzione SetHandler è necessario aggiungere anche la definizione ModMimeUsePathInfo.

Il parametro ModMimeUsePathInfo va impostato su On per tutte le configurazioni di Apache:

ModMimeUsePathInfo On

Il modulo mod_mime (vedi, ad esempio, Modulo Apache mod_mime) viene utilizzato per assegnare metadati di contenuto al contenuto selezionato per una risposta HTTP. La configurazione predefinita comporta che quando mod_mime determina il tipo di contenuto, verrà considerata solo la parte dell’URL mappata su un file o una directory.

Se attivato (On), il parametro ModMimeUsePathInfo specifica che mod_mime deve determinare il tipo di contenuto in base all’URL completo; ciò significa che le risorse virtuali avranno metadati applicati in base alla loro estensione.

L’esempio che segue attiva ModMimeUsePathInfo:

Windows e Unix

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

Options FollowSymLinks
AllowOverride None
</Directory>
...

Abilitazione del supporto per HTTPS (Unix e Linux)

Dispatcher utilizza OpenSSL per implementare una comunicazione sicura tramite HTTP. A partire dalla versione di Dispatcher 4.2.0, sono supportati OpenSSL 1.0.0 e OpenSSL 1.0.1. Dispatcher utilizza OpenSSL 1.0.0 per impostazione predefinita. Per utilizzare OpenSSL 1.0.1, segui la procedura sotto riportata per creare collegamenti simbolici in modo che Dispatcher possa utilizzare le librerie OpenSSL installate.

1. Apri un terminale e cambia la directory corrente con la directory in cui sono installate le librerie OpenSSL, ad esempio:

   cd /usr/lib64
   

2. Per creare i collegamenti simbolici, immetti i seguenti comandi:

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

Passaggi successivi

Prima di iniziare a utilizzare Dispatcher, è necessario:

• Configurare Dispatcher
• Configurare AEM per funzionare con Dispatcher.

Sun Java System Web Server / iPlanet

Sun Java System Web Server / iPlanet: installazione del server web

Per informazioni dettagliate su come installare questi server web, vedi la relativa documentazione:

• Sun Java System Web Server
• iPlanet Web Server

Sun Java System Web Server / iPlanet: aggiunta del modulo Dispatcher

Dispatcher viene fornito per:

• Windows: una DLL (Dynamic Link Library)
• oppure Unix: un DSO (Dynamic Shared Object)

L’archivio di installazione contiene i seguenti file, a seconda che sia stato selezionato Windows o Unix:

Per aggiungere Dispatcher al server web, fai quanto segue:

1. Posiziona il file Dispatcher nella directory plugin del server web:

Sun Java System Web Server / iPlanet; configurazione per Dispatcher

È necessario configurare il server web utilizzando obj.conf. Il kit di installazione di Dispatcher contiene un esempio di file di configurazione denominato obj.conf.disp.

1. Accedi a <WEBSERVER_ROOT>/config.

2. Apri obj.conf per la modifica.

3. Copia la riga che inizia con:
   Service fn="dispService"
   dal file obj.conf.disp alla sezione di inizializzazione del file obj.conf.

4. Salva le modifiche.

5. Apri magnus.conf per la modifica.

6. Copia le due righe che iniziano con:
   Init funcs="dispService, dispInit"
   e
   Init fn="dispInit"
   dal file obj.conf.disp alla sezione di inizializzazione del file magnus.conf.

7. Salva le modifiche.

Init

La tabella che segue riporta alcuni esempi che possono essere utilizzati; le voci esatte dipendono dal tipo di server web in uso:

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"
...

Dove:

A seconda delle esigenze è possibile definire Dispatcher come servizio per tuoi oggetti. Per configurare Dispatcher per l’intero sito web, modifica l’oggetto predefinito:

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="\*/\*"
...

Passaggi successivi

Prima di iniziare a utilizzare Dispatcher, è necessario:

• Configurare Dispatcher
• Configurare AEM per funzionare con Dispatcher.