TechSoftware Présentations

TechSoftware Présentations Philippe THOMAS Spécialiste Supervision chez Tivoli THOMAS1@FR.IBM.COM

2

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 passez en revue le dispositif BIRT (Business Intelligence Reporting Tool) qui permet de créer des rapports pour 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'agent Builder, un nouveau composant qui permet de développer des agents en utilisant des providers prédéfinis. En utilisant des exemples concrets, om montrera la facilité et l'industrialisation de la définition de nouveaux agents ainsi que leur intégration dans une infrastructure 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 à travers des solutions de type VMWare ou par les systèmes P (LPAR). Nous vous proposons en 45 Mn de faire le tour 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 fonctionnalités offertes pour enregistrer des scénarii Web et les rejouer dans ITCAM for Transaction pour mesurer les temps de 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 couvertes. 3

Environnement des démonstrations BIRT TEP RPT VM = ELISH Serveur TCR VM = POST3 Console RPT Agent Builder TDW VM = SMART Serveur Supervision ITM+ITCAM+D TCR Agent Windows Agent ESX Agent RRT AMC New Agent Agent Universel 4

TechSoftware TIV02 - Comment construire ses rapports avec BIRT pour les solutions Tivoli Philippe THOMAS Spécialiste Supervision chez Tivoli THOMAS1@FR.IBM.COM

TIV02 - Comment construire ses rapports avec BIRT pour les solutions Tivoli Dans cette double session de 90 mn, nous allons passez en revue le dispositif BIRT (Business Intelligence Reporting Tool) qui permet de créer des rapports pour 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. 6

Introduction La plupart des solutions Tivoli propose une solution unique pour faire des rapports aux formats HTML ou PDF TCR (Tivoli Common Reporting) est la solution retenue par IBM pour produire ces rapports (à partir d un entrepôt de données) TCR est constitué d un runtime BIRT afin de visualiser et d exploiter les rapports BIRT = Business Intelligence Reporting Tool BIRT est une solution globale constituée de 2 composants : 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 7

BIRT et les rapports communs (TCR) BIRT Designer IBM Tivoli Monitoring A Common/Shared Report Infrastructure Interface Web Facile à utiliser Distribution aisée HTML WEB2 IBM Tivoli Storage Manager Report Administration Organization Customization Subscription & Distribution Scheduling e-mail, WEB/URL, etc IBM Tivoli Business Service Manager BIRT Runtime Engine HTML PDF CSV etc 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 Provisioning Manager 8

Installation de BIRT BIRT Designer version 2.2.1 pour la présente session 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 graphiques, des courbes, des camemberts, des tableaux, des logos, des textes et des paramètres. 9

10

11

Installation de BIRT (10 mn) Note : Ne pas oublier le client JDBC Dans 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 12

Configuration JDBC pour BIRT ou TCR Database DB URL Driver Jar File DB2 jdbc:db2://<hostname>:<dbpo RT>/<DBNAME>:currentSchema= <SCHEMANAME>; com.ibm.db2.jcc.db2driver db2jcc.jar db2jcc_license_cu.jar E.g.,jdbc:db2://tivreporting.raleigh. ibm.com:50000/warehous:curr entschema=itmuser; Oracle jdbc:oracle:thin:@<hostname>: <DBPORT>:<DBNAME> oracle.jdbc.driver.oracledriver oraclethin.jar E.g., jdbc:oracle:thin:@tivreporting.ralei gh.ibm.com:1521:warehous SQLServer jdbc:sqlserver://<hostname>:< DBPORT>;databasename=<DBN AME>; com.microsoft.sqlserver.jdbc.sql ServerDriver sqljdbc.jar E.g., jdbc:sqlserver://tivreporting.raleigh.ibm.com:1433;databasename=w AREHOUS; 13

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 14

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 15

Environnement de la démonstration BIRT+TCR BIRT TEP VM = ELISH Serveur TCR BIRT Designer TDW VM = SMART Serveur Supervision ITM+ITCAM+D TCR Agent Windows 16

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 17

Création d un nouveau rapport 1. File->New->Report 2. Saisir le nom du rapport 3. Finish 18

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) 19

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 20

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 21

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 22

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 23

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 24

Création d un Graphique (4) 1. File->View Report ->View Report in Web Viewer 25

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, 26

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. 27

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 28

Architecture Détaillée de TCR TCR Website on Developerworks TCR GUI (TIP = Tivoli Integrated Portal) TCR Infrastructure HTML, PDF, Excel, Postscript BIRT Business Intelligence Reporting Tool Open Source Eclipse based tool JDBC, XML, Flat file, Web Services, Scripted 29

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\reportengine\plugins\ org.eclipse.birt.report.data.oda.jdbc_2.2.1.r22x_v20070919\drivers 30

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 31

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

Votre premier rapport avec TCR 33

Modification de la sécurité Lors d une première installation, la sécurité est activé par défaut dans TCR Pour activer ou désactiver la sécurité, il faut modifier le fichier suivant : %Path_TCR%\products\tcr\conf\reportingConfig.xml Avec : <Property key="security_enabled">true</property> Ou <Property key="security_enabled">false</property> 34

Importation de package ou de rapports Il est possible depuis TCR d importer un ou plusieurs rapports depuis un package (à partir de fichier zip 35

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 36

Les premiers rapports 37

Logging and Debugging Logging functions provided in TCR Style Package templates Enable tracing in TCR If running reports from BIRT designer view logs in temp dir under root Logs located at <tcr_install>\ewas61\profiles\tcrprofile\logs\tcrserver (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 open the report. Scroll to the bottom of the report to see the exact errors. Common errors discussed on next slide. 38

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.eclipse.birt.report.data.oda.jdbc Cannot 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 ]. The 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) 39

Readme pour chaque rapports 40

www.ibm.com/developerworks/spaces/tcr 41

42

43

Commandes en ligne TCR 44

Lancer des rapports avec des commandes Lancer un rapport et accéder au snapshot via une URL Utilisation du Snapshot ID URL: https://localhost:30343/tcr/reports/view?_tcr_format=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 administrer TCR 45

Autres fonctionnalités de BIRT & TCR Thèmes Templates Cubes Jointures Scripts Sécurité (TCR) 46

Des Questions? Philippe THOMAS THOMAS1@FR.IBM.COM 47