JSP su IIS con il Tomcat Connector

Le guide e gli how-to in giro per Internet su come usare le JSP su IIS non sono molto a prova di bomba, e a me piacciono le cose next-next-next.

Questa è una procedura testata con Windows 2003 e il Connector 1.2.25...

1. IIS
   
1. deve essere installato, doh.
   
2. Tomcat
1. Scaricarlo da http://tomcat.apache.org/download-60.cgi
2. Installarlo in d:\Tomcat6.0\ [è meglio se non ci sono spazi]
3. Verificare che sia installato come servizio e che parta in automatico.
   
4. Verificare che funzioni http://localhost:8080/
5. Stoppare il servizio
6. Cancellare TUTTE le directory in tomcat\webapps
   [tranne manager, che può essere utile]
7. Creare il file d:\Tomcat6.0\conf\Catalina\localhost\ROOT.xml che contenga
   

   <context docbase="D:\sito\www\" path="">
   </context>

   "D:\sito\www\" è la "Home directory" della configurazione del sito in IIS
   
8. Riavviare il servizio
9. Verificare che in d:\Tomcat6.0\logs non ci siano errori
10. Verificare che funzioni http://localhost:8080/
11. Verificare http://localhost:8080/manager/html (se manager c'è ancora)
    
3. Connector
1. Scaricarlo da http://tomcat.apache.org/download-connectors.cgi
2. Copiarlo in d:\TomcatConnector\
4. File di configurazione (del Connector)
1. Creare il file d:\TomcatConnector\workers.properties
   Vedi... http://tomcat.apache.org/connectors-doc/reference/workers.html
   

   # Define 1 real worker using ajp13
   worker.list=worker1
   # Set properties for worker1 (ajp13)
   worker.worker1.type=ajp13
   worker.worker1.host=localhost
   worker.worker1.port=8009

2. Creare il file d:\TomcatConnector\uriworkermap.properties
   Vedi... http://tomcat.apache.org/connectors-doc/reference/uriworkermap.html
   

   # uriworkermap.properties - IIS
   #
   # The general syntax for this file is:
   # [URL]=[Worker name]
   #
   /*.jsp=worker1
   /WEB-INF/*=worker1
   
   # Optionally filter out all .jpeg files inside that context
   # For no mapping the url has to start with exclamation (!)
   
   # !/servlets-examples/*.jpeg=worker1

5. Configurazione del registro
1. creare un file .reg sul server con il contenuto:
   

   Windows Registry Editor Version 5.00
   
   [HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0]
   "extension_uri"="/jakarta/isapi_redirect.dll"
   "log_file"="D:\\TomcatConnector\\logs\\isapi.log"
   "log_level"="info"
   "worker_file"="D:\\TomcatConnector\\workers.properties"
   "worker_mount_file"="D:\\TomcatConnector\\uriworkermap.properties"

   
   
   
2. Eseguire il file .reg
   
6. Configurazione di IIS
1. Aggiungere una nuova virtual directory al sito da JSPizzare
   

   nome: jakarta
   percorso: D:\TomcatConnector\
   permessi: read & execute

2. Web Sites Properties -> ISAPI Filters -> Add
   

   Filter name: tomcat
   Executable: D:\TomcatConnector\isapi_redirect.dll

3. Web Service Extensions -> Add New Web Service Extension
   

   Extension name: Tomcat Connector
   Required file: D:\TomcatConnector\isapi_redirect.dll
   Set extension status to Allowed

4. NOMESERVER Properties -> MIME Types
   Aggiungere .jsp - text/html
7. Verificare i permessi dei file
1. D:\TomcatConnector\
   
   • Administrator: full control
   • Ftp user: modify
   • IIS_WPG: read & execute
   • IUSR_machine: read & execute
   • SYSTEM: full control
   • Users: read & execute
     
2. D:\TomcatConnector\logs\
   ereditati, più...
   
   • IIS_WPG: modify
   • IUSR_machine: modify
3. D:\sitoweb\WEB-INF
   Da IIS -> Directory Security -> Autentication and access control -> Edit
   togliere "Enable anonymous access"
   
8. Riavviare IIS
9. Testare
   
10. Bere una birra e/o un caffè alla mia salute

Altra documentazione:
http://tomcat.apache.org/connectors-doc/

enjoy
-m