Le programme de lancement d'applicatifs peut utiliser le protocole HTTP ou HTTPS pour envoyer les informations sous forme de données XML à la servlet de création de rapports de gestion d'applications de ZfD (zfdamrServlet). La servlet traite les messages et les ajoute à une base de données conforme JDBC*, comme la base de données Sybase fournie avec ZfD.
Pour configurer la fonction de rapport de trappes XML, vous devez exécuter les tâches suivantes :
Configuration requise pour la servlet de création de rapports
La servlet de création de rapports nécessite l'un des environnements serveur suivants. Le numéro de version indiqué représente la version minimum nécessaire.
Server
Moteur de servlet Java
JVM
NetWare® 6 (Support Pack 2 ou version ultérieure) 1
Tomcat 3.3a
Novell JVM* for NetWare 1.3.1
Windows 2000 (avec le dernier service pack)
Tomcat 3.3a
Sun JDK 1.3.1_01
1 Support Pack 2 ou version ultérieure nécessaire. Sans Support Pack 2 ou version ultérieure, la servlet de création de rapport risque de faire passer le niveau d'utilisation du serveur à 100 % et de ne pas le libérer.
Pour plus d'informations sur l'installation de Tomcat sous NetWare 6, reportez-vous à la documentation NetWare 6.
Pour plus d'informations sur l'installation de Tomcat sous Windows 2000, reportez-vous au site Web Apache Tomcat.
Installation de la servlet de création de rapports
Copiez le fichier zfdamrServlet.war à partir du répertoire PUBLIC\REPORTING\CANNED\NAL REPORTS du volume SYS: sur le serveur ZfD vers le répertoire Tomcat WEBAPPS.
Ce fichier est également disponible dans le répertoire ZENWORKS\PRODUCTS\APPMGMT\NAL REPORTS sur le CD Programme de ZfD 4 .
Relancez Tomcat pour développer le fichier zfdamrServlet.war.
ou
Si vous ne voulez pas relancer Tomcat, utilisez les outils fournis avec Tomcat pour développer le fichier.
Configuration de la servlet de création de rapports
La servlet de création de rapport doit connaître certaines informations au sujet de la base de données dans laquelle elle va consigner les événements de rapport. Pour fournir ces informations :
Ouvrez le fichier WEB.XML. Ce fichier est situé dans le répertoire WEBAPPS\ZFDAMRSERVLET\WEB-INF de Tomcat
Si vous utilisez une base de données Sybase, localisez le paramètre dbip > modifiez la valeur du paramètre pour utiliser l'adresse IP du serveur de base de données. L'adresse IP est le seul paramètre à modifier pour une base de données Sybase.
ou
Si vous utilisez une autre base de données, modifiez les paramètres décrits ci-dessous en fonction de la base de données utilisée.
dbuser : Entrez un nom d'utilisateur permettant un accès en écriture à la base de données. L'accès en lecture n'est pas nécessaire. Le nom d'utilisateur préconfiguré (MW_DBA) est le nom d'utilisateur par défaut pour l'accès en lecture/écriture à une base de données Sybase créée par le programme d'installation de ZfD. Si vous utilisez une base de données Sybase de ZfD et que vous ne modifiez pas le nom d'utilisateur pour l'accès en lecture/écriture, vous n'avez pas besoin de modifier ce paramètre.
dbpasswd : Entrez le mot de passe correspondant au nom d'utilisateur spécifié par le paramètre dbuser. Le mot de passe préconfiguré (novell) est le mot de passe utilisateur par défaut pour l'accès en lecture/écriture à une base de données Sybase créée par le programme d'installation de ZfD. Si vous utilisez une base de données Sybase de ZfD et que vous ne modifiez pas le mot de passe de l'utilisateur par défaut pour l'accès en lecture/écriture, vous n'avez pas besoin de modifier ce paramètre.
dbip : Entrez l'adresse IP du serveur qui exécute la base de données.
dbport : Entrez le port d'écoute de la base de données. Le port préconfiguré (2638) est le port serveur par défaut de NetWare pour une base de données créée par le programme d'installation de ZfD. Si vous utilisez une base de données Sybase de ZfD sous NetWare et que vous ne modifiez pas le port par défaut, vous n'avez pas besoin de modifier ce paramètre.
dbprotocol : Entrez le protocole à utiliser pour accéder à la base de données. Pour Sybase, il s'agit de jdbc: (valeur préconfigurée).
dbsubprotocol : Entrez le sous-protocole à utiliser pour accéder à la base de données. Pour Sybase, il s'agit de sybase: (valeur préconfigurée).
dbsubname : Entrez le sous-nom à utiliser pour accéder à la base de données. Pour Sybase, il s'agit de Tds: (valeur préconfigurée).
dbdriver : Entrez la classe complète du pilote à utiliser pour accéder à la base de données. Le pilote doit prendre en charge le protocole défini par le paramètre dbprotocol. Pour Sybase, il s'agit de com.sybase.jdbc2.jdbc.SybDriver (valeur préconfigurée).
Enregistrez le fichier.
Relancez Tomcat.
Activation de la règle Cibles XML
Pour permettre au programme de lancement d'applicatifs de rapporter les événements d'application à l'aide de XML, vous devez :
activer une règle Cibles XML dans un ensemble Emplacement du service de eDirectory. La règle Cibles XML identifie les emplacements Web (URL) vers lesquels les données XML doivent être envoyées. Si vous utilisez la servlet de création de rapports, il s'agit de l'URL de la servlet en question. Un ensemble Emplacement du service ne peut avoir qu'une règle Cibles XML.Si vous n'avez pas créé un ensemble Emplacement du service, ou si les règles Cibles XML sont utilisées pour spécifier d'autres emplacements, vous devez créer un nouvel ensemble Emplacement du service. Les instructions nécessaires sont fournies dans la procédure ci-dessous.
Associez l'ensemble Emplacement du service aux conteneurs dans lesquels résident les utilisateurs ou les stations de travail dont les rapports doivent être envoyés à l'URL Web.
Pour activer une règle Cible XML et l'associer à des conteneurs :
Dans ConsoleOne, cliquez avec le bouton droit sur l'ensemble Emplacement du service à utiliser > cliquez sur Propriétés.
ou
Si vous n'avez pas d'ensemble Emplacement du service, cliquez sur le conteneur dans lequel il doit être créé > cliquez sur Nouveau > cliquez sur Ensemble de règles. Suivez les instructions fournies par l'assistant Ensemble de règles pour créer un ensemble Emplacement du service.
Sur la page Général, cochez la case dans la colonne Activé pour activer la règle Cibles XML.
Sélectionnez la règle Cibles XML dans la liste > cliquez sur Propriétés pour afficher la page de propriétés Cibles XML.
Cliquez sur Ajouter pour afficher la boîte de dialogue des URL XML > entrez l'URL à laquelle les données XML doivent être envoyées > cliquez sur OK pour ajouter l'URL à la liste.
L'URL de la servlet de création de rapport est la suivante :
http://ip_address/zfdamrServlet/run
où ip_address est l'adresse IP ou le nom d'hôte DNS du serveur sur lequel la servlet de création de rapport est exécutée.
Une fois que toutes les URL ont été ajoutées, cliquez sur OK pour retourner à la page Général.
Cliquez sur Associations pour afficher la page Associations.
Cette page est utilisée pour associer l'ensemble Emplacement du service aux conteneurs dans lesquels résident les utilisateurs ou les postes de travail dont les rapports XML doivent être envoyés à l'URL Web. Si un conteneur parent contient plusieurs conteneurs dans lesquels résident des objets Utilisateur et Poste de travail, vous pouvez sélectionner le conteneur parent plutôt que chaque conteneur individuel.
Cliquez sur Ajouter > parcourez l'arborescence et sélectionnez le conteneur à ajouter > cliquez sur OK pour l'ajouter à la liste.
Répétez l'Etape 9 pour ajouter d'autres conteneurs.
Une fois que vous avez ajouté tous les conteneurs, cliquez sur OK pour enregistrer les informations.
Configuration des objets Application pour utiliser les rapports URL
Après avoir activé la règle Cibles XML, vous pouvez configurer des objets Application pour utiliser la fonction de rapport XML. Les rapports d'événements étant configurés application par application, vous pouvez choisir les applications qui doivent collecter ou non des événements de rapport.
