You are on page 1of 81

Reporter

Manuel d'administration

Version : 6.7.01
Date de publication : 2016-09
Automic Software GmbH
ii | Copyright

Copyright
Automic et les logo Automic sont des marques dposes appartenant Automic Software GmbH
(Automic). L'utilisation de toutes les marques dposes ncessite une autorisation explicite crite et
est soumise aux conditions de la licence. Les logiciels et/ou le programme sont la proprit protge
d'Automic Software. L'accs et l'utilisation de ces derniers sont soumis des conditions de licence
devant tre approuves par crit.
Les logiciels et/ou le programme sont galement protgs par des droits de reproduction par des
contrats internationaux ainsi que par les lois nationales et internationales. Un accs et/ou une
utilisation non autoriss peuvent entraner des poursuites civiles et pnales. La copie non autorise et
d'autres formes de reproduction partielle ou totale, la dcompilation, la reproduction, la modification,
ou le dveloppement de produits drivs du logiciel sont strictement interdits. Le non-respect de ces
conditions peut entraner des poursuites pnales.
Sous rserve de modifications. Aucune responsabilit ne sera accepte pour toute modification,
omission, erreur d'impression ou de production. Toute reproduction, totale ou partielle, est strictement
interdite.
Copyright Automic Software GmbH. Tous droits rservs.
Reporter Manuel d'administration | iii

Table des matires


1 Release Notes ...................................................................................................................... 7
2 Introduction .......................................................................................................................... 8
2.1 qui sadresse ce manuel ? .......................................................................................... 8
2.2 Contenu de ce manuel.................................................................................................... 8
3 Concepts et Architecture .................................................................................................... 9
3.1 Concepts ......................................................................................................................... 9
3.1.1 Source de donnes .................................................................................................. 9
3.1.2 Extraction .................................................................................................................. 9
3.1.3 Contenu de la base de donnes .............................................................................. 9
3.1.4 Groupe de nuds .................................................................................................... 9
3.1.5 Rapport ................................................................................................................... 10
3.1.6 Modle de rapport .................................................................................................. 10
3.1.7 Etiquette.................................................................................................................. 10
3.2 Composants de larchitecture ....................................................................................... 10
3.2.1 UniViewer Console (UVC) ...................................................................................... 11
3.2.2 Serveur Reporter .................................................................................................... 11
3.2.3 UniViewer Management Serveur (UVMS) .............................................................. 12
3.2.4 La base de donnes ............................................................................................... 12
3.2.5 Dollar Universe Application Serveur (DUAS) ......................................................... 12
3.2.6 Lordonnanceur interne ........................................................................................... 12
3.2.7 Le client Reporter pour Dollar Universe ................................................................. 12
3.2.8 UniJob (UJ) ............................................................................................................. 13
3.2.9 Le client Reporter pour UniJob ............................................................................... 13
4 Installation .......................................................................................................................... 14
4.1 Configuration matrielle ................................................................................................ 14
4.1.1 Serveur Reporter .................................................................................................... 14
4.1.2 Serveur de base de donnes ................................................................................. 14
4.1.3 Client Reporter pour UniJob/Dollar Universe ......................................................... 15
4.1.4 Source de donnes ................................................................................................ 15
4.2 Configuration logicielle.................................................................................................. 15
4.2.1 Java ........................................................................................................................ 15
4.2.2 Pilotes JDBC........................................................................................................... 15
4.2.3 Jeu de caractres de la base de donnes ............................................................. 15
4.3 Vrifications prliminaires ............................................................................................. 16
4.4 Installation du serveur Reporter sous Windows ........................................................... 16
4.4.1 Instances multiples ................................................................................................. 16
4.4.2 Lcran daccueil ..................................................................................................... 17
4.4.3 Licence utilisateur ................................................................................................... 17
4.4.4 Dfinition de lenvironnement Java (JDK ou JRE) ................................................. 17
4.4.5 Slectionnez le type dinstallation .......................................................................... 17
iv | Table des matires

4.4.6 Rpertoire dinstallation du serveur Reporter ......................................................... 18


4.4.7 Informations sur le serveur Reporter ...................................................................... 18
4.4.8 Dfinition du pilote JDBC ........................................................................................ 18
4.4.9 Prt installer le programme ................................................................................. 18
4.4.10 Procdure InstallShield termine............................................................................ 19
4.5 Installation du client Reporter pour UniJob ou Dollar Universe sous Windows ........... 19
4.5.1 Dossier de destination ............................................................................................ 19
4.5.2 Informations sur le serveur Reporter ...................................................................... 19
4.5.3 Confirmer linstallation ............................................................................................ 19
4.5.4 Procdure InstallShield termine............................................................................ 19
4.6 Installation du serveur Reporter sous Linux ................................................................. 20
4.6.1 Choix de linstallation .............................................................................................. 20
4.6.2 Contrat de licence logicielle de Reporter ................................................................ 21
4.6.3 Slection du type dinstallation ............................................................................... 21
4.6.4 Emplacement de la commande java ...................................................................... 21
4.6.5 Nom du serveur Reporter ....................................................................................... 21
4.6.6 Rpertoire dinstallation .......................................................................................... 22
4.6.7 Nom dhte du serveur Reporter ............................................................................ 22
4.6.8 Numro de port du serveur Reporter ..................................................................... 22
4.6.9 Chemin daccs au fichier du pilote JDBC ............................................................. 22
4.6.10 Confirmer linstallation ............................................................................................ 22
4.7 Installer le client Reporter pour UniJob sous Linux ...................................................... 23
4.7.1 Chemin daccs linstallation dUniJob ................................................................ 23
4.7.2 Nom du serveur Reporter ....................................................................................... 23
4.7.3 Nom dhte du serveur Reporter ............................................................................ 23
4.7.4 Numro de port IP du serveur Reporter ................................................................. 23
4.7.5 Confirmer linstallation ............................................................................................ 23
4.8 Installer le client Reporter pour Dollar Universe sous Linux ......................................... 24
4.8.1 Prrequis sous Linux .............................................................................................. 24
4.8.2 Emplacement de la commande java ...................................................................... 24
4.8.3 Rpertoire de la Socit Dollar Universe ............................................................... 24
4.8.4 Nom du serveur Reporter ....................................................................................... 24
4.8.5 Nom dhte du serveur Reporter ............................................................................ 24
4.8.6 Numro de port IP du serveur Reporter ................................................................. 24
4.8.7 Confirmer linstallation ............................................................................................ 25
5 Configuration ..................................................................................................................... 26
5.1 Licence.......................................................................................................................... 26
5.2 Configuration rseau .................................................................................................... 26
5.3 Configuration du schma de la base de donnes ........................................................ 26
5.3.1 Cration de lutilisateur ........................................................................................... 27
5.3.2 Initialisation de la base de donnes ....................................................................... 27
5.3.3 Vrification des droits des utilisateurs sur les tables .............................................. 27
5.4 Dmarrer et arrter le serveur Reporter ....................................................................... 28
5.5 Initialiser la scurit de Reporter .................................................................................. 28
5.5.1 Droits des utilisateurs ............................................................................................. 28
Reporter Manuel d'administration | v

5.5.2 Communications SSL ............................................................................................. 29


5.6 Dclarer UniViewer Management Server ..................................................................... 37
5.7 Valider les paramtres de la base de donnes ............................................................ 37
5.8 Valider les extractions et le chargement ....................................................................... 38
6 Mise jour et dsinstallation ............................................................................................ 39
6.1 Etapes de la mise jour ............................................................................................... 39
6.2 Migrer la base de donnes ........................................................................................... 39
6.2.1 Mise jour du schma de la base de donnes Oracle .......................................... 40
6.2.2 Mise jour du schma de la base de donnes MS SQL Server ........................... 41
6.2.3 Gestion des erreurs ................................................................................................ 42
6.2.4 Journalisation de la migration ................................................................................. 42
6.3 Mise jour de Reporter sous Windows ........................................................................ 42
6.3.1 Mise jour du serveur Reporter sous Windows..................................................... 43
6.3.2 Mise jour du client Reporter sous Windows ........................................................ 43
6.4 Mise jour de Reporter sous Linux .............................................................................. 44
6.4.1 Mise jour du serveur Reporter sous Linux ........................................................... 44
6.4.2 Mise jour du client Reporter sous Linux .............................................................. 45
6.5 Retour arrire de la base de donnes de Reporter ...................................................... 45
6.6 Retour arrire de Reporter............................................................................................ 45
6.6.1 Retour arrire du client Reporter pour Dollar Universe sous Windows .................. 45
6.6.2 Retour arrire du client Reporter pour Dollar Universe sous Linux ........................ 46
6.7 Dsinstaller les composants de Reporter ..................................................................... 46
6.7.1 Dsinstaller le serveur Reporter sous Windows ..................................................... 46
6.7.2 Dsinstaller le client Reporter pour Dollar Universe sous Windows ...................... 46
6.7.3 Dsinstaller le client Reporter pour UniJob sous Windows .................................... 46
6.7.4 Dsinstaller le serveur Reporter sous Linux ........................................................... 46
6.7.5 Dsinstaller le client Reporter sous Linux .............................................................. 47
7 Authentification et droits des utilisateurs ....................................................................... 48
7.1 Aprs linstallation ......................................................................................................... 49
7.1.1 Utilisateurs internes ................................................................................................ 49
7.1.2 Extraction de cibles Dollar Universe V5 ................................................................. 49
7.1.3 Extraction de cibles UniJob et DUAS v6 ................................................................ 49
7.2 Gestion des utilisateurs Reporter ................................................................................. 49
7.2.1 Ajouter un utilisateur la liste des utilisateurs internes de Reporter ..................... 49
7.2.2 Supprimer un utilisateur de la liste des utilisateurs internes de Reporter .............. 50
7.2.3 Lister les utilisateurs internes de Reporter ............................................................. 50
7.3 Gestion des proxies Reporter ....................................................................................... 51
7.3.1 Ajouter une rgle de proxy au serveur Reporter .................................................... 51
7.3.2 Supprimer une rgle de proxy dun serveur Reporter ............................................ 51
7.3.3 Lister les rgles de proxy dun serveur Reporter .................................................... 52
7.3.4 Rcuprer le nom dun utilisateur de proxy ............................................................ 52
8 Interface Commandes ....................................................................................................... 54
8.1 Gestion des donnes .................................................................................................... 54
8.1.1 Dclenchement des extractions ............................................................................. 54
vi | Table des matires

8.1.2 Suivi des extractions ............................................................................................... 55


8.1.3 Dclenchement dune purge de la base de donnes ............................................. 58
8.2 Gestion des rapports .................................................................................................... 58
8.2.1 Utilisation des modles de rapports ....................................................................... 58
8.2.2 Dclenchement des rapports.................................................................................. 59
8.2.3 Personnalisation des rapports ................................................................................ 60
9 Rsolution des problmes ................................................................................................ 61
9.1 Traabilit du problme ................................................................................................ 61
9.2 Messages derreur ........................................................................................................ 61
9.2.1 Nud Reporter non dfini - Connexion refuse .................................................... 61
9.2.2 Table inexistante .................................................................................................... 61
9.2.3 Impossible de soumettre la commande Tche incidente .................................. 64
9.2.4 Extractions impossibles .......................................................................................... 65
9.2.5 Connexion la base de donnes ........................................................................... 65
9.2.6 Connexion UniViewer Management Serveur ...................................................... 65
9.2.7 Rapports personnaliss en erreur .......................................................................... 65
9.3 Modification du Java Runtime Environment ................................................................. 66
10 Modle de donnes de Reporter v6 ............................................................................ 67
10.1 Tables fonctionnelles de la base de donnes .............................................................. 68
10.1.1 UNI_EVT_AUDITTRAIL ......................................................................................... 68
10.1.2 UNI_EVT_DATASOURCES ................................................................................... 68
10.1.3 UNI_EVT_INTERVENTIONS ................................................................................. 69
10.1.4 UNI_EVT_JOBLOGS ............................................................................................. 72
10.1.5 UNI_EVT_MESSAGES .......................................................................................... 72
10.1.6 UNI_EVT_PARAMETERS...................................................................................... 73
10.1.7 UNI_EVT_RELAUNCHES ...................................................................................... 73
10.1.8 UNI_EVT_STATUSES ........................................................................................... 74
10.1.9 UNI_EVT_VARIABLES .......................................................................................... 75
10.2 Tables techniques de la base de donnes ................................................................... 75
10.2.1 UNI_EVT_EXTRACTIONS ..................................................................................... 75
10.2.2 UNI_EVT_LOG ....................................................................................................... 75
10.2.3 UNI_EVT_PURGES ............................................................................................... 76
10.2.4 UNI_EVT_REPORTS ............................................................................................. 76
10.2.5 UNI_TECH_REPORTS .......................................................................................... 76
11 A propos d'Automic, de la communaut et des services ......................................... 78
11.1 La socit Automic Software ........................................................................................ 78
11.2 La communaut Automic .............................................................................................. 78
11.3 Centre de tlchargement ............................................................................................ 78
11.4 Support technique ......................................................................................................... 79
11.5 Formation et services ................................................................................................... 79
Chapitre 1 Release Notes | 7

1 Release Notes
Le tableau ci-dessous rcapitule l'historique des modifications. Les informations sur les corrections de
problmes et sur les problmes connus sont disponibles dans les Release Notes Workload
Automation ou en contactant le support technique d'Automic.

Date Fonctionnalits cls


11-2014 Les manuels utilisateurs de Dollar Universe changent de look pour s'intgrer dans le monde
Automic.
05-2015 Correction d'une rfrence croise
8 | Chapitre 2 Introduction

2 Introduction
Bienvenue dans le Manuel d'administration de Reporter 6 !

Reporter sintgre compltement dans linterface UniViewer. Il est compatible avec Dollar Universe
Application Server v5 et v6, ceci impose des modifications dans la structure de la base de donnes
concernant les nouvelles fonctionnalits suivantes :
Identifiants des tches
Nouvel historique des interventions
Reporter bnficie des amliorations sur lextraction de lAudit Trail et dun rle ddi dans la gestion
de la scurit par UniViewer Management Server.

2.1 qui sadresse ce manuel ?


Ce document est destin ladministrateur qui doit installer, configurer et maintenir le produit
Reporter. Il ne dtaille pas son utilisation partir de linterface graphique UniViewer.
Afin de tirer le meilleur parti de ce document, le lecteur doit connatre :
Dollar Universe Application Server (installation, administration, utilisation)
UniJob (installation, administration, utilisation)
UniViewer Console
Ladministration de bases de donnes
Les modles de rapport

2.2 Contenu de ce manuel


Ce document dcrit Reporter:
Larchitecture et les concepts
Linstallation, la configuration et ladministration
Les commandes de dclenchement des extractions, de gnration des rapports et de gestion
de la base de donnes
La rsolution des problmes
Le modle des donnes
Chapitre 3 Concepts et Architecture | 9

3 Concepts et Architecture

3.1 Concepts
Cette section prsente la terminologie essentielle lie au produit.

3.1.1 Source de donnes


Une source de donnes (dfinie par une Socit, un Nud, un Espace) correspond au serveur I/O de
Dollar Universe ou dUniJob. Les donnes peuvent tre extraites dune source de donnes ou de
plusieurs sources de donnes en parallle.

3.1.2 Extraction
Reporter extrait les donnes dexploitation de sources de donnes et les charge dans la base de
donnes.
Le terme "Extraction" dsigne laction dextraction des donnes, et non les donnes extraites elles-
mmes. Une Extraction est identifie par sa source (Socit/Nud/Espace), une date de dbut et
une date de fin. Lutilisateur peut contrler uniquement la date de dbut tant donn que lextraction
se termine une fois que toutes les donnes dexploitation ont t charges depuis les sources de
donnes cibles.

Pour les nuds UniJob, la Socit est toujours UNIJOB et lEspace est toujours X.

Les Extractions peuvent tre dclenches pour un nud individuel ou pour des groupes de nuds.

3.1.3 Contenu de la base de donnes


Les donnes extraites par Reporter concernent uniquement les vnements lis aux oprations,
contrairement aux paramtres dordonnancement (voir le manuel Utilisateur de Publisher). Les
donnes extraites par Reporter comprennent les donnes de surveillance des jobs, les lancements
futurs, lhistorique dexcution, les logs des jobs, l'audit trail, etc.
Les donnes extraites sont charges dans une base de donnes. La base de donnes est identifie
par les informations suivantes :
Le type de base de donnes
Le nom dhte du serveur
L'identifiant global de la base de donnes
Un serveur Reporter ne peut accder qu une seule instance dune base de donnes.

3.1.4 Groupe de nuds


Un Groupe de nuds est un ensemble de nuds du mme type de produit (cest--dire UniJob ou
Dollar Universe). Les Groupes de nuds permettent lutilisateur de ne pas avoir besoin de spcifier
les Nuds cibles individuels pour chaque extraction.
Les Nuds peuvent tre inclus dans un Groupe de nuds par des filtres sur le nom de Nud, le
systme dexploitation, ou des tiquettes.
10 | Chapitre 3 Concepts et Architecture

3.1.5 Rapport
Un rapport est gnr partir dun modle de rapport en utilisant ses critres de slection : fentre de
rapport, Socit, Nud, Espace, statut, etc.
Le mme modle peut tre utilis pour crer plusieurs rapports avec diffrents filtres et critres de
slection.
Les rapports peuvent tre gnrs manuellement et planifis depuis UniViewer.
Ils peuvent tre prsents au format PDF et/ou HTML, et envoys par courrier lectronique.

3.1.6 Modle de rapport


Une slection de modles de rapports est propose afin de rpondre aux exigences suivantes :
Statuts des Jobs
Charge du systme
Tendances en matire de charge
Charges moyennes
Tendances en matire de russite/dchec
Excutions les plus longues
cart par rapport au temps elapsed
Les modles de rapport sont dcrits dans le manuel utilisateur de Reporter.

3.1.7 Etiquette
Les tiquettes sont des attributs lis un Nud, qui peuvent tre utiliss pour filtrer tous les Nuds
ayant la mme tiquette. Par exemple, l'tiquette peut tre utilise pour reprsenter une application
ou un domaine fonctionnel.

3.2 Composants de larchitecture


Cette section dcrit les principaux composants de larchitecture.
Chapitre 3 Concepts et Architecture | 11

Figure 1 : Architecture UniViewer et Reporter v6

1. Lutilisateur se connecte un Management Serveur UniViewer (UVMS). L'UVMS transmet les


dtails de la connexion au serveur Reporter.
2. En ce qui concerne Dollar Universe, l'UVMS contient la liste des nuds et des Groupes de
nuds associs. Le gestionnaire Reporter recherche la liste des sources de donnes auprs
de l'UVMS et adresse directement les serveurs I/O cibles afin dextraire les donnes
dexploitation de Dollar Universe.
3. En ce qui concerne UniJob (v1.3 et suivants), plusieurs UVMS peuvent tre installs, chacun
grant un certain nombre de serveurs UniJob diffrents. Chaque UVMS gre la configuration
de ses UniJob associs et lextraction de ses donnes dexploitation.

3.2.1 UniViewer Console (UVC)


UniViewer Console assure linterface utilisateur graphique de Reporter avec les fonctions Reporter
suivantes :
Dclaration du serveur Reporter et des paramtres de la base de donnes Reporter
Dclaration des nuds DUAS et UniJob
Ordonnancement/surveillance des extractions partir d'un ou de plusieurs DUAS ou serveurs
UniJob
Dfinition des rapports
Gnration/surveillance des rapports

3.2.2 Serveur Reporter


Le serveur Reporter gre :
Laccs la base de donnes Reporter
Le processus dextraction de Dollar Universe et dUniJob
12 | Chapitre 3 Concepts et Architecture

La dfinition et la gnration des rapports


Les Extractions et les Rapports peuvent tre dclenchs manuellement ou planifis pour tre
excuts de manire rgulire, depuis la console UniViewer.

3.2.3 UniViewer Management Serveur (UVMS)


Le Management Serveur UniViewer stocke les donnes ncessaires pour la console UniViewer,
comme la liste des Nuds (Dollar Universe et UniJob), accessible depuis la console UniViewer, et
lemplacement du serveur Reporter.
Le nombre dUVMS installer dpend entirement des exigences du client. Au moins un UVMS est
ncessaire. Quatre UVMS sont illustrs sur le schma darchitecture ci-dessus, dans lunique but de
pouvoir distinguer les diffrentes sections du diagramme. Un UVMS peut tre suffisant.

3.2.4 La base de donnes


Reporter extrait des donnes compltes provenant dun large panel de sources (Dollar Univers v5 et
v6, UniJob) et les charges dans une base de donnes relationnelle hors ligne (Oracle ou MS SQL
Server).
Le serveur Reporter se connecte la base de donnes pour stocker les donnes extraites avec une
description de l'extraction.
Le serveur Reporter se connecte la base de donnes pour gnrer des rapports construits partir
des donnes extraites.
Chaque serveur Reporter ne peut accder qu une seule instance de base de donnes.

3.2.5 Dollar Universe Application Serveur (DUAS)


Les donnes dexploitation sont extraites par Reporter sur un ou plusieurs DUAS et sont charges
dans la base de donnes historique hors ligne de Reporter, dans laquelle elles permettent au client
de crer des rapports long terme.
Le serveur dapplication Dollar Universe v6 senregistre auprs dun UVMS lors de son installation, de
faon similaire aux serveurs UniJob. Seul un serveur dapplication Dollar Universe v5 doit tre dclar
manuellement, les autres peuvent tre imports en une seule fois partir du nud dclar.

3.2.6 Lordonnanceur interne


Lordonnanceur interne (UniJob ou Dollar Universe Application Server v6) permet que les extractions
et la gnration des rapports puisse tre planifie directement depuis linterface sans avoir besoin
dcrire de commandes ni de les inclure dans des Uprocs.

3.2.7 Le client Reporter pour Dollar Universe


Le client Reporter pour Dollar Universe offre des commandes en ligne afin de pouvoir automatiser les
extractions et la gnration de rapports avec Dollar Universe.
Les commandes en ligne de Reporter travaillent directement avec UVMS, elles requirent donc les
donnes de connexion UVMS en paramtre.
Chapitre 3 Concepts et Architecture | 13

3.2.8 UniJob (UJ)


UniJob senregistre auprs dun UVMS lors de son installation. Reporter supporte lutilisation de
plusieurs Management Serveurs UniViewer. Dans ce cas, un UVMS dirige un groupe dUniJob,
renvoie les informations de configuration (comme les Groupes de nuds) vers le serveur Reporter et
gre lextraction des donnes depuis ses UniJob. Les donnes extraites sont transmises par lUVMS
au serveur Reporter, qui centralise la phase de chargement de la base de donnes.

3.2.9 Le client Reporter pour UniJob


Le client Reporter pour UniJob est compos de commandes permettant UniJob dinteragir avec le
serveur Reporter pour dclencher des Extractions et des Rapports.
Le client Reporter pour UniJob doit tre install sur l'UniJob dclar au sein du Management Serveur
UniViewer comme tant lordonnanceur interne. Il permet dautomatiser les tches courantes de
Reporter. Les Extractions, la gnration de rapports et les purges de la base de donnes peuvent
tre automatises de manire simple depuis linterface UniViewer, sans aucun script.
14 | Chapitre 4 Installation

4 Installation
Deux kits dinstallation distincts sont disponibles :
InstallShield pour Windows
Script d'installation pour Linux
Chaque kit peut tre utilis pour installer trois composants diffrents :
Serveur Reporter
Client Reporter pour UniJob : ce module doit tre install sur l'UniJob dclar comme tant
lordonnanceur interne, quil soit local ou distant du serveur Reporter.
Lordonnanceur interne permet dautomatiser les tches courantes de Reporter directement
depuis linterface utilisateur UniViewer.
Client Reporter pour Dollar Universe : ce module doit tre install sur le serveur Dollar
Universe dclar comme tant lordonnanceur interne, quil soit local ou distant du serveur
Reporter.
Les dialogues dinstallation Windows et Linux sont diffrents et sont donc dcrits sparment dans ce
chapitre.

4.1 Configuration matrielle

4.1.1 Serveur Reporter


La machine ddie au serveur Reporter doit disposer des ressources minimum suivantes :
1 Go de RAM
150 Mo despace libre sur le disque dur
Fichier dchange de 2 Go

Les niveaux de ressources spcifis sont bien entendu des valeurs minimum. Les vritables
ressources exiges dpendent de linstallation des diffrents composants, du nombre de
sources de donnes, du nombre de Management Serveurs UniViewer grant les sources de
donnes, du volume des donnes extraites et charges, de la frquence, de la complexit et
de la taille des rapports gnrs.

4.1.2 Serveur de base de donnes


La machine ddie la base de donnes doit disposer des ressources minimum suivantes. Les
niveaux de ressources minimum ne tiennent pas compte de la taille de la base de donnes
ncessaire pour accepter les volumes de donnes prvus.
1 Go de RAM
4 Go despace libre sur le disque dur
Fichier dchange de 2 Go
Chapitre 4 Installation | 15

4.1.3 Client Reporter pour UniJob/Dollar Universe


Le client Reporter pour UniJob/Dollar Universe permet laccs au mode commande de Reporter et
cre des jobs spcifiques dans UniJob/DUAS. Il peut automatiser les Extractions et la gnration des
rapports ainsi que les tches habituelles de maintenance. Le client Reporter peut tre install sur
nimporte quel UniJob/DUAS correctement configur. Les processus dExtraction sont situs sur le
serveur Reporter. Le client Reporter nest utilis que pour dclencher lextraction.

4.1.4 Source de donnes


Il nexiste aucune contrainte particulire quant aux sources de donnes cibles. Les Extractions sont
conues de faon tre excutes dans le cadre de processus faible priorit, afin de ne pnaliser
aucune autre activit sur le Nud cibl.

4.2 Configuration logicielle


Pour plus dinformations sur les systmes dexploitation, sur les logiciels tiers et sur la compatibilit
avec les autres produits, reportez-vous la matrice de compatibilit ("Compatibility Matrix")
accessible sur le site du Service Clients, dans longlet "Content".

4.2.1 Java
La variable PATH doit inclure le chemin vers les binaires Java, ou le rpertoire JAVA_HOME doit tre
dclar. Si aucun des deux nexiste, le dialogue dinstallation demande lutilisateur de spcifier
lemplacement des binaires Java.
Reportez-vous la page suivante http://java.com/en/download/help/ie_online_install.xml pour plus de
dtails sur le tlchargement de Java.

4.2.2 Pilotes JDBC


Vous devez installer le pilote JDBC correspondant la base de donnes installe qui sera utilise par
Reporter.

Base de donnes Nom du pilote lien


Oracle 11g ojdbc5.jar Oracle Database 11g JDBC Drivers sur www.oracle.com
SQL Server sqljdbc4.jar Microsoft SQL Server JDBC Driver 4.0 sur www.microsoft.com

La base de donnes doit tre accessible depuis la machine du serveur Reporter.


Les serveurs Reporter installs sur des machines Linux ne supportent que les bases de donnes
Oracle.

4.2.3 Jeu de caractres de la base de donnes


Unicode UTF-8
16 | Chapitre 4 Installation

4.3 Vrifications prliminaires


Pour installer le serveur Reporter :
Sous Windows, lutilisateur doit tre un administrateur.
Sous Linux, il est prfrable d'utiliser root. Si linstallation est excute sans les droits root :
o Reporter ne pourra alors tre dmarr ou arrt que par cet utilisateur.
o Le dmarrage de Reporter ne sera pas enregistr dans les fichiers de dmarrage de la
machine.
Avant de commencer :
UniViewer Console et UniViewer Management Server doivent tre installs et dmarrs.
Les serveurs Dollar Universe et UniJob doivent tre accessibles des serveurs UniViewer et
Reporter.
Un Java Runtime Environment (JRE) doit tre install.
Une base de donnes doit tre installe et accessible (Oracle ou SQL Server).
Un pilote JDBC appropri doit tre install.
Un utilisateur, disposant de droits DBA, doit exister (tous les exemples citent lutilisateur
repowner).

4.4 Installation du serveur Reporter sous


Windows
Le nom de lexcutable InstallShield est le suivant :
reporter_6.<m.bb>_windows.exe

O m est le numro de version mineure et bb est le numro de gnration.


Cliquez deux fois sur lexcutable pour lancer le programme.
Un historique des installations est maintenu en interne. La procdure dinstallation est immdiatement
avertie des composants installs et de leurs versions (suprieures v3.0).

La dtection de composants plus anciens nest pas automatique.

4.4.1 Instances multiples


Si aucune instance de Reporter nexiste, lcran daccueil est affich directement.
Plusieurs instances de Reporter peuvent tre installes.
Si une instance existante du serveur Reporter est dtecte sur la machine locale, les choix suivants
sont proposs :
Install a new instance
Maintain or upgrade an existing instance
Slectionnez "Install a new instance" si vous souhaitez installer un nouveau serveur Reporter ou si
vous souhaitez installer un client Reporter pour UniJob ou Dollar Universe.
Si vous voulez faire une mise jour, rparer ou supprimer un serveur Reporter, reportez-vous au
paragraphe "Mise jour et dsinstallation" page 39.
Chapitre 4 Installation | 17

Cliquez Next pour poursuivre


Cliquez Cancel pour abandonner linstallation.

4.4.2 Lcran daccueil


Le programme affiche lcran daccueil de la procdure InstallShield.
Cliquez Next pour poursuivre
Cliquez Cancel pour abandonner linstallation.
Les instances existantes du serveur Reporter sont affiches sil en existe.
Pour toutes les installations, slectionnez "Install a new instance" et cliquez Next.

4.4.3 Licence utilisateur


Lisez le contrat.
Cliquez sur le bouton "I accept " (Jaccepte...)
Vous ne pouvez pas poursuivre linstallation si vous nacceptez pas les termes du contrat.
Cliquez Back pour retourner lcran prcdent
Cliquez Next pour poursuivre
Cliquez Cancel pour abandonner linstallation.

4.4.4 Dfinition de lenvironnement Java (JDK ou JRE)


Saisissez le chemin du rpertoire Java Home.
Le rpertoire Java Home doit contenir un sous-rpertoire bin contenant les binaires Java. Najoutez
pas /bin au chemin.
Cliquez sur le bouton Browse pour slectionner le rpertoire dans larborescence.
Cliquez Next pour poursuivre
Cliquez Cancel pour abandonner linstallation.

4.4.5 Slectionnez le type dinstallation


Ceci dtermine si vous voulez installer le serveur Reporter ou un client Reporter pour UniJob ou
Dollar Universe.
Cliquez sur le bouton voulu :
Server installation
UniJob client installation (Client Reporter pour UniJob)
Dollar Universe 6.x client installation (Client Reporter pour Dollar Universe v6)
Au moins un serveur Reporter doit tre install ainsi quun client Reporter pour chaque source de
donnes.
Cliquez Back pour retourner lcran prcdent
Cliquez Next pour poursuivre
Cliquez Cancel pour abandonner linstallation.
18 | Chapitre 4 Installation

4.4.6 Rpertoire dinstallation du serveur Reporter


Indiquez le rpertoire dans lequel le serveur Reporter doit tre install.
Par dfaut, le serveur sera install dans :
C:\Program Files\AUTOMIC\Reporter

Utilisez le bouton Change pour slectionner un autre rpertoire.


Si le dossier spcifi contient dj une instance dun serveur Reporter, une mise jour sera
propose.
Cliquez Back pour retourner lcran prcdent
Cliquez Next pour poursuivre
Cliquez Cancel pour abandonner linstallation.

4.4.7 Informations sur le serveur Reporter


Saisissez le nom logique du serveur Reporter (max. : 64 caractres). [Hte local par dfaut].
Saisissez le nom dhte de la machine sur laquelle est install Reporter. [Hte local par
dfaut].
Saisissez le numro de port TCP rserver pour le serveur Reporter [Par dfaut : 10630].
Lenregistrement suivant est cr dans le fichier <Serveur Reporter>/mgr/uxsrsrv.alias.
<nom de nud>_REP_X 10630/tcp

Lutilisateur peut concatner ce fichier avec le fichier de services TCP du systme afin de maintenir
une visibilit centrale des ports.
Cliquez Back pour retourner lcran prcdent
Cliquez Next pour poursuivre
Cliquez Cancel pour abandonner linstallation.

4.4.8 Dfinition du pilote JDBC


Un pilote JDBC doit tre prsent pour que Reporter puisse communiquer avec la base de donnes.
Reportez-vous au paragraphe "Pilotes JDBC" page 15 pour plus de dtails sur le tlchargement du
pilote requis.
Le programme dinstallation cre un lien vers le pilote indiqu.
Utilisez le bouton Browse pour slectionner le pilote dans larborescence.
Cliquez Back pour retourner lcran prcdent
Cliquez Next pour poursuivre
Cliquez Cancel pour abandonner linstallation.

4.4.9 Prt installer le programme


Cliquez Back pour retourner lcran prcdent
Cliquez Install pour dmarrer linstallation
Cliquez Cancel pour abandonner linstallation.
Une barre de progression est affiche durant la phase dinstallation.
Chapitre 4 Installation | 19

4.4.10 Procdure InstallShield termine


Cliquez Finish pour fermer la fentre InstallShield.
Le serveur Reporter est dmarr automatiquement.

4.5 Installation du client Reporter pour UniJob


ou Dollar Universe sous Windows
Double cliquez sur le kit dinstallation. Reportez-vous la section "Installation du serveur Reporter
sous Windows".

4.5.1 Dossier de destination


Parcourez le systme de fichiers jusqu atteindre le rpertoire racine dune installation UniJob ou
Dollar Universe existante.
Le rpertoire reporter_client sera cr dans le rpertoire racine dUniJob ou de Dollar Universe.

4.5.2 Informations sur le serveur Reporter


Prcisez les dtails du serveur Reporter qui a t install au paragraphe "Informations sur le serveur
Reporter".
Saisissez le nom logique du serveur Reporter (max. : 64 caractres). [Par dfaut : hte local].
Saisissez le nom dhte de la machine sur laquelle est install Reporter. [Par dfaut : hte
local].
Saisissez le numro de port TCP rserv pour le serveur Reporter [Par dfaut : 10630].
Le numro de port TCP rserv pour le serveur Reporter se trouve dans le fichier :
<Serveur Reporter>/mgr/uxsrsrv.alias

Cliquez Next pour poursuivre


Cliquez Cancel pour abandonner linstallation.

4.5.3 Confirmer linstallation


Cliquez Install pour dmarrer linstallation du client Reporter pour UniJob/Dollar Universe.

4.5.4 Procdure InstallShield termine


Cliquez Finish pour fermer la fentre InstallShield.
20 | Chapitre 4 Installation

4.6 Installation du serveur Reporter sous


Linux
Un inventaire des installations est actualis en interne dans le rpertoire :
/var/opt/AUTOMIC/.Installer/Reporter

La procdure dinstallation est immdiatement avertie des composants installs et de leurs


versions. Cependant, la dtection des composants antrieurs v3.0 nest pas automatique.

Le nom du kit est le suivant :


reporter_6.<m.bb>_all_unix.taz

O m est le numro de version mineure et bb est le numro de gnration.


Le kit est fourni au format tar compress.
1. Copiez le kit dans un rpertoire de travail.
2. Dcompressez le kit et extrayez larchive tar :
tar xvzf reporter_6.<m.bb>_all_unix.taz

Le kit extrait se trouve dans le sous-rpertoire reporter_6.<m.bb>_all_unix.


La procdure unirun (reporter_6.<m.bb>_all_unix/unirun) peut tre lance de 3 faons:
-i : Installation d'une instance
-u : Mise jour d'une instance
Pour ces deux modes, les options suivantes peuvent tre utilises :
o -r : mode enregistrement (optionnel), incompatible avec s
Le mode enregistrement est interactif et enregistre les rponses de lutilisateur dans un
fichier de rponses. Le mode enregistrement requiert largument f <fichier de rponses>.
o -s : mode silencieux (optionnel), incompatible avec r
Le mode silencieux nest pas interactif. Il utilise les rponses enregistres par lutilisateur
dans le fichier de rponses. Le mode silencieux requiert largument f <fichier de
rponses>. Les installations en mode silencieux peuvent tre excutes partir dun
fichier de commandes excut en batch sans interaction de lutilisateur.
-d : dsinstallation d'une instance
-h : affiche l'aide en ligne de la commande.
Exemple de commande dinstallation:
./unirun i

Exemple de commande dinstallation et denregistrement dun fichier de rponses :


./unirun i r f <fichier de rponse>

Exemple de commande dinstallation en mode silencieux :


./unirun i s f <fichier de rponse>

4.6.1 Choix de linstallation


You can install a new , upgrade or remove an existing one .
Please enter your choice:
--> Please enter "i" to install, "u" to upgrade or "d" to delete an instance
?
Tapez :
Chapitre 4 Installation | 21

"i" pour installer Reporter


"u" : reportez-vous au paragraphe "Mise jour de Reporter sous Linux" page 44
"d" : reportez-vous au paragraphe "Dsinstaller le serveur Reporter sous Linux" page 46

4.6.2 Contrat de licence logicielle de Reporter


# ----------------------------------------------------------------------
# AUTOMIC licence agreement:
# Please, read AUTOMIC licence agreement, press <space bar> to read next
page

# Press return to continue


Tapez Entre pour afficher la premire page.
Tapez Espace pour afficher les pages suivantes.
Do you accept the agreement ?
--> ("y" to accept, "n" to decline and abort procedure)?
Vous ne pouvez pas poursuivre linstallation du serveur Reporter si vous nacceptez pas les termes
du contrat.
Si vous voulez plus dinformations, contactez le support technique.

4.6.3 Slection du type dinstallation


_______________________________________________________

Reporter Installation (c) AUTOMIC 2011


_______________________________________________________

Please select the installation type


- Server installation [s]
- Client installation for Dollar Universe [d]
- Client installation for UniJob [u]
Saisissez:
"s" pour installer le serveur Reporter,
"u" pour installer le client Reporter pour UniJob, reportez-vous au paragraphe "Installer le
client Reporter pour UniJob sous Linux" page 23
"d" pour installer le client Reporter pour Dollar Universe, reportez-vous au paragraphe
"Installer le client Reporter pour Dollar Universe sous Linux" page 24.
Pour poursuivre la procdure de mise jour reportez-vous au paragraphe "Mise jour de Reporter
sous Linux" page 44.

4.6.4 Emplacement de la commande java


Provide the path to the directory containing Jre/Jdk.
it must contain a "bin" folder with the java command inside:
Location of the java folder [] :

4.6.5 Nom du serveur Reporter


Server Name (Max: 64 characters) [<LOCAL HOST>] :
Saisissez le nom logique du serveur Reporter (max: 64 caractres). [Dfaut: localhost].
22 | Chapitre 4 Installation

Si une instance du serveur Reporter a dj t installe pour ce nom de nud logique, le message
derreur suivant est affich :
" Data found in
/var/opt/AUTOMIC/.Installer/Reporter/server/OOV/Reporter.installer
You cannot install with that server name "OOV" because there is already an
instance registered using that ID."

4.6.6 Rpertoire dinstallation


Installation directory [/var/opt/AUTOMIC/Reporter/<LOCAL HOST>] :
Cest le rpertoire racine de linstallation.

4.6.7 Nom dhte du serveur Reporter


Change the "Reporter Server Host Name" only if you need to set a different
logical network name
(useful for cluster configuration).
Reporter Server Host Name [<LOCAL HOST>] :
Tapez Entre pour utiliser le nom dhte local par dfaut. Il nest gnralement ncessaire de
modifier cette valeur que dans le cas dune configuration cluster.

4.6.8 Numro de port du serveur Reporter


Port Number (Range: 1023 to 65535) [10630] :
Saisissez le numro de port TCP rserv pour le serveur Reporter [Dfaut : 10630].
Lenregistrement suivant est cr dans le fichier <Serveur Reporter>/mgr/uxsrsrv.alias.
<nom de noeud>_REP_X 10630/tcp

4.6.9 Chemin daccs au fichier du pilote JDBC


Enter the FULL path to the JDBC driver file.
Reporter uses the JDBC driver to communicate with the database (Oracle or MS
SQL Server)
If you can't find the driver file (ojdbc*.jar or sqljdbc*.jar), download it
from the db vendor website.

JDBC driver file path []:


Un pilote JDBC est requis pour que Reporter puisse communiquer avec la base de donnes.
Reportez-vous au paragraphe "Pilotes JDBC" page 15 pour plus de dtails sur le tlchargement du
pilote requis.
Le programme dinstallation tablit un lien sur lemplacement du pilote indiqu. La procdure attend le
chemin et le nom du fichier du pilote.
Exemple de chemin du fichier du pilote JDBC :
/mnt/hgfs/Shared/ojdbc14.jar

4.6.10 Confirmer linstallation


Installation of instance <nom de noeud> in /var/opt/AUTOMIC/Reporter/<Node
Name> is ready to start.
Press Enter to continue:
Chapitre 4 Installation | 23

Tapez Entre pour dmarrer la procdure dinstallation.


Le serveur Reporter est dmarr automatiquement.

4.7 Installer le client Reporter pour UniJob


sous Linux
Les extractions et les gnrations de rapport peuvent tre planifies directement partir de linterface
de Reporter. Pour que cela fonctionne, lordonnanceur interne doit tre dclar dans les paramtres
nud de Reporter.
Lordonnanceur interne ne doit pas ncessairement rsider sur la mme machine que le serveur
Reporter.
Le client Reporter doit tre install sur l'UniJob dclar comme lordonnanceur interne, que le produit
soit install localement ou distance.

4.7.1 Chemin daccs linstallation dUniJob


Ceci est le rpertoire racine du produit UniJob dans lequel le sous-rpertoire reporter_client sera
cr. Dans le cas dUniJob, le rpertoire racine est :
<rpertoire dinstallation>/UNIJOB/<nom de nud>

La procdure recherche alors le fichier values.xml dans le sous-rpertoire data pour vrifier que
lemplacement correct a t spcifi.

4.7.2 Nom du serveur Reporter


Saisissez le nom de nud logique du serveur Reporter (max: 64 caractres). [dfaut : localhost].

4.7.3 Nom dhte du serveur Reporter


Par dfaut, le nom dhte local est utilis. Ne changez le "Reporter Server Host Name" que si vous
voulez spcifier un nom rseau logique diffrent, par exemple dans le cas dune configuration cluster.

4.7.4 Numro de port IP du serveur Reporter


Saisissez le numro de port TCP rserv pour le serveur Reporter [dfaut : 10630].
Le numro de port TCP rserv pour Reporter peut tre trouv dans le fichier <Serveur
Reporter>/mgr/uxsrsrv.alias.

4.7.5 Confirmer linstallation


Saisissez Y pour poursuivre ou N pour abandonner linstallation.
24 | Chapitre 4 Installation

4.8 Installer le client Reporter pour Dollar


Universe sous Linux
Les extractions et les gnrations de rapport peuvent tre planifies directement partir de linterface
de Reporter (reportez-vous au manuel utilisateur de Reporter). Pour que cela fonctionne,
lordonnanceur interne doit tre dclar dans les paramtres nud de Reporter.
Lordonnanceur interne ne doit pas ncessairement rsider sur la mme machine que le serveur
Reporter.
Le client Reporter pour Dollar Universe doit tre install sur le serveur Dollar Universe dclar comme
lordonnanceur interne, que le produit soit install localement ou distance.

4.8.1 Prrequis sous Linux


La procdure d'installation doit tre lance sous le compte de l'administrateur de la Socit
Dollar Universe cible
Le rpertoire /var/opt/ORSYP/.Installer doit tre accessible en lecture et criture pour le
compte de l'administrateur Dollar Universe.

4.8.2 Emplacement de la commande java


Provide the path to the directory containing Jre/Jdk.
it must contain a "bin" folder with the java command inside:
Location of the java folder [] :

4.8.3 Rpertoire de la Socit Dollar Universe


Saisissez le chemin daccs au rpertoire dinstallation de la Socit Dollar Universe. Ceci est
ncessaire pour rcuprer lenvironnement logique de la Socit. Le sous-rpertoire reporter_client
sera cr dans le rpertoire racine de la Socit.

4.8.4 Nom du serveur Reporter


Saisissez le nom logique du serveur Reporter (max : 64 caractres).
Le fichier <rpertoire dinstallation>/Reporter/<nud>/mgr/uxsrsrv.sck du serveur Reporter contient
linformation suivante :
Nom_du_serveur_Reporter Nom_dhte

4.8.5 Nom dhte du serveur Reporter


Saisissez le nom dhte de la machine supportant le serveur Reporter. Notez que le serveur Reporter
doit tre install pour un nom dhte flottant dans une configuration cluster.

4.8.6 Numro de port IP du serveur Reporter


Saisissez le numro de port TCP rserv pour le serveur Reporter [dfaut : 10630].
Ce numro peut tre trouv dans le fichier <rpertoire
dinstallation>/Reporter/<nud>/mgr/uxsrsrv.alias.
Chapitre 4 Installation | 25

4.8.7 Confirmer linstallation


Tapez Entre pour poursuivre ou toute autre touche pour abandonner linstallation.
26 | Chapitre 5 Configuration

5 Configuration
Linitialisation de Reporter requiert :
Une cl de licence
Une configuration rseau
La cration dun utilisateur de la base de donnes
La gnration du schma de la base de donnes
Le dmarrage du serveur Reporter
La dclaration de la liste des UniViewer Management Servers connus du serveur Reporter
Des paramtres de base de donnes valids

5.1 Licence
Les cls de licence de Reporter sont gres sur UniViewer Management Server.
La cration dune licence valide pour Reporter a pour effet dafficher les activits lies Reporter
("BD Reporter" en mode Administration et "Rapports" en mode Rapports) dans linterface UniViewer
Console.
Consultez la documentation dUniViewer ou laide en ligne pour obtenir des instructions sur la faon
de saisir la cl de licence :
Mode Administration > Nuds > Management Server > Paramtres nud > Licences.

5.2 Configuration rseau


Le port TCP rserv pour le serveur Reporter est dclar localement dans le fichier :
<Serveur Reporter>/mgr/uxsrsrv.alias.
Le nom logique du nud Reporter est traduit en nom de nud physique dans le fichier :
<Serveur Reporter>/mgr/uxsrsrv.sck.
Ces fichiers ne contiennent pas de dtails sur les nuds des sources de donnes. Ces informations
sont enregistres dans la liste des nuds sur UniViewer Management Server et sont accessible avec
linterface UniViewer.
Les fichiers ci-dessus sont personnaliss pendant linstallation. Aucune action supplmentaire nest
requise.

5.3 Configuration du schma de la base de


donnes
La cration dune instance de base de donnes ddie (tous les exemples se rfrent une instance
de BD nomme REPDB) est recommande.
Reportez-vous votre administrateur de base de donnes pour vous assistez dans cette tche. Vous
pouvez suivre la procdure dcrite dans le manuel dadministration de la base de donnes.
Chapitre 5 Configuration | 27

5.3.1 Cration de lutilisateur


La cration dun utilisateur de la base de donnes ddie repowner ayant le rle DBA, utilis pour
initialiser la base de donnes (paragraphe suivant) est recommande. Le serveur Reporter se
connecte avec cet utilisateur pour charger les donnes dans les tables de la base de donnes et
gnrer les rapports. Les exemples se rfrent lutilisateur "REPOWNER".

5.3.2 Initialisation de la base de donnes


Pendant le processus dinstallation, les scripts de cration sont gnrs dans le rpertoire <Server
Reporter >/dbscripts/<dbtype>. Lexcution du script appropri dans la ligne de commande SQL de la
base de donnes cre les tables dans lesquelles Reporter enregistrera les donnes.
Cette initialisation cre les tables auxquelles le serveur Reporter accde lors de la lecture, la
modification et la purge des tables de la base de donnes.
Les index, les procdures stockes et les dclencheurs sont galement crs. Ni le serveur Reporter
ni les logiciels tiers ne ncessitent laccs ces informations.

5.3.2.1 Initialisation Oracle


Le script create_db_oracle.sql doit tre excut avec loutil Oracle sqlplus :
Dans une fentre de commandes, excutez la commande suivante pour ouvrir une connexion
la base de donnes :
sqlplus <repowner>/<mot de passe>@<REPDB>

Excutez le script avec la commande suivante :


SQL> @<Server Reporter>/dbscripts/oracle/create_db_oracle.sql

Si le chemin daccs contient des espaces, excutez le script partir du rpertoire local.

5.3.2.2 Initialisation MS SQL


Le script create_db_mssql.sql peut tre excut avec les outils MS SQL Server osql (obsolte) ou
sqlcmd. Dans une fentre de commandes, excutez la commande suivante :
osql U <repowner> P <mot de passe> D <REP DB> i <Server
Reporter>/dbscripts/mssqlserver/create_db_mssql.sql

Ou :
sqlcmd U <repowner> P <mot de passe> d <REP DB> i <Server
Reporter>/dbscripts/mssqlserver/create_db_mssql.sql

5.3.3 Vrification des droits des utilisateurs sur les tables


Lutilisateur repowner de la base de donnes doit avoir les droits SELECT, INSERT, UPDATE et
DELETE sur toutes les tables de la base de donnes. Reportez-vous au paragraphe Modle de
donnes de Reporter v6" page 67 pour la liste et le contenu des tables de la base de donnes.
28 | Chapitre 5 Configuration

5.4 Dmarrer et arrter le serveur Reporter


Sous Windows : le serveur Reporter est un service dmarr sous le compte systme local. Par
dfaut, le service Reporter est dmarr au dmarrage du systme. Ladministrateur systme peut
modifier ce comportement dans la console des services Windows.
Sous Linux : s'il a t install sous root, le serveur Reporter est dmarr en tant que daemon.
Les commandes pour dmarrer et arrter le serveur sont situes dans le rpertoire <Serveur
Reporter>/exec :
Pour dmarrer le serveur, utilisez le script :
o unistartrep.bat sous Windows
o unistartrep sous Linux.
Pour arrter le serveur, utilisez le script :
o unistoprep.bat sous Windows
o unistoprep sous Linux.
Pour vrifier le statut du serveur Reporter :
o unicheckrep.bat sous Windows
o unicheckrep sous Linux.
Pour afficher la version du serveur Reporter :
o unirepinfo.bat sous Windows
o unirepinfo sous Linux.

Sous Windows, le serveur Reporter peut tre dmarr ou arrt par le menu Windows >
Programmes > AUTOMIC > Reporter server <nom du nud> Start ou Stop (Excuter en tant
qu'administrateur).

5.5 Initialiser la scurit de Reporter

5.5.1 Droits des utilisateurs


Deux rles de la scurit sont livrs lors de linstallation de Reporter :
Reporter [nom de nud] Administrator
Reporter [nom de nud] Reader
Par dfaut, ces rles doivent tre assigns de la faon suivante aux groupes de la scurit :
Le rle Reporter Administrator doit tre attribu au groupe Administrators.
Le rle Reporter Reader doit tre attribu au groupe Developers.
Le rle Reporter Reader doit tre attribu au groupe Operators.
Vrifiez que le rle Administrator a t attribu au groupe Administrators, sans quoi laccs aux
paramtres nuds de Reporter sera impossible. Reportez-vous au manuel utilisateur dUniViewer
Console pour plus de dtails sur les paramtres de scurit.
Chapitre 5 Configuration | 29

5.5.2 Communications SSL


A des fins de confidentialit et d'intgrit des donnes, les communications entre les diffrents
composants de l'architecture peuvent tre scurises l'aide du protocole SSL.
Les versions minimum des composants supportant SSL sont :
UVMS v4
UVC v4 (direct, web start et web console/gateway)
DUAS v6 et les managers associs
Reporter v4
L'architecture et les principes sont dcrits dans le manuel d'administration d'UniViewer. La mise en
uvre de SSL dans Reporter est similaire celle dcrite pour UVMS.

Les quelques diffrences qui peuvent apparaitre sont lies aux technologies utilises qui sont
diffrentes pour les deux produits : UVMS et Reporter utilisent java, DUAS utilise Open SSL.

5.5.2.1 Certificats
Reporter supporte les certificats suivants au format DER ou Base 64:
les chanes de certificats (fichier .p7b)
les certificats simples : certificats serveur et certificat CA (fichier .cer ou .crt)

Dans le cas de l'utilisation de certificats simples, les certificats CA doivent tre imports
AVANT les certificats serveur.

Certificat serveur :
o Nom d'hte spcifique
o Caractre gnrique * dans le CN
o Extensions SANs : nom d'hte et adresse IP
Certificat CA
o Gestion des chaines de certificats : Certificats CA additionnels
Reportez-vous au manuel d'administration d'UniViewer pour la description des certificats.

5.5.2.2 Configurations SSL


Si SSL est activ sur Reporter, toutes les communications entrantes devront tre au format SSL.
Si SSL n'est pas activ sur Reporter, toutes les communications entrantes devront tre en clair.

Pour que Reporter puisse extraire des donnes de nuds DUAS v6 configurs en SSL, il doit
tre configur en SSL.

Si Reporter est configur en SSL, les communications suivantes seront au format SSL :
Reporter <-> UVMS
Reporter -> DUAS v6 (SSL)
Client Reporter pour Dollar Universe -> Reporter
UVC -> Reporter
Mme si Reporter est configur en SSL, les communications suivantes seront en clair :
Reporter -> DUAS v6 (non SSL)
30 | Chapitre 5 Configuration

Reporter -> DUAS v5


Reporter -> UniJob v1

5.5.2.3 Configuration SSL de Reporter


La configuration SSL d'un serveur Reporter est ralise l'aide de la commande unissl du serveur
Reporter. Les tapes suivantes sont ncessaires pour configurer un serveur Reporter en SSL :
1. Crer le keystore
Excuter la commande :
unissl GENSTORE

2. Gnrer une paire Cl publique / Cl prive sur le serveur


Excuter la commande :
unissl GENKEY

Pour enregistrer la paire cl publique/cl prive dans le keystore, protg par un mot de
passe
3. Gnrer une requte de signature de certificat (CSR) sur le serveur
Excuter la commande :
unissl GENCSR

Pour gnrer le fichier (au format PKCS#10) contenant la requte


4. Envoyer la requte (CSR) l'autorit de certification
Envoyer le fichier l'autorit de certification
5. Recevoir le certificat du serveur sign par l'autorit de certification
Rcuprer le certificat sign de l'autorit de certification
6. Installer les certificats
Excuter la commande :
unissl IMPORT

Pour installer les certificats dans le keystore du serveur


7. Arrter Reporter
8. Activer SSL
Excuter la commande :
unissl SET

9. Redmarrer Reporter pour prendre en compte les modifications.

Lorsque la configuration SSL est termine, le serveur Reporter doit tre redmarr.

D'autres options de la commande unissl permettent d'activer/dsactiver SSL, de lister ou de


supprimer les cls et les certificats, de modifier le mot de passe.

5.5.2.4 Configuration SSL du client Reporter pour Dollar Universe


Si le serveur Reporter est configur en SSL, le client Reporter pour Dollar Universe v6 doit galement
tre configur pour communiquer en SSL avec le serveur Reporter.
Reportez-vous au paragraphe "Activer / dsactiver SSL sur le client Reporter" page 34.
Chapitre 5 Configuration | 31

5.5.2.5 unissl
Cette commande permet de configurer SSL pour le serveur Reporter; la mme commande existe
pour tous les serveurs pour lesquels SSL doit tre configur.
Elle est situe dans le sous-rpertoire exec du serveur Reporter.

Aide en ligne
Pour afficher la liste des mots cls tapez : unissl sans arguments :
./unissl
Choose the proper object:
unissl SET to enable/disable SSL
unissl GENSTORE to generate the keystore
unissl GENKEY to generate public/private keys
unissl GENCSR to generate a certificate request
unissl IMPORT to import a certificate
unissl LIST to list the content of the keystore
unissl DELETE to delete an entry
unissl KEYPASSWD to change the keystore password
Pour afficher l'aide en ligne, tapez : unissl MOTCLE help. Par exemple :
./unissl GENSTORE -help
usage: unissl genstore
-help display command line help
-pwd <arg> Password for the new Keystore

Gnrer le keystore
Cette commande permet de gnrer le keystore qui doit accueillir les certificats et les cls.
Syntaxe :
unissl GENSTORE pwd <val>

Paramtre Description
-pwd <val> Mot de passe du keystore. Si cet argument n'est pas saisi il sera demand interactivement
l'utilisateur.
Ce mot de passe sera utilis par toutes les commandes unissl
-help Affiche l'aide en ligne de la commande

Un seul keystore peut tre dfini pour un serveur Reporter.


Le keystore "rep_store.cer" est cr dans le sous-rpertoire mgr du serveur Reporter.
Exemple :
unissl GENSTORE -pwd unissl
Keystore created successfully

Gnrer les cls


Cette commande gnre une paire de cls publique / prive pour le serveur Reporter.
Syntaxe :
unissl GENKEY dn <val> -alg <val> -size <val> pwd <val> -overwrite

Paramtres Description
-dn <val> Distinguished name. Obligatoire. Tous les composants standards X509 sont accepts
mais seul CN=<nom d'hte> est utilis.
la chane doit tre encadre de guillemets.
-alg <val> Algorithme utilis pour gnrer les cls (DSA ou RSA), RSA par dfaut
32 | Chapitre 5 Configuration

Paramtres Description
-size Taille de la cl gnre : 512, 1024, 2048 ou 4096, la valeur par dfaut est 2048
-pwd <val> Mot de passe. Optionnel, si cet argument n'est pas saisi il sera demand interactivement
l'utilisateur.
Le mot de passe est dfini par la commande unissl GENSTORE
-overwrite Permet de forcer l'crasement de la paire existante, sinon une confirmation sera
demande l'utilisateur
-help Affiche l'aide en ligne de la commande

Une seule paire peut tre cre dans un keystore.


Les cls sont stockes dans le keystore cr par la commande unissl GENSTORE.
Exemple :
unissl GENKEY dn "CN=vmstluni99.automic.com" -pwd unissl
The keys were generated successfully

Gnrer une demande de certificat


Cette commande permet de gnrer une demande de certificat sign (CSR) pour le serveur Reporter
et l'enregistre dans le fichier spcifi.
Syntaxe :
unissl GENCSR file <val> pwd <val>

Paramtres Description
-file <val> Obligatoire. Nom complet du fichier qui contiendra la demande de certificat
-pwd <val> Mot de passe. Optionnel, si cet argument n'est pas saisi il sera demand interactivement
l'utilisateur.
Le mot de passe est dfini par la commande unissl GENSTORE
-help Affiche l'aide en ligne de la commande

La commande retourne une erreur si la paire cl publique / cl prive n'existe pas sur le serveur.
Exemple :
unissl GENCSR -file
"/var/opt/AUTOMIC/Reporter/vmstluni99.automic.com/mgr/CSR.txt" -pwd unissl
The request was generated successfully
Le fichier gnr contient la demande de certificat. Ce fichier doit tre envoy l'autorit de
certification qui doit retourner :
Le certificat de l'autorit de certification
Le certificat sign pour ce serveur.

Importer un certificat
Cette commande permet d'approuver les certificats CA et d'installer le certificat du serveur Reporter.
1. Pour ajouter le certificat la liste des certificats approuvs (ncessaire pour les
communications dans lesquelles Reporter agit en tant que client : Reporter -> DUAS) :
unissl IMPORT type TRUSTEDCACERT -file <val> -alias <val> -position <val>

ou
unissl IMPORT type TRUSTEDSERVER host <val> -port <val>

2. Pour importer le certificat serveur de Reporter (ncessaire pour les communications dans
lesquelles Reporter agit en tant que serveur):
Chapitre 5 Configuration | 33

unissl IMPORT type SERVERCERT -file <val> -pwd <val> -overwrite

Paramtre Description
-type <val> Obligatoire; le type peut tre :
SERVERCERT : pour importer le certificat du serveur (fichier .cer, .crt ou .pb7)
TRUSTEDCACERT : pour importer et approuver un certificat CA (fichier .cer ou .crt) ou
pour importer et approuver un des certificats CA d'un fichier .pb7
TRUSTEDSERVER : pour importer et approuver un certificat d'autorit de certification en
se connectant un serveur distant (-host et -port)
-file <val> Obligatoire pour TRUSTEDCACERT et SERVERCERT.
Nom complet du fichier qui contient le certificat
-alias <val> Obligatoire pour TRUSTEDCACERT
Alias utilis pour l'import du certificat. L'alias permet de donner un nom au certificat
import et donc de pouvoir le supprimer si plusieurs certificats CA ont t imports.
-position Disponible pour le type TRUSTEDCACERT. Position du certificat approuver dans la
chaine de certificats si le fichier est de type .pb7
Optionnel, si cet argument n'est pas saisi il sera demand interactivement l'utilisateur.
-host <val> Obligatoire pour le type TRUSTEDSERVER. Nom d'hte du serveur.
-port Obligatoire pour le type TRUSTEDSERVER. Numro de port TCP du serveur
-overwrite Optionnel, permet de forcer l'crasement des certificats existants, sinon une confirmation
sera demande l'utilisateur
-pwd <val> Mot de passe. Optionnel, si cet argument n'est pas saisi il sera demand interactivement
l'utilisateur.
Le mot de passe est dfini par la commande unissl GENSTORE
-help Affiche l'aide en ligne de la commande

Le mot cl CHAIN n'est plus utilis depuis la version 4.0.06 de Reporter.

Le certificat de l'autorit de certification (TRUSTEDCACERT ou TRUSTEDSERVER) doit tre install


en premier sur le serveur avant de pouvoir importer le certificat sign (SERVERCERT) si celui-ci est
import partir d'un fichier .cer ou .crt.
Un seul certificat SERVERCERT peut tre enregistr dans un keystore. Cependant il est possible
dajouter autant de certificats TRUSTEDCACERT que lon dsire sa base de certificats de
confiance.
Exemple 1 : Import du certificat CA partir d'une chaine de certificats
unissl IMPORT -type TRUSTEDCACERT -file
"/var/opt/AUTOMIC/Reporter/vmstluni99.automic.com/mgr/certnew.p7b" -alias
ECA
Enter the Keystore password:

The chain contains 2 certificate(s)

1
Type: CA Certificate
Subject: CN=OrsypTstCA, DC=orsyptst, DC=com
Valid from: 11/05/2011
Valid to: 11/05/2016
Fingerprint (MD5): F1:9B:08:98:42:6D:A6:87:98:C3:E8:89:F0:30:CF:9A
Fingerprint (SHA1):
1E:EE:43:C9:C0:6B:59:11:E8:70:BA:F3:C2:F4:2D:B0:D0:2B:F5:1B
2 Type: Server Certificate
Subject: CN=vmstluni99.automic.com
Valid from: 18/10/2012
Valid to: 18/10/2014
Fingerprint (MD5): D7:8B:71:EF:88:51:A3:21:2A:61:16:F6:24:91:B2:95
Fingerprint (SHA1):
02:A9:78:E2:30:F3:1C:EA:8E:59:0A:6A:19:D2:8B:9C:94:09:3B:DB
34 | Chapitre 5 Configuration

Enter the position of the certificate to add to the alias "ECA" of the
Keystore or 'q' to quit: [1]
1
Import successful
Exemple 2 : import du certificat serveur partir d'une chaine de certificats
unissl IMPORT -type SERVERCERT -file
"/var/opt/AUTOMIC/Reporter/vmstluni99.automic.com/mgr/certnew.p7b"
Enter the Keystore password:

Import successful

Activer / dsactiver SSL sur le serveur Reporter


Une fois la configuration termine, cette commande indique au serveur Reporter la nouvelle
configuration SSL ou non SSL.
Le serveur Reporter doit tre arrt pour excuter cette commande ("Dmarrer et arrter le serveur
Reporter" page 28).
Syntaxe :
unissl SET enable <val> -pwd <val>

Paramtre Description
-enable <val> ON : pour activer la communication SSL du serveur Reporter
OFF pour dsactiver la communication SSL du serveur Reporter
-pwd <val> Mot de passe.
Optionnel, si cet argument n'est pas saisi il sera demand interactivement l'utilisateur.
Le mot de passe est dfini par la commande unissl GENSTORE
-help Affiche l'aide en ligne de la commande

Un certificat serveur valide doit avoir t import pour que cette commande soit excute.
Exemple 1 : Activer SSL sur le serveur Reporter
unissl set -enable on
The server needs to be stopped before executing this command. Do you really
want to continue? Y/N
y
Enter the Keystore password:

The variable has been updated successfully.


SSL will be enabled after starting the server.
Exemple 2 : Dsactiver SSL sur le serveur Reporter
unissl set -enable off
The server needs to be stopped before executing this command. Do you really
want to continue? Y/N
y
Enter the Keystore password:

The variable has been updated successfully.


SSL will be disabled after starting the server.
La commande modifie les paramtres nud du serveur Reporter (catgorie Paramtres du serveur).

Le serveur Reporter doit tre redmarr pour utiliser SSL.

Activer / dsactiver SSL sur le client Reporter


Cette commande permet de configurer le client Reporter pour Dollar Universe pour qu'il utilise (ou
pas) SSL pour sa communication avec le serveur Reporter.
Chapitre 5 Configuration | 35

La commande unissl du client Reporter est situe dans le rpertoire reporter_client/exec de Dollar
Universe.
Syntaxe :
unissl SET enable <val> -repnode <val>

Paramtre Description
-enable <val> ON : pour activer la communication SSL du client Reporter; le serveur Reporter doit tre
configur en SSL.
OFF pour dsactiver la communication SSL du client Reporter.
-repnode <val> Nom logique du nud Reporter. Si ce paramtre n'est pas renseign, le nom d'hte local
est utilis.
-help Affiche l'aide en ligne de la commande

Le serveur Reporter doit etre dmarr pour que ces commandes puissent tre excutes.
Pour l'activation de SSL, l'utilisateur doit saisir "Y" pour accepter les certificats du serveur Reporter.
Exemple 1 : Activer SSL sur le client Reporter
unissl set -enable on
Server Certificate:
[
<Affichage de la chane de certificats du serveur Reporter>
]
Do you want to trust this certificate permanently? Y/N
Y
SSL cominucation are now enabled

Exemple 2 : Dsactiver SSL sur le client Reporter


unissl set -enable off
SSL cominucation are now disabled

Lister le contenu du keystore / truststore


Cette commande permet de lister les certificats ou les cls du keystore.
Syntaxe :
unissl LIST type <val> -pwd <val> -view

Paramtre Description
-type <val> Obligatoire; le type peut tre :
TRUSTEDCACERT : pour afficher le certificat de l'autorit de certification
SERVERCERT : pour afficher le certificat du serveur
SERVERKEY : pour afficher la paire de cls publique/prive
-pwd <val> Mot de passe. Optionnel, si cet argument n'est pas saisi il sera demand interactivement
l'utilisateur.
Le mot de passe est dfini par la commande unissl GENSTORE
-view Affiche tout le contenu des certificats ou des cls
-help Affiche l'aide en ligne de la commande

L'affichage est dirig sur la sortie standard.


Exemple :
./unissl LIST -type TRUSTEDCACERT
Enter the Keystore password:

Content of alias: eca


36 | Chapitre 5 Configuration

Type: CA Certificate
Subject: CN=OrsypTstCA, DC=orsyptst, DC=com
Valid from: 11/05/2011
Valid to: 11/05/2016
Fingerprint (MD5): F1:9B:08:98:42:6D:A6:87:98:C3:E8:89:F0:30:CF:9A
Fingerprint (SHA1):
1E:EE:43:C9:C0:6B:59:11:E8:70:BA:F3:C2:F4:2D:B0:D0:2B:F5:1B
Content of alias: rep
Type: Certificate
Subject: CN=vmstluni99.automic.com
Valid from: 18/10/2012
Valid to: 18/10/2014
Fingerprint (MD5): D7:8B:71:EF:88:51:A3:21:2A:61:16:F6:24:91:B2:95
Fingerprint (SHA1):
02:A9:78:E2:30:F3:1C:EA:8E:59:0A:6A:19:D2:8B:9C:94:09:3B:DB

Supprimer une entre


Cette commande permet de supprimer les certificats du keystore.
Syntaxe :
unissl DELETE type <val> -alias <val> -pwd <val>

Paramtre Description
-type <val> Obligatoire; le type peut tre :
TRUSTEDCACERT : pour supprimer le certificat d'autorit de certification
SERVERCERT : pour supprimer le certificat de serveur
-alias <val> Obligatoire si type= TRUSTEDCACERT. Alias utilis pour stocker le certificat
-pwd <val> Mot de passe. Optionnel, si cet argument n'est pas saisi il sera demand interactivement
l'utilisateur.
Le mot de passe est dfini par la commande unissl GENSTORE
-help Affiche l'aide en ligne de la commande

L'affichage est dirig sur la sortie standard.


Exemple : Suppression du certificat serveur
./unissl DELETE -type SERVERCERT
Enter the Keystore password:

Certificate deleted

Modifier le mot de passe du keystore / truststore


Cette commande modifie le mot de passe du keystore cr par la commande unissl GENSTORE.
Syntaxe :
unissl KEYPASSWD -pwd <val> -new <val>

Paramtre Description
-pwd <val> Mot de passe existant. Optionnel, si cet argument n'est pas saisi il sera demand
interactivement l'utilisateur.
Le mot de passe est dfini par la commande unissl GENSTORE
-new <val> Nouveau mot de passe. Optionnel, si cet argument n'est pas saisi il sera demand
interactivement l'utilisateur.
-help Affiche l'aide en ligne de la commande

Exemple :
./unissl KEYPASSWD
Enter the Keystore password:
Chapitre 5 Configuration | 37

Enter the new password:

Confirm the new Keystore password:

The password has been changed

5.6 Dclarer UniViewer Management Server


Un serveur Reporter peut grer plusieurs UniViewer Management Servers. Reportez-vous au manuel
utilisateur de Reporter pour les explications.
Lors de linstallation, lutilisateur doit dclarer au moins un UniViewer Management Server.
Ouvrez UniViewer Console, mode Administration > Nuds.
Slectionnez le nud Reporter puis cliquez sur Paramtres nuds > Paramtres UVMS.
Slectionnez la ligne UniViewer Management Server dexemple et cliquez sur Modifier.
Remplacez "name" par le nom de nud dUniViewer Management Server.
Remplacez "host" par le nom dhte dUniViewer Management Server.
Remplacez le numro de port sil est diffrent de 4184 (numro de port par dfaut
dUniViewer Management Server).
Saisissez ladministrateur dUniViewer Management Server et son mot de passe.
Dans le champ "Nom de groupe" saisissez le nom de nud dUniViewer Management
Server.
Cliquez Enregistrer et fermer.
Cliquez Valider connexion UniViewer. Le statut doit tre "Connexion UVMS russie".

Si vous utilisez une architecture UVMS avance matre-subordonns et si vous voulez que
Reporter puisse changer d'UVMS de connexion en cas de non-rponse du premier UVMS,
vous devez dclarer autant de lignes que d'UVMS : mme nom de nud mais noms d'htes
diffrents.

5.7 Valider les paramtres de la base de


donnes
Ouvrez UniViewer Console, mode Administration > Nuds.
Slectionnez le nud Reporter puis cliquez sur Paramtres nuds > Paramtres de la base
de donnes.
Nous supposons que vous avez cr une instance de base de donnes (par exemple REPDB) et un
utilisateur de base de donnes ayant les droits DBA (par exemple REPOWNER)
Identifiant de la base de donnes : REPDB
Serveur hte de la base de donnes : laissez "localhost" si la base de donnes est sur la
mme machine que le serveur Reporter, sinon saisissez le nom dhte du serveur de la base
de donnes.
Modle de la base de donnes relationnelle : Oracle ou MS SQL Server
Numro de port de communication avec la base de donnes : 1521 (par dfaut pour Oracle)
ou 1433 (par dfaut pour MS SQL Server)
38 | Chapitre 5 Configuration

Utilisateur BD : REPOWNER
Mot de passe utilisateur base de donnes : mot de passe de REPOWNER
Utiliser l'URL du service Oracle : si Reporter utilise une base de donnes Oracle, saisissez
Oui pour utiliser le nom du service Oracle pour identifier la base, saisissez Non pour utiliser
le SID.
Nom de la base de donnes (MSSQL seulement) : si Reporter utilise une base de donnes
MS SQL, saisissez le nom de la base.
Cliquez Enregistrer puis Valider connexion BD, le message "Connexion la base de donnes
russie" doit tre affich.

5.8 Valider les extractions et le chargement


Lancez une extraction simple pour vrifier que le Reporter fonctionne correctement :
Mode Administration > BD Reporter > Extractions
Dans le document de suivi des extractions, cliquez Extraire
Management Server : UVMS par dfaut
Produit : slectionnez Dollar Universe (ou UniJob si aucun serveur Dollar Universe nest
dclar)
Slection : par groupe de nuds
Groupe de nuds : slectionnez un groupe de nuds (All DUAS UNIV62/X NODES par
exemple).
Au moins un nud de la liste des nuds doit tre coch.
Cliquez Extraire
Lextraction peut varier selon la quantit de donnes cibles par lextraction.
Lextraction doit tre affiche Termine dans le suivi des extractions.
Dans ce cas, il est raisonnable de supposer que l'installation Reporter est correcte.
La gnration des rapports, les extractions et les purges de la base de donnes ne sont pas
proprement parler incompatibles, mais sont concurrentielles. Vrifiez que ces activits sont planifies
des priodes diffrentes de la journe.
Par exemple dans un schma traditionnel:
Fentre de Activit principale Activit de Commentaires
temps Reporter
7:00-19:00 Fentre interactive Gnration de Les rapports sont gnrs ds que les extractions sont
rapports termines pour assurer un maximum dactualit des
donnes.
19:00-05:00 Fentre de Purges Les Purges prennent place lorsque le serveur Reporter
traitement batchs et la base de donnes ne supportent pas dautres
activits.
05:00-07:00 Extractions Si possible, les extractions ne devraient pas
commencer avant que lactivit batch soit termine.
Chapitre 6 Mise jour et dsinstallation | 39

6 Mise jour et dsinstallation


Ce chapitre dtaille les procdures de mise jour, de retour arrire et de dsinstallation du serveur
Reporter, des clients Reporter pour UniJob et Dollar Universe et de la base de donnes.
La mise jour et la dsinstallation doivent tre ralises sous le mme compte utilisateur que celui
utilis pour l'installation :
Administrateur sous Windows
Compte utilisateur d'installation ou root sous Linux.
Avant tout mise jour, veuillez vrifier les prrequis en terme de systme d'exploitation et de base de
donnes. Ceux-ci sont dcrits au paragraphe "Configuration logicielle" page 15.

Un nouveau schma de base de donnes est install avec Reporter v4.0.

La procdure dinstallation de Reporter (Windows et Linux) maintient un inventaire interne des


versions de produit installes (suprieures v3.0). Cette inventaire est utilis pour simplifier les mises
jour pour les versions futures de Reporter.

6.1 Etapes de la mise jour


La mise jour du serveur Reporter dune version 3 en version 6 se droule en plusieurs tapes:
1. Sauvegarder les rpertoires du serveur et des clients Reporter
2. Sauvegarder la base de donnes du serveur Reporter
3. Migrer le schma de la base de donnes du serveur Reporter
4. Mettre jour les excutables du serveur Reporter
5. Mettre jour la licence
6. Compiler les rapports personnaliss utiliss sous Reporter v3 pour qu'ils soient utilisables par
Reporter v4/v6 l'aide d'iReport v4.0.2 (reportez-vous au paragraphe 6.4 du manuel
utilisateur de Reporter).
Selon la version initiale, l'tape 1 doit tre ralise en plusieurs fois :
Une premire migration de la base et mise jour de Reporter est ncessaire pour passer
d'une version v3.0 v4.0.
Une seconde migration de la base et mise jour de Reporter est ncessaire pour passer
d'une version v4.0 v4.0.7.
Une seconde migration de la base et mise jour de Reporter est ncessaire pour passer
d'une version v4.0.7 v4.0.10.

La migration dune base de donnes peut tre longue.

Le schma de la base de donnes n'a pas t modifi entre la version 4.0.10 et la version 6.

6.2 Migrer la base de donnes


Vrifiez que vous avez fait une sauvegarde complte de la base de donnes avant la mise
jour. Des modifications structurelles sont effectues directement sur les donnes des tables de
la base de donnes. Si une erreur intervient, il ny a pas de procdure de retour arrire.
40 | Chapitre 6 Mise jour et dsinstallation

Le schma de la base de donnes de Reporter v4.0/v6 a subi de nombreuses modifications depuis la


version 3.0.
Les procdures SQL sont fournies dans le rpertoire <Serveur Reporter>/dbscripts/dbtype pour
mettre jour les schmas des versions prcdentes en schma dune base de donnes v4.0 ou v6.
La mise jour de la base de donnes est ralise en excutant un script SQL sous un utilisateur de
la base de donnes disposant des privilges ncessaires pour modifier le schma ddi au serveur
Reporter.
Les scripts SQL utilisent la convention de nommage suivante :
alter_db_<database_type>_<REP_old_version>_to_<REP_new_version>.sql

O database_type peut tre oracle (pour Oracle) ou mssql (pour Microsoft SQL Server).
Par exemple, le nom du script de mise jour pour Oracle de la version 3 la version 4 de Reporter
est : alter_db_oracle_v30x_to_v400.

Les scripts SQL doivent tre excuts sous un compte utilisateur disposant des droits
suffisants pour crer/modifier/supprimer des objets (tables, contraintes, index, dclencheurs,
squences, vues, procdures, fonctions et rpertoires). Les droits pour les objets
DIRECTORY sont requis pour crer/supprimer lobjet correspondant au dossier de sortie
contenant le fichier journal.

Selon la version de mise jour du serveur Reporter, les scripts SQL peuvent contenir un ou plusieurs
objets (table, index, etc.) et cration/modification des donnes.
Les objets de la base de donnes ont t renomms et reconfigurs pour supporter de nouvelles
fonctionnalits ou pour amliorer les anciennes. Pour cette raison, le script alter_database qui met
jour la base de donnes dune version 3.0 en 4.0 ralise une mise jour complte de la base de
donnes :
Il cre les nouveaux objets ncessaires.
Il modifie les anciens objets.
Il les complte avec les donnes correspondantes.
Ainsi, les anciens objets sont transforms en nouveaux objets tout en prservant les donnes.
La procdure de migration de la base de donnes introduit de nouvelles fonctionnalits pour tracer
les diffrentes tapes du traitement des donnes, dans un fichier journal externe. Ceci permet
dinformer lutilisateur sur lopration qui est excute un moment donn. Cette fonctionnalit est
gre diffremment pour Oracle et pour Microsoft SQL Server, elle est dcrite ci-dessous.

Le rpertoire qui doit contenir le fichier journal doit exister sur le disque. Sinon le moteur de la
base de donnes renvoie une erreur lorsquil essaie daccder un rpertoire qui nexiste pas.

6.2.1 Mise jour du schma de la base de donnes Oracle


Vrifiez que vous avez fait une sauvegarde complte de la base de donnes avant la mise jour.
Des modifications structurelles sont effectues directement sur les donnes des tables de la base de
donnes.

La procdure de migration est journalise sur le disque laide du package UTL_FILE. Pour
cette raison, lutilisateur ralisant la migration de la base de donnes doit avoir accs ce
package. Le droit dexcuter le package UTL_FILE peut tre donn tous les utilisateurs en
excutant linstruction GRANT suivante utilisant lutilisateur system de la base de donnes :
GRANT EXECUTE on SYS.UTL_FILE TO PUBLIC /

Afin de dmarrer la procdure de migration, connectez-vous la base de donnes avec le compte


utilisateur de base de donnes configur pour Reporter v3.0.x.
Chapitre 6 Mise jour et dsinstallation | 41

Vrifiez que lutilisateur de la base de donnes dispose des droits suffisants pour
crer/modifier/supprimer des objets (tables, contraintes, index, dclencheurs, squences, vues,
procdures, fonctions et rpertoires). Les droits pour les objets DIRECTORY sont requis pour
crer/supprimer lobjet correspondant au dossier de sorite contenant le fichier journal.
Le script de migration peut tre excut de deux faons :
1. Excuter le script de migration partir de loutil sqlplus dOracle:
Exemple:
SQL> @<dir_path>/alter_db_oracle_v30x_to_v400.sql

2. Excuter le contenu du script de modification en utilisant un client graphique de la base de


donnes : copier/coller le contenu du fichier script dans un diteur de requtes et lexcuter.

Si le chemin daccs contient des caractres espaces, excutez le script depuis le rpertoire
local.

6.2.2 Mise jour du schma de la base de donnes MS


SQL Server
Vrifiez que vous avez fait une sauvegarde complte de la base de donnes avant la mise jour.
Des modifications structurelles sont effectues directement sur les donnes des tables de la base de
donnes.
Connectez-vous la base de donnes avec le compte utilisateur de base de donnes configur pour
Reporter v3.0.x.
Lutilisateur peut excuter le fichier script de deux faons :
1. (Recommand) en excutant le fichier script laide de loutil osql (obsolte) ou sqlcmd de
Microsoft SQL Server, dans une fentre de commandes.
Vrifiez que le chemin daccs OSQL.EXE est inclus dans la variable denvironnement
PATH. Ce rpertoire est <Microsoft SQL Server install dir>\90\Tools\Bin.
Exemple dans une nouvelle fentre de commandes, excutez cette commande :
osql -U <db_username> -P <db_password> -S <db_server_name> -d <db_name> -i
<alter_script_folder>\alter_db_mssql_v3.0.x_to_v400.sql -o
<full_path_of_output_log_file> -w 1000 n

Ou :
sqlcmd -U <db_username> -P <db_password> -S <db_server_name> -d <db_name> -i
<alter_script_folder>\alter_db_mssql_v3.0.x_to_v400.sql -o
<full_path_of_output_log_file> -w 1000

Pour migrer une base de donnes v3.0.x en v4.0, utilisez le script


alter_db_mssql_v3.0.x_to_v400.sql.
Les arguments de cette commande sont :
o -U : nom dutilisateur
o -P : mot de passe
o -S : nom du serveur
o -d : nom de la base de donnes
o -i : chemin complet du fichier dentre contenant le code T-SQL excuter
o -o : chemin complet du fichier de sortie, o le fichier sera cr ; le rpertoire doit exister
avant lappel de la commande
o -w : taille de chaque ligne dans le fichier de sortie
o -n : supprime la numrotation et le symbole de prompt (>) des lignes crites
42 | Chapitre 6 Mise jour et dsinstallation

Plus de dtails sur osql.exe peuvent tre trouvs dans http://technet.microsoft.com/en-


us/library/aa214012%28v=sql.80%29.aspx.
Plus de dtails sur sqlcmd.exe peuvent tre trouvs dans http://technet.microsoft.com/en-
us/library/ms162773.aspx
2. En excutant le contenu du fichier de modification laide de Microsoft SQL Server
Management Studio: copier/coller le contenu du fichier script dans un diteur de requtes et
lexcuter.

Lutilisation de cette mthode a pour effet dcrire par dfaut la sortie du fichier script dans la
console de Microsoft SQL Server Management Studio. L'inconvnient de cette mthode est
que le contenu nest effectivement affich que lorsque le script termine son excution.
Cependant, la console peut tre redirige vers un fichier externe, en utilisant une configuration
spcifique. Reportez-vous la documentation de Microsoft ce propos. Le fichier journal de
Microsoft SQL Server contiendra les avertissements suivants plusieurs reprises : "Caution:
Changing any part of an object name could break scripts and stored procedures." Ce message
est mis sans condition par le moteur de la base de donnes, lorsque des objets sont
renomms, et ne peut tre supprim. Ne vous inquitez pas, aucun script de la base de
donnes et aucune procdure enregistre ne peut tre endommage cause du renommage
des objets.

6.2.3 Gestion des erreurs


Si des enregistrements de donnes incohrentes sont rencontrs, ils seront enregistrs dans le
fichier journal externe dont l'adresse a t spcifie dans la procdure de mise niveau.
Si des incohrences sont rencontres dans les objets de bases de donnes, ils seront enregistrs par
le moteur de base de donnes dans sa propre console.
Lenregistrement ci-dessous inscrit dans le fichier journal externe indique la russite du processus de
migration:
[INFO ][date et heure] Successful database migration.
Si la procdure de migration choue, contacter le support technique pour une analyse plus
approfondie.

6.2.4 Journalisation de la migration


La procdure de migration crit les tapes dans un fichier journal externe afin que lutilisateur puisse
connaitre ltat davancement tout moment.

Le rpertoire qui doit contenir le fichier journal doit exister sur le disque. Sinon le moteur de la
base de donnes renvoie une erreur lorsquil essaie daccder un rpertoire qui nexiste pas.

6.3 Mise jour de Reporter sous Windows


La mise jour du produit est gre par la mme procdure que linstallation du produit.
Reportez-vous la section "Installation du serveur Reporter sous Windows" page 16.

Une mise jour de version majeure requiert la saisie d'une nouvelle licence Reporter (v3 ->
v4, v4 -> v6).
Chapitre 6 Mise jour et dsinstallation | 43

6.3.1 Mise jour du serveur Reporter sous Windows


Les instances existantes du serveur et des clients Reporter sont affiches sil en existe.
Slectionnez l'instance du serveur Reporter mettre jour et cliquez sur Next.

6.3.1.1 Lcran daccueil


Le programme affiche lcran daccueil de la procdure InstallShield.
Cliquez Next pour poursuivre
Cliquez Cancel pour abandonner linstallation.

6.3.1.2 Dfinition de lenvironnement Java (JDK ou JRE) - Windows


Saisissez le chemin du rpertoire Java Home.
Le rpertoire Java Home doit contenir un sous-rpertoire bin contenant les binaires Java. Najoutez
pas /bin au chemin.
Cliquez sur le bouton Browse pour slectionner le rpertoire dans larborescence.
Cliquez Next pour poursuivre
Cliquez Cancel pour abandonner linstallation.

6.3.1.3 Dfinition du pilote JDBC


Un pilote JDBC doit tre prsent pour que Reporter puisse communiquer avec la base de donnes.
Reportez-vous au paragraphe "Pilotes JDBC" page 15 pour plus de dtails sur le tlchargement du
pilote requis.
Le programme dinstallation cre un lien vers le pilote indiqu.
Utilisez le bouton Browse pour slectionner le pilote dans larborescence.
Cliquez Back pour retourner lcran prcdent
Cliquez Next pour poursuivre
Cliquez Cancel pour abandonner linstallation.
Si le rpertoire contient une installation de Reporter cohrente, un message rappelant le rpertoire de
destination et indiquant le nom du nud Reporter invite lutilisateur poursuivre la mise jour.

6.3.1.4 Fin de la procdure de mise jour


Quand la procdure de mise jour se termine :
Reporter est redmarr automatiquement aprs un upgrade v4 > v6 s'il tait dmarr quand
l'utilisateur a lanc l'upgrade.
Reporter n'est pas redmarr aprs un upgrade v3 > v6.

6.3.2 Mise jour du client Reporter sous Windows


La mise jour du produit est gre par la mme procdure que l'installation du produit.
Reportez-vous la section "Installation du serveur Reporter sous Windows" page 16.
Les instances existantes du serveur et des clients Reporter sont affiches sil en existe.
Slectionnez l'instance du client Reporter mettre jour et cliquez sur Next.
44 | Chapitre 6 Mise jour et dsinstallation

6.4 Mise jour de Reporter sous Linux


La mise jour du produit est gre par la mme procdure que linstallation du produit.
Reportez-vous la section "Chemin daccs linstallation dUniJob" page 23.

Une mise jour de version majeure requiert la saisie d'une nouvelle licence Reporter (v3 ->
v4, v4 -> v6).

6.4.1 Mise jour du serveur Reporter sous Linux


L'inventaire des installations de Reporter ( partir de la version 3.0) est affich. Par exemple :
List of the instances of product Reporter (version higher than 3.0) already
installed on this machine:
1) Nodename="vmstluni99.automic.com" Installation
directory="/var/opt/AUTOMIC/Reporter/vmstluni99.automic.com"
2) Nodename="vmstluni99" Installation directory="/var/tmp/Reporter"
:
Saisissez le numro correspondant l'instance que vous voulez mettre jour et tapez Entre.
Une confirmation est demande, par exemple :
Upgrade the instance vmstluni99 installed in /var/tmp/Reporter (y/n) [n] :

6.4.1.1 Emplacement de la commande java - Linux


Provide the path to the directory containing Jre/Jdk.
it must contain a "bin" folder with the java command inside:
Location of the java folder [] :

6.4.1.2 Chemin daccs au fichier du pilote JDBC


Enter the FULL path to the JDBC driver file.
Reporter uses the JDBC driver to communicate with the database (Oracle or MS
SQL Server)
If you can't find the driver file (ojdbc*.jar or sqljdbc*.jar), download it
from the db vendor website.

JDBC driver file path []:


Un pilote JDBC est requis pour que Reporter puisse communiquer avec la base de donnes.
Reportez-vous au paragraphe "Pilotes JDBC" page 15 pour plus de dtails sur le tlchargement du
pilote requis.
Le programme dinstallation tablit un lien sur lemplacement du pilote indiqu. La procdure attend le
chemin et le nom du fichier du pilote.
Exemple de chemin du fichier du pilote JDBC :
/mnt/hgfs/Shared/ojdbc14.jar

6.4.1.3 Arrt de Reporter


La procdure de mise jour arrte Reporter si ncessaire :
The server vmstluni99 is started, we stop it

6.4.1.4 Fin de la procdure de mise jour


La procdure de mise jour se termine par le message suivant :
Chapitre 6 Mise jour et dsinstallation | 45

====================================
Installation successfully completed
====================================
Reporter server is launched in background in nohangup mode.
Quand la procdure de mise jour se termine :
Reporter est redmarr automatiquement aprs un upgrade v4 > v6 s'il tait dmarr quand
l'utilisateur a lanc l'upgrade.
Reporter n'est pas redmarr aprs un upgrade v3 > v6.
Une sauvegarde complte est effectue dans le rpertoire <Rpertoire dinstallation>/<Rpertoire
Reporter >/<backup>/backup_AAAAMMJJ-*.tar.

6.4.2 Mise jour du client Reporter sous Linux


Reportez-vous la section "Mise jour du serveur Reporter sous Linux" page 44.

6.5 Retour arrire de la base de donnes de


Reporter
Arrtez le serveur Reporter (reportez-vous la section: "Dmarrer et arrter le serveur
Reporter" page 28).
Restaurez la base de donnes partir de la sauvegarde d'avant la mise jour.

6.6 Retour arrire de Reporter


L'utilisateur doit sauvegarder lui-mme le rpertoire de Reporter s'il veut pouvoir revenir l'tat
prcdent.
Le retour arrire du serveur Reporter de la version courante la version prcdente peut tre ralis
manuellement en suivant les tapes dcrites ci-dessous :
Arrtez le serveur Reporter (reportez-vous la section: "Dmarrer et arrter le serveur
Reporter" page 28).
Copiez le rpertoire <backup_before upgrade> dans un rpertoire situ en-dehors de
larborescence de Reporter.
Supprimez le contenu du rpertoire racine de Reporter <Reporter root>.
Copiez le contenu du rpertoire <backup_before upgrade> dans <Reporter root>.
Dmarrez le serveur Reporter.

6.6.1 Retour arrire du client Reporter pour Dollar


Universe sous Windows
Le retour arrire du client Reporter de la version courante la version prcdente peut tre ralis
manuellement en suivant les tapes dcrites ci-dessous :
Copiez le rpertoire <Reporter_client>\<backup_before upgrade> dans un rpertoire
temporaire en-dehors de larborescence de Dollar Universe.
Supprimez le contenu du rpertoire <Reporter_client>.
46 | Chapitre 6 Mise jour et dsinstallation

Copiez le contenu du rpertoire <backup_before upgrade> dans <Reporter_client>.

6.6.2 Retour arrire du client Reporter pour Dollar


Universe sous Linux
Le retour arrire du client Reporter de la version courante la version prcdente peut tre ralis
manuellement en suivant les tapes dcrites ci-dessous :
Copiez le rpertoire <Reporter_client>\<backup_before upgrade> dans un rpertoire
temporaire en-dehors de larborescence de Dollar Universe.
Supprimer le contenu du rpertoire <Reporter_client>.
Copiez le contenu du rpertoire <backup_before upgrade> dans <Reporter_client>.

6.7 Dsinstaller les composants de Reporter


La dsinstallation du serveur Reporter et des clients Reporter pour Dollar Universe et UniJob est
dcrite ci-dessous.

6.7.1 Dsinstaller le serveur Reporter sous Windows


Arrtez le serveur Reporter.
Slectionnez le serveur Reporter dans Dmarrer>Paramtres>Panneau de configuration>Ajout /
Suppression de programmes.
Slectionnez linstance supprimer.

6.7.2 Dsinstaller le client Reporter pour Dollar Universe


sous Windows
Dsinstaller le client Reporter pour Dollar Universe laide de Dmarrer>Paramtres>Panneau de
configuration>Ajout / Suppression de programmes.
Slectionnez linstance supprimer.

6.7.3 Dsinstaller le client Reporter pour UniJob sous


Windows
Dsinstaller le client Reporter pour UniJob laide de Dmarrer>Paramtres>Panneau de
configuration>Ajout / Suppression de programmes.
Slectionnez linstance supprimer.

6.7.4 Dsinstaller le serveur Reporter sous Linux


Lancer la procdure d'installation unirun d (reportez-vous au paragraphe "Installation du serveur
Reporter sous Linux" page 20) :
_______________________________________________________

Reporter Uninstallation (c) AUTOMIC 2011


Chapitre 6 Mise jour et dsinstallation | 47

_______________________________________________________

Please select the installation type


- Server installation [s]
- Reporter Client for UniJob [u]
- Reporter Client for Dollar Universe [d]
Enter Installation Type : s
Saisissez s pour le serveur Reporter
La liste des instances installes est affiche, par exemple :
List of the instances of product Reporter (version higher than 3.0) already
installed on this machine:
1) Nodename="vmstluni99.automic.com" Installation
directory="/var/opt/AUTOMIC/Reporter/vmstluni99.automic.com"
2) Nodename="vmstluni99" Installation directory="/var/tmp/Reporter"
:
Saisissez le numro de linstance Reporter supprimer.
Une confirmation est demande avant de lancer la dsinstallation, par exemple :
Confirm the uninstallation of instance vmstluni99 installed in
/var/tmp/Reporter (y/n)? [n] :
Saisissez "y" pour continuer ou "n" pour abandonner.

6.7.5 Dsinstaller le client Reporter sous Linux


Lancer la procdure d'installation unirun d (reportez-vous au paragraphe "Installation du serveur
Reporter sous Linux" page 20) :
_______________________________________________________

Reporter Uninstallation (c) AUTOMIC 2011


_______________________________________________________

Please select the installation type


- Server installation [s]
- Reporter Client for UniJob [u]
- Reporter Client for Dollar Universe [d]
Enter Installation Type : d

Saisissez d pour le client Reporter pour Dollar Universe.


Saisissez u pour le client Reporter pour UniJob.
Saisissez le numro de linstance du client Reporter supprimer.
48 | Chapitre 7 Authentification et droits des utilisateurs

7 Authentification et droits des


utilisateurs
Reporter v6 considre les nuds Dollar Universe v6 comme les nuds UniJob. Les nuds Dollar
Universe v6 sont enregistrs UniViewer Management Server lors de linstallation comme les nuds
UniJob. Les nouveaux nuds sont envoys tous les nuds Dollar Universe par lautomate de
synchronisation.
Linstallation de Reporter v6 ajoute les rles Reporter_Administrator et Reporter_Reader et les
attribue aux groupes par dfaut sur UniViewer Management Server.
Lauthentification des utilisateurs voulant accder Reporter v6 et donc aux Dollar Universe
Application Server v6 est gre en central sur UniViewer Management Server par les Comptes
utilisateurs, les Rles et les Groupes.
Les proxies locaux et la gestion des utilisateurs sont grs sur Reporter v6 afin de permettre
lauthentification des commandes excutes par linterface ligne de commande.

Figure 2: Gestion des utilisateurs par UniViewer et Reporter

Les commandes dcrites dans ce chapitre sont les suivantes.


Catgorie Commande Description
Proxy delproxy Supprimer une rgle de proxy dun serveur Reporter
Proxy getproxy Rcuprer le nom dun utilisateur de proxy
Proxy lstproxy Lister les rgles de proxy dun serveur Reporter
Proxy setproxy Ajouter une rgle de proxy au serveur Reporter
User adduser Ajouter un utilisateur la liste des utilisateurs internes de Reporter
User deluser Supprimer un utilisateur de la liste des utilisateurs internes de Reporter
User lstuser Lister les utilisateurs internes de Reporter
Chapitre 7 Authentification et droits des utilisateurs | 49

7.1 Aprs linstallation


Une liste des utilisateurs internes est gre sur le serveur Reporter. Lors de linstallation cette liste ne
contient que lutilisateur admin.
Par dfaut, tous les utilisateurs systmes provenant de toutes les machines correspondent par proxy
lutilisateur admin de Reporter.
lstproxy
* * * * admin

Les utilisateurs standards ne peuvent excuter que des commandes dextraction et de rapport. Ceux
ayant lattribut ADMIN peuvent galement excuter les commandes de gestion des utilisateurs et
configurer la base de donnes laide de linterface graphique.

7.1.1 Utilisateurs internes


La liste des utilisateurs internes de Reporter est gre par les commandes de gestion des utilisateurs
de Reporter (reportez-vous la section: "Gestion des utilisateurs Reporter" page 49). Aucun accs
la liste des utilisateurs interne nest possible depuis UniViewer Console.
Pour utiliser les commandes de Reporter, lutilisateur systme doit tre dclar dans la liste des
utilisateurs internes ou tre li un utilisateur interne valide par un proxy Reporter (reportez-vous la
section: "Gestion des proxies Reporter" page 51).

7.1.2 Extraction de cibles Dollar Universe V5


Lutilisateur interne de Reporter qui excute la commande dextraction doit avoir accs aux DUAS
distants. Lutilisateur doit donc tre dclar dans la table des utilisateurs de Dollar Universe ou tre li
un utilisateur interne valide par un proxy Dollar Universe.

7.1.3 Extraction de cibles UniJob et DUAS v6


Un compte utilisateur UniViewer peut tre spcifi (utilisateur et mot de passe) dans les Paramtres
nuds de Reporter > Paramtres UVMS pour lextraction des donnes par le serveur Reporter pour
les nuds cibles.
Il est intressant de crer un utilisateur ddi (par exemple rep_user) avec un profil "Production
lecture" pour raliser les fonctions d'extraction UniJob.

7.2 Gestion des utilisateurs Reporter


Les commandes suivantes sont disponibles sur le serveur Reporter dans le rpertoire <Serveur
Reporter>\exec afin de grer les utilisateurs et les droits daccs au serveur Reporter.
Les commandes de gestion des utilisateurs sont rserves aux utilisateurs de Reporter ayant lattribut
ADMIN.

7.2.1 Ajouter un utilisateur la liste des utilisateurs


internes de Reporter
Un utilisateur peut tre ajout laide de la commande adduser. La syntaxe est la suivante :
50 | Chapitre 7 Authentification et droits des utilisateurs

adduser [-REPNODE <nom de nud logique du serveur reporter>] <nom


d'utilisateur> [ADMIN]

Cette commande met jour le fichier dutilisateurs <Serveur Reporter>\data\users.conf en ajoutant le


nom du nouvel utilisateur.
Arguments Description
REPNODE Chane de dix caractres indiquant le nom logique du nud du serveur Reporter. Si ce
paramtre nest pas indiqu dans la ligne de commandes, il est automatiquement dfini
selon la valeur de la variable denvironnement REPNODE. Si la variable nexiste pas,
REPNODE sera dfini selon la valeur du paramtre com.orsyp.server.config.repnode dans le
fichier server.conf. La commande choue si ce paramtre est introuvable.
nom Nom de lutilisateur ajouter.
d'utilisateur
ADMIN Confre des privilges dadministrateur lutilisateur. Seuls les administrateurs peuvent
excuter les commandes de gestion des utilisateurs.

7.2.2 Supprimer un utilisateur de la liste des utilisateurs


internes de Reporter
Un utilisateur peut tre supprim laide de la commande deluser. La syntaxe est la suivante :
deluser [REPNODE <nom de nud logique reporter>] <nom d'utilisateur>

Cette commande met jour le fichier dutilisateurs <Serveur Reporter>\data\users.conf.

Arguments Description
REPNODE Chane de dix caractres indiquant le nom logique du nud du serveur Reporter.
Si ce paramtre nest pas indiqu dans la ligne de commandes, il est automatiquement dfini
selon la valeur de la variable denvironnement REPNODE. Si la variable nexiste pas,
REPNODE sera dfini selon la valeur du paramtre com.orsyp.server.config.repnode dans le
fichier server.conf. La commande choue si ce paramtre est introuvable.
nom Nom de lutilisateur supprimer.
d'utilisateur

7.2.3 Lister les utilisateurs internes de Reporter


Les utilisateurs connus peuvent tre affichs laide de la commande Istuser. La syntaxe est la
suivante :
lstuser [-REPNODE <nom de nud logique reporter>]

Cette commande affiche les utilisateurs rfrencs dans le fichier <Serveur


Reporter>\data\users.conf.
Chapitre 7 Authentification et droits des utilisateurs | 51

Arguments Description
REPNODE Chane de dix caractres indiquant le nom logique du nud du serveur Reporter.
Si ce paramtre nest pas indiqu dans la ligne de commandes, il est automatiquement dfini
selon la valeur de la variable denvironnement REPNODE. Si la variable nexiste pas,
REPNODE sera dfini selon la valeur du paramtre com.orsyp.server.config.repnode dans le
fichier server.conf. La commande choue si ce paramtre est introuvable.

7.3 Gestion des proxies Reporter

7.3.1 Ajouter une rgle de proxy au serveur Reporter


Une rgle de proxy peut tre ajoute laide de la commande setproxy. La syntaxe est la suivante :
setproxy -REPNODE <nom de nud logique reporter>] <SystemCode>
<UniverseNode> <UserDomain> <UserName> <ProxyName>

Cette commande met jour le fichier de proxy <Serveur Reporter>\data\proxy.txt en ajoutant la


nouvelle rgle de conversion.

Arguments Description
REPNODE Chane de dix caractres indiquant le nom logique du nud du serveur Reporter.
Si ce paramtre nest pas indiqu dans la ligne de commandes, il est automatiquement dfini
selon la valeur de la variable denvironnement REPNODE. Si la variable nexiste pas,
REPNODE sera dfini selon la valeur du paramtre com.orsyp.server.config.repnode dans le
fichier server.conf. La commande choue si ce paramtre est introuvable.
SystemCode Accepte les cls suivantes :
- * pour les utilisateurs issus de nimporte quel systme,
- W32 pour les utilisateurs issus dun systme Windows (utilisateur de soumission d'un client
batch),
- UNX pour les utilisateurs issus dun systme UNIX/Linux (utilisateur de soumission d'un
client batch).
UniverseNode Nud Dollar Universe.
UserDomain Paramtre spcifique Windows. Il doit tre prvu uniquement sur les plates-formes
Windows. Il rfrence le domaine Windows de lutilisateur distant.
UserName Nom de lutilisateur distant.
ProxyName Nom de lutilisateur local.

Par exemple, pour dfinir une rgle qui convertisse nimporte quel utilisateur du domaine
myCompany.com soumettant des requtes qui proviennent de nuds Windows dont les noms
commencent par "us_nodes_" lutilisateur local "admin", procdez comme suit :
setproxy W32 us_nodes_* myCompany.com * admin

7.3.2 Supprimer une rgle de proxy dun serveur Reporter


Une rgle de proxy peut tre supprime laide de la commande delproxy. La syntaxe est la
suivante :
delproxy [REPNODE <nom de nud logique reporter>] <SystemCode>
<UniverseNode> <UserDomain> <UserName>

Cette commande met jour le proxy dans le fichier < Serveur Reporter>\data\proxy.txt en supprimant
la rgle dcrite.
52 | Chapitre 7 Authentification et droits des utilisateurs

Arguments Description
REPNODE Chane de dix caractres indiquant le nom logique du nud du serveur Reporter.
Si ce paramtre nest pas indiqu dans la ligne de commandes, il est automatiquement dfini
selon la valeur de la variable denvironnement REPNODE. Si la variable nexiste pas,
REPNODE sera dfini selon la valeur du paramtre com.orsyp.server.config.repnode dans le
fichier server.conf. La commande choue si ce paramtre est introuvable.
SystemCode Accepte les cls suivantes :
- * pour les utilisateurs issus de nimporte quel systme,
- W32 pour les utilisateurs issus dun systme Windows (utilisateur de soumission d'un client
batch),
- UNX pour les utilisateurs issus dun systme UNIX/Linux (utilisateur de soumission d'un
client batch).
UniverseNode Nud Dollar Universe.
UserDomain Paramtre spcifique Windows. Il doit tre prvu uniquement sur les plates-formes
Windows. Il rfrence le domaine Windows de lutilisateur distant.
UserName Nom de lutilisateur distant.

7.3.3 Lister les rgles de proxy dun serveur Reporter


Les rgles de proxy peuvent tre affiches laide de la commande lstproxy. La syntaxe est la
suivante :
lstproxy [-REPNODE <nom de nud logique reporter>]

Cette commande affiche les rgles dfinies dans le fichier de proxy < Serveur
Reporter>\data\proxy.txt.

Arguments Description
REPNODE Chane de dix caractres indiquant le nom logique du nud du serveur Reporter.
Si ce paramtre nest pas indiqu dans la ligne de commandes, il est automatiquement dfini
selon la valeur de la variable denvironnement REPNODE. Si la variable nexiste pas,
REPNODE sera dfini selon la valeur du paramtre com.orsyp.server.config.repnode dans le
fichier server.conf. La commande choue si ce paramtre est introuvable.

7.3.4 Rcuprer le nom dun utilisateur de proxy


La commande getproxy peut tre utilise pour trouver la conversion dun ensemble donn (code
systme, nom du nud, domaine de lutilisateur, nom dutilisateur) :
getproxy [-REPNODE < nom de nud logique reporter >]<SystemCode>
<UniverseNode> <UserDomain> <UserName>

Cette commande renvoie lutilisateur local dfini dans le fichier de proxy < Serveur
Reporter>\data\proxy.txt.

Arguments Description
REPNODE Chane de dix caractres indiquant le nom logique du nud du serveur Reporter.
Si ce paramtre nest pas indiqu dans la ligne de commandes, il est automatiquement dfini
selon la valeur de la variable denvironnement REPNODE. Si la variable nexiste pas,
REPNODE sera dfini selon la valeur du paramtre com.orsyp.server.config.repnode dans le
fichier server.conf. La commande choue si ce paramtre est introuvable.
Chapitre 7 Authentification et droits des utilisateurs | 53

Arguments Description
SystemCode Accepte les cls suivantes :
- * pour les utilisateurs issus de nimporte quel systme,
- W32 pour les utilisateurs issus dun systme Windows (utilisateur de soumission d'un client
batch),
- UNX pour les utilisateurs issus dun systme UNIX/Linux (utilisateur de soumission d'un
client batch).
UniverseNode Nud Dollar Universe.
UserDomain Paramtre spcifique Windows. Il doit tre prvu uniquement sur les plates-formes
Windows. Il rfrence le domaine Windows de lutilisateur distant.
UserName Nom de lutilisateur distant.
54 | Chapitre 8 Interface Commandes

8 Interface Commandes
Les commandes de Reporter (uxrepadd, uxrepgen, uxreppurge) sont des scripts et non des
binaires. Ceci signifie, en particulier si l'interface command est utilise en environnements Windows,
que chaque command doit tre prcde par le mot cl "call' lorsqu'elle est utilise dans le script
d'une Uproc.

8.1 Gestion des donnes


Linterface de lignes de commandes permet toutes les actions principales de Reporter, comme la
maintenance de la base de donnes (extraction et purge), la gnration de rapports et la diffusion,
dtre excutes partir de scripts et dtre automatises partir de Dollar Universe ou UniJob.
Les commandes dcrites dans ce chapitre sont illustres ci-dessous.

Catgorie Commande Description


Extractions uxrepadd Dclenchement dune extraction partir de sources de donnes et
chargement dans la base de donnes.
Suivi unicheckrep Vrification de lactivit du serveur Reporter
Suivi unirepinfo Vrification de la version logicielle du serveur Reporter
Purge uxreppurge Purge des donnes extraites partir de la base de donnes

8.1.1 Dclenchement des extractions


Les Extractions peuvent tre dclenches laide de la commande uxrepadd (depuis le serveur
Reporter, un client Reporter pour Dollar Universe ou un client Reporter pour UniJob).
La syntaxe est la suivante :
uxrepadd EXT -PRODUCT <UNIJOB, DUAS ou ALL>
[-UVMS <Nom UVMS>]
[-COMPANY <Socit Dollar Universe>]
[EXP, SIM, INT ou APP]
[-REPNODE <nom du serveur Reporter>]
[-LABEL <description de l'extraction>]
[-NODEVIEW <nom du groupe de Noeuds>]
[-NODE <liste des noeuds>]
[-FILTER <ALL, ABORTED, REFUSED ou OLDEST>]
[WAIT|NOWAIT]

La commande est disponible dans le rpertoire exec :


<Serveur Reporter>\exec pour le serveur Reporter
<SOCIETE>\reporter_client\exec pour le client Reporter pour DUAS.
<UNIJOB>\reporter_client\exec pour le client Reporter pour UniJob.
Comme linterface utilisateur graphique, elle se connecte au serveur Reporter spcifi et dclenche
lextraction.
Chapitre 8 Interface Commandes | 55

Paramtre Valeur par Obligatoire/description


dfaut
-PRODUCT DUAS DUAS ou UNIJOB ou TOUS (Obligatoire).
-UVMS Le nom de lUVMS doit tre spcifi uniquement si plusieurs nuds UVMS
ont t dclars sur le serveur Reporter.
L'UVMS dtermine les nuds et les Groupe de nuds disponibles pour
lextraction.
Si plusieurs nuds ont t dclars et si cette option nest pas indique, la
commande uxrepadd se termine en erreur.
-COMPANY Uniquement si Produit=DUAS
Chane de six caractres indiquant le nom dune socit DUAS partir de
laquelle doivent tre extraites les donnes.
Si ce paramtre nest pas indiqu dans la ligne de commandes, il est
automatiquement dfini selon la valeur de la variable denvironnement
S_COMPANY.
La commande choue si la variable denvironnement nexiste pas.
EXP/SIM/INT/APP Uniquement si Produit=DUAS
Chane de trois caractres indiquant lespace partir duquel doivent tre
extraites les donnes.
Si ce paramtre nest pas indiqu dans la ligne de commandes, il est
automatiquement dfini selon la valeur de la variable denvironnement
S_AREA.
La commande choue si la variable denvironnement nexiste pas.
-REPNODE Indique le nom du serveur Reporter. Ce paramtre est ncessaire
uniquement si la variable denvironnement REPNODE nest pas dfinie.
-LABEL Chane de 256 caractres descriptive de lextraction. la description est
purement informative (elle figure dans la colonne "Dernires Extractions" de
UniViewer). Elle ne peut tre utilise pour identifier un groupe de nuds,
contrairement UniViewer.
Si aucune description nest spcifie, "All extractions" saffiche alors dans
UniViewer.
-NODEVIEW NODE ou NODEVIEW doit tre spcifi.
-NODE NODE ou NODEVIEW doit tre spcifi.
Liste des nuds cibls pour lextraction. Sur la base de ce paramtre, la
commande dclenche une extraction sur les nuds spcifis.
WAIT/NOWAIT WAIT Indicateurs utiliser pour contrler lexcution de la commande. En cas
dutilisation de "WAIT", la commande sexcute de manire synchrone et le
contrle nest renvoy quune fois lextraction termine. Ce comportement
correspond au comportement par dfaut. "NOWAIT" renvoie le contrle
immdiatement.

Les extractions sont gres en FIFO par UVMS. Si 10 extractions ciblent chacune 20 sources
de donnes via 10 UVMS diffrents (et si maxParallelExtractions=10), une seconde extraction
ne peut pas tre lance tant que les 20 sources de donnes de la premire extraction nont
pas t traites.

8.1.2 Suivi des extractions

8.1.2.1 Etat du serveur Reporter


Il nexiste aucun quivalent du Suivi des extractions ou de Lhistorique dextractions dans linterface
de lignes de commandes. Cependant, certaines commandes fournissent des donnes utiles.
56 | Chapitre 8 Interface Commandes

Ltat et lactivit du serveur peuvent tre affichs l'aide du script unicheckrep, qui est disponible
dans le rpertoire exec :
pour le serveur Reporter :
<Serveur Reporter>\exec

et pour le client Reporter pour DUAS :


<SOCIETE>\reporter_client\exec

Syntaxe de la commande :
unicheckrep [-REPNODE <Nud serveur Reporter> -d]

Le paramtre "d(dtail)" indique la liste des extractions en cours et en attente regroupes par
UVMS.
Des exemples de rsultats produits par lexcution de cette commande dans des environnements
MSSQL et Oracle sont illustrs ci-dessous.
La taille de la table et le nombre de curseurs ne sont affichs que pour l'environnement Oracle si
l'utilisateur dispose des droits suffisants sur les tables UNI_EVT* (dans le cas contraire ces
informations ne sont pas affiches) :
Exemple de la commande unicheckrep pour MSSQL:
unicheckrep d

REPNODE=cavtlqpj01 value taken from configuration file server.conf.


Reporter Server name = cavtlqpj01
Reporter Server PID = 28559
noOfPurgesInExec = 0
noOfPurgesInWait = 0
noOfExtractionsInExec = 0
noOfExtractionsInWait = 0
noOfReportsGenerateInExec = 0
noOfReportsGenerateInWait = 0
memUsage = 18.856934
memFree = 971.01807

***********Rows Count per table***********


UNI_EVT_RELAUNCHES: 0 records.
UNI_EVT_JOBLOGS: 0 records.
UNI_EVT_MESSAGES: 0 records.
UNI_EVT_PARAMETERS: 0 records.
UNI_EVT_VARIABLES: 0 records.
UNI_EVT_AUDITTRAIL: 0 records.
UNI_EVT_DATASOURCES: 0 records.
UNI_EVT_EXTRACTIONS: 0 records.
UNI_EVT_PURGES: 0 records.
UNI_EVT_LOG: 0 records.
UNI_EVT_REPORTS: 0 records.
UNI_EVT_TECH_REPORTS: 48 records.
UNI_EVT_STATUSES: 22 records.
Exemple de la commande unicheckrep pour Oracle:
unicheckrep d

REPNODE=CAVTMQTKH value taken from environment variable. REPNODE


Reporter Server name = CAVTMQTKH
Reporter Server PID = 3980
noOfPurgesInExec = 0
noOfPurgesInWait = 0
noOfExtractionsInExec = 0
noOfExtractionsInWait = 0
noOfReportsGenerateInExec = 0
noOfReportsGenerateInWait = 0
memUsage = 107.90021
memFree = 881.9748
Chapitre 8 Interface Commandes | 57

***********Rows Count per table***********


UNI_EVT_RELAUNCHES: 0 records.
UNI_EVT_JOBLOGS: 0 records.
UNI_EVT_MESSAGES: 0 records.
UNI_EVT_PARAMETERS: 0 records.
UNI_EVT_VARIABLES: 0 records.
UNI_EVT_AUDITTRAIL: 0 records.
UNI_EVT_DATASOURCES: 0 records.
UNI_EVT_EXTRACTIONS: 0 records.
UNI_EVT_PURGES: 0 records.
UNI_EVT_LOG: 0 records.
UNI_EVT_REPORTS: 0 records.
UNI_EVT_TECH_REPORTS: 24 records.
UNI_EVT_STATUSES: 11 records.

***********Tables size***********
UNI_EVT_RELAUNCHES: 720896 bytes.
UNI_EVT_JOBLOGS: 131072 bytes.
UNI_EVT_MESSAGES: 327680 bytes.
UNI_EVT_PARAMETERS: 262144 bytes.
UNI_EVT_VARIABLES: 262144 bytes.
UNI_EVT_AUDITTRAIL: 262144 bytes.
UNI_EVT_DATASOURCES: 524288 bytes.
UNI_EVT_EXTRACTIONS: 327680 bytes.
UNI_EVT_PURGES: 196608 bytes.
UNI_EVT_LOG: 131072 bytes.
UNI_EVT_REPORTS: 196608 bytes.
UNI_EVT_TECH_REPORTS: 131072 bytes.
UNI_EVT_STATUSES: 131072 bytes.

***********Cursors used***********
Number of opened cursors is: 5

***********Extractions In Progress***********
Extract from UVMS: frlpmpmgt
Extraction info: name = Allextractions datasource =(UNIV53 frlpmpmgt X)
Si lextraction a t dclenche de manire synchrone, lutilisateur peut suivre son volution laide
de la commande unicheckrep.

8.1.2.2 Informations sur le serveur Reporter


La commande unirepinfo affiche la version du logiciel et les informations concernant le serveur
Reporter, ainsi que la liste des UVMS dclars.
Syntaxe de la commande :
unirepinfo [ -REPNODE <Nud serveur Reporter> ]
unirepinfo
REPNODE=FRLPMDEV04 the value was taken from the variable REPNODE

Reporter Server Information:


Version: 3.0
Build Number: 01
Build Date: 25.01.2010
Server Current Date: 10 Feb 2010 17:17:50
Server GMT: GMT+01:00
UVMS Info:
UVMS:[ uvmsName=frlpmdev04, uvmsHost=frlpmdev04, uvmsPort=4184,
uvmsLogin=admin

FR_UVMS:[ uvmsName=frlpmpmgt, uvmsHost=frlpmpmgt, uvmsPort=4184,


uvmsLogin=admin
FR_Patch information:
58 | Chapitre 8 Interface Commandes

8.1.3 Dclenchement dune purge de la base de donnes


La commande uxreppurge peut tre lance depuis le serveur Reporter ou depuis un client Reporter.
La commande est disponible dans le rpertoire exec :
pour le serveur Reporter :
<Serveur Reporter>\exec

pour le client Reporter :


<SOCIETE>\reporter_client\exec

Une purge de la base de donnes peut tre dclenche laide de la commande suivante :
uxreppurge EXT
[-LABEL <purge label>]
[-REPNODE <Reporter Server Node name>] Default=REPSERVER
[WAIT/NOWAIT]

Arguments Description
-LABEL (En option) Chane de 128 caractres. Ce descriptif identifie la purge.
-REPNODE Chane de dix caractres indiquant le nom logique du nud du serveur Reporter.
Si ce paramtre nest pas indiqu dans la ligne de commandes, il est automatiquement
dfini selon la valeur de la variable denvironnement REPNODE. Si la variable nexiste pas,
REPNODE sera dfini selon la valeur du paramtre com.orsyp.server.config.repnode dans
le fichier server.conf. La commande choue si ce paramtre est introuvable.
WAIT/NOWAIT (En option) "WAIT" (par dfaut) renvoie le contrle la ligne de commande uniquement
lorsque la commande de purge a t excute (excution synchrone). "NOWAIT" renvoie le
contrle immdiatement (excution asynchrone).

La commande se connecte au serveur Reporter et dclenche lopration de purge, conformment aux


critres de purge de la base de donnes (voir le manuel Utilisateur de Reporter pour plus de dtails
sur les paramtres de purge de Reporter).
Cette commande ncessite que lutilisateur de Reporter dispose de droits dadministrateur.

8.2 Gestion des rapports


Reporter propose plusieurs modles de Rapports standards simples utiliser pour les donnes Dollar
Universe et UniJob.
Les commandes dcrites dans ce chapitre sont illustres ci-dessous.
Catgorie Commande Description
Rapports uxrepgen Gnre un rapport partir dun modle.

8.2.1 Utilisation des modles de rapports


Les modles de rapports sont regroups par thme :
Statut du job
Charge du systme
Tendances en matire de charge
Charges moyennes
Tendances en matire de russites/dchecs
Chapitre 8 Interface Commandes | 59

Jobs les plus longs


cart par rapport au temps elapsed
Les modles de rapports sont stocks dans le rpertoire:
<Serveur Reporter>\data\reports\templates\system\<db_type>

Les modles de rapports sont prfixs par Tg-o ou TUJ-o :


O :
T=Modle Dollar Universe
TUJ=Modle UniJob
g=numro du groupe
o=position dans le groupe
Exemples
T1-2 Statuts des Jobs avec la liste des Anomalies.jasper
TUJ-1-2 Job Statuts des Jobs avec la liste des Anomalies.jasper
Lutilisateur peut crer des rapports personnaliss. Les fichiers .jasper doivent tre dposs dans le
rpertoire :
<Serveur Reporter>\data\reports\templates\custom\<db_type>

Notez que les rapports personnaliss ne sont pas inclus dans de la procdure de mise jour
fournie. Si le schma de la base de donnes est modifi dans la nouvelle version, ce qui est
frquemment le cas, les rapports personnaliss devront tre adapts avant de pouvoir
fonctionner correctement.

Les modles de rapports systmes et personnaliss sont dcrits dans le Manuel Utilisateur de
Reporter.

8.2.2 Dclenchement des rapports


La commande uxrepgen peut tre lance depuis le serveur Reporter ou depuis un client Reporter.
La commande est disponible dans le rpertoire exec :
Pour le serveur Reporter :
<Serveur Reporter>\exec

Pour le client Reporter :


<SOCIETE>reporter_client\exec

Un rapport peut tre gnr de la commande suivante :


uxrepgen -REPNODE <Nud Reporter>]
-DEFINITION <Nom de la Dfinition de Rapport>
[ WAIT/NOWAIT]
60 | Chapitre 8 Interface Commandes

Arguments Description
-REPNODE Chane de dix caractres indiquant le nom logique du nud du serveur Reporter.
Si ce paramtre nest pas indiqu dans la ligne de commandes, il est automatiquement dfini
selon la valeur de la variable denvironnement REPNODE. Si la variable nexiste pas,
REPNODE sera dfini selon la valeur du paramtre com.orsyp.server.config.repnode dans le
fichier server.conf. La commande choue si ce paramtre est introuvable.
-DEFINITION Nom de la dfinition du rapport. La dfinition du rapport doit bien entendu exister.
WAIT/NOWAIT (En option) "WAIT" (par dfaut) renvoie le contrle la ligne de commande uniquement
lorsque la commande de purge a t excute (excution synchrone). "NOWAIT" renvoie le
contrle immdiatement (excution asynchrone).

8.2.3 Personnalisation des rapports


Un logo de la socit (par dfaut=AUTOMIC) est intgr en haut gauche du rapport gnr.
Ce logo est stock dans :
<Serveur Reporter>\data\report\logo.png

Ce fichier doit tre cras par le logo de la socit de lutilisateur (aprs avoir sauvegard le fichier
par dfaut).
Le nouveau logo sera redimensionn proportionnellement lespace disponible en haut gauche du
rapport.
Chapitre 9 Rsolution des problmes | 61

9 Rsolution des problmes


Cette section contient quelques conseils qui permettront de rsoudre les problmes les plus
frquents.

9.1 Traabilit du problme


Plusieurs sources dinformation permettent didentifier lorigine dun problme :
Le fichier Reporter server.log stock dans le rpertoire <Serveur Reporter>\logs
Les fichiers log, associs chaque extraction, et stocks dans la base de donnes, dans la
table UNI_EVT_LOG (et qui peuvent galement tre affichs partir de linterface UniViewer)
La table des services en cours dexcution sous Windows
La table des processus en cours dexcution sous Linux
Le log de chaque lancement sur les nuds du client Reporter
La commande unicheckrep
La commande unirepinfo
L'Audit Trail

9.2 Messages derreur


Les messages derreur lis aux situations les plus courantes sont indiqus ci-dessous.

9.2.1 Nud Reporter non dfini - Connexion refuse


(Reporter Node Not Defined Connection Refused)
Ce message saffiche lorsque lemplacement du serveur Reporter na pas t dfini :
Dfinir la variable REPNODE sur le nud de rfrence DUAS en cas de DUAS v5.3.
Redmarrer le serveur.

9.2.2 Table inexistante


(Table Does Not Exist)
Si lutilisateur de la connexion la base de donnes Reporter nest pas le propritaire du schma de
la base de donnes, le message suivant peut safficher en cas de tentative de lancement dune action
avec votre compte utilisateur de connexion :
java.sql.SQL Exception: ORA-00942: table or view does not exist

Supposez que lutilisateur repowner a t utilis pour crer le schma et que lutilisateur repcon est
utilis pour se connecter la base de donnes. Les deux utilisateurs doivent partager le mme
espace de tables.
Le script SQL suivant doit tre excut sous lutilisateur repowner afin dautoriser laccs aux tables
de Reporter pour lutilisateur repcon :
/* Grant access to Tables */
62 | Chapitre 9 Rsolution des problmes

GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_AUDITTRAIL TO


repcon;
GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_DATASOURCES TO
repcon;
GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_EXTRACTIONS TO
repcon;
GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_JOBLOGS TO
repcon;
GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_LOG TO
repcon;
GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_MESSAGES TO
repcon;
GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_PARAMETERS TO
repcon;
GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_PURGES TO
repcon;
GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_RELAUNCHES TO
repcon;
GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_REPORTS TO
repcon;
GRANT SELECT ON repowner.UNI_EVT_STATUSES TO
repcon;
GRANT SELECT, INSERT, UPDATE, DELETE ON repowner.UNI_EVT_VARIABLES TO
repcon;
GRANT SELECT ON repowner.UNI_EVT_TECH_REPORTS TO
repcon;

/* Grant access to Views */


GRANT SELECT ON repowner.UNI_REP_LAUNCHES_VIEW TO repcon;

/* Grant access to Sequences */


GRANT SELECT ON repowner.UNI_EVT_AUDITTRAIL_SEQ TO repcon;
GRANT SELECT ON repowner.UNI_EVT_DATASOURCES_SEQ TO repcon;
GRANT SELECT ON repowner.UNI_EVT_EXTRACTIONS_SEQ TO repcon;
GRANT SELECT ON repowner.UNI_EVT_LOG_SEQ TO repcon;
GRANT SELECT ON repowner.UNI_EVT_PURGES_SEQ TO repcon;
GRANT SELECT ON repowner.UNI_EVT_RELAUNCHES_SEQ TO repcon;
GRANT SELECT ON repowner.UNI_EVT_REPORTS_SEQ TO repcon;

/* Grant access to Stored Procedures */


GRANT EXECUTE ON repowner.INSERT_OR_UPDATE_RELAUNCH TO repcon;
GRANT EXECUTE ON repowner.UPDATE_RELAUNCH TO repcon;
Le script SQL suivant doit tre excut par lutilisateur repcon afin de pointer les objets appartenant
lutilisateur repowner.

/* Create SYNONYM for Tables */


CREATE SYNONYM repcon.UNI_EVT_AUDITTRAIL FOR repowner.UNI_EVT_AUDITTRAIL;
CREATE SYNONYM repcon.UNI_EVT_DATASOURCES FOR
repowner.UNI_EVT_DATASOURCES;
CREATE SYNONYM repcon.UNI_EVT_EXTRACTIONS FOR
repowner.UNI_EVT_EXTRACTIONS;
CREATE SYNONYM repcon.UNI_EVT_JOBLOGS FOR repowner.UNI_EVT_JOBLOGS;
CREATE SYNONYM repcon.UNI_EVT_LOG FOR repowner.UNI_EVT_LOG;
CREATE SYNONYM repcon.UNI_EVT_MESSAGES FOR repowner.UNI_EVT_MESSAGES;
CREATE SYNONYM repcon.UNI_EVT_PARAMETERS FOR repowner.UNI_EVT_PARAMETERS;
CREATE SYNONYM repcon.UNI_EVT_PURGES FOR repowner.UNI_EVT_PURGES;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES FOR repowner.UNI_EVT_RELAUNCHES;
CREATE SYNONYM repcon.UNI_EVT_REPORTS FOR repowner.UNI_EVT_REPORTS;
CREATE SYNONYM repcon.UNI_EVT_STATUSES FOR repowner.UNI_EVT_STATUSES;
CREATE SYNONYM repcon.UNI_EVT_VARIABLES FOR repowner.UNI_EVT_VARIABLES;
CREATE SYNONYM repcon.UNI_EVT_TECH_REPORTS FOR
repowner.UNI_EVT_TECH_REPORTS;

/* Create SYNONYM for Views */


CREATE SYNONYM repcon.UNI_REP_LAUNCHES_VIEW FOR
repowner.UNI_REP_LAUNCHES_VIEW;
Chapitre 9 Rsolution des problmes | 63

/* Create SYNONYM for Sequences */


CREATE SYNONYM repcon.UNI_EVT_AUDITTRAIL_SEQ FOR
repowner.UNI_EVT_AUDITTRAIL_SEQ;
CREATE SYNONYM repcon.UNI_EVT_DATASOURCES_SEQ FOR
repowner.UNI_EVT_DATASOURCES_SEQ;
CREATE SYNONYM repcon.UNI_EVT_EXTRACTIONS_SEQ FOR
repowner.UNI_EVT_EXTRACTIONS_SEQ;
CREATE SYNONYM repcon.UNI_EVT_LOG_SEQ FOR
repowner.UNI_EVT_LOG_SEQ;
CREATE SYNONYM repcon.UNI_EVT_PURGES_SEQ FOR
repowner.UNI_EVT_PURGES_SEQ;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_SEQ FOR
repowner.UNI_EVT_RELAUNCHES_SEQ;
CREATE SYNONYM repcon.UNI_EVT_REPORTS_SEQ FOR
repowner.UNI_EVT_REPORTS_SEQ;

/* Create SYNONYM for Constraints */


CREATE SYNONYM repcon.UNI_EVT_LOG_PK FOR repowner.UNI_EVT_LOG_PK;
CREATE SYNONYM repcon.UNI_EVT_DATASOURCES_PK FOR
repowner.UNI_EVT_DATASOURCES_PK;
CREATE SYNONYM repcon.UNI_EVT_EXTRACTIONS_PK FOR
repowner.UNI_EVT_EXTRACTIONS_PK;
CREATE SYNONYM repcon.UNI_EVT_EXTRACTIONS_FK1 FOR
repowner.UNI_EVT_EXTRACTIONS_FK1;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_PK FOR
repowner.UNI_EVT_RELAUNCHES_PK;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_FK FOR
repowner.UNI_EVT_RELAUNCHES_FK;
CREATE SYNONYM repcon.UNI_EVT_JOBLOGS_FK FOR
repowner.UNI_EVT_JOBLOGS_FK;
CREATE SYNONYM repcon.UNI_EVT_MESSAGES_FK FOR
repowner.UNI_EVT_MESSAGES_FK;
CREATE SYNONYM repcon.UNI_EVT_PARAMETERS_FK FOR
repowner.UNI_EVT_PARAMETERS_FK;
CREATE SYNONYM repcon.UNI_EVT_VARIABLES_FK FOR
repowner.UNI_EVT_VARIABLES_FK;
CREATE SYNONYM repcon.UNI_EVT_PURGES_PK FOR
repowner.UNI_EVT_PURGES_PK;
CREATE SYNONYM repcon.UNI_EVT_AUDITTRAIL_PK FOR
repowner.UNI_EVT_AUDITTRAIL_PK;
CREATE SYNONYM repcon.UNI_EVT_AUDITTRAIL_FK FOR
repowner.UNI_EVT_AUDITTRAIL_FK;
CREATE SYNONYM repcon.UNI_EVT_REPORTS_PK FOR
repowner.UNI_EVT_REPORTS_PK;
CREATE SYNONYM repcon.UNI_EVT_STATUSES_PK FOR
repowner.UNI_EVT_STATUSES_PK;
CREATE SYNONYM repcon.UNI_TECH_REPORTS_PK FOR
repowner.UNI_TECH_REPORTS_PK;

CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_UNIQUE FOR


repowner.UNI_EVT_RELAUNCHES_UNIQUE;
CREATE SYNONYM repcon.UNI_EVT_JOBLOGS_UNIQUE FOR
repowner.UNI_EVT_JOBLOGS_UNIQUE;
CREATE SYNONYM repcon.UNI_EVT_MESSAGES_UNIQUE FOR
repowner.UNI_EVT_MESSAGES_UNIQUE;
CREATE SYNONYM repcon.UNI_EVT_PARAMETERS_UNIQUE FOR
repowner.UNI_EVT_PARAMETERS_UNIQUE;
CREATE SYNONYM repcon.UNI_EVT_VARIABLES_UNIQUE FOR
repowner.UNI_EVT_VARIABLES_UNIQUE;
CREATE SYNONYM repcon.UNI_EVT_AUDITTRAIL_UNIQUE FOR
repowner.UNI_EVT_AUDITTRAIL_UNIQUE;

/* Create SYNONYM for Indexes */


CREATE SYNONYM repcon.UNI_EVT_DATASOURCES_UVMS FOR
repowner.UNI_EVT_DATASOURCES_UVMS;
CREATE SYNONYM repcon.UNI_EVT_DATASOURCES_COMPANY FOR
repowner.UNI_EVT_DATASOURCES_COMPANY;
64 | Chapitre 9 Rsolution des problmes

CREATE SYNONYM repcon.UNI_EVT_DATASOURCES_NODE FOR


repowner.UNI_EVT_DATASOURCES_NODE;
CREATE SYNONYM repcon.UNI_EVT_DATASOURCES_TAGS FOR
repowner.UNI_EVT_DATASOURCES_TAGS;
CREATE SYNONYM repcon.UNI_EVT_DATASOURCES_AREA FOR
repowner.UNI_EVT_DATASOURCES_AREA;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_SESS_NAME FOR
repowner.UNI_EVT_RELAUNCHES_SESS_NAME;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_SESS_VERS FOR
repowner.UNI_EVT_RELAUNCHES_SESS_VERS;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_UPROC_NAME FOR
repowner.UNI_EVT_RELAUNCHES_UPROC_NAME;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_UPR_VERS FOR
repowner.UNI_EVT_RELAUNCHES_UPR_VERS;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_MU FOR
repowner.UNI_EVT_RELAUNCHES_MU;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_DATASOURCE FOR
repowner.UNI_EVT_RELAUNCHES_DATASOURCE;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_NUMLANC FOR
repowner.UNI_EVT_RELAUNCHES_NUMLANC;
CREATE SYNONYM repcon.UNI_EVT_RELAUNCHES_STATUS FOR
repowner.UNI_EVT_RELAUNCHES_STATUS;
CREATE SYNONYM repcon.UNI_EVT_VARIABLES_PI FOR
repowner.UNI_EVT_VARIABLES_PI;
CREATE SYNONYM repcon.UNI_EVT_VARIABLES_NAME FOR
repowner.UNI_EVT_VARIABLES_NAME;
CREATE SYNONYM repcon.UNI_EVT_MESSAGES_PI FOR
repowner.UNI_EVT_MESSAGES_PI;
CREATE SYNONYM repcon.UNI_EVT_MESSAGES_CRE_TIME FOR
repowner.UNI_EVT_MESSAGES_CRE_TIME;
CREATE SYNONYM repcon.UNI_EVT_MESSAGES_MSG_TEXT FOR
repowner.UNI_EVT_MESSAGES_MSG_TEXT;
CREATE SYNONYM repcon.UNI_EVT_PARAMETERS_PI FOR
repowner.UNI_EVT_PARAMETERS_PI;
CREATE SYNONYM repcon.UNI_EVT_PARAMETERS_NAME FOR
repowner.UNI_EVT_PARAMETERS_NAME;
CREATE SYNONYM repcon.UNI_EVT_JOBLOGS_PI FOR
repowner.UNI_EVT_JOBLOGS_PI;
CREATE SYNONYM repcon.UNI_EVT_AUDITTRAIL_DS FOR
repowner.UNI_EVT_AUDITTRAIL_DS;
CREATE SYNONYM repcon.UNI_EVT_EXTRACTIONS_DI FOR
repowner.UNI_EVT_EXTRACTIONS_DI;
CREATE SYNONYM repcon.UNI_EVT_EXTRACTIONS_LI FOR
repowner.UNI_EVT_EXTRACTIONS_LI;
CREATE SYNONYM repcon.UNI_EVT_PURGES_LI FOR
repowner.UNI_EVT_PURGES_LI;
CREATE SYNONYM repcon.UNI_EVT_REPORTS_LI FOR
repowner.UNI_EVT_REPORTS_LI;

/* Create SYNONYM for stored procedures */2


CREATE SYNONYM repcon.INSERT_OR_UPDATE_RELAUNCH FOR
repowner.INSERT_OR_UPDATE_RELAUNCH;
CREATE SYNONYM repcon.UPDATE_RELAUNCH FOR
repowner.UPDATE_RELAUNCH;

9.2.3 Impossible de soumettre la commande Tche


incidente
(Impossible to submit command job aborted)
COMMAND: ../../../reporter_client/exec/uxrepadd EXT -REPNODE frlpmdev04 -
PRODUCT UNIJOB -UVMS *

Le message derreur ci-dessus saffiche dans le log d'un job planifi en interne, appel par exemple
REP_EXT_<nodename>_<counter>, si le client Reporter pour UniJob na pas t install.
Chapitre 9 Rsolution des problmes | 65

9.2.4 Extractions impossibles


(Extractions Do Not Work)
Si les demandes manuelles dextraction restent sans effet, cela peut tre d une erreur de version
du pilote JDBC install.
Labsence du ojdbc5.jar provoque laffichage de messages derreur clairs indiquant que le pilote
JDBC Oracle na pas t install. Cependant, en cas dinstallation dune version inapproprie du
ojdbc5.jar, aucun message derreur clair ne saffiche.
Tlcharger le fichier Oracle 11g Release 2 ojdbc5.jar et redmarrer le serveur Reporter.

9.2.5 Connexion la base de donnes


(Database Connection)
En cas de problme de configuration de la connexion la base de donnes, le message suivant peut
safficher lors de louverture dun document :
REPORTER: Reporter Extraction Monitor on <nodename>:
Could not get last extraction source status : Could not open a connection to
the database. Check your database settings.
Solution :
Ouvrez le document des paramtres du nud Reporter.
Vrifiez le champ relatif la connexion la base de donnes.
Vrifiez que la connexion est valide en cliquant sur Valider connexion BD.
Aucun redmarrage nest ncessaire.

9.2.6 Connexion UniViewer Management Serveur


(UniViewer management Server Connection)
En cas de problme de configuration de la connexion UVMS, le message suivant peut safficher :
REPORTER: Reporter Extraction Monitor on <nodename>:
Could not get last extraction source status: Unable to initiate a connection
to the central server.connect: error creating socket.

Ouvrez les paramtres du nud Reporter


Vrifiez le champ relatif la connexion UVMS
Vrifiez que la connexion est valide en cliquant sur Valider la connexion UniViewer
UVMS doit tre redmarr.

9.2.7 Rapports personnaliss en erreur


Les rapports personnaliss peuvent chouer avec l'erreur Process ABORTED. Status changed to
ABORTED: Font 'sansserif' is not available to the JVM. See the Javadoc for more details: ceci est d
une erreur dans iReport v3.0.0 (Reporter v3).
Vrifiez que vous avez install et configur iReport v4.0.2 comme expliqu au chapitre 5.4 du
manuel utilisateur de Reporter.
Pour chaque rapport personnalis :
o Ouvrez le fichier jasper correspondant dans iReport v4.0.2 (ce fichier est situ dans le
rpertoire Reporter\data\reports\templates\custom\<BD>).
66 | Chapitre 9 Rsolution des problmes

o Enregistrez-le en tant que fichier jrxml.


o Ouvrez le fichier jrxml avec un diteur de texte.
o Remplacez le nom de police 'sansserif' par 'SansSerif'.
o Enregistrez le fichier jrxml.
o Dans iReport v4.0.2, chargez le fichier jrxml.
o Compilez-le.
o Copiez le fichier jasper obtenu dans le rpertoire
Reporter\data\reports\templates\custom\<BD>.

9.3 Modification du Java Runtime Environment


Si le Java Runtime Enviroment est mis jour, la configuration Reporter doit tre modifie comme suit:
Editez le fichier
o Sous Windows : <rpertoire racine Reporter>/mgr/setenv.bat
o Sous Linux : <rpertoire racine Reporter >/mgr/setenv.sh
Modifiez la variable JAVA_ORSYP avec le chemin du nouveau JRE
Enregistrez le fichier
Arrtez et redmarrez Reporter
Chapitre 10 Modle de donnes de Reporter v6 | 67

10 Modle de donnes de Reporter v6


Le modle de donnes est dtaill ci-dessous.

Figure 3: Modle de donnes du serveur Reporter v6


68 | Chapitre 10 Modle de donnes de Reporter v6

10.1 Tables fonctionnelles de la base de


donnes

10.1.1 UNI_EVT_AUDITTRAIL
Toutes les activits interactives au sein de Dollar Universe sont traces dans le fichier dAudit Trail.
Les donnes d'Audit Trail sont galement stockes dans la base de donnes Reporter afin de pouvoir
corrler les modifications des paramtres et les volutions de lactivit de production.
L'Audit Trail nest pas li un lancement ni une excution en particulier, mais une source de
donnes.
Les informations relatives aux Uproc/Session/UG peuvent tre rcupres dans le champ
AUDITTRAIL_KEY de l'Audit Trail.
Les lments ne sont pas dupliqus (comme par exemple aprs 2 extractions).

Les lments de UNI_EVT_AUDITTRAIL ne sont pas purgs par les outils de purge Reporter.

Nom de la colonne Format Description


AUDITTRAIL_ID Nombre Cl primaire.
DATASOURCE_ID Nombre Cl trangre vers le nud qui a gnr l'audit trail o
l'action a eu lieu
AUDITTRAIL_DATE Date Date de lvnement
AUDITTRAIL_USERSYSTEM chane de 64 Utilisateur du systme sous lequel laction a eu lieu.
caractres
AUDITTRAIL_USERUNIVERSE chane de 64 Utilisateur de proxy Dollar Universe correspondant.
caractres
AUDITTRAIL_PROFILE chane de 64 Profil utilisateur correspondant.
caractres
AUDITTRAIL_NODE chane de 256 Nud partir duquel une action a t gnre, mais
caractres pas ncessairement o laction a eu lieu.
AUDITTRAIL_PROG chane de 50 Composant technique utilis pour effectuer laction.
caractres
AUDITTRAIL_ACTION chane de 50 Opration effectue par le composant.
caractres
AUDITTRAIL_OBJECT chane de 50 Type de cible pour lopration (Uproc, session, etc.)
caractres
AUDITTRAIL_KEY chane de 256 Identifiant de lobjet cible (nom de la tche, etc.).
caractres
AUDITTRAIL_MU chane de 64 Sous-composant de l'objet (nom de l'UG extrait de la
caractres cl, par exemple)
AUDITTRAIL_SESSION chane de 256 Sous-composant de l'objet (nom de la session extrait
caractres de la cl, par exemple)
AUDITTRAIL_UPROC chane de 256 Sous-composant de l'objet (nom de l'Uproc extrait de la
caractres cl, par exemple)

10.1.2 UNI_EVT_DATASOURCES
Les informations relatives aux sources de donnes sont conserves dans
"UNI_EVT_DATASOURCES".
Chapitre 10 Modle de donnes de Reporter v6 | 69

chaque fois quune nouvelle source de donnes est rencontre, elle est enregistre dans cette
table (triplet Socit/Nud/Espace).
La liste des sources de donnes est extraite de l'UVMS au dbut de chaque extraction. Si un Nud
est prsent dans la base de donnes mais est absent de l'UVMS, il est alors marqu comme tant
supprim. Les sources de donnes marques comme tant supprimes sont ignores pendant la
gnration dun rapport.
Les informations dune source de donnes sont synchronises avec l'UVMS au dbut de chaque
extraction. Tous les lments de donnes sont impliqus, lexception de COMPANY_NAME,
NODE_NAME, AREA_NAME.

Nom de la colonne Format Description


DATASOURCE_ID Numrique Code didentification gnr automatiquement. Cl primaire
pour cette table.
PRODUCT_NAME Chane de 20 Nom du composant logiciel (comme Dollar Universe, UniJob,
caractres etc.)
PRODUCT_VERSION Chane de 10 Version du logiciel
caractres
COMPANY_NAME Chane de 6 Rcupr partir de lenvironnement.
caractres
COMPANY_LABEL Chane de 64 Rcupr partir de la table de Socits DUAS.
caractres
NODE_NAME Chane de 64 Rcupr partir de lenvironnement.
caractres
NODE_LABEL Chane de 64 Rcupr partir de la table de Nuds DUAS
caractres
AREA_NAME 1 caractre Rcupr partir de lenvironnement.
AREA_LABEL Chane de 64 Rcupr partir de lEspace DUAS.
caractres
TAG_NAME Chane de 900 Liste des Etiquettes dun Nud.
caractres
UVMS_NAME Chane de 64 Management Serveur UniViewer sur lequel est enregistr le
caractres Nud.
DELETED Horodatage Date laquelle le Nud a t supprim du Management
Serveur.

10.1.3 UNI_EVT_INTERVENTIONS
Cette table contient lhistorique des interventions qui a t notablement enrichi avec Dollar Universe
v6.0. Lhistorique des interventions trace les actions des utilisateurs (par exemple modifier une fentre
de lancement ou suspendre un lancement) qui modifient le comportement normal des lancements
existants. Dollar Universe Application Server v6 introduit les exceptions qui sappliquent aux
lancements qui nont pas encore t calculs.
Selon le type dintervention, plusieurs champs peuvent ne pas tre remplis. Les actions engages par
loprateur (suspendre, modifier etc.) sur des lancements existants dans la liste des excutions sont
enregistres dans la structure HISTORY de cette table. Les exceptions dfinies sur des lancements
qui nont pas encore t gnrs apparaissent dabord dans la structure EXCEPT puis dans la
structure HISTORY lorsque lexception a t applique.

Nom de la colonne Format Description


EXCEPTION_ID Numrique Cl primaire.
DATASOURCE_ID Numrique Cl trangre vers le triplet
SOCIETE/NOEUD/ESPACE
70 | Chapitre 10 Modle de donnes de Reporter v6

Nom de la colonne Format Description


HISTORY_OEXID_SUBTYPE 1 caractre Sous-type historique : X (Exception), O (Plage
de maintenance), T (Tche optionnelle) L
(Hritage).
HISTORY_OEXID_PARENTTASK_NAME Chane de 64 Nom historique de la tche principale
caractres
HISTORY_OEXID_PARENTTASK_VERS Chane de 3 Version historique de la tche principale
caractres
HISTORY_OEXID_PARENTTASK_MU Chane de 64 UG historique de la tche principale
caractres
HISTORY_OEXID_SPECTASK_NAME Chane de 64 Nom historique de la tche spcifique
caractres
HISTORY_OEXID_SPECTASK_VERS Chane de 3 Version historique de la tche spcifique
caractres
HISTORY_OEXID_SESSION_NAME Chane de 64 Nom historique de la Session
caractres
HISTORY_OEXID_SESSION_VERS Chane de 3 Version historique de la Session
caractres
HISTORY_OEXID_UPROC_NAME Chane de 64 Nom historique de lUproc
caractres
HISTORY_OEXID_UPROC_VERS Chane de 3 Version historique de lUproc
caractres
HISTORY_OEXID_MUID_NAME Chane de 64 Nom historique de lunit de gestion
caractres
HISTORY_OEXID_TYPUG 1 caractre Type historique de lunit de gestion
HISTORY_OEXID_NUMLAUNCH Numrique Numro de lancement historique
HISTORY_OEXID_NUMSESSION Numrique Numro dexcution de Session historique
HISTORY_OEXID_NUMPROC Numrique Numro dexcution dUproc historique
EXCEPT_OEXID_TYPE 1 caractre Type d'exception: H (Historique), X (Exception)
ou O (Plage de maintenance).
EXCEPT_OEXID_SUBTYPE 1 caractre Sous-type dexception :
Si type = H : X (Exception), O (Plage de
lancement), T (tche optionnelle) L (hritage).
Si type= X : B (lancement sans pilotage), S
(lancement sans excution) F (Forcer termin)
H (suspendu) P (pas de lancement).
Si Type= O : G (Gnral) T (Type UG) M (UG)
EXCEPT_OEXID_PARENTTASK_NAME Chane de 64 Nom de lexception de la tche principale
caractres
EXCEPT_OEXID_PARENTTASK_VERS Chane de 3 Version de lexception de la tche principale
caractres
EXCEPT_OEXID_PARENTTASK_MU Chane de 64 UG de lexception de la tche principale
caractres
EXCEPT_OEXID_SPECTASK_NAME Chane de 64 Nom de lexception de la tche spcifique
caractres
EXCEPT_OEXID_SPECTASK_VERS Chane de 3 Version de lexception de la tche spcifique
caractres
EXCEPT_OEXID_SESSION_NAME Chane de 64 Nom de de la session de lexception
caractres
EXCEPT_OEXID_SESSION_VERS Chane de 3 Version de la Session de lexception
Chapitre 10 Modle de donnes de Reporter v6 | 71

Nom de la colonne Format Description


caractres
EXCEPT_OEXID_UPROC_NAME Chane de 64 Nom de lUproc de lexception
caractres
EXCEPT_OEXID_UPROC_VERS Chane de 3 Version de lUproc de lexception
caractres
EXCEPT_OEXID_MUID_NAME Chane de 64 Nom de lUnit de gestion de lexception
caractres
EXCEPT_OEXID_TYPUG 1 caractre Type de lUnit de gestion de lexception
EXCEPT_OEXID_NUMLAUNCH Numrique Numro de lancement de lexception
EXCEPT_OEXID_NUMSESSION Numrique Numro dexcution de la Session de
lexception
EXCEPT_OEXID_NUMPROC Numrique Numro dexcution de lUproc de lexception
EXCEPT_VALIDITY_CONSUMED 1 caractre " " (non consomm) C (consomm) dfini par
le serveur dIO
EXCEPT_VALIDITY_COUNTER Numrique Dfinit le nombre de fois qu'une exception peut
tre applique
EXCEPT_VALIDITY_STARTDATE Indicateur Dbut de la fentre de validit
temporel
EXCEPT_VALIDITY_ENDDATE Indicateur Fin de la fentre de validit
temporel
EXCEPT_VALIDITY_PROCESSDATE Indicateur Filtre sur la validit de la date de traitement
temporel
EXCEPT_VALIDITY_TYPE 1 caractre Critre de validit dfinit par le serveur dIO :
0 (pas de critre), 1 (compteur), 2 (fentre), 3
(date de traitement), 4 (compteur + fentre), 5
(compteur + date de traitement), 6 (fentre +
date de traitement), 7 (compteur + fentre +
date de traitement).
EXCEPT_LABEL Chane de 64 Description de lexception
caractres
EXCEPT_OPTIONS_CREATEWEVENT 1 caractre Option de cration dvnement pour une
exception Pas de lancement/Optionnel.
HISTORY_APPLICATION_DATE Indicateur Date dexception applique
temporel
HISTORY_ORIGTYPE 1 caractre Type dintervention
LAUNCH_ORIGIN_NUMPROC Numrique Numro dexcution dUproc du lancement sur
lequel lexception a t applique.
LAUNCH_ORIGIN_STATE 1 caractre Statut du lancement lorsque lexception a t
applique.
LAUNCH_ORIGIN_STARTDATE Indicateur Dbut de la fentre de lancement lorsque
temporel lexception a t applique.
LAUNCH_ORIGIN_ENDDATE Indicateur Fin de la fentre de lancement lorsque
temporel lexception a t applique.
LAUNCH_ORIGIN_PROCESSDATE Indicateur Date de traitement lorsque lexception a t
temporel applique.
LAUNCH_ORIGIN_NUMPROCRE Numrique Numro de lancement de la reprise
LAUNCH_ORIGIN_USER Chane de 64 Compte de soumission origine
caractres
LAUNCH_ORIGIN_PRIORITY Numrique Priorit Origine
72 | Chapitre 10 Modle de donnes de Reporter v6

Nom de la colonne Format Description


LAUNCH_ORIGIN_QUEUE Chane de 31 Nom de la queue batch origine
caractres
OPTIONAL_TASK_NAME Chane de 64 Nom de la tche optionnelle qui a gnr une
caractres exception historique
OPTIONAL_TASK_VERS Chane de 3 Version de la tche optionnelle qui a gnr
caractres une exception historique
OPTIONAL_TASK_TYPE 1 caractre Type de la tche optionnelle : b (lancement
sans pilotage) s (lancement sans excution), h
(suspendu) f (forcer termin) p (tche
optionnelle) e (cration dvnement
uniquement)
LEGACY ACTION 1 caractre H (suspendre), B (lancer sans pilotage) R
(librer) L (lancer)
PROVOKED_TASK_NAME Chane de 64 Nom de la tche provoque qui a gnr une
caractres exception historique
PROVOKED_TASK_VERS Chane de 3 Version de la tche provoque qui a gnr
caractres une exception historique
PROVOKED_TASK_UPD_PRIORITY 1 caractre Priorit mise jour de la tche provoque qui a
gnr une exception historique
PROVOKED_TASK_UPD_PROCDATE 1 caractre Date de traitement mise jour de la tche
provoque qui a gnr une exception
historique
PROVOKED_TASK_UPD_QUEUE 1 caractre Queue mise jour de la tche provoque qui a
gnr une exception historique
PROVOKED_TASK_UPD_USER 1 caractre Utilisateur mis jour de la tche provoque qui
a gnr une exception historique

10.1.4 UNI_EVT_JOBLOGS
La rcupration des logs des jobs est optionnelle. Les logs des jobs termins et/ou incidents
peuvent tre rcuprs. Le log peut galement tre tronqu en cas de dpassement de la taille limite
prdtermine. Consulter le Manuel Utilisateur Reporter pour savoir comment configurer le systme
(nud Reporter, paramtres des nuds, paramtres du processus dextraction).

Nom de la colonne Format Description


RELAUNCH_ID Numrique Cl primaire de la table
JOBLOG Texte Log du job rcupr pour lexcution

10.1.5 UNI_EVT_MESSAGES
Chaque phase dexcution dune Uproc peut contenir un ou plusieurs message(s) gnr(s) dans son
log et dans sa trace automate laide de la commande uxset msg. Chaque message est dat.

Nom de la colonne Format Description


RELAUNCH_ID Numrique Cl primaire gnre automatiquement.
MESSAGE_TEXT Chane de 124 caractres Message gnr.
CREATION_TIMESTAMP Indicateur temporel Date laquelle ce message a t gnr.
Chapitre 10 Modle de donnes de Reporter v6 | 73

10.1.6 UNI_EVT_PARAMETERS
Une Uproc peut tre lanc avec 30 paramtres au maximum. Les paramtres sont stocks dans le
fichier dhistorique afin de pouvoir les rcuprer.
Nom de la colonne Format Description
RELAUNCH_ID Numrique Cl primaire gnre automatiquement.
PARAMETER_NAME Chane de 64 caractres Nom utilis pour dsigner le paramtre.
PARAMETER_VALUE Chane de 256 caractres Valeur donne au paramtre pendant lexcution.

10.1.7 UNI_EVT_RELAUNCHES
Ce paragraphe dcrit les tables destines contenir les donnes gnres au cours de lexcution
de jobs sur les sources de donnes cibles.
Pendant lexcution d'un job, certains lments peuvent changer : nombre de Steps, Messages,
Statut, Paramtres et Variables. Seul le dernier tat (information, svrit, statut, paramtres et
variables) est accessible. Ce paragraphe dcrit les tables qui contiennent les donnes qui
caractrisent les lancements de jobs.
Diffrentes "phases" d'un job partagent le mme numro de lancement.
La table centrale du modle de donnes est UNI_EVT_RELAUNCHES. Cette table contient les
donnes communes lensemble des excutions dun lancement donn (cest--dire lensemble des
enregistrements ayant la mme valeur dans "SOCIETE/NOEUD/ESPACE/NUMERO de
LANCEMENT").
Un lancement peut tre associ plusieurs excutions (comme par exemple en cas de relance d
des conditions non satisfaites).
Nom de la colonne Format Description
RELAUNCH_ID Numrique Cl primaire gnre automatiquement.
DATASOURCE_ID Numrique Cl trangre destine au triplet
"COMPANY/NODE/AREA"
(Socit/Nud/Espace).
MANAGEMENT_UNIT_NAME Chane de 64 caractres Unit de Gestion des excutions.
MANAGEMENT_UNIT_LABEL Chane de 64 caractres Description de lUnit de Gestion.
MANAGEMENT_UNIT_OFFSET_HH Chane de 3 caractres Dcalage horaire (heures) par rapport la
table des UG.
MANAGEMENT_UNIT_OFFSET_MM Chane de 2 caractres Dcalage horaire (minutes) par rapport
la table des UG.
MANAGEMENT_UNIT_OFFSET_SIGN Chane de 1 caractre Dcalage horaire (direction) par rapport
la table des UG.
SESSION_NAME Chane de 64 caractres Nom de la Session.
SESSION_LABEL Chane de 64 caractres Description de la Session.
SESSION_NODE Chane de 64 caractres Nud sur lequel est excute la Session.
SESSION_VERSION Chane de 3 caractres Version de la Session.
UPROC_NAME Chane de 64 caractres Nom de l'Uproc.
UPROC_LABEL Chane de 64 caractres Description de l'Uproc.
UPROC_TYPE Chane de 10 caractres Type d'Uproc
UPROC_VERSION Chane de 3 caractres Version de lUproc.
RANK_IN_SESSION Chane de 4 caractres Position de lUproc au sein de la Session.
74 | Chapitre 10 Modle de donnes de Reporter v6

Nom de la colonne Format Description


SESSION_NUM Chane de 7 caractres Numro de Session commun tous les
Uprocs dans le cadre de la mme
excution de la Session.
LAUNCH_NUM Chane de 7 caractres Numro de lancements futurs.
LAUNCH_NUM_ORIG Chane de 7 caractres Numro de lancement initial
APPLICATION Chane de 64 caractres Code de lapplication de l'Uproc
PROCESSING_DATE Chane de 8 caractres Date des donnes traites.
RELAUNCH_NUM Numrique Compteur de relances
ACCOUNT_NAME Chane de 64 caractres Compte utilisateur de soumission.
ACCOUNT_CODE Chane de 4 caractres Code auteur du compte de soumission.
PRIORITY Chane de 4 caractres Priorit de mise en queue batch
QUEUE_NAME Chane de 31 caractres Nom de la queue batch
QUEUE_ENTRY_NO Chane de 6 caractres Compteur de soumissions
STARTING_EVT_TIME Indicateur temporel Heure de vrification de la 1re condition
PENDING_EVT_TIME Indicateur temporel Heure de soumission de lexcution
RUNNING_EVT_TIME Indicateur temporel Heure de dbut de lexcution
ENDING_EVT_TIME Indicateur temporel Heure de fin de lexcution
FINAL_STATUS Chane de 1 caractre Code de statut dexcution du job
FINAL_EXECUTION_NUM Chane de 7 caractres Numro dexcution
FINAL_EXECUTION_NUM_ORIG Chane de 7 caractres Numro dexcution origine
FINAL_INFORMATION Chane de 50 caractres Code dinformation la fin du job
FINAL_SEVERITY Chane de 4 caractres Code de svrit la fin du job.
LAUNCH_WAIT_TIME Indicateur temporel Dbut de la plage de lancement
COMPL_IN_PROGRESS_TIME Indicateur temporel Dbut des consignes de terminaison
LAST_DISABLE_TIME Indicateur temporel Heure de la dernire dsactivation
LAST_ACKNOWLEDGE_TIME Indicateur temporel Heure du dernier acquittement utilisateur
EVT_WAIT_COUNT Numrique Nombre de lancement stant termins en
attente dvnement
TASK_NAME Chane de 64 caractres Identifiant de la tche
TASK_VERSION Chane de 3 caractres Version de la Tche
SPECIFIC_TASK Chane de 64 caractres Tches optionnelles et provoques
associes
MASK_FLAGS Numrique Colonne utilise pour stocker les statuts
avancs dune excution (colonne Actions
dans le suivi des excutions). Lencodage
de cette colonne est propritaire.
EXEC_RETURN_CODE Numrique Code retour de lexcution

10.1.8 UNI_EVT_STATUSES
Nom de la colonne Format Description
STATUS_ID Nombre Cl primaire de la table
STATUS_CODE Chane de 2 caractres Correspond au FINAL_STATUS dans la table de relances.
Chapitre 10 Modle de donnes de Reporter v6 | 75

Nom de la colonne Format Description


STATUS_LABEL Chane de 30 caractres Statut final. Termin", "Incident", "Refus" ou "Horaire
dpass"

10.1.9 UNI_EVT_VARIABLES
Une Uproc peut contenir jusqu 80 variables nommes avec ou sans valeur. Les valeurs des
variables peuvent tre modifies au sein de la tche, lors des lancements manuels ou lors des
rcuprations. Les valeurs initiales peuvent galement avoir t modifies pendant lexcution dune
Uproc par la commande uxset var.

Nom de la colonne Format Description


RELAUNCH_ID Numrique Cl primaire gnre automatiquement.
VARIABLE_NAME Chane de 256 caractres Nom utilis pour dsigner la variable.
VARIABLE_VALUE Chane de 1024 caractre Valeur donne la variable pendant lexcution.

10.2 Tables techniques de la base de donnes

10.2.1 UNI_EVT_EXTRACTIONS
Cette table contient les donnes dhistorique des extractions.
Nom de la colonne Format Description
EXTRACTION_ID Numrique Cl primaire gnre automatiquement.
DATASOURCE_ID Numrique Rfrence vers la cl primaire du data source
associ
START_TIMESTAMP Indicateur temporel Date/heure de dbut de lextraction
LAST_UPDATE_TIMESTAMP Indicateur temporel Date/heure de la dernire mise jour du
statut de lextraction
LAST_RECORD_TIMESTAMP Chane de 16 caractres Date/heure de la dernire excution extraite
LAST_AUDIT_TIMESTAMP Chane de 16 caractres Date dextraction du dernier enregistrement
daudit
LAST_OEX_TIMESTAMP Chane de 16 caractres Date dextraction du dernier enregistrement
dhistorique des interventions
RECORD_COUNT Numrique Nombre dlments extraits
STATUS Chane de 30 caractres Statut de lextraction
LOG_ID Numrique Rfrence vers la cl primaire du log associ
EXTRACTION_SET_NAME Chane de 256 caractres Nom de lextraction (obsolte)
CONTINUOUS Numrique 0 en cas dextraction manuelle ou planifie ; 1
en cas de gnration par le mcanisme
dintervalle dextraction continu

10.2.2 UNI_EVT_LOG
Cette table contient les messages dvolution des rapports, des purges et des extractions.
76 | Chapitre 10 Modle de donnes de Reporter v6

Nom de la colonne Format Description


LOG_ID Numrique Cl primaire gnre automatiquement.
MESSAGE Chane de 4000 caractres
TYPE Numrique

10.2.3 UNI_EVT_PURGES
Cette table contient les donnes dhistorique des purges.
Nom de la colonne Format Description
PURGE_ID Numrique Cl primaire gnre automatiquement.
PURGE_TYPE Chane de 256 caractres Toujours manuel.
START_TIMESTAMP Indicateur temporel Date/heure de dmarrage de la purge
LAST_UPDATE_TIMESTAMP Indicateur temporel Date/heure de fin de la dernire mise jour
du statut de la purge
RECORD_COUNT Numrique Nombre dlments purgs
END_TIMESTAMP Indicateur temporel Date/heure de fin de la purge
STATUS Chane de 30 caractres Statut de la purge
LOG_ID Numrique Rfrence vers la cl primaire du log associ

10.2.4 UNI_EVT_REPORTS
Cette table contient les donnes dhistorique des gnrations de rapports.

Nom de la colonne Format Description


REPORT_ID Numrique Cl primaire gnre automatiquement.
REPORT_DEFINITION_NAME Chane de 512 caractres Nom du rapport (dfini manuellement en
cas de rapport particulier).
REPORT_TEMPLATE_NAME Chane de 512 caractres Nom du modle utilis
START_TIMESTAMP Indicateur temporel Date/heure de dmarrage de la gnration
du rapport
END_TIMESTAMP Indicateur temporel Date/heure de fin de la gnration du
rapport
STATUS Chane de 30 caractres Statut de la gnration du rapport
LOG_ID Numrique Rfrence vers la cl primaire du log
associ
OUTDATED_NODES_COUNT Numrique Nombre de nuds non jour

10.2.5 UNI_TECH_REPORTS
Cette table technique simplifie le processus de gnration de rapports.
Nom de la colonne Format Description
TECH_ID Numrique Cl primaire gnre automatiquement.
DAY_HOUR Numrique Liste des heures de la journe.
WEEK_DAY Numrique Liste des jours de la semaine.
Chapitre 10 Modle de donnes de Reporter v6 | 77

Nom de la colonne Format Description


WEEK_DAY_NAME Chane de 10 caractres Nom du jour de la semaine.
YEAR_MONTH Numrique Liste des mois de lanne.
YEAR_MONTH_NAME Chane de 10 caractres Nom du mois.
78 | Chapitre 11 A propos d'Automic, de la communaut et des services

11 A propos d'Automic, de la
communaut et des services
Ce sujet prsente la socit Automic Software et comment tirer parti de toutes les solutions que nous
vous proposons.

Vous pouvez galement accder la documentation en ligne d'Automic l'adresse


docs.automic.com.

11.1 La socit Automic Software


Automic Software est ddie l'automatisation de l'entreprise.

Automic est la plateforme la plus complte pour l'automatisation de l'entreprise. Fonde en 1985,
Automic a lanc la plate-forme d'automatisation indpendante la plus vaste, dploye l'chelle
mondiale qui renforce les applications l'infrastructure et l'entreprise. Maintenant que la
consumrisation de l'informatique s'acclre, Automic r-imagine comment les organisations
s'intgrent dans les modles de services de nouvelle gnration comme le Cloud, Big Data et
DevOps. Aujourd'hui, nos logiciels automatisent des dizaines de millions d'oprations par jour pour
plus de 2000 clients dans le monde entier. Nous dfions la pense conventionnelle, permettant nos
clients d'tre plus rapides, plus intelligents dans le contrle des oprations. Automic le standard
dans l'automatisation de l'entreprise.
Pour en savoir plus, visitez notre site web www.automic.com .

11.2 La communaut Automic


Vous voulez communiquer avec d'autres utilisateurs Automic pour comparer des ides ou apprendre
comment d'autres s'attaquent aux problmes que vous rencontrez ?

Partagez avec d'autres utilisateurs du monde entier pour apprendre comment ils optimisent
l'automatisation de l'entreprise l'aide d'Automic. Dialoguez avec l'quipe Automic pour obtenir des
trucs et astuces directement de la source.
Rejoignez la communaut Automic et devenez un initi Automic pour tre parmi les premiers
recevoir des nouvelles sur les nouveaux produits et vnements, parfois mme avant qu'ils ne soient
annoncs !

11.3 Centre de tlchargement


Assurez-vous que vous utilisez tout le potentiel de nos produits.

Le Centre de tlchargement est l'emplacement o vous trouverez les tlchargements des produits,
la documentation et les informations sur les nouvelles mises jour et la rsolution des problmes de
votre solution Automic. Tout est regroup : les mises jour, les release notes et tous les manuels
utilisateurs. Vous trouverez galement la description des patchs, les problmes connus et les
solutions de contournement.
Chapitre 11 A propos d'Automic, de la communaut et des services | 79

11.4 Support technique


Vous pouvez faire confiance notre quipe de support.

Notre quipe de professionnels est votre service, n'importe o et n'importe quand. Plusieurs centres
de supports situs en Europe, en Amrique du nord et en Asie Pacifique constituent le cur de
l'organisation du support Automic.
Vos experts Automic de nos quipes de support technique sont au plus quelques heures de vol,
quel que soit le continent sur lequel vos filiales et vos centres de donnes sont situs. Automic
Software est conue pour fournir une connectivit mondiale des entreprises internationales. Vous
utilisez les logiciels Automic l'chelle mondiale, vous pouvez donc vous attendre un service
mondial.

11.5 Formation et services


Vous voulez en savoir plus sur les solutions Automic ?

Nous proposons une gamme de formations sur la faon de tirer le meilleur parti de votre solution
Automic. Selon votre localisation, vous pouvez participer aux sessions de formations organises au
centre de formation d'Automic ou nous pouvons organiser des sessions de formation personnalises
sur le site de votre entreprise, selon ce qui vous convient le mieux.
Visitez le site du centre de formation pour obtenir des informations dtailles sur les cours proposs.

You might also like