Le référentiel WebFOCUS doit être en cours d'exécution pour effectuer la conversion.

Remarque : si vous effectuez une mise à jour depuis une version WebFOCUS antérieure à 8.1, il n'est pas nécessaire de convertir les portails, seulement les favoris.

1. Allez à inst_dir/ibi/WebFOCUS80/utilities/bip.
2. Exécutez le script portalconversion.sh.
3. Entrez un ID et mot de passe administrateur
4. Sélectionnez la version de WebFOCUS depuis laquelle vous effectuez la migration :
   • Selectionnez 1 pour WebFOCUS 77x. Ceci est l'option par défaut.
   • Selectionnez 2 pour WebFOCUS 8x.
   • Selectionnez q pour quitter l'utilitaire de conversion.
5. Vous serez notifié quand l'utilitaire aura terminé la conversion. Appuyez sur Entrer pour quitter.

Le référentiel WebFOCUS doit être en cours d'exécution pour effectuer la conversion.

Remarque : cette étape doit aussi être effectuée si vous migrez vos favoris de WebFOCUS 8.1.00 à WebFOCUS 8.1.03 ou supérieure.

1. Allez à inst_dir/ibi/WebFOCUS80/utilities/bip.

   Remarque : si vous avez mis à jour de WebFOCUS 8.1.00 à une version de WebFOCUS 8.1 plus récente, l'emplacement sera inst_dir/ibi/WebFOCUS81/utilities/bip.

2. Exécutez le script favoritesmigration.sh.
3. Entrez un ID et mot de passe administrateur
4. Sélectionnez la version de WebFOCUS depuis laquelle vous effectuez la migration :
   • Selectionnez 1 pour WebFOCUS 77x. Ceci est l'option par défaut.
   • Selectionnez 2 pour WebFOCUS 8x.
   • Selectionnez q pour quitter l'utilitaire de conversion.
5. Vous serez notifié quand l'utilitaire aura terminé la conversion. Appuyez sur Entrer pour quitter.

Remarque : si vous avez mis à jour de WebFOCUS 8.1.00 à une version de WebFOCUS 8.1 plus récente, l'emplacement sera inst_dir/ibi/WebFOCUS81/utilities/bip.

WebFOCUS installe deux applications web dans le répertoire install_directory/ibi/WebFOCUS81/webapps, qui sont conçues pour servir du contenu statique du système de fichiers au navigateur :

• approot.war. Sert le contenu du répertoire install_directory/ibi/apps.
• ibi_html.war. Sert le contenu du répertoire install_directory/ibi/WebFOCUS81/ibi_html .

Déployez au moins l'une de ses applications dans le cadre d'une configuration multicouche ou serveur d'applications unique :

• Le serveur Web est incapable d'accéder au contenu statique lorsqu'il se trouve sur la machine du serveur d'applications.
• Il n'y a pas de serveur Web et vous souhaitez utiliser un serveur d'applications de façon autonome.

  Remarque : Tomcat peut être utilisé seul, sans ces applications, parce qu'il peut faire un mapping entre un répertoire du fichier système et un chemin de contexte.

Chaque application inclut un descripteur de déploiement (webconfig.xml) qui est utilisé pour localiser le répertoire contenant son fichier de configuration. Le paramètre de contexte IBI_Configuration_Directory de webconfig.xml est mis à jour pendant l'installation pour qu'il pointe vers install_directory/ibi/WebFOCUS81/config, qui contient le fichier de configuration approotConfig.xml. Le fichier de configuration est partagé par les deux serveurs d'applications, même si son nom suggère qu'il n'est utilisé que par un seul. Le fichier de configuration est utilisé pour maintenir les mappings MIME, le chemin physique des répertoires servis, ainsi que le niveau de journalisation.

Ces applications incluent aussi un fichier de propriété Log4J (log4j.xml), qui contient le chemin du fichier journal utilisé par chaque application. L'installation met à jour chaque fichier log4j.xml file avec le chemin vers son propre journal, respectivement install_directory/ibi/WebFOCUS81/logs/wfapproot.log et install_directory/ibi/WebFOCUS81/logs/wfibihtml.log.

Les applications serveur mettent à jour les journaux quotidiennement en ajoutant une date au nom du fichier pour en créer un nouveau (par exemple, wfibihtml.log.2014-01-01). Vous pouvez incrémenter le niveau de journalisation en éditant install_directory/ibi/WebFOCUS81/config/approotConfig.xml et en changeant le paramètre de niveau sur DEBUG, INFO, WARN, ERROR, ou FATAL, où DEBUG est le plus fourni.

Il existe des considérations spéciales pour l'utilisation de l'option de serveur de contenu dans un environnement multicouche clusterisé.

WebFOCUS 8 contient une page d'accueil dans le portail BI WebFOCUS, à partir de laquelle vous accédez aux interfaces WebFOCUS, dont la console d'administration WebFOCUS.

Vous pouvez accéder à la Console d'administration WebFOCUS depuis la page d'accueil WebFOCUS, ou bien directement en utilisant un navigateur et son URL.

Accéder à la Console d'administration WebFOCUS avec Internet Explorer ou Firefox

La console d'administration WebFOCUS contient un outil de vérification pour tester davantage la configuration.

Il est conseillé de configurer l'authentification de la Console d'administration WebFOCUS. La console d'administration WebFOCUS n'a pas son propre mécanisme d'authentification et, par défaut, aucun n'est utilisé.

Si vous souhaitez définir des paramètres d'authentification pour la console, vous pouvez choisir de le faire via le serveur de rapports WebFOCUS ou le serveur Web. Pour plus d'informations, consultez le manuel Administration et Sécurité WebFOCUS.

Les paramètres de connexion du Client WebFOCUS sont stockés dans le fichier suivant :

/install_directory/ibi/WebFOCUS81/client/wfc/etc/odin.cfg

Ces fichiers contiennent des blocs de noeud qui définissent les serveurs de rapports WebFOCUS auxquels le client accède. Un bloc de noeud consiste en un jeu de paramètres définissant un serveur et un écouteur, entre autres composants de communication.

Lorsque vous installez le Client WebFOCUS, vous spécifiez un Serveur de Rapports WebFOCUS par défaut, auxquel le client accède. Si le client n'accède qu'à un seul serveur, passez à Configuration de l'Authentification Statique.

Pour changer l'information de connexion du serveur par défaut, ou définir des serveurs supplémentaires, utiliser les procédures suivantes.

/install_directory/ibi/WebFOCUS81/client/wfc/etc/cgivars.wfs

IBI_REPORT_SERVER

Quand le client accède au serveur de rapports WebFOCUS exécuté avec sécurité, il doit se connecter au serveur pour des taches telles que naviguer dans les métadonnées, lister les fichiers, ou exécuter les rapports. Vous pouvez utiliser l'authentification statique, ou bien avoir les utilisateurs ou les applications fournir ces informations. Avec l'authentification statique, vous spécifiez un ID utilisateur et un mot de passe que le client passera systématiquement au serveur. Ceci peut être renseigné pour tous les serveurs ou pour chaque serveur individuellement. L'authentification statique assure que toute connexion serveur au client WebFOCUS accède au serveur en utilisant la même configuration d'environnement.

Remarque : dans certains environnements, vous pourrez utiliser une authentification vérifiée (traitement déjà vérifié) à la place de l'authentification statique. Pour plus d'informations, consultez le manuel Administration et Sécurité WebFOCUS. Cette section ne concerne que l'authentification statique.

Les variables suivantes définissent l'authentification statique :

IBI_REPORT_USER
IBI_REPORT_PASS

Vous devriez renseigner ces variables via la Console d'administration WebFOCUS de façon à crypter le fichier qui contient le mot de passe. L'authentification statique est définie globalement pour tous les nœuds dans le fichier cgivars.wfs. L'authentification statique peut être définie pour un nom spécifique en créant un profil pour le même nœud.

Bien que la plupart des fonctionnalités du client WebFOCUS soient configurées via la console d'administration WebFOCUS, certaines sont activées et configurées via le serveur de rapports WebFOCUS. Si vous avez une licence Active Technologies, vous devez obligatoirement fournir son code dans la console Web du Serveur de Rapports WebFOCUS.

export CLASSPATH=/ibi/srv81/home/etc/flex/lib/xercesImpl.jar:$CLASSPATH

La variable DISPLAY de votre serveur d'applications doit obligatoirement être renseignée sur un serveur X. Consultez Configurer les serveurs Web et d'applications pour plus d'informations sur la variable DISPLAY. Ceci peut être renseigné dans le .profile de l'ID utilisateur qui exécute le serveur d'applications ou son script de démarrage. Par exemple :

export DISPLAY=xserverHostname:0.0

export TERM=xterm

Si votre machine UNIX n'a pas de serveur X, vous pouvez installer un serveur X sur une machine Windows et, sur cette dernière, renseigner la variable DISPLAY.

De plus, le serveur X doit accepter les requêtes depuis le serveur d'applications ou le serveur Web. Sur certaines plates-formes UNIX, le serveur X est configuré par défaut pour refuser les connexions, même si DISPLAY a la valeur localhost:0. Sur de telles machines, une solution consiste à se connecter sur la machine physique, puis à démarrer une session X. Ensuite, ouvrez un shell et utilisez la commande xhost pour spécifier les hôtes qui se connecteront au serveur X. Par exemple :

xhost +localhost

La commande xhost est installée avec votre environnement X Windows et n'est pas forcément dans votre PATH par défaut. Après avoir lancé la commande xhost, laissez cet utilisateur connecté pour que les sections X restent actives. Pour protéger la machine, verrouillez l'affichage plutôt que de vous déconnecter. Si un utilisateur différent a besoin de se connecter à la machine physique, ou si cette machine doit être redémarrée, la commande xhost devrait être relancée au moment de la connexion, et vous devriez laisser une session X active.

Si aucun serveur X n'est disponible, l'option headless peut être utilisée. C'est une option Java VM, pas une fonctionnalité spécifique à WebFOCUS. Elle est renseignée au niveau du serveur d'applications :

-Djava.awt.headless=true

Réviser la documentation de votre serveur d'applications et Configurer les serveurs Web et d'applications. Après avoir défini les options Java, redémarrez complètement votre serveur d'applications.

Remarque : si vous changez les paramètres graphiques WebFOCUS par défaut pour utiliser SSG_EXTERNAL=YES, il devrait aussi être modifié via la console d'administration WebFOCUS sous Configuration et Graphique dans le champ IBIJAVACMD.

Une procédure d'exemple est installée avec le Serveur de Rapports WebFOCUS pour tester les Graphiques Côté Serveur.

1. Connectez-vous à WebFOCUS en tant qu'administrateur et sélectionnez d'administration dans le menu Administration.
   La console d'administration s'affiche.
2. Déployez le noeud Diagnostiques, puis le noeud Vérification, puis sélectionnez Serveur de rapports WebFOCUS.
3. Cliquez sur Tester une procédure existante.
4. Dans le champ Nom procédure, entrez cargraph et cliquer sur Exécuter.
5. Si le serveur est exécuté avec sécurité, connectez-vous.

   Votre navigateur devrait afficher un graphique similaire à l'image suivante.

   

Si vous recevez une erreur ou si le navigateur est ralenti, vérifiez les journaux de votre serveur d'applications.

• Si vous renseignez une variable DISPLAY, vous allez peut-être trouver les erreurs suivantes dans vos journaux.

  java.lang.InternalError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.

  Ceci indique que la variable DISPLAY n'est probablement pas renseignée correctement. Assurez-vous de définir et d'exporter cette variable sur une machine qui exécute un serveur X.

  java.lang.InternalError: Can't connect to X11 window server using 'localhost:0' en tant que valeurs de la variable DISPLAY.

  Ceci indique qu'aucun serveur X n'est disponible sur l'hôte, ou que l'hôte rejette la connexion. Essayez d'utiliser la commande xhost, tel que décrit dans Utiliser les Graphiques Côté Serveur via la variable DISPLAY. Vous devez configurer votre serveur X pour permettre la connexion, puis redémarrer le serveur d'applications.

• Si vous utilisez headless :
  • Assurez-vous que vous utilisez un JDK version 6 ou supérieure.
  • Assurez-vous que vous utilisez le nouveau moteur graphique. Ceci est renseigné dans cgivars.wfs avec :

    IBIF_graphengine =GRAPH53

  • Assurez-vous que l'option headless est renseignée sur la JVM de votre serveur d'applications, tel que décrit dans Configurer les serveurs Web et d'applications. Assurez-vous de redémarrer votre serveur d'applications.

Pour modifier le fichier server.xml :

1. Naviguez vers le répertoire suivant :

   /tomcat_home/conf

   où :

   tomcat_home

   est l'emplacement sur votre ordinateur où est installé l'application Apache Tomcat.

2. Modifiez le fichier server.xml.
3. Rechercher le bloc de connecteur Coyote/JK2 AJP 1.3.
4. Ajoutez les paramètres proxyName et proxyPort, tels que présentés dans l'exemple suivant :

   <!-- Define a Coyote/JK2 AJP 1.3 Connector on port 8009 -->
   <Connector port="8009" enableLookups="false" redirectPort="8443" 
       debug="0" protocol="AJP/1.3" proxyName="WEB-FACING PROXY_SERVER"
       proxyPort="WEB FACING PROXY_PORT"/>

5. Pour la valeur du paramètre proxyName, spécifiez le nom d'hôte du serveur proxy Web.
6. Pour la valeur de paramètre proxyPort, spécifiez le numéro de port du serveur proxy Web.
7. Enregistrez les modifications apportées au fichier server.xml.
8. Redémarrez le serveur d'application Apache Tomcat.