Professional Documents
Culture Documents
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
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.
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.
3 Concepts et Architecture
3.1 Concepts
Cette section prsente la terminologie essentielle lie au produit.
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.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.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.
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.
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.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.
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.
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."
La procdure recherche alors le fichier values.xml dans le sous-rpertoire data pour vrifier que
lemplacement correct a t spcifi.
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.
Si le chemin daccs contient des espaces, excutez le script partir du rpertoire local.
Ou :
sqlcmd U <repowner> P <mot de passe> d <REP DB> i <Server
Reporter>/dbscripts/mssqlserver/create_db_mssql.sql
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).
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.
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
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
Lorsque la configuration SSL est termine, le serveur Reporter doit tre redmarr.
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
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
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
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
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
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:
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
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
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
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
Certificate deleted
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
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.
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.
Le schma de la base de donnes n'a pas t modifi entre la version 4.0.10 et la version 6.
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.
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 /
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
Si le chemin daccs contient des caractres espaces, excutez le script depuis le rpertoire
local.
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
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.
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.
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
Une mise jour de version majeure requiert la saisie d'une nouvelle licence Reporter (v3 ->
v4, v4 -> v6).
====================================
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.
_______________________________________________________
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.
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
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.
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
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.
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.
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.
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.
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
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
***********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.
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).
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.
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).
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
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
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
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.
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.
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.
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).
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.
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
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
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.
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
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.
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
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.
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 .
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 !
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
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.
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.