Configuration IBM WebSphere 7.0

Dans cette section :

Cette section explique comment configurer WebSphere Application Server avec ou sans serveur HTTP IBM pour l'utiliser avec WebFOCUS et ReportCaster. On suppose que les composants WebSphere sont installés et configurés. Pour des informations supplémentaires, vous pouvez consulter la documentation WebSphere.


Haut de page

x
Prérequis version Java

Comment :

À partir de WebFOCUS 8, WebFOCUS requiert une machine virtuelle Java (JVM) Version 6 minimum sur le système qui héberge le serveur d'applications (la machine sur laquelle le serveur de rapports WebFOCUS et le serveur de distribution ReportCaster sont installés).

Important : Pour IBM WebSphere Application Server Version 7.0, appliquez IBM WebSphere Application Server feature pack pour applications OSGI et Java persistence API 2.0.



x
Comment : Appliquer IBM APAR

Pour appliquer IBM APAR :

  1. Dans la console d'administration, déployez le nœud Serveurs et sélectionnez Serveur d'applications.
  2. Sélectionnez le serveur auquel la propriété personnalisée est appliquée.
  3. Sous Configuration et paramètres Conteneur, déployez le nœud Paramètres Conteneur Web et sélectionnez Conteneur Web.
  4. Sous Configuration propriétés supplémentaires, cliquez sur Propriétés personnalisées.

    La page Propriétés personnalisées s'ouvre.

  5. Cliquez sur Nouveau.
  6. Entrez exactement ce qui suit dans le champ Nom.
    com.ibm.ws.jsp.jdkSourceLevel
  7. Entrez exactement ce qui suit dans le champ Valeur :
    16
  8. Cliquez sur Appliquer ou OK.

    La fenêtre de dialogue Messages s'affiche.

  9. Cliquez sur Enregistrer.

Haut de page

x
Étapes pré-déploiement WebSphere

Comment :

Avant de déployer les applications Web WebFOCUS, vous devriez configurer WebSphere pour les graphiques WebFOCUS.



x
Comment : Configurer WebSphere pour les graphiques WebFOCUS

Pour générer des graphiques, les servlets WebFOCUS doivent disposer d'un accès à un serveur X Windows (via la variable DISPLAY), ou utiliser l'option Java VM headless.



x
Comment : Renseigner WebSphere CLASSPATH pour le référentiel WebFOCUS

Si vous utilisez ReportCaster, la variable CLASSPATH doit inclure le pilote JDBC de votre référentiel. Vous pouvez renseigner CLASSPATH via la console d'administration WebSphere.

Remarque : si vous utilisez InfoAssist, il est possible que vous ayez à augmenter les options de mémoire Java par défaut, tel que décrit dans Problèmes de mémoire Java. Vous pourrez le faire ultérieurement si nécessaire, mais il est effectué depuis la même zone de la console d'administration WebSphere comme pour le paramètre CLASSPATH.

  1. Démarrez WebSphere, s'il n'est pas en cours d'exécution.
  2. Connectez-vous à la console d'administration WebSphere via un navigateur.
  3. Sur la gauche, déployez Types Serveur/Serveurs.
  4. Sur la gauche, cliquez sur Serveurs d'applications WebSphere.
  5. Cliquez sur le serveur où vous déployez WebFOCUS.
  6. Pour WebSphere, sous Infrastructure Serveur, cliquez sur Gestion Java et Processus.
  7. Cliquez sur Définition processus.
  8. Sous Propriétés supplémentaires, cliquez sur Java Virtual Machine.

    Note: si vous devez changer les options de mémoire Java décrites dans Problèmes de mémoire Java, vous pouvez les spécifier dans le champ Arguments génériques JVM.

  9. Dans le champ Classpath, spécifiez le chemin absolu du pilote JDBC, incluant le ou les noms de fichier. Par exemple :
    /home/oraclejdbc/ojdbc6.jar
  10. Cliquez sur OK.
  11. En haut de la page, cliquez sur Enregistrer.
  12. Sur la page qui apparaît, cliquez sur Enregistrer pour enregistrer la configuration master.
  13. Redémarrez le serveur d'applications.

Haut de page

x
Mise à jour de jackson-all-1.9.11.jar

Comment :

Si vous utilisez WebSphere Application Server Version 8.0 ou 8.5, vous devez mettre à jour la version de jackson-all-1.9.11.jar fourni avec WebSphere, puis redéployer l'application web WebFOCUS.



x
Comment : Mettre à jour jackson-all-1.9.11.jar

WebFOCUS 8 est fourni avec une version plus récente du fichier jackson-all-1.9.11.jar, qui inclut des classes mises à jour. Pour éviter tout conflit avec la version en cours de jackson-all-1.9.11.jar qui est inclus est utilisé par WebSphere Application Server Version 8.0 et 8.5, suivez les étapes suivantes. Ces étapes décrivent comment définir une bibliothèque partagée à conteneurs, qui peut être utilisée par les applications WebFOCUS déployées.

  1. Localisez les fichiers httpclient*.jar, httpcore*.jar, et jackson-all-1.9.11.jar fournis avec WebFOCUS Version 8. Par défaut, ces fichiers se trouvent dans le répertoire suivant :
    ibi/WebFOCUS81/webapps/webfocus/WEB-INF/lib
  2. Créez un répertoire vide sur votre système et copiez les fichiers httpclient*.jar, httpcore*.jar, et jackson-all-1.9.11.jar dans ce nouveau répertoire. Par exemple :
    /appsrv1/IBM/shared
  3. Connectez-vous à la console Solutions intégrées WebSphere.
  4. Dans le volet de gauche, déployez Environnement et sélectionnez Bibliothèques partagées, comme le montre l'image suivante.

    Menu environnement - bibliothèques partagées

    Le volet Bibliothèques partagées s'ouvre, comme le montre l'image suivante.

    Bibliothèques partagées > Nouvelle

  5. Sélectionnez une étendue dans la liste déroulante, pour spécifier le niveau de visibilité de la définition de ressource, puis cliquez sur Nouvelle.

    Le volet Bibliothèques partagées > Nouvelle s’ouvre, comme le montre l'image suivante.

    Bibliothèques partagées > volet Nouvelle

  6. Dans le champ Nom, entrez un nom pour la nouvelle bibliothèque partagée (par exemple, IBI Jackson 1.9).
  7. Fournissez une description (optionnel)
  8. Dans le champ Classpath, entrez le chemin du dossier de votre système dans lequel vous avez copié le fichier mis à jour jackson-all-1.9.11.jar (fourni avec WebFOCUS 8).
  9. Dans la zone Chargement Classe, cochez la case Utiliser un chargeur de classe isolé pour cette bibliothèque partagée.
  10. Cliquez sur OK puis cliquez sur Appliquer.


x
Comment : Mettre à jour le fichier webfocus.war pour l'application web WebFOCUS

Cette procédure décrit comment définir une bibliothèque partagée à conteneurs, qui peut être utilisée par les applications WebFOCUS déployées.

Remarque : seul le fichier webfocus.war pour l'application web WebFOCUS requiert ce changement. Les fichiers ibi_help.war, approot.war, et ibi_html.war ne requièrent pas les changements décrits dans cette procédure.

  1. Dans la console Solutions intégrées WebSphere, déployez Applications et sélectionnez Applications WebSphere entreprise.

    Le volet Applications Entreprise s'ouvre, comme le montre l'image ci-dessous.

    Volet Applications entreprise

  2. Cliquez sur le nom du fichier webfocus.war pour l'application web WebFOCUS (par exemple, 15215webfocus_war).
  3. Dans la zone Références, cliquez sur Références bibliothèque partagée, comme le montre l'image suivante.

    Volet Applications entreprise - zone référence

    Le volet Références Bibliothèque partagée s’ouvre, comme le montre l'image suivante.

    Volet Références Bibliothèque partagée

    Remarque : l'application WebFOCUS utilisée dans cet exemple est appelée 15215webfocus_war et le module WebFOCUS 8.1.

  4. Cochez la case située à gauche de l'application WebFOCUS et cliquer sur WebFOCUS Références Bibliothèque partagée.

    Le volet Mapping Références Bibliothèque partagée s’ouvre, comme le montre l'image suivante.

    Volet Mapping Bibliothèque partagée

  5. Dans la zone Disponible, sélectionnez la bibliothèque partagée IBI Jackson 1.9, puis cliquez sur l'icône flèche droite.

    La bibliothèque partageait IBI Jackson 1.9 est maintenant dans la liste de zone sélectionnée.

  6. Cliquez sur OK.
  7. Répétez les étapes 4 à 5 pour le module (par exemple, WebFOCUS 8.1) qui est listé dans le volet Références Bibliothèque partagée.

    Assurez-vous que la bibliothèque partagée IBI Jackson 1.9 pour le module a été déplacé dans la zone sélectionnée.

  8. Cliquez sur OK.

    Vous êtes renvoyé au volet Références Bibliothèque partagée, comme le montre l'image suivante.

    Volet Références Bibliothèque partagée

    Notez que la nouvelle bibliothèque partagée (IBI Jackson 1.9) est maintenant listée dans la colonne Bibliothèques partagées pour Application et Module.

  9. Cliquez sur OK.
  10. Redémarrez IBM WebSphere Application Server s'il est déjà en cours d'exécution.

    Remarque : Redémarrer uniquement l'application WebFOCUS ne sera pas suffisant.


Haut de page

x
Déploiement des Applications Web

Comment :

Utilisez la console d'administration WebSphere pour déployer l'application WebFOCUS. Répétez cette procédure pour chaque application web que vous voulez déployer.

Les applications web se trouvent dans le répertoire suivant :

/install_directory/ibi/WebFOCUS81/webapps

Toutes les applications web devraient être déployées.

Application Web

But

webfocus.war

Déployez toujours cette application web.

ibi_help.war

Déployez toujours cette application web.

approot.war

Déployez cette application web si vous utilisez une configuration Serveur d'applications seulement.

Vous pouvez utiliser l'instance par défaut WebSphere ou créer une nouvelle instance avec la console d'administration WebSphere. Consultez la documentation IBM si vous souhaitez créer de nouvelles instances ou des hôtes virtuels.



x
Comment : Déployer (installer) une application web avec WebSphere 7.0
  1. Si elle n'est pas ouverte, accéder à la console d'administration WebSphere dans un navigateur. Par exemple :
    http://hostname:9060/ibm/console
  2. Sur la gauche, déployez Applications.

    Remarque : si vous souhaitez déployer de nouvelles instances de WebFOCUS en gardant votre ancienne version, vous devez installer WebFOCUS avec de nouveaux ports et de nouvelles racines de contexte.

  3. Sur la gauche, cliquez sur [Installer] Nouvelle application.
  4. Sur la droite, sélectionnez Nouvelle application entreprise.
  5. Sélectionnez le bouton radio Système fichier distant. Dans le champ chemin complet, entrez le nom de votre application avec son chemin complet. Cliquez sur Suivant. Par exemple :
    /install_directory/ibi/WebFOCUS81/webapps/webfocus.war

    Remarque : dans WebFOCUS 8, une application web est présente dans le répertoire WebFOCUS81/webapps, contenant le client WebFOCUS et ReportCaster (ibi_apps).

    install_directory/ibi/WebFOCUS81/webapps/ibi_help.war
    install_directory/ibi/WebFOCUS81/webapps/approot.war
  6. Cliquez sur Détaillé, puis sur Suivant.
  7. Cliquez sur le bouton Continuer.
  8. Sur l'écran Sélectionner Options d'installation, changez le nom de l'application avec un nom unique dans le champ Nom Application. Par exemple, préfixez le nom de l'application avec le nom du cluster ou du serveur d'applications. Cliquez sur Suivant.
  9. Dans l'écran Mapper modules aux serveurs, sélectionnez l'application listée en bas (par exemple, WebFOCUS). Ensuite, en maintenant la touche Ctrl enfoncée, sélectionnez le cluster ou le serveur d'applications sur lequel vous allez déployer et tout serveur Web que vous utilisez. Cliquez sur Appliquer, puis sur Suivant.
  10. Pour les étapes 3 à 6, accepté les valeurs par défaut et cliquez sur Suivant. Pour l'étape 7, Mappper les hôtes virtuels pour les modules web, sélectionnez l'application et l'hôte virtuel que vous avez définis précédemment, puis cliquez sur Suivant.
  11. Renseignez la racine de contexte pour l'application web. Pour cet exemple, indiquez /ibi_apps. Cliquez sur Suivant.
  12. Révisez l'écran de synthèse et cliquez sur Terminer pour déployer.

    Une fois le déploiement de l'application complété, cliquez sur Enregistrer directement dans la configuration maître.


Haut de page

x
Vérification de la configuration WebFOCUS avec IBM WebSphere

Comment :

Après la configuration des composants WebSphere, vérifiez leur opérabilité.



x
Comment : Vérifier la configuration WebFOCUS
  1. S'ils ne sont pas démarrés, démarrez les suivants :
    • Serveur de Rapports WebFOCUS
    • Serveurs d'applications WebSphere et IBM HTTP
  2. Saisissez l'URL suivant sensible à la casse pour accéder à la page d'accueil WebFOCUS qui fournit des liens vers toutes les fonctionnalités de WebFOCUS :
    http://hostname:port/ibi_apps

    Vous pouvez créer un signet sur cette page pour utilisation future. Cette page est également connue comme la page d'accueil WebFOCUS.

  3. Passez à Tâches post-installation WebFOCUS, et lancez l'outil de vérification. Si vous utilisez ReportCaster, réviser Tâches Post-Installation WebFOCUS ReportCaster .

N'oubliez pas que vous aurez sans doute à augmenter les paramètres de mémoire Java si vous utilisez InfoAssist. Vous pouvez le faire plus tard, tel que décrit dans Problèmes de mémoire Java.


WebFOCUS