Configuration des applications WebSphere Application Server à l'aide des scripts de configuration et de vérification pureQuery Runtime

Le répertoire d'installation de pureQuery contient les scripts qui configurent WebSphere Application Server pour l'exécution des applications prenant en charge pureQuery. Le répertoire contient également une application servlet WebSphere qui vérifie que WebSphere Application Server est configuré de manière adéquate.

Avant de commencer

L'utilisateur qui exécute les scripts doit disposer des privilèges suivants :

Pourquoi et quand exécuter cette tâche

Les scripts se trouvent dans le répertoire PureQuery_Websphere_Config_Scripts du répertoire d'installation de pureQuery Runtime.

Vous pouvez exécutez les scripts sans spécifiez de paramètres d'affichage pour les paramètres facultatifs et les paramètres requis du script.

Procédure

Pour l'exécution de scripts pour la configuration de WebSphere Application Server afin qu'il fonctionne avec pureQuery Runtime et pour vérifier la configuration, exécutez les scripts dans l'ordre suivant :

  1. Exécutez le script InstallPQJars pour mettre à jour le chemin d'accès aux classes de fournisseur JDBC avec les informations pureQuery Runtime.
  2. Exécutez le script SetupDSProp pour créer une propriété de source de données personnalisée qui spécifie les propriétés pureQuery Runtime.
  3. Exécutez le script InstallPQValidator pour vérifier la configuration pureQuery Runtime.

Exécution du script InstallPQJars pour ajouter les fichiers pureQuery Runtime JAR au chemin d'accès aux classes du fournisseur JDBC

Lorsque vous exécutez le script InstallPQJars, spécifiez la portée du fournisseur JDBC WebSphere à mettre à jour et le chemin d'accès aux fichierspureQuery Runtime JAR. Sélectionnez le fournisseur JDBC dans la liste des fournisseurs affichée par le script. Le script met à jour le chemin d'accès aux classes du fournisseur JDBC spécifié. Lorsque le script configure le chemin d'accès aux classes du fournisseur, il affiche des informations relatives au fournisseur JDBC WebSphere, à pureQuery Runtime, et à l'environnement Java.

Procédure

Pour exécuter le script afin d'ajouter les fichierspureQuery Runtime JAR au chemin d'accès aux classes du fournisseur JDBC :

  1. Ouvrez une fenêtre de commande et exécutez le script InstallPQJars. Par exemple, cette commande spécifie que le noeudWebSphere devNode01 et le chemin d'accès aux fichiers pureQuery Runtime JAR est C:/PureQueryRuntime. :
     InstallPQJars -node devNode01 -pqPath C:/PureQueryRuntime

    La commande d'exemple suppose que les fournisseurs JDBC WebSphere sont définis au niveau du noeud et que l'installation de WebSphere Application Server est une simple installation autonome.

  2. Suivez les instructions du script pour configurer le chemin d'accès aux classes du fournisseur JDBC.

    Si le script détecte les fichiers pureQuery Runtime JAR dans le chemin d'accès aux classes, vous pouvez mettre à jour le chemin d'accès aux classes ou garder le chemin d'accès aux classes actuel.

    Lorsque le script s'exécute, il affiche des informations de configuration WebSphere, pureQuery et Java.

Que faire ensuite

A partir de la console d'administration, vous pouvez afficher le chemin d'accès aux classes du fournisseur JDBC avec les informations pureQuery Runtime.

Ensuite, exécutez le script SetupDSProp pour configurer une source de données de fournisseur JDBC avec les propriétés pureQuery Runtime.

Exécution du script SetupDSProp pour ajouter des propriétés pureQuery Runtime à une source de données

Lorsque vous exécutez le script SetupDSProp, spécifiez les valeurs des propriétés pureQuery Runtime et un serveur WebSphere. Le script SetupDSProp crée la propriété personnalisée pdqProperties pour la source de données spécifiées. La valeur de la propriété est la liste des valeurs de propriétés pureQuery Runtime spécifiées.

Procédure

Pour exécuter le script afin de configurer une source de données :

  1. Ouvrez une fenêtre de commande et exécutez le script SetupDSProp. Par exemple, cette commande spécifie le serveurWebSphere server1 et spécifie la valeur de la propriété pureQuery Runtime captureMode sur ON et la valeur de la propriété pureQueryXml sur C:\temp\capture.pdqxml.
    SetupDSProp -server server1 -props "captureMode(ON), pureQueryXml(C:\temp\capture.pdqxml)"
    Remarque : Le script ne valide pas les valeur de propriétés pureQuery Runtime spécifiées. Il crée la propriété personnalisée pdqProperties avec la chaîne comme valeur de propriété.
  2. Suivez les instructions du script pour configurer la source de données.

    Après avoir sélectionné la source de données à configurer, le script crée la propriété personnalisée. Ensuite, le script affiche des informations sur la source de données et la propriété personnalisée.

Résultats

A partir de la console d'administration, vous pouvez vérifier que la propriété personnalisée pdqProperties est définie. La propriété est répertoriée comme une propriété personnalisée pour la source de données.

Que faire ensuite

Ensuite, exécutez le script InstallPQValidator pour vérifier que la configuration de pureQuery Runtime est correcte en exécutant le script InstallPQValidator.

Exécution du script InstallPQValidator pour vérifier la configuration de pureQuery Runtime

Le script InstallPQValidator installe et démarre le servlet WebSphere RunPQDataVersionEAR.ear. Le servlet valide la configuration pureQuery et les prérequis pureQuery Runtime pour la source de données. Le servlet affiche le contexte, les chargeurs de classe d'application, les propriétés pureQuery globales et les informations sur la version pureQuery Runtime.

Procédure

Pour exécuter le script afin de vérifier l'installation de pureQuery Runtime :

  1. Ouvrez une fenêtre de commande et exécutez le script InstallPQValidator. Par exemple, cette commande spécifie le serveur WebSphere server1, noeud devNode01.
    InstallPQValidator -server server1 -node devNode01
    Le script installe et démarre le servlet

    Le servlet est répertorié comme une application dans la console d'administration.

  2. Exécutez le servlet à partir d'un navigateur. Démarrez un navigateur et accédez à l'URL pour exécuter le servlet.
    Par exemple, cette URL suppose que WebSphere est en cours d'exécution, que le servlet se trouve sur votre ordinateur et que le port WebSphere Application Server est 9081 :
    http://localhost:9081/RunPQValidate/
    La page du servlet s'ouvre.
  3. Sur la page du servlet, entrez le nom JNDI pour la source de données DB2, puis cliquez sur Submit (Soumettre).

    Le servlet établit une connexion avec la source de données, puis affiche les informations de configuration dans la fenêtre du navigateur.

Que faire ensuite

La source de données WebSphere Application Server est configurée pour pureQuery Runtime. Les applications compatibles avec pureQuery peuvent utiliser la source de données pour accéder à une base de données DB2.

Commentaires en retour