Référence : |
L'installation WebFOCUS fournit une option pour installer le connecteur Tomcat (plug-in). Dans certains environnements, la configuration manuelle est nécessaire après l'installation terminée. Si vous avez choisi de configurer le connecteur Tomcat (plug-in) avec le client WebFOCUS, il devrait être installé dans :
C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector
Si le connecteur Tomcat n'est pas installé, vous pouvez suivre les étapes ci-dessous pour installer et configurer manuellement le connecteur.
Une installation de Tomcat qui s'est correctement déroulée, a effectué les étapes suivantes. Vous n'avez pas besoin d'effectuer manuellement ces étapes à moins qu'une erreur s'est produite lors de l'installation WebFOCUS, si le connecteur ne fonctionne pas correctement, ou si vous souhaitez ajouter le connecteur plus tard. De plus, si vous souhaiter changer le site web IIS qui utilise le connecteur, il peut être nécessaire d'effectuer certaines configurations manuelles.
- S'ils n'existent pas déjà, créez manuellement les sous-répertoires suivants sous le répertoire C:\Program Files\Apache Software Foundation\ :
\Jakarta Isapi Redirector\bin
\Jakarta Isapi Redirector\conf
\Jakarta Isapi Redirector\log
- Le connecteur doit être installé sur votre système dans le répertoire par défaut suivant :
C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector\bin
Remarque : si vous changez le répertoire par défaut, effectuez une substitution.
S'il n'existe pas, vous pouvez obtenir une copie du fichier isapi_redirect.dll depuis le répertoire suivant :
drive:\ibi\WebFOCUS81\utilities\install\iisCopiez le fichier isapi_redirect.dll vers le répertoire par défaut.
Remarque : Pour les installations Windows AMD 64 bits, une copie du fichier 64 bits isapi_redirect_64.dll se trouve dans le répertoire suivant :
drive:\ibi\WebFOCUS81\utilities\install\iis - Dans le sous-répertoire \Jakarta Isapi Redirector\conf, créez les fichiers suivants :
-
uriworkermap.properties
L'exemple suivant fournit la structure du fichier uriworkermap.properties, que vous pouvez utiliser comme référence :
# uriworkermap.properties - # # This file provides sample mappings for example # ajp13w worker defined in workermap.properties /servlet-examples/*=ajp13w # Now filter out all .jpeg files inside that context # For no mapping the url has to start with exclamation (!) !/servlet-examples/*.jpeg=ajp13w
Le fichier uriworkermap.properties indique à IIS quand transmettre les requêtes à Tomcat. Ce fichier doit spécifier les racines de contexte WebFOCUS suivantes :
- /ibi_apps
- /ibi_help
Remarque : si vous utilisez un alias personnalisé dans votre environnement, assurez-vous que l'alias utilisé pour la racine de contexte est bien spécifié.
Dans un éditeur texte, ouvrez le fichier uriworkermap.properties, qui se trouve dans le répertoire suivant :
C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector\ conf\uriworkermap.properties
Conseil : si le formatage du fichier n'apparaît pas correctement dans Notepad, vous pouvez utiliser WordPad. Toutefois, si vous utilisez WordPad, vérifiez que le fichier est enregistré en tant que texte (.txt).
Vérifiez que les racines contextuelles sont définies comme suit :
/ibi_apps/*=ajp13w
/ibi_help/*=ajp13w
Si ces lignes n'existent pas, ajoutez les après les éléments suivants :
/servlet-examples/*=ajp13w
En utilisant la ligne par défaut, IIS va transférer
http://hostname/ibi_apps/
but not
http://hostname/ibi_apps
Si vous souhaitez transférer tous les deux, ajoutez les lignes suivantes, en plus des autres lignes à la fin du fichier uriworkermap.properties :
/ibi_apps=ajp13w
/ibi_help=ajp13w
Cependant, la ligne exacte n'apparaît qu'une seule fois.
Remarque : si vous voulez que Tomcat traite les alias approot et que IIS ne soit utilisé que pour leur transmettre les requêtes, ajoutez /approot/*=ajp13w au fichier uriworkermap.properties, puis créez un contexte Tomcat pointant vers le fichier WAR approot : drive:\ibi\WebFOCUS81\webapps\approot.war
Enregistrez et quittez le profil et quittez l'éditeur. Redémarrez IIS.
-
workers.properties
L'exemple suivant fournit la structure du fichier workers.properties, que vous pouvez utiliser comme référence :
# workers.properties - # # This file provides minimal jk configuration properties needed to # connect to Tomcat. # # The workers that jk should create and work with # worker.list=ajp13w # # Defining a worker named ajp13w and of type ajp13 # Note that the name and the type do not have to match. # worker.ajp13w.type=ajp13 worker.ajp13w.host=localhost worker.ajp13w.port=8009
-
uriworkermap.properties
- Créez les paramètres du Registre sous :
HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0
Le tableau suivant affiche les paramètres. Confirmez qu'ils sont créés correctement sur votre système.
Nom de valeur
Données de valeur
extension_uri
/jakarta/isapi_redirect.dll
fichier de journal
C:\Program Files\Apache Software Foundation\ Jakarta Isapi Redirector\log\isapi_redirect.loglog_level
info
worker_file
C:\Program Files\Apache Software Foundation\ Jakarta Isapi Redirector\conf\workers.propertiesworker_mount_file
C:\Program Files\Apache Software Foundation\ Jakarta Isapi Redirector\conf\uriworkermap.propertiesL'image suivante montre les paramètres créés dans l'Editeur de registres.
- Créez un répertoire virtuel (alias) avec les autorisations pour scripts et exécutables sous le site web IIS par défaut.
Alias
Chemin
/jakarta
C:\Program Files\Apache Software Foundation\ Jakarta Isapi Redirector\bin\
Ceci doit avoir les autorisations d'exécution pour scripts et exécutables. Vous pouvez confirmer ou ajouter cela avec le Gestionnaire des services Internet. Si vous n'êtes pas sûr comment ajouter un répertoire virtuel, consultez Configurer les répertoires virtuels IIS (alias).
Si vous souhaitez utiliser le connecteur avec un site web différent, créez aussi ce répertoire virtuel sous ce site, ou bien remplacez l'existant.
- Ajouté le fichier suivant en tant que filtre ISAPI sur le site Web par défaut :
C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector\ bin\isapi_redirect.dll
Dans le gestionnaire des services Internet, faites un clic droit sur le site Web par défaut, choisissez Propriétés, puis sélectionnez l'onglet Filtres ISAPI. Cliquez sur Ajouter, entrez Jakarta dans le champ Nom Filtre ainsi que le chemin complet du fichier isapi_redirect.dll en tant qu'exécutable.
Si vous souhaitez utiliser le connecteur avec un autre site web, créez plutôt ce filtre sous celui-ci. Assurez-vous d'ajouter le filtre pour le site Web spécifique, pas pour le serveur IIS en entier.
Remarque :
- Pour utiliser plusieurs instances du connecteur Tomcat, consultez le Mémo technique 4595 : installation de plusieurs instances de WebFOCUS en utilisant Apache Tomcat sous Windows.
- Si WebFOCUS a installé le connecteur Tomcat, vous pouvez manuellement le désinstaller en supprimant les paramètres du registre, filtre ISAPI, Répertoire virtuel, et le répertoire Redirecteur Jakarta Isapi.
Le fichier workers.properties informe IIS où trouver Tomcat. Il est situé dans le répertoire suivant :
C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector\ conf\workers.properties
Normalement, vous n'avez pas besoin de modifier ce fichier. Vous ne devez modifier ce fichier que si vous avez changé le port par défaut 8009 ou si Tomcat n'est pas sur le même ordinateur que IIS. Si vous avez exécuté manuellement l'installation de Tomcat Connector, le fichier workers.properties est utilisé à la place.
Remarque : IIS trouve le fichier workers.properties en recherchant dans le registre. Toutefois, si un fichier isapi_redirect.properties est dans le même répertoire que le fichier isapi_redirect.dll, IIS lit le fichier isapi_redirect.properties au lieu du registre.
Le fichier journal par défaut pour le connecteur Tomcat est écrit sous :
C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector\log
Dans certains environnements, le fichier isapi_redirect.log peut être vide. Si vous souhaitez utiliser ce fichier journal, il peut être nécessaire de définir les autorisations NTFS afin qu'IIS puisse écrire ou modifier le répertoire du journal. Normalement, ceci requiert des permissions modifier/écrire sur l'utilisateur IUSR_servername et le groupe Utilisateurs authentifiés, mais les ID utilisateurs requis peuvent varier en fonction de votre configuration.
Vous pouvez contrôler la quantité d'informations consignées via le registre sous :
HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0\log_level
Vous pouvez définir cela à l'un des suivants :
debug info error emerg
Vous devez redémarrer IIS si vous modifiez log_level.