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.
Considera che Adobe Experience Manager 6.5 richiede Dispatcher versione 4.3.2 o successiva. Ciò detto, le versioni di Dispatcher sono indipendenti da AEM, ad esempio, Dispatcher versione 4.3.2 è compatibile anche con Adobe Experience Manager 6.4.
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:
Server web | Kit di installazione |
---|---|
Apache 2.4 | dispatcher-apache 2.4-<altri parametri> |
Microsoft Internet Information Server 7.5, 8, 8.5 | dispatcher-iis-<altri parametri> |
Sun Java Web Server iPlanet | dispatcher-ns-<altri parametri> |
Installa la versione più recente di Dispatcher disponibile per la tua piattaforma. È opportuno aggiornare l’istanza di Dispatcher ogni anno per utilizzare sempre la versione più recente e sfruttarne i miglioramenti apportati.
I clienti che eseguono l’aggiornamento specifico dalla versione 4.3.3 alla versione 4.3.4 noteranno un comportamento diverso nel modo in cui le intestazioni di memorizzazione in cache vengono impostate per i contenuti da non memorizzare nella cache. Per ulteriori informazioni su questa modifica, consulta la pagina Note sulla versione.
Ogni archivio contiene i seguenti file:
Prima di iniziare l’installazione, leggi il file README per eventuali modifiche dell’ultimo minuto o note specifiche per la tua piattaforma.
Per informazioni su come installare questo server web, vedi le risorse seguenti:
Le versioni 8.5 e 10 di IIS richiedono l’installazione dei seguenti componenti IIS:
Inoltre, è necessario aggiungere il ruolo Server web (IIS). Utilizza Server Manager per aggiungere ruolo e componenti.
L’archivio richiesto per Microsoft Internet Information System è:
dispatcher-iis-<operating-system>-<dispatcher-release-number>.zip
Il file ZIP contiene i seguenti file:
File | Descrizione |
---|---|
disp_iis.dll |
File DLL (Dynamic Link Library) di Dispatcher. |
disp_iis.ini |
File di configurazione per IIS. Questo esempio può essere aggiornato in base alle tue esigenze. Nota: il file ini deve avere lo stesso nome-radice del file DLL. |
dispatcher.any |
Esempio di file di configurazione per Dispatcher. |
author_dispatcher.any |
Un esempio di file di configurazione per Dispatcher che funziona con l’istanza Autore. |
README | File Readme contenente istruzioni di installazione e informazioni dell’ultimo minuto. Nota: leggere questo file prima di iniziare l’installazione. |
CHANGES | Il file Changes elenca i problemi risolti in questa e nelle precedenti versioni. |
Per copiare i file Dispatcher nella posizione corretta, utilizza la procedura descritta di seguito.
Utilizza Esplora risorse per creare la directory <IIS_INSTALLDIR>/Scripts
, ad esempio C:\inetpub\Scripts
.
Estrai i seguenti file dal pacchetto di Dispatcher in questa directory Scripts:
disp_iis.dll
disp_iis.ini
author_dispatcher.any
dispatcher.any
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à.
Parametro | Descrizione |
---|---|
configpath | La posizione di dispatcher.any all’interno del file system locale (percorso assoluto). |
logfile | Posizione del file dispatcher.log . Se questo parametro non è impostato, i messaggi del registro vanno nel registro eventi di Windows. |
loglevel | Definisce il livello di registro utilizzato per inviare messaggi al registro eventi. È possibile specificare i seguenti valori: livello del file di registro: 0 - solo messaggi di errore. 1 - errori e avvisi. 2 - errori, avvisi e messaggi informativi 3 - errori, avvisi, messaggi informativi e di debug. Nota: si consiglia di impostare il livello di registro su 3 durante l’installazione e il test, quindi su 0 quando l’esecuzione avviene in un ambiente di produzione. |
replaceauthorization | Specifica come vengono gestite le intestazioni di autorizzazione nella richiesta HTTP. Sono validi i seguenti valori: 0 - Le intestazioni di autorizzazione non vengono modificate. 1 - Sostituisce qualsiasi intestazione denominata "Authorization" diversa da "Basic" con il suo Basic <IIS:LOGON\_USER> equivalente. |
servervariables | Definisce il modo in cui vengono elaborate le variabili del server. 0 - Le variabili del server IIS non vengono inviate né a Dispatcher né ad AEM. 1 - Tutte le variabili del server IIS (come LOGON\_USER, QUERY\_STRING, ... ) vengono inviate a Dispatcher, insieme alle intestazioni delle richieste (e anche all’istanza di AEM, se non memorizzate in cache). Le variabili del server includono AUTH\_USER, LOGON\_USER, HTTPS\_KEYSIZE e molte altre. Vedi la documentazione di IIS per l’elenco completo delle variabili con relativi dettagli. |
enable_chunked_transfer | Definisce se abilitare (1) o disabilitare (0) il trasferimento a blocchi per la risposta del client. Il valore predefinito è 0. |
Esempio di configurazione:
[main]
configpath=C:\Inetpub\Scripts\dispatcher.any
loglevel=1
servervariables=1
replaceauthorization=0
Configura IIS in modo da integrare il modulo ISAPI di Dispatcher. In IIS si utilizza il mapping di applicazioni con caratteri jolly.
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.
Per aggiungere il modulo ISAPI di Dispatcher a IIS, utilizza la procedura descritta di seguito.
Apri IIS Manager.
Seleziona il sito web che utilizzi come cache di Dispatcher.
Utilizzando la modalità Visualizzazione funzionalità, nella sezione IIS fai doppio clic su Mapping gestori.
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:
C:\inetpub\Scripts\disp_iis.dll
.Dispatcher
.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.
(IIS 8.0) Nell’elenco dei mapping dei gestori, seleziona quello appena creato e nell’area Azioni fai clic su Modifica.
(IIS 8.0) Nella finestra di dialogo Modifica mapping di script, fai clic sul pulsante Restrizioni richieste.
(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.
(IIS 8.0) Nella finestra di dialogo Modifica mapping di script, fai clic su OK.
Fornisci all’utente del pool di applicazioni predefinito l’accesso in scrittura alla cartella che viene utilizzata come cache di Dispatcher.
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
.
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.
In Gestione IIS, seleziona il sito IIS che utilizzi come cache di Dispatcher e fai clic su Impostazioni avanzate sul lato destro della finestra.
Seleziona il valore della proprietà Application Pool e copiala negli Appunti.
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
Fai clic sul pulsante Controlla nomi. Quando Windows risolve l’account utente, fai clic su OK.
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à.
Utilizza la seguente procedura per registrare il tipo MIME JSON quando vuoi che Dispatcher consenta le chiamate JSON.
In IIS Manager, seleziona il sito Web e, utilizzando Visualizzazione funzionalità, fai doppio clic su Tipi MIME.
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:
.json
application/json
Per rimuovere il segmento nascosto bin
, utilizza la procedura descritta di seguito. I siti Web che non sono nuovi possono contenere questo segmento nascosto.
bin
, fai clic su Rimuovi e nella finestra di dialogo di conferma fai clic su Sì.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.
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
.
Fai clic con il pulsante destro del mouse sulla cartella di Dispatcher e fai clic su Proprietà.
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.
In Gestione IIS, seleziona il sito IIS che utilizzi come cache di Dispatcher e fai clic su Impostazioni avanzate sul lato destro della finestra.
Seleziona il valore della proprietà Application Pool e copiala negli Appunti.
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
Fai clic sul pulsante Controlla nomi. Quando Windows risolve l’account utente, fai clic su OK.
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à.
Utilizza un editor di testo per aprire il file disp_iis.ini
.
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
Prima di poter iniziare a utilizzare Dispatcher è necessario conoscere:
Le istruzioni per l’installazione in Windows e Unix sono riportate qui. Fai molta durante l’esecuzione di questi passaggi.
Per informazioni sull’installazione di un server web Apache, leggere il manuale di installazione online o nella distribuzione.
Se stai creando un file binario di Apache tramite la compilazione dei file source, accertati che sia ttivo il supporto dei moduli dinamici. Per questo scopo, puoi utilizzare una qualsiasi delle opzioni –enable-shared. Quantomeno includi il modulo mod_so
.
Ulteriori informazioni sono disponibili nel manuale di installazione del server web Apache.
Vedi anche i suggerimenti sulla sicurezza e i rapporti sulla sicurezza di Apache HTTP Server.
Dispatcher viene fornito per:
L’archivio di installazione contiene i seguenti file, a seconda che sia stato selezionato Windows o Unix:
File | Descrizione |
---|---|
disp_apache<x.y>.dll | Windows: il file DLL di Dispatcher. |
dispatcher-apache<x.y>-<rel-nr>.so | Unix: il file DSO di Dispatcher. |
mod_dispatcher.so | Unix: un esempio di collegamento. |
http.conf.disp<x> | Un esempio di file di configurazione del server Apache. |
dispatcher.any | Esempio di file di configurazione per Dispatcher. |
README | File Readme contenente istruzioni di installazione e informazioni dell’ultimo minuto. Nota: leggere questo file prima di iniziare l’installazione. |
CHANGES | Il file Changes in cui sono elencati i problemi risolti in questa e nelle precedenti versioni. |
Per aggiungere Dispatcher al server web Apache, fai quanto segue:
Posiziona il file di Dispatcher nella directory appropriata del modulo Apache:
disp_apache<x.y>.dll
in <APACHE_ROOT>/modules
<APACHE_ROOT>/libexec
o <APACHE_ROOT>/modules
in base al tipo di installazione.dispatcher-apache<options>.so
in questa directory.mod_dispatcher.so
a Dispatcher:ln -s dispatcher-apache<x>-<os>-<rel-nr>.so mod_dispatcher.so
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).
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à:
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](/.*)?"
È 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:
Accedi a <APACHE_ROOT>/conf
.
Apri httpd.conf
per la modifica.
È necessario aggiungere le seguenti voci di configurazione, nell’ordine indicato:
(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:
Windows | ... LoadModule dispatcher_module modules\disp_apache.dll ... |
Unix (presupponendo un collegamento simbolico) | ... LoadModule dispatcher_module libexec/mod_dispatcher.so ... |
Il primo parametro di ogni istruzione deve essere scritto esattamente come negli esempi precedenti.
Per informazioni dettagliate su questo comando, vedi gli esempi di file di configurazione forniti e la documentazione del server web Apache.
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:
Parametro | Descrizione |
---|---|
DispatcherConfig | Posizione e nome del file di configurazione di Dispatcher. Quando questa proprietà si trova nella configurazione del server principale, tutti gli host virtuali ereditano il valore della proprietà. Tuttavia, gli host virtuali possono includere la proprietà DispatcherConfig per ignorare la configurazione del server principale. |
DispatcherLog | Posizione e nome del file di registro. |
DispatcherLogLevel | Livello del file di registro: 0 - Errori 1 - Avvisi 2 - Informazioni 3 - Debug Nota: si consiglia di impostare il livello del file di registro su 3 durante l’installazione e il test, quindi su 0 quando l’esecuzione avviene in un ambiente di produzione. |
DispatcherNoServerHeader | Questo parametro è obsoleto e non è più valido. Definisce l’intestazione del server da utilizzare:
|
DispatcherDeclineRoot | Definisce se rifiutare le richieste alla radice "/": 0 - Accetta le richieste a / 1 - Le richieste a / non sono gestite da Dispatcher; utilizza mod_alias per il mapping corretto. |
DispatcherUseProcessedURL | Definisce se utilizzare URL preelaborati per tutte le ulteriori elaborazioni da parte di Dispatcher: 0 - Utilizza l’URL originale inviato al server web. 1 - Dispatcher utilizza l’URL già elaborato dagli handler che precedono Dispatcher (vale a dire, mod_rewrite ) invece dell’URL originale inviato al server web. Ad esempio, l’URL originale o quello elaborato corrisponde ai filtri di Dispatcher. L’URL viene utilizzato anche come base per la struttura del file della cache. Per informazioni su mod_rewrite, vedi la documentazione del sito web di Apache; ad esempio, Apache 2.4. Quando si utilizza mod_rewrite, è consigliabile utilizzare il flag ‘passthrough |
DispatcherPassError | Definisce come supportare i codici di errore per la gestione di ErrorDocument: 0 - Dispatcher effettua lo spool di tutte le risposte di errore inviate al client. 1 - Dispatcher non effettua lo spool di una risposta di errore inviata al client (nel caso in cui il codice di stato sia maggiore di o uguale a 400), ma invia il codice di stato ad Apache, il quale, ad esempio, consente a una direttiva ErrorDocument di elaborarlo. Intervallo di codici - Specifica un intervallo di codici di errore per i quali la risposta viene inviata ad Apache. Gli altri codici di errore vengono inviati al client. Ad esempio, la seguente configurazione invia al client le risposte per l’errore 412 e tutti gli altri errori vengono inviati ad Apache: DispatcherPassError 400-411,413-417 |
DispatcherKeepAliveTimeout | Specifica il timeout keep-alive espresso in secondi. A partire dalla versione 4.2.0 di Dispatcher, il valore keep-alive predefinito è 60. Il valore 0 disattiva keep-alive. |
DispatcherNoCanonURL | Se si attiva questo parametro, l’URL non elaborato viene inviato al backend invece che alla destinazione canonica e vengono ignorate tutte le impostazioni di DispatcherUseProcessedURL. Il valore predefinito è Disattivato. Nota: le regole dei filtri nella configurazione di Dispatcher verranno sempre valutate in base all’URL bonificato e non all’URL non elaborato. |
Le voci del percorso sono relative alla directory principale del server web Apache.
Le impostazioni predefinite per l’intestazione del server sono:
ServerTokens Full
DispatcherNoServerHeader 0
Mostra la versione di AEM (per fini statistici). Se vuoi disattivare la disponibilità di queste informazioni nell’intestazione, puoi impostare:
ServerTokens Prod
Per ulteriori informazioni, vedi la Documentazione di Apache sulla direttiva ServerTokens (ad esempio, per Apache 2.4).
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>
...
Il parametro dell’istruzione SetHandler deve essere scritto esattamente come negli esempi precedenti, in quanto questo è il nome dell’handler definito nel modulo.
Per informazioni dettagliate su questo comando, vedi gli esempi di file di configurazione forniti e la documentazione del server web Apache.
ModMimeUsePathInfo
Dopo l’istruzione SetHandler è necessario aggiungere anche la definizione ModMimeUsePathInfo.
Il parametro ModMimeUsePathInfo
va utilizzato e configurato solo se utilizzi Dispatcher versione 4.0.9 o successive.
(Dispatcher versione 4.0.9 è stato rilasciato nel 2011. Se utilizzi una versione precedente, sarebbe auspicabile l’aggiornamento a una versione recente di Dispatcher).
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>
...
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.
Apri un terminale e cambia la directory corrente con la directory in cui sono installate le librerie OpenSSL, ad esempio:
cd /usr/lib64
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
Se utilizzi una versione personalizzata di Apache, accertati che Apache e Dispatcher siano compilati con la stessa versione di OpenSSL.
Prima di iniziare a utilizzare Dispatcher, è necessario:
Le istruzioni per gli ambienti Windows e Unix sono descritte qui.
Fai molta attenzione quando selezioni quale eseguire.
Per informazioni dettagliate su come installare questi server web, vedi la relativa documentazione:
Dispatcher viene fornito per:
L’archivio di installazione contiene i seguenti file, a seconda che sia stato selezionato Windows o Unix:
File | Descrizione |
---|---|
disp_ns.dll |
Windows: il file DLL di Dispatcher. |
dispatcher.so |
Unix: il file DSO di Dispatcher. |
dispatcher.so |
Unix: un esempio di collegamento. |
obj.conf.disp |
Esempio di file di configurazione per Sun Java System Web Server / iPlanet. |
dispatcher.any |
Esempio di file di configurazione per Dispatcher. |
README | File Readme contenente istruzioni di installazione e informazioni dell’ultimo minuto. Nota: leggere questo file prima di iniziare l’installazione. |
CHANGES | Il file Changes in cui sono elencati i problemi risolti in questa e nelle precedenti versioni. |
Per aggiungere Dispatcher al server web, fai quanto segue:
plugin
del server web:È 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
.
Accedi a <WEBSERVER_ROOT>/config
.
Apri obj.conf
per la modifica.
Copia la riga che inizia con:
Service fn="dispService"
dal file obj.conf.disp
alla sezione di inizializzazione del file obj.conf
.
Salva le modifiche.
Apri magnus.conf
per la modifica.
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
.
Salva le modifiche.
Le seguenti configurazioni devono essere tutte su una stessa riga e i parametri $(SERVER_ROOT)
e $(PRODUCT_SUBDIR)
devono essere sostituiti dai rispettivi valori.
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:
Parametro | Descrizione |
---|---|
config | Posizione e nome del file di configurazione dispatcher.any. |
logfile | Posizione e nome del file di registro. |
loglevel | Livello di registro per la scrittura dei messaggi nel file di registro: 0 Errori 1 Avvisi 2 Informazioni 3 Debug Nota: si consiglia di impostare il livello di registro su 3 durante l’installazione e il test e su 0 quando l’esecuzione avviene in un ambiente di produzione. |
keepalivetimeout | Specifica il timeout keep-alive espresso in secondi. A partire dalla versione 4.2.0 di Dispatcher, il valore keep-alive predefinito è 60. Il valore 0 disattiva keep-alive. |
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="\*/\*"
...
Prima di iniziare a utilizzare Dispatcher, è necessario: