Publication, exécution et débogage d'applications à l'aide d'Agent Controller

Le produit fonctionne avec Agent Controller pour effectuer des opérations de publication, de test, de débogage et de profilage pour des applications Java et WAS (WebSphere Application Server) sur des serveurs distants.

Remarque : Pour plus d'information sur les configurations WAS, voir le document RedBooks page for WebSphere: Search for RedBooks for WebSphere Application Server Version 5.0, 5.1, and 6.0 à l'adresse http://publib-b.boulder.ibm.com/redbooks.nsf/portals/Websphere.

Création d'une configuration serveur

Avant de publier ou d'exécuter votre application, vous devez d'abord configurer votre serveur.
  1. Créer une instance de serveur sur votre serveur WAS. Par exemple, si vous utilisez le produit WAS Express Edition Version 5.0 :
    1. Connectez-vous à votre serveur iSeries.
    2. A l'invite de commande, tapez :
      qsh
      cd /QIBM/ProdData/WebASE/ASE5/bin
      crtwasinst -instance nomDeMonInstance -portblock 43210
      nomDeMonInstance représente le nom de votre instance WAS. Veuillez noter que la commande ci-dessus attribue une numéro de port à l'instance WAS. Conservez ce numéro.
  2. Ouvrez le plan de travail (s'il n'est pas encore ouvert).
  3. Basculez vers la perspective Serveur en cliquant sur Fenêtre > Ouvrir la perspective > Serveur.
  4. Après avoir placé le curseur dans la vue Configuration Serveur, cliquez à l'aide du bouton droit de la souris et sélectionnez Nouveau > Serveur et configuration de serveur.
  5. Dans la zone Nom du serveur, entrez le nom de votre instance de serveur WAS.
  6. Dans la zone Type de serveur, développez WebSphere Version 5.0, 5.1, ou 6.0 et sélectionnez le serveur approprié (Serveur Express par exemple). Cliquez sur Suivant.
  7. Dans la zone Serveur de la fenêtre Nouveau serveur et configuration de serveur, entrez le nom du serveur ou l'adresse IP de votre serveur iSeries.
  8. Vous pouvez obtenir les informations du répertoire WebSphere à partir du serveur iSeries, via Remote Access Controller.
  9. Entrez le nom de l'instance WAS créée avec la commande crtwasinst (étape 2). Cliquez sur Suivant.
  10. Sélectionnez ftp (ou tout autre système de transfert) et cliquez sur Suivant.
  11. Si vous avez choisi ftp, entrez le nom de votre répertoire cible. Par exemple, pour WAS Express version 5.0, la ligne à taper serait : /QIBM/UserData/WebASE/ASE5/nomDeMonInstance. Et pour la version standard 5.0 de WAS : /QIBM/UserData/WebASE/BASE/nomDeMonInstance.
  12. Entrez votre nom d'utilisateur et votre mot de passe ftp. Cliquez sur Suivant.
  13. Sélectionnez le bouton radio Numéros de port consécutifs.
  14. Entrez votre numéro de blocage de port (portblock). Dans cet exemple, le numéro utilisé est 43210.
  15. Cliquez sur Terminer.
Remarque : Pour que les configurations des serveurs distants soient correctes, les copies locales et distantes du serveur WAS doivent correspondre. Cela signifie que la version de l'environnement de test WAS utilisé doit correspondre à la version réelle du serveur WAS hébergé sur le serveur iSeries. Si vous publiez des fichiers sur le serveur Express distant, ces fichiers seraient incorrectement publiés sur /qibm/userdata/webase/ase5/toshwasexp/installedApps/DefaultNode et non pas sur l'emplacement correct suivant : /qibm/userdata/webase/ase5/toshwasexp/installedApps/HOSTNAME_myinstancename.
Pour vous assurer que les fichiers sont publiés au bon endroit :
  1. Affectez une lettre d'unité réseau au répertoire principal de votre IFS iSeries, en supposant que vous avez défini une racine partagée. Sinon, remplacez "root" avec le nom que vous avez défini.
  2. Sélectionnez Fichier > Importer > Configuration de serveur dans le menu du plan de travail. Le système importe la configuration dans une configuration de serveur temporaire (toshtemp par exemple). Utilisez l'unité réseau pour préciser le chemin exact de l'emplacement de la configuration de serveur (x:\QIBM\UserData\WebASE5\myinstancename\config par exemple). Une nouvelle configuration apparaît dans la vue Navigateur de la perspective Serveur. Dans cet exemple, elle apparaît sous le nom toshtemp.wsc.
  3. Basculez vers la vue de Configuration de serveur, dans la perspective Serveur, et cliquez à l'aide du bouton droit de la souris sur l'instance de serveur (toshwasexp5 par exemple). Dans le menu contextuel, sélectionnez Changer de configuration puis la configuration de serveur temporaire créée à l'étape précédente (toshtemp.wsc par exemple).

Publication de vos fichiers sur un serveur distant

Vous pouvez effectuer des publications sur votre serveur distant à partir de la perspective Serveur de votre plan de travail. Cliquez à l'aide du bouton droit de la souris sur la configuration de serveur éloigné et sélectionnez Publier. Votre nouvelle configuration de serveur est publiée, ainsi que toutes les applications Web de votre projet.
Avertissement : Votre première publication peut prendre quelques instants. Les publications ultérieures sont beaucoup plus rapides.

Exécution de vos applications

Vous pouvez exécuter différentes applications Web et Java avec le Agent Controller. Pour lancer une application :
  1. Dans la vue Navigateur, sélectionnez l'élément à exécuter (fichier EAR, WAR, .jsp , etc.).
  2. Cliquez à l'aide du bouton droit de la souris sur l'élément voulu puis sur Exécuter pour publier et exécuter l'application.
Cette action publie le contrôleur de test d'unité et la configuration de serveur, puis démarre le serveur d'Agent Controller et ouvre une fenêtre de navigation dans laquelle s'affiche votre application.

Débogage et profilage de vos applications

Agent Controller vous permet de déboguer et de profiler différentes applications Web et Java. Pour profiler une application, cliquez à l'aide du bouton droit de la souris sur l'élément voulu et sélectionnez Profil sur le serveur. Pour déboguer une application, vous devez d'abord vous assurer que le serveur Remote Agent opère en mode débogage. Dans le cas contraire, arrêtez et redémarrez le serveur pour vous assurer que la machine virtuelle Java se réinitialise bien avec les options de débogage voulues. Vous devez également modifier un certain nombre de préférences avant le débogage :
  1. Dans la barre de menus du plan de travail, cliquez sur Fenêtre > Préférences.
  2. Développez Java et cliquez sur Déboguer.
  3. Dans la zone Délai d'expiration du débogueur, entrez la valeur 60000.
  4. Cliquez sur OK.
  5. Pour déboguer votre fichier, basculez en vue Navigateur, cliquez à l'aide du bouton droit de la souris sur le fichier à déboguer et sélectionnez Déboguer sur le serveur.