Dans cette section : |
Cette section explique comment configurer manuellement Apache Tomcat pour l'utilisation avec WebFOCUS et ReportCaster. L'installation WebFOCUS vous a donné l'option d'installer et de configurer Apache Tomcat pour vous. Si vous avez sélectionné cette option et l'outil de vérification a été exécutée avec succès, vous n'avez pas besoin de configurer manuellement Tomcat. Cependant, si vous êtes nouveau sur Tomcat ou recevez des erreurs, vous devriez consulter cette section pour comprendre le processus de configuration.
Il existe deux configurations disponibles lorsque vous utilisez Apache Tomcat :
Microsoft IIS peut être utilisé en tant que serveur Web, avec Tomcat en tant que serveur d'applications. Cela requiert la configuration de deux serveurs et de leurs communications. Le traitement est ensuite divisé entre Tomcat et IIS.
Remarque : pour limiter l'utilisation d'IIS à la transmission des requêtes à Tomcat via un pare-feu, configuré Tomcat en mode autonome tel que nous le décrivons dans cette section, puis configurer manuellement le connecteur Tomcat en suivant les instructions de Configurer IIS pour utiliser le connecteur Tomcat (plugin).
Vous aurez peut-être à ajuster les options mémoire JVM en cas de problèmes de performance.
Ouvrez l'utilitaire de configuration Tomcat et sélectionnez l'onglet Java, comme le montre l'image suivante.
Pour Java 6 et 7, dans la section Options Java, assurez-vous que la ligne suivante a été ajoutée :
-XX:MaxPermSize=256M
Remarque : ceci n'est pas nécessaire pour Java 8.
Assurez-vous que la taille de pool mémoire initiale est d'au moins 256 méga-octets et la taille maximale de 512 méga-octets.
Comment : Référence : |
On suppose que Tomcat est installé pour le moment. Si Tomcat n'est pas installé, vous pouvez l'installer avec le CD Installation du client WebFOCUS ou en téléchargeant l'utilitaire d'installation depuis :
Si vous avez choisi pour que WebFOCUS configure Tomcat pour vous, les étapes suivantes ont été effectuées :
Les étapes suivantes peuvent être effectuées pour configurer davantage Tomcat :
L'emplacement du pilote JDBC se trouve obligatoirement dans le CLASSPATH Tomcat. Tomcat s'exécute comme un service Windows, donc CLASSPATH est défini dans le registre. Si vous avez choisi de configurer Tomcat lorsque vous avez installé WebFOCUS, l'installation aurait dû définir cela pour vous.
Pour définir manuellement Java Classpath ou dépanner, vérifiez votre champ CLASSPATH et n'oubliez pas d'inclure le pilote JDBC.
Remarque : si le pilote n'apparaît pas, ajoutez un point-virgule à la fin du champ Classpath Java. Puis ajoutez le chemin d'accès absolu vers le pilote JDBC pour votre référentiel. Si plus d'un fichier est nécessaire, séparez chaque chemin d'accès avec un point-virgule. Les espaces peuvent se produire dans les noms de répertoire, mais pas entre les chemins d'accès et les points-virgules. N'oubliez pas d'inclure le nom du fichier et pas seulement le répertoire contenant le fichier. Par exemple :
C:\ibi\tomcat\bin\bootstrap.jar;C:\drivers\sqljdbc.jar
Pour plus d'informations sur les pilotes JDBC, consultez Tâches et rubriques Référentiel WebFOCUS.
Par défaut, Tomcat utilise les trois ports TCP listés ci-dessous.
Port par défaut |
Nom |
Utiliser |
---|---|---|
8080 |
Port d'écoute HTTP |
Vous pouvez accéder à Tomcat dans un navigateur web avec ce port. Par exemple : http://hostname:8080 |
8009 |
Port connecteur |
Les serveurs acheminent les requêtes vers Tomcat sur ce port. Le connecteur Tomcat (plug-in) pour IIS utilise ce port. Si vous modifiez ce port et utilisez le connecteur, modifiez le port dans le fichier workers.properties du connecteur. |
8005 |
Port d'arrêt |
Tomcat utilise ce port pour les opérations internes et s'arrêter. |
Vous n'avez normalement pas besoin de modifier ces ports. Cependant, si ces ports ne sont pas disponibles ou que vous souhaitez les modifier, effectuez les étapes suivantes :
C:\ibi\tomcat\conf\server.xml
Si vous modifiez les valeurs par défaut, faites les changements en conséquence dans les procédures et exemples.
Dans cette section :
Comment : Référence : |
La configuration de Tomcat nécessite surtout pour indiquer à Tomcat où les fichiers WebFOCUS sont situés et les racines contextuelles dans lesquelles les utiliser. Par exemple, vous devez indiquer à Tomcat qu'il doit servir les fichiers depuis l'application web WebFOCUS :
drive:\ibi\WebFOCUS81\webapps\webfocus
Lorsqu'il reçoit une requête pour la racine contextuelle WebFOCUS :
http://hostname:8080/ibi_apps/
En créant ce contexte, vous déployez l'application web WebFOCUS.
Tomcat peut aussi servir les fichiers à l'extérieur d'une application Web s'il connaît leur emplacement et leur contexte. Ainsi, Tomcat peut être utilisé comme serveur web et serveur d'applications. Sur un serveur web traditionnel, vous créez des alias. Avec Tomcat, un alias est traité comme une racine contextuelle, même lorsqu'en servant des fichiers en dehors d'une application web.
Contexte (chemin) | Répertoire (DocumentBase) |
---|---|
/ibi_apps | drive:\ibi\WebFOCUS81\webapps\webfocus.war |
/ibi_help | drive:\ibi\WebFOCUS81\webapps\ibi_help.war |
/approot | drive:\ibi\WebFOCUS81\webapps\approot.war |
Contexte (chemin) | Répertoire (DocumentBase) |
---|---|
/ibi_apps | drive:\ibi\WebFOCUS81\webapps\webfocus.war |
/ibi_help | drive:\ibi\WebFOCUS81\webapps\ibi_help.war |
Le contexte approot est alors créé en tant qu'alias (Répertoires Virtuels) sur IIS. IIS est ensuite configuré pour envoyer les requêtes de ibi_apps vers Tomcat.
<catalina_home>\conf\Catalina\localhost
Remarque : si vous avez une version existante de Tomcat, qui n'a pas été installée par une 8.x de WebFOCUS, le répertoire sera en-dessous de :
<catalina_home>\conf\Catalina\localhost
Ce répertoire peut contenir les fichiers XML qui définissent les contextes. Si l'installation de WebFOCUS a installé et a configuré Tomcat pour vous, le fichier suivant devrait s'afficher pour définir le contexte ibi_apps qui déploie le répertoire de WebFOCUS :
ibi_apps.xml
ibi_help.xml
Si vous utilisez Tomcat en mode autonome, les éléments suivants devraient apparaître également :
approot.xml
Les fichiers XML sont nommés pour la racine contextuelle que vous utilisez pour accéder à l'application Web et doit avoir la syntaxe suivante :
<?xml version='1.0' encoding='utf-8'?> <Context docBase="path_To_WebApplication" path="/contextRoot"> </Context>
où :
est le chemin d'accès absolu vers le fichier WAR ou le répertoire que vous déployez.
est la racine contextuelle.
Remarque : les fichiers XML peuvent contenir d'autres informations optionnelles, comme l'explique la documentation Tomcat.
Vous pouvez créer ou éditer les fichiers dans un éditeur texte, tel que Notepad.
<?xml version='1.0' encoding='utf-8'?> <Context docBase="C:\ibi\WebFOCUS81\webapps\webfocus" path="/ibi_apps" useHttpOnly="true"> </Context>
N'oubliez pas de préciser le bon répertoire sur votre ordinateur et de modifier la racine contextuelle si vous n'utilisez pas le contexte par défaut (ibi_apps).
<?xml version='1.0' encoding='utf-8'?> <Context docBase="C:\ibi\apps" path="/approot"> </Context>
N'oubliez pas de préciser le bon répertoire sur votre ordinateur.
Ce n'est pas une considération si vous venez d'installer WebFOCUS pour la première fois, mais vous devriez en tenir compte lorsque vous installez un service pack ou une nouvelle révision. Lorsque vous mettez à niveau WebFOCUS ou installez un service pack, Tomcat doit utiliser la nouvelle application web plutôt que des copies mises en mémoire cache de l'ancienne version.
<catalina_home>\work\Catalina\localhost\ibi_apps
<catalina_home>\work\Catalina\localhost\ibi_help
<catalina_home>\work\Catalina\localhost\approot (si déjà déployé)
<catalina_home>\conf\Catalina\localhost\ibi_apps.xml
<catalina_home>\work\Catalina\localhost\ibi_apps
<catalina_home>\work\Catalina\localhost\ibi_help
<catalina_home>\webapps\ibi_apps
Remarque : lorsque vous déployez des fichiers WAR, Tomcat les déploie dans sa propre structure de répertoires, sans forcément connaître l'emplacement original.
Vous pouvez accéder à la fenêtre Propriétés Apache Tomcat via Programmes, Information Builders, Tomcat, et Utilitaire Configuration Tomcat. L'image suivante montre Apache Tomcat 8.0.21 pour la fenêtre Propriétés WebFOCUS.
Pour changer les paramètres de mémoire Java, cliquez sur l'onglet Java, comme le montre l'image suivante.
Si nécessaire, vous pouvez utiliser cet onglet pour modifier les paramètres de mémoire Java après l'installation.
Le gestionnaire d'applications Tomcat (Tomcat Manager) est fourni avec Apache Tomcat. Il fournit la fonctionnalité de base pour gérer les applications web déployées sur Apache Tomcat. Il peut être utilisé pour résoudre des problèmes liés au déploiement, ou, si nécessaire, déployer manuellement les fichiers .war. À partir de WebFOCUS 8, le gestionnaire d'applications Tomcat n'est pas déployé automatiquement.
Comment : |
Après avoir terminé la configuration, exécutez les appels de test pour vérifier le fonctionnement.
http://hostname:port/ibi_apps
où :
Sont le nom d'hôte et le port du serveur Web. Toutefois, si vous utilisez une configuration seule du serveur d'applications, alors ceux-là sont le nom d'hôte et le port HTTP du serveur d'applications. Pour les configurations Tomcat autonomes, le port par défaut est 8080. Si vous avez besoin du certificat SSL, utilisez le préfixe https au lieu du préfixe http.
La page de connexion WebFOCUS s'ouvre, comme le montre l'image suivante.
La page d'accueil du Portail BI WebFOCUS s'ouvre dans votre navigateur.
La console d'administration WebFOCUS s'ouvre.
La page suivante s'ouvre, présentant votre instance WebFOCUS Reporting Server instance si celle-ci est disponible.
Quand Tester procédure existante est sélectionné et que le Serveur de Rapports WebFOCUS n'est pas en cours d'exécution, ou tourne avec sécurité activée (ON), vous êtes invité à renseigner les informations de connexion au serveur.
Lorsque les informations de connexion sont renseignées, et que le serveur de rapports WebFOCUS n'est pas en cours d'exécution, un message d'erreur s'affiche.
Si le serveur de rapports WebFOCUS est en cours d'exécution avec sécurité désactivée (OFF), la page Exécuter une procédure stockée s'ouvre, comme le montre l'image suivante.
Une procédure est normalement lancée avec Servlet WebFOCUS et un exemple de rapport devrait s'afficher. Vous pouvez utiliser manuellement un servlet pour exécuter une procédure, telle que carinst.fex, avec :
http://host:[port]/ibi_apps/WFServlet?IBIF_ex=carinst
WebFOCUS |