Validation de l'installation de WebSphere Business Monitor

Les informations qui suivent décrivent comment valider l'exécution de chaque étape de l'installation. Le processus d'installation de Monitor étant long et complexe, il est fortement recommandé d'en vérifier chaque étape. La détection d'un incident en fin de processus peut nécessiter la réinstallation complète de certaines parties de la pile de logiciels.

Si vous ne parvenez pas à vérifier l'une des étapes de l'installation, adressez-vous à votre "service d'assistance IBM" afin d'obtenir de l'aide.

Remarque : <temp> correspond au répertoire "%temp%\" sous Windows et au répertoire "/tmp" sous AIX.

DB2 Enterprise Server Edition

A l'issue de l'installation de DB2 Enterprise Server Edition, procédez comme suit :
  1. Vérifiez que l'icône DB2 figure dans la zone de notification (Windows) et que vous pouvez démarrer le Centre de contrôle DB2.
  2. Si les bases de données vont être créées en local, assurez-vous que vous pouvez créer une base de données sur le poste local.
  3. Si les bases de données seront éloignées, assurez-vous que vous pouvez cataloguer et accéder aux bases de données situées sur le poste éloigné.
  4. Sur la plateforme AIX, assurez-vous que l'instance db2inst1 a été créée sous /home/db2inst1/sqllib et que vous pouvez démarrer db2cc (Centre de contrôle) manuellement.

DB2 Cube Views

A l'issue de l'installation de DB2 Cube Views, procédez comme suit :
  1. Vérifiez que l'élément de menu "OLAP Center" (centre OLAP) a été ajouté au menu "Tools" du Centre de contrôle DB2 et/ou que l'élément de menu "OLAP Center" a été ajouté au menu "Business Intelligence Tools" du menu Démarrer, et que l'application OLAP Center s'initialise.
  2. Sous AIX : Exécutez une commande d'affichage de module afin de vous assurer que les modules Cubeviews ont été correctement installés. La commande "lslpp -L all | grep db2" doit renvoyer db2_08_01.cbsg, db2_08_01.cube.services et db2_08_01.olsampdb entre autres modules DB2. Pour vous assurer que l'instance db2inst1 a été mise à jour, vérifiez que toutes les opérations ont abouti dans le fichier /tmp/db2setup.log. L'information suivante doit être indiquée : db2inst1 instance was updated successfully.

WebSphere Application Server

A l'issue de l'installation de WebSphere Application Server à l'aide du profil "dashboard", procédez comme suit :
  1. Exécutez la fonction de "vérification d'installation" à partir de la console "Premiers pas" et vérifiez qu'un message indique que l'opération a abouti.
  2. Vérifiez que vous pouvez démarrer/arrêter le serveur d'applications "server1" en consultant startServer.log et stopServer.log dans C:\IBM\WebSphere\AppServer\profiles\dashboard\logs\server1.
  3. Vérifiez que l'application "Console d'administration" est accessible à l'adresse : http://localhost:9060/ibm/console
  4. Vérifiez si SystemOut.log comporte des erreurs dans C:\IBM\WebSphere\AppServer\profiles\dashboard\logs\server1.
  5. Si vous ne pouvez pas valider l'installation, consultez le journal d'installation d'Application Server, "<temp>log.txt", et le journal d'installation de Monitor, "<temp>launchpad-monitor.log".
Les autres fichiers Application Server utilisés pour le débogage d'une installation figurent aux emplacements suivants :
  • C:\IBM\WebSphere\AppServer\logs, en particulier C:\IBM\WebSphere\AppServer\logs\log.txt et C:\IBM\WebSphere\AppServer\logs\wbi\log.txt
  • C:\IBM\WebSphere\AppServer\logs\dashboard\*
  • C:\IBM\WebSphere\AppServer\profiles\dashboard\logs\*
  • C:\IBM\WebSphere\AppServer\profiles\dashboard\
  • C:\IBM\WebSphere\AppServer\profiles\dashboard\properties\*
  • C:\IBM\WebSphere\AppServer\properties\profileRegistry.xml

WebSphere Process Server

A l'issue de l'installation de WebSphere Process Server à l'aide du profil "monitor", procédez comme suit :
  1. Exécutez la fonction de "vérification d'installation" à partir de la console "Premiers pas" et vérifiez qu'un message indique que l'opération a abouti.
  2. Vérifiez que vous pouvez démarrer/arrêter le serveur d'applications "server1" en consultant startServer.log et stopServer.log dans C:\IBM\WebSphere\ProcServer\profiles\monitor\logs\server1
  3. Vérifiez que l'application "Console d'administration" est accessible à l'adresse "http://localhost:9060/ibm/console".
  4. Vérifiez si SystemOut.log comporte des erreurs dans C:\IBM\WebSphere\ProcServer\profiles\monitor\logs\server1.
  5. Vérifiez que les bases de données suivantes existent dans DB2 : WPRCSDB et EVENT. Si la base de données d'événements EVENT n'a pas été créée, vous pouvez la créer en exécutant %ProfileHome%\event\dbscripts\db2\cr_event_db2.{sh|bat} server {db2inst1 | db2admin}
  6. Si vous ne pouvez pas valider l'installation, consultez le journal d'installation de Process Server, "<temp>log.txt", le journal d'installation de Monitor, "<temp>launchpad-monitor.log".
Les autres fichiers Process Server utilisés pour le débogage d'une installation figurent aux emplacements suivants :
  • C:\IBM\WebSphere\ProcServer\logs, en particulier C:\WebSphere\ProcServer\logs\log.txt et C:\WebSphere\ProcServer\logs\wbi\log.txt
  • C:\IBM\WebSphere\ProcServer\logs\monitor\*
  • C:\IBM\WebSphere\ProcServer\profiles\monitor\logs\*
  • C:\IBM\WebSphere\ProcServer\profiles\monitor\
  • C:\IBM\WebSphere\ProcServer\profiles\monitor\properties\*
  • C:\IBM\WebSphere\ProcServer\properties\profileRegistry.xml

WebSphere Portal

A l'issue de l'installation de WebSphere Portal, procédez comme suit :
  1. Vérifiez que vous pouvez démarrer/arrêter le serveur d'applications "WebSphere_Portal". Vous pouvez utiliser "Premiers pas" pour lancer le serveur.
  2. Vérifiez que l'application Web IBM WebSphere Portal est accessible.
    1. Si vous utilisez "Premiers pas", cette dernière lance automatiquement l'application Web après le démarrage du serveur.
    2. Vous pouvez également sélectionner l'option de "démarrage de serveur" et une fois le serveur démarré, afficher l'application Web dans un navigateur à l'adresse "http://localhost:9081/wps/portal".
    3. La page de "connexion au portlet" doit s'afficher. Connectez-vous au moyen de l'ID/mot de passe par défaut, "wpsadmin/wpsadmin".
    4. Une fois connecté, une page Web contenant le message "Welcome to WebSphere Portal version 5.1.0.2" doit s'afficher.
  3. Si vous n'arrivez pas à valider l'installation, consultez les fichiers journaux d'installation de WebSphere Portal, "wpsinstalllog.txt", "pznInstallLog.txt", "pzninstall.log" et wpinstalllog.txt", et vérifiez le fichier journal d'installation de Monitor, "launchpad-monitor.log", dans le répertoire <temp>. Vérifiez également si SystemOut.log comporte des erreurs dans C:\WebSphere\PortalServer\log.

DB2 Alphablox

A l'issue de l'installation de DB2 Alphablox, procédez comme suit :
  1. Vérifiez que vous pouvez accéder à Alphablox Administrative Pages à l'adresse "http://localhost:9081/AlphabloxAdmin/home". Connectez-vous au moyen de l'ID/mot de passe par défaut, "admin/password".
  2. Consultez les fichiers journaux d'installation d'Alphablox, "alphablox_install_log.html" ou IBM_DB2_Alphablox_8.3_InstallLog.log dans le répertoire C:\IBM\DB2Alphablox.
  3. Pour obtenir la maintenance Alphablox obligatoire, effectuez l'installation d'Alphablox via Monitor Launchpad, puis accédez à l'adresse URL ci-après et suivez les instructions. http://www-1.ibm.com/support/docview.wss?rs=2026&context=SSCPX3&dc=D600&uid=swg21227687&loc=en_US&cs=UTF-8&lang=en

Création de base de données

  1. Avant d'utiliser le tableau de bord pour créer des bases de données, procédez comme suit :
    1. Si vous avez utilisé le tableau de bord pour installer DB2, assurez-vous de l'arrêter et de le redémarrer dans une nouvelle fenêtre de commande. Vous êtes ainsi assuré que l'environnement DB2 est correctement configuré.
    2. Assurez-vous que DB2 est démarré.
    3. Assurez-vous que les répertoires utilisés pour les sauvegardes et les espaces table existent. Sous AIX, ces répertoires doivent disposer de droits définis par "777" ou le propriétaire doit être défini par "db2inst1".
  2. A l'issue de la création de base de données (i.e. après avoir cliqué sur Terminer), vérifiez que les tables ont été créées dans les bases de données. Vérifiez que les bases de données suivantes contiennent ces tables :
    Base de données Tables
    Référentiel Database_Characteristics, Property, Monitor_Client (dernière table créée)
    Etat DEPLOYED_DDL, RMPRUNECTRL (dernière table créée)
    Exécution TIME_BASED_SITUATIONS, RMPRUNECTRL (dernière table créée)
    Historique DIM_TIME, RMPRUNECTRL (dernière table créée)

    Incidents possibles et mesures correctives :

    1. Base de données non créée.

      Action : Assurez-vous que DB2 est démarré.

    2. Base de données créée, mais elle ne comporte aucune table.

      Action : Assurez-vous d'avoir entré un ID utilisateur et un mot de passe corrects dans l'écran de création de base de données. Consultez le fichier <Monitor_Home> /install/logs/db2Create****Out.log où "****" est State, Runtime, Historical ou Repository. Recherchez le message suivant :

      "SQL30082N Attempt to establish connection failed with security reason "24" ("USERNAME AND/OR PASSWORD INVALID")"

      Si ce message a été émis, désinstallez la base de données, puis réinstallez-la avec un ID utilisateur et un mot de passe corrects.

  3. Vérifiez que des données correctes ont été écrites dans la table DATABASE_CHARACTERISTICS de la base de données de référentiel. La table doit contenir une ligne pour chacune des trois bases de données (état, exécution et historique). Cette ligne doit indiquer le nom de la base de données, le nom du schéma et le nom de l'hôte. De plus, lors de la création d'une base de données d'historique, une ligne doit être ajoutée dans la table des propriétés de la base de données de référentiel. Cette ligne doit contenir une propriété appelée "CubeDataSource" avec la valeur "<Nom_hist>_CUBE" où "<Nom_hist>" est le nom de la base de données d'historique. Si aucune entrée n'y figure, consultez le fichier <temp>launchpad-monitor.log. Recherchez "repos command0" et vérifiez si des erreurs sont signalées. Si les informations ont été correctement écrites, l'instruction suivante doit figurer dans le fichier journal : "repos command finished, rc=0"

    Incidents possibles et mesures correctives :

    1. Sous AIX, impossible d'accéder à la machine JVM regroupée. "repos command finished rc=126" doit figurer dans <temp>launchpad-monitor.log.

      Action : le répertoire parent contenant launchpad.sh doit être accessible en lecture et en exécution pour tous les utilisateurs.

    2. Impossible d'accéder aux bibliothèques DB2.

      Action : Assurez-vous que DB2 est démarré. Si vous avez utilisé le tableau de bord pour installer DB2, assurez-vous de l'arrêter et de le redémarrer dans une nouvelle fenêtre de commande.

    3. Impossible de se connecter à la base de données de référentiel.

      Action : Si la base de données de référentiel se trouve sur un poste local, assurez-vous d'avoir entré un ID utilisateur et un mot de passe corrects dans l'écran de création de base de données. Si la base de données du référentiel est sur un poste éloigné, assurez-vous qu'elle est cataloguée sur la machine locale. Assurez-vous également d'avoir entré un ID utilisateur et un mot de passe corrects dans l'écran d'informations de la base de données de référentiel.

  4. AIX UNIQUEMENT : Vérifiez que la base de données d'exécution a été correctement alimentée. Ouvrez le Centre de contrôle DB2 et connectez-vous à la base de données d'exécution. Vérifiez que deux fonctions définies par l'utilisateur figurent dans la base de données nommée GMTLONG2TIMESTAMP et GMTTIMESTAMP2LONG. Si ces fonctions n'existent pas, Replication Manager va échouer. Consultez le fichier <Monitor_Home>/install/logs/db2CreateRuntimeOut.log afin de déterminer si les fonctions ont été créées. Recherchez "call sqlj.install_jar". Si les fonctions ont été créées, le message suivant doit être indiqué :
    "DB20000I The CALL command completed successfully".
    Si les fonctions n'ont pas été créées, le message suivant doit être indiqué :
    "SQL4302N Procedure or user-defined function "sqlejReadJar", specific name "SQL051206175332050"
    aborted with an exception "Permission denied /home/db2inst1/sqlli". SQLSTATE=38501".

    Si tel est le cas, utilisez le programme de désinstallation de Monitor pour désinstaller la base de données d'exécution. Supprimez la base de données, réamorcez votre machine, puis réinstallez la base de données d'exécution.

  5. Pour déboguer les incidents de création de base de données Monitor, consultez le fichier <Monitor_Home>/install/logs/db2CreateAAAAOut.log où "AAAA" représente State, Runtime, Historical ou Repository.

Monitor Server

Démarrez Process Server à l'aide du profil "monitor", puis lancez l'application "Console d'administration" à l'adresse "http://localhost:9060/ibm/console". Effectuez les vérifications suivantes :
  • Applications d'entreprise : Assurez-vous que IBM_WB_ACTIONMANAGER et IBM_WB_MONITOR_SERVER sont correctement démarrés.
  • Ressources JDBC : Testez les connexions de base de données sous Serveur & portée Node aux sources de données sous la ressource MonitorDB2XADriver1JDBC.
  • WebSphere Business Monitor : Assurez-vous que tous les plug-ins/écrans spécifiques à Monitor sont correctement installés. Pour ce faire, cliquez simplement sur chaque lien hypertexte sous l'en-tête WebSphere Business Monitor.

Si l'une des applications d'entreprise est manquante, consultez les fichiers MonitorAppInstallOut.log et MonitorAppInstallErr.log sous <Monitor_Home>/install/logs. Dans le fichier MonitorAppInstallOut.log file, recherchez "ADMA5016I: Installation of IBM_WB_MONITOR_SERVER started." and "ADMA5016I: Installation of IBM_WB_ACTIONMANAGER started.". Si les applications ont été correctement installées, vous devez trouver les deux instructions suivantes : "ADMA5013I: Application IBM_WB_MONITOR_SERVER installed successfully" et "ADMA5013I: Application IBM_WB_ACTIONMANAGER installed successfully".

Si l'une des ressources JDBC est manquante, consultez les fichiers MonitorAppInstallOut.log et MonitorAppInstallErr.log sous <Monitor_Home>/install/logs. Dans le fichier MonitorAppInstallOut.log, recherchez "## Installing DataSource: ???? on node Node01" où "????" peut-être "RepositoryDBDataSource" ou "RuntimeDBDataSource". Recherchez également "## Installing DataSource: MonitorDataSource on server1". Assurez-vous qu'il n'y a aucune erreur.

Si l'un des plug-ins de la console d'administration WAS est manquant, consultez les fichiers MonitorConsoleInstallOut.log et MonitorConsoleInstallErr.log sous <Monitor_Home>/install/logs. Dans MonitorAppInstallOut.log, recherchez "PLPR0013I: Saving Console Enterprise Application". Si les plug-ins ont été correctement installés, vous devez trouver l'instruction "PLPR0014I: Closing Console Enterprise Application".

Si vous désinstallez puis réinstallez Monitor Server, vous devez supprimer le répertoire de bases de données SIB après la désinstallation de Monitor Server. Si vous ne supprimez pas le répertoire, des erreurs seront signalées au démarrage du serveur après la réinstallation. Le répertoire suivant doit être supprimé : C:\WebSphere\ProcServer\profiles\monitor\databases\com.ibm.ws.sib\<Node_Name>.server1-MONITOR.<Cell_Name>.Bus.

Des incidents peuvent également être signalés dans les fichiers SystemOut.log et SystemErr.log dans C:\WebSphere\ProcServer\profiles\monitor\logs\server1.

Dashboard Client

Démarrez le serveur WebSphere_Portal et accédez à la page "WebSphere Business Monitor Welcome" à l'adresse "http://localhost:9081/wps/portal".
  1. Vérifiez que le thème utilisé est correct. Le thème WebSphere Business Monitor est de couleur pourpre et comporte des images et des icônes WebSphere Business Monitor au lieu des icônes et des images WebSphere Portal habituels. De plus, une page d'accueil spécifique à WebSphere Business Monitor doit s'afficher à la place de la page de bienvenue WebSphere Portal habituelle.
  2. Dans l'angle droit supérieur de la page, cliquez sur Log in. Connectez-vous au moyen de l'ID/mot de passe par défaut, "wpsadmin/wpsadmin".
  3. Sous Administration > Portal Management > Portlets, effectuez une recherche par nom unique (Unique Name) en indiquant la chaîne 'com.ibm' et assurez-vous que toutes les vues de tableau de bord sont installées.
  4. Démarrez le profil de tableau de bord "server1" et vérifiez ce qui suit dans la console d'administration de WebSphere Application Server :
    1. Ressources -> Fournisseurs JDBC : Testez les connexions de base de données sous la portée Node (noeud) aux sources de données sous MonitorDB2XADriver1 JDBC Resource
  5. Des incidents peuvent être signalés dans les fichiers SystemOut.log et SystemErr.log dans C:\WebSphere\AppServer\profiles\portal\logs\server1.

Si l'une des ressources JDBC est manquante, consultez les fichiers DashboardClientDeployOut.log et DashboardClientDeployErr.log sous <Monitor_Home>/install/logs. Dans le fichier DashboardClientDeployOut.log, recherchez "## Installing DataSource: ???? on node Node01" où "????" peut être "RepositoryDBDataSource", "RuntimeDBDataSource" ou "HistoricalDBDataSource". Assurez-vous qu'il n'y a aucune erreur.

Vérifiez que des données correctes ont été écrites dans la table Monitor_Client de la base de données de référentiel. Cette table doit contenir une ligne comportant le nom de l'hôte du poste Dashboard Client et le numéro de port SOAP du poste Dashboard Client. Si aucune entrée ne figure dans la table, consultez le fichier DashboardClientDeployOut.log. Recherchez "Register Dashboard Client..." et vérifiez si des erreurs sont signalées.

Le script d'installation de Dashboard Client exécute plusieurs étapes. Voici les messages qui indiquent le début d'une étape. Consultez le fichier DashboardClientDeployOut.log afin de vous assurer que chaque étape se termine sans erreurs.
Etape Message
Création de ressources WebSphere Application Server, comme les sources de données Create WAS resources..
Déploiement du fichier WAR Deploying war...
Déploiement du thème WebSphere Business Monitor Deploying themes...
Sauvegarde de la page d'accueil WebSphere Portal Exporting Welcome Page ...
Définition de la page d'accueil WebSphere Business Monitor Setting Welcome Page ...
Création de la liaison d'un espace nom Creating namespace bindings and mapping EJB Refs ...
Création de la source de données DB2 Alphablox Create Alphablox data source...
Mise à jour de la table Monitor_Client Register Dashboard Client...

Copyright IBM Corporation 2005, 2006. All Rights Reserved.