TIV02P1 & P2 - Comment construire ses rapports avec BIRT ... · 3 IBM Tivoli Software IBM Tivoli...

IBM Tivoli Software

© 2009 IBM CorporationIBM Tivoli Automation

Philippe THOMASSpécialiste Supervision chez [email protected]

TechSoftwarePrésentations

2

IBM Tivoli Software


3

IBM Tivoli Software


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


� 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


� 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


� '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


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


Philippe THOMASSpécialiste Supervision chez [email protected]

TechSoftwareTIV02 - Comment construire ses rapports avec BIRT pour les solutions Tivoli

6

IBM Tivoli Software


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


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


� 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


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.

10

IBM Tivoli Software


11

IBM Tivoli Software


12

IBM Tivoli Software


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


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


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


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


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


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


Création d’un nouveau rapport

1. File->New->Report

2. Saisir le nom du rapport

3. Finish

19

IBM Tivoli Software


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


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


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


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



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



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



1. File->View Report ->View Report in Web Viewer

26

IBM Tivoli Software


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


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


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


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


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


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


Votre premier rapport avec TCR

� Afin de vérifier que TCR fonctionne correctement, vous pouvez lancer votre premier rapport (défini par défaut)

33

IBM Tivoli Software


Votre premier rapport avec TCR

34

IBM Tivoli Software


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


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


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

37

IBM Tivoli Software


Les premiers rapports

38

IBM Tivoli Software


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


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)

40

IBM Tivoli Software


Readme pour chaque rapports

41

IBM Tivoli Software


www.ibm.com/developerworks/spaces/tcr

42

IBM Tivoli Software


43

IBM Tivoli Software


44

IBM Tivoli Software


Commandes en ligne TCR

45

IBM Tivoli Software


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


Autres fonctionnalités de BIRT & TCR

� Thèmes

� Templates

� Cubes

� Jointures

� Scripts

� Sécurité (TCR)

47

IBM Tivoli Software


Des Questions ?

Philippe THOMAS – [email protected]

TIV02P1 & P2 - Comment construire ses rapports avec BIRT ... · 3 IBM Tivoli Software IBM Tivoli...

Documents

Transcript of TIV02P1 & P2 - Comment construire ses rapports avec BIRT ... · 3 IBM Tivoli Software IBM Tivoli...