Configurer Apache Tomcat

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 :


Haut de page

x
Prérequis Mémoire Java

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.


Haut de page

x
Préparation de Tomcat pour WebFOCUS

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 :

http://tomcat.apache.org/

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 :



x
Comment : Définir CLASSPATH pour les Tables Référentiel

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.



x
Référence : Ports Tomcat

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 :

  1. Ouvrez le fichier suivant dans un éditeur de texte :
    C:\ibi\tomcat\conf\server.xml
  2. Recherchez les numéros de port que vous souhaitez remplacer (8080, 8009, 8005) et remplacez-les par les ports que vous souhaitez utiliser.
  3. Enregistrez et fermez le fichier.

Si vous modifiez les valeurs par défaut, faites les changements en conséquence dans les procédures et exemples.



x
Création de contextes WebFOCUS pour Tomcat

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.



x
Comment : Configurer Apache Tomcat
  1. Arrêtez Tomcat depuis la fenêtre Services Windows en faisant un clic droit sur Apache Tomcat et en choisissant Stop.
  2. Naviguez vers le répertoire suivant dans Explorateur Windows ou Poste de travail :
    <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ù :

    path_To_WebApplication

    est le chemin d'accès absolu vers le fichier WAR ou le répertoire que vous déployez.

    contextRoot

    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.

  3. Si le fichier ibi_apps.xml n'existe pas, créez-le. Par exemple :
    <?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).

  4. Si vous utilisez Tomcat en mode autonome, créez un fichier approot.xml s'il n'existe pas. Par exemple :
    <?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.

  5. Redémarrez Tomcat depuis la fenêtre Services.


x
Référence : Recharger les applications Web

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.



x
Accéder au raccourci vers la fenêtre Propriétés Apache Tomcat

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.



x
Accès au gestionnaire d'applications Tomcat

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.


Haut de page

x
Vérifier la configuration WebFOCUS avec Apache Tomcat

Comment :

Après avoir terminé la configuration, exécutez les appels de test pour vérifier le fonctionnement.



x
Comment : Vérifier la configuration WebFOCUS
  1. S'ils ne sont pas démarrés, démarrez les suivants :
    • Apache Tomcat
    • Serveur de Rapports WebFOCUS
  2. Entrez l’URL suivante dans votre navigateur 
    http://hostname:port/ibi_apps

    où :

    hostname:port

    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.

  3. Connectez-vous en tant qu'administrateur. Le nom d'utilisateur et mot de passe par défaut sont respectivement admin et admin.

    La page d'accueil du Portail BI WebFOCUS s'ouvre dans votre navigateur.

  4. Cliquez sur Administration dans le panneau supérieur, puis sélectionnez Console d'Administration, comme le montre l'image suivante.

    La console d'administration WebFOCUS s'ouvre.

  5. Déployez Diagnostics, Vérification, puis WebFOCUS Reporting Server, comme le montre l'image suivante.

    La page suivante s'ouvre, présentant votre instance WebFOCUS Reporting Server instance si celle-ci est disponible.

  6. Cliquez sur Tester une procédure existante.

    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.

  7. Cliquez sur Exécuter pour exécuter la procédure de test.

    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
  8. Si vous utilisez Tomcat en mode autonome, passez à Tâches post-installation Client WebFOCUS.

WebFOCUS