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.
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.
Pour appliquer IBM APAR :
La page Propriétés personnalisées s'ouvre.
com.ibm.ws.jsp.jdkSourceLevel
16
La fenêtre de dialogue Messages s'affiche.
Comment : |
Avant de déployer les applications Web WebFOCUS, vous devriez 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.
DISPLAY. Si un serveur X Windows est disponible, vous devriez renseigner une variable d'environnement DISPLAY.
DISPLAY doit être renseignée à l'extérieur de la console d'administration WebSphere avant de démarrer le serveur d'applications. Vous pouvez le faire en déclarant la variable au démarrage du serveur. Vous pouvez éditer le script de démarrage pour WebSphere ou éditer le fichier profile pour l'ID utilisateur chargé de démarrer WebSphere. Par exemple :
DISPLAY=xserver_host:0.0
export DISPLAY
TERM=xterm
export TERM
où :
est le nom d'hôte ou l'adresse IP d'une machine sous environnement X Server.
Remarque : les graphiques ne sont pas affichés effectivement sur la machine pour laquelle DISPLAY renseignée, mais les Servlets WebFOCUS doivent accéder à ce serveur X pour générer les graphiques. Après avoir fini ce chapitre, assurez-vous de réviser les tests pour vérifier les graphiques dans Vérification et dépannage des Graphiques Côté Serveur (PCHOLD).
Headless. Si aucun serveur X Windows n'est disponible, vous pouvez utiliser l'option Java headless via la console d'administration WebSphere. Toutefois, prenez en compte que cette option ne prend pas en charge les fichiers GIF ou l'ancien moteur WebFOCUS GRAPH32.
http://hostname:9060/ibm/console
-Djava.awt.headless=true
Vous aurez à redémarrer le serveur pour l'option headless à utiliser, mais vous pourrez le faire après les procédures suivantes.
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.
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.
/home/oraclejdbc/ojdbc6.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.
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.
ibi/WebFOCUS81/webapps/webfocus/WEB-INF/lib
/appsrv1/IBM/shared
Le volet Bibliothèques partagées s'ouvre, comme le montre l'image suivante.
Le volet Bibliothèques partagées > Nouvelle s’ouvre, comme le montre l'image suivante.
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.
Le volet Applications Entreprise s'ouvre, comme le montre l'image ci-dessous.
Le volet Références Bibliothèque partagée s’ouvre, comme le montre l'image suivante.
Remarque : l'application WebFOCUS utilisée dans cet exemple est appelée 15215webfocus_war et le module WebFOCUS 8.1.
Le volet Mapping Références Bibliothèque partagée s’ouvre, comme le montre l'image suivante.
La bibliothèque partageait IBI Jackson 1.9 est maintenant dans la liste de zone sélectionné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.
Vous êtes renvoyé au volet Références Bibliothèque partagée, comme le montre l'image suivante.
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.
Remarque : Redémarrer uniquement l'application WebFOCUS ne sera pas suffisant.
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.
http://hostname:9060/ibm/console
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.
/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
Une fois le déploiement de l'application complété, cliquez sur Enregistrer directement dans la configuration maître.
Comment : |
Après la configuration des composants WebSphere, vérifiez leur opérabilité.
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.
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 |