====== Installazione Tomcat Connectors Jk 1.2.X (isapi_redirect.dll) ======

Il connettore fa dialogare IIS al Tomcat ed è un servizio esterno ad Apache Tomcat.

1.	Configurazione del “connettore” (N.B. fare attenzione alla versione del proprio sistema, se a 64bit o 32bit)

Per la documentazione su questo componente open source, fare riferimento al seguente link:

https://tomcat.apache.org/connectors-doc/reference/iis.html

1.	Creare la cartella “connettore” sotto C:\

2.      Creare una cartella "logs" nella cartella "connettore"

3.	Eseguire il download della dll dal link ufficiale: 

Link 64 bit

http://apache.panu.it/tomcat/tomcat-connectors/jk/binaries/windows/tomcat-connectors-1.2.42-windows-x86_64-iis.zip

Link 32 bit:

http://apache.panu.it/tomcat/tomcat-connectors/jk/binaries/windows/tomcat-connectors-1.2.42-windows-i386-iis.zip

4.	Nella cartella “C:\connettore” creare i seguenti file:

5.	Copiare il file isapi_redirect.dll nella cartella C:\connettore

  * file “isapi_redirect.properties” col seguente contenuto:
<code>
    # Configuration file for the Jakarta ISAPI Redirector
    # The path to the ISAPI Redirector Extension, relative to the website
    # This must be in a virtual directory with execute privileges
    extension_uri=/jakarta/isapi_redirect.dll
    # Full path to the log file for the ISAPI Redirector
    log_file=C:\connettore\logs\Connector.log
    # Log level (debug, info, warn, error or trace)
    log_level=error
    # Full path to the workers.properties file
    worker_file=C:\connettore\workers.properties
    # Full path to the uriworkermap.properties file
    worker_mount_file=C:\connettore\uriworkermap.properties
</code>
  * file “web.config” col seguente contenuto:
<code>
    <?xml version="1.0" encoding="UTF-8"?>
    <configuration>
    <system.webServer>
    <urlCompressiondoStaticCompression="false" />
    <handlers accessPolicy="Read, Execute, Script" />
    </system.webServer>
    </configuration>
</code>

  * file “workers.properties” col seguente contenuto:
<code>
    worker.list=extra
    worker.extra.port=8009
    worker.extra.host=localhost
    worker.extra.type=ajp13
</code>
  * file “uriworkermap.properties” col seguente contenuto:
<code>
    #/nome_contesto=extra
    #/nome_contesto/*=extra
</code>

2.	Creazione in IIS di directory Virtuale ‘jakarta’ che punta a c:/connettore

  1.	Dal Server Manager cliccare su “Strumenti”

  2.	Selezionare “Gestione Internet Information Services (IIS)”

{{:gwinstguide:idxinstguide:server_manager.png?600|}}

  3.	Dall’elenco a tendina cliccare con tasto dx su “default websites” e selezionare “addvirtual directory”
  
{{:gwinstguide:idxinstguide:h_p_def_web_site.png?600|}}

{{:gwinstguide:idxinstguide:agg_directory_virt.png?600|}}

3.	Creare un filtro isapi di nome ‘jakarta’ che punta alla dll isapi_redirect.dll; selezionando Filtri ISAPI dalla Home Page di Default Web Site e poi “Aggiungi” dal menu delle Azioni dopo aver fatto doppio click

{{:gwinstguide:idxinstguide:home_p_default.png?600|}}

{{:gwinstguide:idxinstguide:filtri_sapi.png?600|}}

4.	Inserire nel nome del filtro “jakarta” e nell’eseguibile “c:\connettore\isapi_redirect.dll”

{{:gwinstguide:idxinstguide:connettore_isapi.png?600|}}

5.	Aggiungere tra le estensioni conosciute e valide la dll su citata; selezionando “Restrizioni ISAPI e CGI” nella home page del server. Dopo averci fatto doppio clic selezionare aggiungi. Spuntare “consenti esecuzione percorso estensione”

{{:gwinstguide:idxinstguide:home_page_win.png?600|}}

{{:gwinstguide:idxinstguide:res_isapi_e_cgi.png?600|}}

{{:gwinstguide:idxinstguide:agg_res_isapi_o_cgi.png?600|}}

6.	Aprire il file “uriworkermap.properties” presente nella cartella del connettore “C:\connettore” e configurarlo inserendo per ogni contesto applicativo le seguenti 2 righe
/nomecontesto=extra
/nomecontesto/*=extra
N.B. Cosa che verrà fatta successivamente in fase di deploy dell'applicativo.