Conseils de dépannage WebFOCUS

Conseils

Essayez certaines de ces solutions lorsque vous dépannez les problèmes de WebFOCUS :

Effacez le cache de votre navigateur et fermez toutes ses instances. Souvent, même après avoir pris les mesures pour corriger un problème, la ou les pages contenant le problème original réside(nt) toujours dans le cache.
Vérifiez que tous les composants sont démarrés et écoutent sur leurs ports attendus. L'application web WebFOCUS peut prendre un certain temps à charger.
Vérifiez que vous avez saisi l'URL correct. Les URLs de WebFOCUS sont sensibles à la casse.
Si votre serveur Web écoute sur un autre port que 80, assurez-vous que vous invoquez le port correct dans l'URL.
Vérifiez que les bons noms d'applications sont listés dans l'APP PATH de votre serveur d'applications WebFOCUS. Ceci est défini dans :
```
/install_directory/ibi/srv81/wfs/etc/edasprof.prf
```
Ceci est sans doute le problème si vous recevez un message d'erreur Ressource non trouvée.
Notez que WebFOCUS ne prend pas en charge deux sessions Microsoft Internet Explorer simultanées depuis un seul PC. Cela est dû à une limitation de la gestion des cookies d'Internet Explorer. Si vous exécutez deux sessions de navigateur simultanément sur la même machine, des messages apparaissent, par exemple fichier non trouvé.
Activez le traçage via la console d'administration WebFOCUS.
Effacez le cache de votre serveur d'applications après avoir complété l'installation de la mise à niveau. Par exemple, si vous utilisez Apache Tomcat, vous pouvez supprimer la mise en cache manuellement en effaçant tous les sous-répertoires correspondant aux racines que vous avez déployées (par exemple, /ibi_apps, /ibi_html, et /ibi_help), qui se trouvent dans le répertoire suivant :
```
/tomcat_home/work/Catalina/localhost
```
Dans la console d'administration WebFOCUS, cliquez sur Diagnostics sur la gauche, et utilisez les options disponibles pour résoudre les problèmes.
Redémarrez tous les composants, en particulier vos serveurs Web et/ou d'applications.

Problèmes de navigateurs Web

Référence :

Support Firefox

Si vous envisagez d'utiliser les produits WebFOCUS, notez que les navigateurs sortis après la date de production de votre version WebFOCUS doivent faire l'objet d'une certification. La certification est opérée avec le niveau de version courante de WebFOCUS, AppStudio, et Developer Studio. Pour plus d'informations, consultez Support navigateurs Web pour WebFOCUS, auxquelles vous pouvez accéder ici :

https://techsupport.informationbuilders.com/tech/wbf/wbf_tmo_027.html

Remarque : certains navigateurs peuvent fonctionner différemment en fonction du système d'explication.. Consultez Notes de Version WebFOCUS pour des informations détaillées sur les problèmes liés à la version du navigateur ou à la configuration connus.

Haut de page

Référence : Support Firefox

Pour plus d'informations sur les versions Firefox supportées, consultez Support navigateurs Web pour WebFOCUS, auxquelles vous pouvez accéder ici :

https://techsupport.informationbuilders.com/tech/wbf/wbf_tmo_027.html

Les paramètres suivants sont requis pour utiliser Firefox avec Dashboard :

Autoriser les fenêtres contextuelles.
Ouvrez les liens d'autres applications dans une nouvelle fenêtre.
Pour utiliser le constructeur de vues, passez security.checkloaduri sur false (faux).

Aide au dépannage JVM pour IBM WebSphere Application Server

Comment :

Vérifier la version JVM

WebFOCUS 8 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).

Haut de page

Comment : Vérifier la version JVM

Il existe deux méthodes de vérification de la version de la JVM installée sur la machine sur laquelle est déployé le client WebFOCUS.

Depuis la Console d'administration WebFOCUS :
1. Connectez-vous à WebFOCUS et sélectionnez Console d'administration dans le menu Administration.
2. Cliquez sur Diagnostiques.
3. Sélectionnez Info propriété JVM.
La version est indiquée en dessous de java.runtime.version.
Dans un navigateur, saisissez l'URL suivant :
```
http://hostname:port/ibi_apps/diagnostics/properties.jsp
```
La version est indiquée en dessous de java.vm.version.

Débogage du serveur Web et d'applications

Dans cette section :

Problèmes de mémoire Java

Assurez-vous que votre serveur Web et votre serveur d'applications sont configurés, tel que décrit dans Configurer les serveurs Web et d'applications.

WebFOCUS s'appuie sur des processus JVM, serveur Web, et serveur d'applications (conteneur de servlets), leurs outils de débogage et leurs fichiers logs peuvent donc vous aider à résoudre certains problèmes WebFOCUS. Réviser la documentation pour votre serveur Web et votre serveur d'applications pour les informations liées aux traces et la journalisation.

Haut de page

Problèmes de mémoire Java

La définition de certaines options pour la machine virtuelle Java peut améliorer la performance et corriger des problèmes liés au serveur d'applications. Quelques paramétrages importants concernent la taille de segment mémoire et de pile Java, qui déterminent la mémoire disponible pour des programmes Java et la JVM. 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.

Si vous rencontrez des problèmes de performance ou que des messages d'exception de mémoire insuffisante s'affichent, redéfinissez ces tailles. 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 le signe ### par la taille que vous souhaitez définir :

-Xss####M: Définit la taille de la pile de thread Java.
-Xmx####M: Définit la taille maximale des segments de mémoire Java.
-Xms####M: Définit la taille initiale des segments de mémoire Java. Ceci devrait être au moins 1024 MB (1 GB).

La taille est généralement définie en mégaoctets, par exemple :

-Xms1024M
-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.

Problèmes Managed Reporting

Les permissions fichier, le déploiement de l'application web WebFOCUS, ou le navigateur plug-in Java posent souvent les problèmes suivants :

La page de connexion à Managed Reporting apparaît, mais la cliquez sur Connexion, vous recevez une erreur Impossible d'afficher la page.
La page de connexion à Managed Reporting apparaît, mais la cliquez sur Connexion, vous recevez une erreur Java.
Graph Assistant ou Report Assistant ne sont pas correctement, ou aucune description de fichier n'apparaît dans la fenêtre de description du fichier.
Vous ne pouvez pas créer de nouveaux groupes, rapports, domaines, utilisateurs, ou d'autres objets, et le navigateur console Java affiche :
```
Directive not found in IBIMRcgi: 
---COMMENT---START Directive not found in IBIMRcgi: ---COMMENT---END
```

Faites ce qui suit pour résoudre ces erreurs.

Assurez-vous que les permissions fichier sont renseignées pour les répertoires WebFOCUS. Les processus chargés d'exécuter votre serveur Web et votre serveur d'applications doive avoir un accès en écriture sur les répertoires du client WebFOCUS.
Assurez-vous que l'application web WebFOCUS est déployée en exécutant les tests décrits dans Configurer les serveurs Web et d'applications.
Si vous avez installé et désinstallé plusieurs versions de WebFOCUS sur votre machine, assurez-vous que la version correcte de l'application Web est déployée.
Essayez de recharger manuellement l'application web WebFOCUS. Il est possible que vous souhaitiez l'effacer puis la redéployer.

Problèmes liés au jeu de caractères

WebFOCUS et ReportCaster nécessitent un jeu de caractères basé sur ISO8859-1. Toutefois, certains systèmes peuvent utiliser Unicode (ISO 10646/UTF-8) par défaut. Dans un tel cas, certains caractères tels que les scripts secondaires peuvent être remplacés par un point d'interrogation (?) ou un autre symbole dans vos rapports. Pour corriger ceci, définissez la variable d'environnement LANG pour spécifier le jeu de caractères ISO8859-1 de votre langue. sur systèmes Solaris, définissez aussi la variable d'environnement LC_ALL pour spécifier le jeu de caractères ISO8859-1 correct. Par exemple, English sur Solaris est :

export LANG=en_US.ISO8859-1
export LC_ALL=en_US.ISO8859-1

Définissez les variables LANG et LC_ALL pour les mettre à disponibilité de la JVM en charge de votre serveur d'applications et de votre serveur de distribution. L'endroit où vous les définissez dépend de votre serveur d'applications, mais vous pouvez normalement exporter et définir les variables dans le script de démarrage du serveur d'applications. Pour le serveur de distribution, vous pouvez exporter et définir ceci dans le script schbkr.

Utiliser l'utilitaire jar

Comment :

Un utilitaire jar est installé avec le JDK Java. elle vous permet de créer, d'extraire et de modifier le contenu de JAR, WAR, EAR, ZIP, RAR, et autres fichiers d'archive. Si vous déployez l'application Web WebFOCUS avec un fichier WAR, l'utilitaire jar vous permettra de changer les contenus du fichier webfocus.war.

Haut de page

Comment : Modifier l'application Web de WebFOCUS

L'application Web WebFOCUS est distribuée sous la forme d'un fichier WAR et un répertoire déployé correspondant.

/install_directory/ibi/WebFOCUS81/webapps/webfocus.war

/install_directory/ibi/WebFOCUS81/webapps/webfocus

Le moyen le plus simple d'éditer l'application Web consiste à :

Annulez le déploiement du fichier webfocus.war depuis votre serveur d'applications.
Renommez le fichier webfocus.war en webfocus-old.war. Cela permet de s'assurer que vous avez une sauvegarde et que vous pouvez suivre où réside la dernière version.
Modifiez ou ajoutez des fichiers au répertoire développé webfocus et aux sous-répertoires. Vous devriez le faire même si vous déployez le fichier WAR au lieu des répertoires développés. Cela permet de s'assurer que les service packs gèrent vos modifications. Lorsque vous appliquez un service pack, tout changement doit être dans les répertoires développés pour être maintenu.
Naviguez jusqu'au répertoire webfocus. Par exemple :
```
/install_directory/ibi/WebFOCUS81/webapps/webfocus
```
Utilisez la commande jar pour créer un nouveau fichier webfocus.war qui contient le contenu du répertoire webfocus et des sous-répertoires. Par exemple :
```
jar cvf ../webfocus.war *
```
Cela entraîne la création d'un fichier webfocus.war contenant tous les fichiers et sous-répertoires dans votre répertoire actuel. Le fichier webfocus.war sera situé un répertoire au-dessus de votre emplacement actuel puisque vous l'avez préfacé avec "../".
Redéployez l'application Web WebFOCUS sur votre serveur d'applications.

Vous pouvez éditer l'application Web ReportCaster en utilisant la même méthode.

Haut de page

Comment : Exécuter l'utilitaire jar

Les options pour l'utilisation des commandes jar sont sont utiles à connaître.

Pour créer un nouveau fichier jar :
```
jar cvf FileToCreate.war FileToAdd1 FileToAdd2
```
Vous pouvez ajouter tous les fichiers et les sous-répertoires en utilisant un * :
```
jar cvf FileToCreate.war *
```
Pour extraire le contenu d'un fichier jar existant :
```
jar xvf ExistingFile.war FileToExtract1 FileToExtract2
```
Les fichiers sont extraits à votre emplacement actuel.
Vous pouvez extraire tous les fichiers et sous-répertoires en ne spécifiant aucun fichier à extraire:
```
jar xvf ExistingFile.war
```
Pour ajouter ou remplacer un fichier dans un fichier jar existant :
```
jar uvf ExistingFile.war FileToAdd1
```

Problèmes liés au chemin d'installation silencieuse

Un problème de chemin peut générer une erreur pendant l'installation silencieuse d'un serveur de distribution.

Lorsque vous exécutez le fichier paramétrage installation, il est possible que vous receviez les messages suivants :

./install[924]: var_asgn_file: not found.

Pour résoudre ce problème, vous devez ajouter . (point) à votre instruction UNIX PATH.

Ceci est un exemple de syntaxe :

export PATH=.:$PATH

Vérifiez que la définition devrait montrer le nouveau chemin :

.: /usr/java6/jre/bin:/usr/bin

Vous devriez alors être capable d'exécuter l'installation silencieuse.