44.4 Configuration de la fonction de création de rapports XML

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 d'application ZENworks Desktop Management (zfdamrServlet). La servlet traite les messages et les ajoute à une base de données compatible JDBC*, comme la base de données Sybase fournie avec ZENworks.

Pour configurer la fonction de création de rapports XML, effectuez les tâches suivantes :

44.4.1 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 minimale nécessaire.

Tableau 44-1 Configuration requise pour la servlet de création de rapports

Serveur

Moteur de servlet Java

JVM

NetWare® 6.5 (Support Pack 1 ou version ultérieure)

Tomcat 4.1x

Novell JVM* for NetWare 1.4.2

NetWare 6 (Support Pack 2 ou version ultérieure) 1

Tomcat 3.3a

Novell JVM for NetWare 1.3.1

Windows Server 2003 (avec dernière version du Service Pack)

Tomcat 3.3a

Sun JDK* 1.3.1_01

Windows 2000 (avec dernière version du Service Pack)

Tomcat 3.3a

Sun JDK 1.3.1_01

SUSE Linux Enterprise Server (SLES) 9 SP1

Tomcat 4.1x

JVM 1.4.2 2

Novell Open Enterprise Server (Linux) 1.0

Tomcat 4.1x

JVM 1.4.2 3

1 Support Pack 2 ou version ultérieure nécessaire. Sans Support Pack 2 ou version ultérieure, la servlet de création de rapports risque faire passer le niveau d'utilisation du serveur à 100 % et de ne pas le libérer.

2 JVM est installé sur le serveur SLES 9 SP1 par le programme d'installation du serveur Middle Tier ZENworks 7.

3 JVM est installé par le programme d'installation du serveur Novell Open Enterprise avec lequel il est livré.

Pour plus d'informations sur l'installation de Tomcat sous NetWare 6.5, reportez-vous à la documentation de NetWare 6.5.

Pour plus d'informations sur l'installation de Tomcat sous NetWare 6, reportez-vous à la documentation de NetWare 6.

Pour plus d'informations sur l'installation de Tomcat sous Windows 2000, reportez-vous au site Web de Apache Tomcat.

OES Linux est livré avec Tomcat déjà installé.

44.4.2 Installation de la servlet de création de rapports sous Linux

  1. Assurez-vous que l'environnement serveur dans lequel la servlet de création de rapports va être installée présente bien la configuration logicielle indiquée à la section précédente, Configuration requise pour la servlet de création de rapports.

  2. Copiez le fichier zfdamrServlet.war du répertoire /opt/novell/zenworks/zdm/winutils/nalreporting du serveur Desktop Management vers /var/opt/novell/tomcat4/webapps.

  3. Relancez Tomcat pour développer le fichier zfdamrServlet.war. Pour relancer Tomcat sous Linux, saisissez /usr/share/tomcat/bin/startup.sh dans la ligne de commande.

    ou

    Si vous ne voulez pas relancer Tomcat, utilisez les outils fournis avec Tomcat pour développer le fichier.

44.4.3 Installation de la servlet de création de rapports sous NetWare et Windows

  1. Assurez-vous que l'environnement serveur dans lequel la servlet de création de rapports va être installée présente bien la configuration logicielle indiquée à la section précédente, Configuration requise pour la servlet de création de rapports.

  2. Copiez le fichier zfdamrServlet.war du répertoire sys:\public\reporting\canned\nal reports du serveur Desktop Management vers sys:\tomcat\4\webapps.

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

44.4.4 Configuration de la servlet de création de rapports pour une utilisation avec Apache

  1. Ouvrez le fichier sys:/apache2/conf/httpd.conf.

  2. Ajoutez la ligne ci-dessous à la fin du fichier :

    Include sys:/public/Reporting/canned/Nal Reports/zfdamrServlet.conf

  3. Enregistrez le fichier httpd.conf.

  4. Redémarrez le serveur Web Apache.

44.4.5 Configuration de la servlet de création de rapports

La servlet de création de rapports doit connaître certaines informations concernant la base de données dans laquelle elle va consigner les événements. Pour fournir ces informations :

  1. Ouvrez le fichier web.xml. Le fichier se trouve dans le répertoire Tomcat webapps\zfdamrservlet\web-inf.

  2. Si vous utilisez une base de données Sybase, recherchez le paramètre dbip et remplacez sa valeur par 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. Si vous utilisez une base de données Microsoft SQL, suivez les instructions fournies dans le TID 10094306.

    dbuser : Saisissez 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 du serveur Desktop Management. Si vous utilisez une base de données Sybase de ZENworks et si 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 : Saisissez 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 du serveur Desktop Management. Si vous utilisez une base de données Sybase de ZENworks et si 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 : Saisissez l'adresse IP du serveur qui exécute la base de données.

    dbport : Saisissez 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 du serveur Desktop Management. Si vous utilisez une base de données Sybase de ZENworks sous NetWare et si vous ne modifiez pas le port par défaut, vous n'avez pas besoin de modifier ce paramètre.

    dbprotocol : Saisissez le protocole à utiliser pour accéder à la base de données. Pour Sybase, il s'agit de jdbc (valeur préconfigurée).

    dbsubprotocol : Saisissez le sous-protocole à utiliser pour accéder à la base de données. Pour Sybase, il s'agit de sybase (valeur préconfigurée).

    dbsubname : Saisissez le sous-nom à utiliser pour accéder à la base de données. Pour Sybase, il s'agit de Tds (valeur préconfigurée).

    dbdriver : Saisissez 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).

  3. Enregistrez le fichier.

  4. Relancez Tomcat.

44.4.6 Activation de la stratégie Cibles XML

Pour permettre au programme de lancement d'applicatifs de créer des rapports d'événements d'application à l'aide de XML, vous devez effectuer les opérations suivantes :

  • Dans ConsoleOne, activez la stratégie Cibles XML d'un ensemble Emplacement du service. La stratégie 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 du composant Gestion d'applications, il s'agit de l'URL de la servlet en question. Un ensemble Emplacement du service ne peut avoir qu'une seule stratégie Cibles XML. Si vous n'avez pas créé d'ensemble Emplacement du service, ou si les stratégies Cibles XML sont utilisées pour spécifier d'autres emplacements, créez 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 postes de travail dont vous souhaitez envoyer les rapports à la base de données.

Pour activer une stratégie Cibles XML et l'associer à des conteneurs :

  1. Dans ConsoleOne, cliquez avec le bouton droit sur l'ensemble Emplacement du service à utiliser, puis 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éé, sur Nouveau, puis sur Ensemble de stratégies. Suivez les instructions fournies par l'assistant Ensemble de stratégies pour créer un ensemble Emplacement du service.

    Page des stratégies générales
  2. Dans la page Général, cochez la case dans la colonne Activé pour activer la stratégie Cibles XML.

  3. Sélectionnez la stratégie Cibles XML dans la liste, puis cliquez sur Propriétés pour afficher la page de propriétés Cibles XML.

    Page Cibles XML
  4. Cliquez sur Ajouter pour afficher la boîte de dialogue des URL XML, saisissez l'URL à laquelle les données XML doivent être envoyées, puis cliquez sur OK pour ajouter l'URL à la liste.

    L'URL doit comporter le numéro de port (par défaut le port 8080 sous Windows ou sous NetWare, et le port 8180 sous OES Linux et SLES). Ce port est le port Tomcat par défaut dans ces environnements. Il est nécessaire pour la stratégie d'emplacement du service pour que la fonction de création de rapports XML trouve la servlet zfdamrServlet exécutée sous Tomcat.

    L'URL de la servlet de création de rapports sous Windows ou NetWare serait :

    http://ip_address:8080/zfdamrServlet/run
    

    L'URL de la servlet de création de rapports sous Linux (OES Linux ou SLES) serait :

    http://ip_address:8180/zfdamrServlet/run
    

    ip_address est l'adresse IP ou le nom d'hôte DNS du serveur sur lequel la servlet de création de rapports est exécutée.

  5. Répétez l'Étape 4 pour ajouter d'autres URL.

  6. Une fois que toutes les URL ont été ajoutées, cliquez sur OK pour retourner à la page Général.

  7. Cliquez sur l'onglet Associations pour afficher la page correspondante.

    Page Associations de l'Ensemble Emplacement du service

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

  8. Cliquez sur Ajouter, parcourez l'arborescence, sélectionnez le conteneur à ajouter, puis cliquez sur OK pour l'ajouter à la liste.

  9. Répétez l'Étape 8 pour ajouter d'autres conteneurs.

  10. Une fois que vous avez ajouté tous les conteneurs, cliquez sur OK pour enregistrer les informations.

44.4.7 Configuration des objets Application pour utiliser les rapports XML

Après avoir activé la stratégie Cibles XML, vous pouvez configurer des objets Application pour utiliser la fonction de création de rapports XML. La création de rapports d'événements étant configurée application par application, vous pouvez choisir les applications pour lesquelles vous souhaitez créer des rapports d'événements et celles pour lesquelles vous ne voulez pas de rapport.

Pour obtenir des instructions détaillées sur la configuration d'une application afin d'utiliser la fonction de création de rapports XML, reportez-vous à la Section 44.5, Configuration d'applications pour utiliser la fonction de création de rapports.