Dans cette section : |
Cette section explique comment configurer Serveur d’applications IBM WebSphere pour une utilisation avec WebFOCUS et ReportCaster. On suppose que les composants WebSphere sont installés et configurés. Pour plus d'informations, consultez la documentation WebSphere. Dans WebFOCUS 8, vous pouvez utiliser WebSphere Application Server sans serveur HTTP IBM en déployant le fichier approot.war.
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.
En fonction des paramètres par défaut de votre serveur d'applications IBM WebSphere, vous aurez peut-être à ajuster les options mémoire JVM en cas de problèmes de performance.
Les options Java VM les plus courantes que vous devez définir impliquent la taille du segment de mémoire et de la pile Java, qui déterminent la disponibilité de la mémoire pour les programmes Java et Java VM (machine virtuelle). Les erreurs peuvent se produire si la mémoire disponible est insuffisante, et la taille du segment de mémoire a un effet sur la performance, car elle détermine la fréquence du nettoyage de la mémoire.
Les fonctionnalités décrites ci-après constituent les options Java VM les plus courantes liées aux paramètres de mémoire. Remplacez ### par la taille que vous souhaitez définir :
Définit la taille maximale des segments de mémoire Java. En général 1/4 de la RAM système est affecté, mais doit être au moins de 1536 MB (1.5 GB).
Définit la taille initiale des segments de mémoire Java. En général 1/8 de la RAM système est affecté, mais doit être au moins de 1536 MB (1.5 GB).
Définit la taille de la pile de thread Java. Vous n'avez pas besoin de définir cela à moins que vous ajustez votre environnement.
La taille est généralement définie en mégaoctets, par exemple :
-Xms1536M -Xmx2048M
Pour visualiser les paramètres de mémoire Java VM courants, ouvrez la console d'administration WebFOCUS. Dans le volet de gauche de la console, déployez le noeud Diagnostics et cliquez sur Info propriété JVM, comme le montre l'image suivante.
Les paramètres mémoire Java pour votre environnement sont affichés dans le volet de droite, comme le montre l'image suivante.
Les tailles optimales varient en fonction de la mémoire totale disponible, les besoins de votre application, des autres processus exigeant de la mémoire, le type de machine virtuelle Java, et autres considérations. Un bon point de départ est de définir le minimum à 1/8 de la RAM totale et le maximum à 1/4 de la RAM totale.
La définition de ces options, et des autres options pour machine virtuelle Java, dépendent de votre serveur d'applications.
Pour Tomcat, elles sont automatiquement définies si l'installation WebFOCUS a configuré Tomcat.
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èques partagées 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 Bibliothèques partagées 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 : |
Afin de préparer WebSphere pour ReportCaster, vous devriez définir la variable CLASSPATH pour inclure votre pilote JDBC.
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.
Si vous n'utilisez pas ReportCaster, passez à Déploiement des Applications Web.
Vous devez inclure le fichier dans le chemin d'accès. Fournir un répertoire n'est pas suffisant. Si plusieurs fichiers sont nécessaires pour le pilote JDBC, fournissez le chemin d'accès vers chaque fichier en les séparant par des points-virgules. Les espaces peuvent se produire dans les noms de répertoire, mais pas entre les chemins d'accès et les points-virgules. Par exemple :
drive:\Program Files\Microsoft SQL Server 2008 Driver for JDBC\ lib\sqljdbc4.jar
Pour plus d'informations sur les pilotes JDBC, consultez Aperçu JDBC .
Comment : |
Utilisez la console d'administration WebSphere pour déployer les applications web WebFOCUS et ReportCaster. Le nombre des applications web que vous déployez dépend de votre configuration. 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 :
drive:\ibi\WebFOCUS81\webapps
Pour WebSphere, vous déployez les fichiers WAR.
Vous pouvez utiliser l'instance par défaut WebSphere ou créer une nouvelle instance avec la console d'administration WebSphere. Si vous souhaitez créer de nouvelles instances ou des hôtes virtuels, consultez la documentation IBM.
Remarque :
http://hostname:9060/ibm/console
Attention : si des instances précédentes d'applications WebFOCUS ou ReportCaster ont été installées, vous devez les arrêter et désinstaller pour pouvoir installer les nouvelles. Pour déterminer si des instances précédentes ont été installées, cliquez sur Applications Entreprise sur la gauche. Si des applications apparaissent, cochez les cases et cliquer sur Stop. Après leur arrêt, cliquez sur Désinstaller.
drive:\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).
drive:\ibi\WebFOCUS81\webapps\ibi_help.war and
drive:\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/diagnostics/about.jsp
où :
Est le nom d'hôte du serveur d'applications Websphere et du port HTTP associé. Pour le default_host, le port par défaut est HTTP 9060. Pour d'autre hôte, consultez la console d'administration de WebSphere sous Environnement, Hôtes Virtuels, host_name, et Aliase Hôte.
Une page présentant le build en cours devrait apparaître.
Si vous recevez une erreur, essayez de redémarrer WebSphere.
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 |