IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Philippe THOMASSpécialiste Supervision chez [email protected]
TechSoftwarePrésentations
3
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Mes Sessions à TechSoftware� TIV02 - Comment construire ses rapports avec BIRT pour les solutions Tivoli
� intervenant : Philippe THOMAS , spécialiste Tivoli
� Dans cette double session de 90 mn, nous allons pas sez en revue le dispositif BIRT (Business Intellige nce Reporting Tool) qui permet de créer des rapports po ur l'ensemble des solutions Tivoli. Instalaltion, personnalisation, définition et export des rapports seront passés en revue au cors de la session avec de nombreux exemples concrets.
� TIV14 - Comment définir de nouveaux agents de supervision
� intervenant : Philippe THOMAS , spécialiste Tivoli
� Les solutions ITCAM et ITM sont livrées avec l'Agen t Builder, un nouveau composant qui permet de dével opper des agents en utilisant des providers prédéfinis. E n utilisant des exemples concrets, om montrera la f acilité et l'industrialisation de la définition de nouveaux ag ents ainsi que leur intégration dans une infrastruc ture ITM.
� TIV16 - Comment appréhender la supervision des environnements virtualisés
� intervenant : Philippe THOMAS , spécialiste Tivoli
� De plus en plus d'environnements se consolident à tr avers des solutions de type VMWare ou par les systè mes P (LPAR). Nous vous proposons en 45 Mn de faire le to ur des agents ITM qui permettent de superviser ces environnements avec des démonstrations à l'appui.
� TIV18 - Monitoring : nouvelles fonctionnalités pour enregistrer vos scénarios avec ITCAM for Transactions
� intervenant : Philippe THOMAS , spécialiste Tivoli
� 'Cette session permettra de découvrir les fonctionn alités offertes pour enregistrer des scénarii Web e t les rejouer dans ITCAM for Transaction pour mesurer les temps d e réponses. Cela couvrira la prise en main et le paramétrage de l’enregistreur en mode protocolaire. Les fonctions de corrélations, de mise en place de point de vérifications et de gestion des erreurs seront couv ertes.
4
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
VM = SMART
Serveur Supervision
ITM+ITCAM+D
VM = POST3
� Console RPT
VM = ELISH
� Serveur TCR
Environnement des démonstrations
Agent Windows
Agent Universel
Agent ESX Agent RRT
Agent Builder
BIRT
TCR New Agent
TDW
TEP RPT
AMC
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Philippe THOMASSpécialiste Supervision chez [email protected]
TechSoftwareTIV02 - Comment construire ses rapports avec BIRT pour les solutions Tivoli
6
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
TIV02 - Comment construire ses rapports avec BIRT pour les solutions Tivoli
� Dans cette double session de 90 mn, nous allons pas sez en revue le dispositif BIRT (Business Intelligence Reporting Tool) qui permet d e créer des rapports pour l'ensemble des solutions Tivoli. Instalaltion, pers onnalisation, définition et export des rapports seront passés en revue au cors de la s ession avec de nombreux exemples concrets.
7
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Introduction
� La plupart des solutions Tivoli propose une solutio n unique pour faire des rapports aux formats HTML ou PDF
� TCR (Tivoli Common Reporting) est la solution retenue p ar IBM pour produire ces rapports (à partir d’un entrepôt de don nées)
� TCR est constitué d’un runtime BIRT afin de visualis er et d’exploiter les rapports
� BIRT = Business Intelligence Reporting Tool
� BIRT est une solution globale constituée de 2 compo sants :� Définition des rapports avec BIRT Designer
� Exploitation des rapports (profils, visualisation, exécution, dispatching, scheduling, email …) avec le runtime BIRT … qui est utilisé dans TCR dans notre cas.
� Dans la suite de ce document :� BIRT désigne le produit open source pour la définition des rapports
� TCR désigne la solution IBM utilisant le runtime de BIRT pour l’exploitation des rapports
8
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
� HTML� PDF� CSV� etc
Report Administration• Organization• Customization• Subscription & Distribution• Scheduling
BIRT Runtime Engine
ACommon/Shared
Report Infrastructure
TCR est une solution ouverte bâtie sur Birt Runtime Engine qui fournit des rapports prédéfinis pour l’ensemble des solutions Tivoli.
IBM Tivoli BusinessService Manager
IBM TivoliMonitoring
IBM TivoliProvisioning Manager
IBM TivoliStorage Manager
BIRT et les rapports communs (TCR)
e-mail, WEB/URL, etc
� HTML� WEB2
Interface WebFacile à utiliser
Distributionaisée
BIRTDesigner
9
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Installation de BIRT
� BIRT Designer version 2.2.1 pour la présente sessio n
� Le code se trouve sur :� Le site BIRT :
� http://download.eclipse.org/birt/downloads/
� Le site IBM OPAL :
� http://www-01.ibm.com/software/tivoli/features/opal/
� Note : sur OPAL, on trouve également de nombreux rapports pour toutes les solutions Tivoli
� BIRT Designer est un plugin de Eclipse.
� BIRT permet de définir visuellement des rapports (de complexité variable) sur des sources de données variées et propose des g raphiques, des courbes, des camemberts, des tableaux, des logos, d es textes et des paramètres.
12
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Installation de BIRT (10 mn)
Note : Ne pas oublier le client JDBCDans le répertoire :%PATH_BIRT%\eclipse\plugins\org.eclipse.birt.report.data.oda.jdbc_2.2.1.r22x_v20070919\drivers
Copier le driver DB2 (par exemple)db2jcc.jar
db2jcc_license_cu.jar
13
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Configuration JDBC pour BIRT ou TCR
sqljdbc.jarcom.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc:sqlserver://<HOSTNAME>:<DBPORT>;databasename=<DBNAME>;
E.g., jdbc:sqlserver://tivreporting.raleigh.ibm.com:1433;databasename=WAREHOUS;
SQLServer
oraclethin.jaroracle.jdbc.driver.OracleDriverjdbc:oracle:thin:@<HOSTNAME>:<DBPORT>:<DBNAME>
E.g., jdbc:oracle:thin:@tivreporting.raleigh.ibm.com:1521:WAREHOUS
Oracle
db2jcc.jardb2jcc_license_cu.jar
com.ibm.db2.jcc.DB2Driverjdbc:db2://<HOSTNAME>:<DBPORT>/<DBNAME>:currentSchema=<SCHEMANAME>;
E.g.,jdbc:db2://tivreporting.raleigh.ibm.com:50000/WAREHOUS:currentSchema=ITMUSER;
DB2
Jar FileDriverDB URLDatabase
sqljdbc.jarcom.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc:sqlserver://<HOSTNAME>:<DBPORT>;databasename=<DBNAME>;
E.g., jdbc:sqlserver://tivreporting.raleigh.ibm.com:1433;databasename=WAREHOUS;
SQLServer
oraclethin.jaroracle.jdbc.driver.OracleDriverjdbc:oracle:thin:@<HOSTNAME>:<DBPORT>:<DBNAME>
E.g., jdbc:oracle:thin:@tivreporting.raleigh.ibm.com:1521:WAREHOUS
Oracle
db2jcc.jardb2jcc_license_cu.jar
com.ibm.db2.jcc.DB2Driverjdbc:db2://<HOSTNAME>:<DBPORT>/<DBNAME>:currentSchema=<SCHEMANAME>;
E.g.,jdbc:db2://tivreporting.raleigh.ibm.com:50000/WAREHOUS:currentSchema=ITMUSER;
DB2
Jar FileDriverDB URLDatabase
14
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Démarrage de BIRT
1. Cliquez sur l’icône d’Eclipse :
2. Saisir un nom de répertoire de travail où vous allez définir vos rapports
3. Puis cliquez sur Workbench
15
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Les étapes de la création d’un rapport
1. Création d’un projet (sauf si on souhaite définir le rapport dans un projet existant)
2. Définition d’un rapport
3. Définition d’une source de données (ou de plusieurs selon vos besoins)
4. Définition d’une table de données (Dataset) à partir d’une source
5. Création d’une page de rapport
6. Export du rapport
Alternative : importer depuis un fichier zip contenant un package BIRT
16
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
VM = SMART
Serveur Supervision
ITM+ITCAM+D
VM = ELISH
� Serveur TCR
� BIRT Designer
Environnement de la démonstration BIRT+TCR
Agent Windows
BIRT
TCR
TDW
TEP
17
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Création d’un projet
1. File ->New->Project
2. Choisir Report Project
3. Nommer le projet
4. Confirmer
5. Visualiser le projet dans le navigateur à gauche
18
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Création d’un nouveau rapport
1. File->New->Report
2. Saisir le nom du rapport
3. Finish
19
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Data Sources
� JDBC (bases de données)
� Web services
� Scripted
� XML
� Flat file (csv, ssv, psv, tsv)
� Rapports croisés� Plusieurs sources dans le même
rapport
� Jointures sur différentes sources (Joint Data Set)
20
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Définir la source de données
1. Cliquer sur l’onglet Data Explorer
2. Cliquer droit et choisir New Data Source
3. Sélectionner JDBC Data Source et fournir un nom à cette source
4. Vous devez fournir les paramètres JDBC en fonction de la base choisie. Pour DB2 :
Driver Class: com.ibm.db2.jcc.DB2Driver
Database URL: jdbc:db2://localhost:50000/warehous
User Name: ITMUser
Password: xxxxx
Pas d ’URL JNDI
5. Tester la connexion
6. Finish
21
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Création d’un Data Set
1. Cliquer droit puis New Data Set
2. Nommer le Data Set puis associer à une Data Source
3. Puis on détermine la table en utilisant des filtres au besoin
4. Modifier l’ordre Select (à droite) en fonction de vos besoins
5. Finish
6. Déterminer le format de sortie (optionnel)
7. Vérifier la preview des données afin de s’assurer de leur présence
22
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Création d’un Graphique (1)
1. Cliquer sur l’onglet Palette puis Report Items puis Chart, on visualise alors à droite une page en format WYSIWYG qui supporte le Drag&Drop
2. Faire un Drag&Drop du chart (ou d’une autre forme de la Palette) vers la feuille blanche
3. Puis choisir un type de graphique et associer un format de sortie
4. Next
23
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Création d’un Graphique (2)
1. Cliquer sur Use Data Set dans la section Select Data (l’apparition des colonnes peut prendre un certain temps en fonction du volume des données)
2. Puis utiliser le drag & drop pour assigner les axes du graphique par rapports à des colonnes de la table de données
3. Pour la gestion du Timestamp dans ITM et ITCAM, cliquez sur Fx et copier la formule ci-dessous
4. Next
var year = 20 + row["Timestamp"].substr(1,2);
var month = row["Timestamp"].substr(3,2); var day = row["Timestamp"].substr(5,2); var hour = row["Timestamp"].substr(7,2);
var minute = row["Timestamp"].substr(9,2); year +"-" + month + "-" + day + " " + hour + ":" + minute
24
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Création d’un Graphique (3)
1. Cliquer sur Y-Axis
2. Définir un titre et cocher sur Visible pour faire apparaitre le titre
3. Faire de même pour X-Axis
4. Finish
25
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Création d’un Graphique (4)
1. File->View Report ->View Report in Web Viewer
26
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Anatomie d’un « bon » rapport BIRT
� Un entête de la société avec un ou deux logo (possibilité d’avoir une master page)
� Un premier titre général
� Des titre secondaires
� Les paramètres utilisés pour faire ce rapport
� Les sections avec les graphiques et les tableaux
� Des descriptions
� Un bas de page avec numéro de page, date, …
27
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Exporter un rapport
1. File->Export
2. Choisir le projet
3. Saisir le nom du zip
4. Finish
Ce fichier zip pourra ensuite être
importé dans TCR
Un rapport est un fichier XML.
La Data Source n’est pas exportée.
28
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Tivoli Common Reporter (TCR)
� TCR est un portail sécurisé prêt àl’emploi pour exploiter des rapports BIRT sur des sources de données variées (DB2, Oracle, MSSQL ou d’autres) :� Organiser les rapports en set� Exécuter les rapports immédiatement� Voir les rapports sous différents formats� Importer/Exporter/Télécharger� Exécuter selon une fréquence et un
calendrier� Distribuer via email ou RSS (à venir dans
TCR 1.3)� Protéger (profils utilisateurs)� Personnaliser les rapports
� TCR crée une indépendance entre la couche design et la couche organisationnelle
29
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Architecture Détaillée de TCR
BIRT – Business Intelligence Reporting Tool – Open Source Eclipse based tool
JDBC, XML, Flat file, Web Services, Scripted
TCR GUITCR Website on Developerworks
TCR Infrastructure
HTML, PDF, Excel, Postscript
(TIP = Tivoli Integrated Portal)
30
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Installation de TCR
� Via Passeport Advantadge
� TCR version 1.2 = C1RS7ML
� Durée de l’installation : environ 30 mn
� TCR contient un serveur eWAS et donc il a besoin de 1 Go de RAM mini
� A la fin de l’installation, il faut noter :� Le nom de l’utilisateur : par défaut tipadmin
� Le mot de passe
� L’url de connexion : http://tcrhost:16310 par exemple
� Finalement copier le driver JDBC :db2jcc.jar
db2jcc_license_cu.jar
Dans le répertoire : %path_TCR%\products\tcr\lib\birt-runtime-2_2_1\Repo rtEngine\plugins\
org.eclipse.birt.report.data.oda.jdbc_2.2.1.r22x_v2 0070919\drivers
31
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Démarrage/Arrêt du serveur TCR
� Start->Programs->Tivoli Common Reporting->Start Tivoli Common
Reporting Server
� Start->Programs->Tivoli Common Reporting->Stop Tivoli Common
Reporting Server
� Pour lancer la console : http://<hostname>:16310
� User ID (défaut) = tipadmin
� Password = celui que vous avez mis lors de l’installation
32
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Votre premier rapport avec TCR
� Afin de vérifier que TCR fonctionne correctement, vous pouvez lancer votre premier rapport (défini par défaut)
34
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Modification de la sécurité
� Lors d’une première installation, la sécurité est ac tivé par défaut dans TCR
� Pour activer ou désactiver la sécurité, il faut mod ifier le fichier suivant :
%Path_TCR%\products\tcr\conf\reportingConfig.xml
Avec :
<Property key="SECURITY_ENABLED">true</Property>
Ou
<Property key="SECURITY_ENABLED">false</Property>
35
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Importation de package ou de rapports
� Il est possible depuis TCR d’importer un ou plusieurs rapports depuis un package (àpartir de fichier zip
36
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Avant de lancer le deuxième rapport
� Il faut spécifier les data sources
� En effet, les data sources de TCR ne corrspondent pas forcement àcelles de BIRT (cliquer droit sur le rapport puis choisir data sources)
� Puis saisir les informations JDBC
38
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Logging and Debugging� Logging functions provided in TCR Style Package templa tes
� Enable tracing in TCR
� If running reports from BIRT designer view logs in te mp dir under root
� Logs located at <tcr_install>\eWas61\profiles\tcrProfile\logs\tcrSe rver (SystemOut.log, SystemError.log)
� Article on Logging: http://www.ibm.com/developerworks/tivoli/library/t- tcr/ibm_tiv_tcr_report_logging.pdf?S_TACT=105AGX01& S_CMP=L
� If you get the following error, click on the link to op en the report. Scroll to the bottom of the report to see the exact errors. Common errorsdiscussed on next slide.
39
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Common Usage Errors� “SQL Statement does not return a ResultSet object ”
– The tables/views from which data is to be extracted do not exist in the database.
– The column names are wrong or SQL syntax is not correct
– To view the SQL query refer to the logs
� “ Javascript errors”
– Look for “Caused by” in the stack trace. It will point out the line number of the script in the report design at which the error occurred.
� “Cannot open the connection for the driver: org.eclips e.birt.report.data.oda.jdbcCannot load JDBC Driver class ”
– Driver incompatible or JDBC drivers not placed in the right directory� “ CTGTRE028E A BIRT exception [ The design file is an invalid xml file. ] has occurred
during the opening of the design [ design stream ]. Th e BIRT design cannot be used.”
– Wrong version of BIRT designer used to create the report. Use only BIRT 2.2.1� “Empty Data Set”
– No data was returned by the query. Check the database if data exists
– Try a different set of parameters (e.g., different date range, different shift periods etc)
41
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
www.ibm.com/developerworks/spaces/tcr
45
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Lancer des rapports avec des commandes
� Lancer un rapport et accéder au snapshot via une UR L� Utilisation du Snapshot ID
� URL: https://localhost:30343/TCR/Reports/view?_TCR_forma t=html&_TCR_snapshot=100002
� Distribution des snapshots vers un répertoire � Permet de distribuer les rapports vers un serveur Web autre que TCR
� Environ 30 commandes en ligne (CLI) pour gérer et a dministrer TCR
46
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Autres fonctionnalités de BIRT & TCR
� Thèmes
� Templates
� Cubes
� Jointures
� Scripts
� Sécurité (TCR)
47
IBM Tivoli Software
© 2009 IBM CorporationIBM Tivoli Automation
Des Questions ?
Philippe THOMAS – [email protected]