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 :
- 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.
- 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.
- 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é.
- 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 :
- 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.
- 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 :
- 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.
- 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.
- Vérifiez
que l'application "Console d'administration" est accessible
à l'adresse : http://localhost:9060/ibm/console
- Vérifiez
si SystemOut.log comporte des erreurs dans
C:\IBM\WebSphere\AppServer\profiles\dashboard\logs\server1.
- 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 :
- 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.
- 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
- Vérifiez que l'application "Console d'administration" est
accessible à l'adresse "http://localhost:9060/ibm/console".
- Vérifiez si SystemOut.log comporte des erreurs dans
C:\IBM\WebSphere\ProcServer\profiles\monitor\logs\server1.
- 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}
- 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 :
- Vérifiez que
vous pouvez démarrer/arrêter le serveur d'applications
"WebSphere_Portal". Vous pouvez utiliser "Premiers pas" pour lancer le serveur.
- Vérifiez que l'application
Web
IBM
WebSphere
Portal est accessible.
- Si vous
utilisez "Premiers pas", cette dernière lance automatiquement
l'application Web après le démarrage du serveur.
- 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".
- La
page de "connexion au portlet" doit s'afficher. Connectez-vous au
moyen de l'ID/mot de passe par défaut, "wpsadmin/wpsadmin".
- Une
fois connecté, une page Web contenant le message
"Welcome to WebSphere Portal
version 5.1.0.2" doit s'afficher.
- 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 :
- 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".
- 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.
- 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
- Avant
d'utiliser le tableau de bord pour créer des bases de données, procédez
comme suit :
- 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é.
- Assurez-vous que
DB2
est démarré.
- 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".
- 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 :
- Base
de données non créée.
Action : Assurez-vous que
DB2
est démarré.
- 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.
- 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 :
- 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.
- 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.
- 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.
- 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.
- 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".
- 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.
- 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".
- 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.
- Démarrez
le profil de tableau de bord "server1" et vérifiez ce qui suit dans
la console d'administration de WebSphere
Application Server :
- 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
- 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... |