Utilisation de la console pour l'administration de composants i5/OS à distance

Cette section fournit une présentation de la console ainsi qu'une description des fonctions de la console. Cette section traite des points suivants :

Présentation de la console

Définition des droits d'accès à la console

Gestion du serveur à l'aide de la console

Configuration des gestionnaires de files d'attente

Gestion des agents de connecteur à l'aide de la console

Gestion des agents ODA à l'aide de la console

Démarrage, arrêt et actualisation des agents de connecteur et des agents ODA à l'aide de la console

Actualisation et régénération des composants à l'aide de la console

Affichage et utilisation des journaux de la console

Présentation de la console

La console est un outil WebSphere Business Integration Server Express utilisé pour administrer des composants i5/OS à distance. La console s'exécute sur un système d'exploitation Windows et se connecte à distance à un système i5/OS. Cet outil est uniquement utilisé dans la version 4.4 de WebSphere Business Integration Server Express sur un système i5/OS. Son installation est effectuée avec les outils d'administration via le Launchpad pour i5/OS.

La console offre une interface utilisateur graphique permettant d'utiliser les scripts d'administration i5/OS fournis avec le produit. La conception de cette console facilite l'exécution de tâches administratives pour Server Express.

Remarque :
Si la console se connecte à un système i5/OS protégé par un pare-feu, consultez le centre d'informations pour IBM eServer iSeries afin de connaître les ports permettant l'ouverture de la Java ToolBox.

Démarrage de la console :

Cliquez sur Démarrer>Programmes>IBM WebSphere Business Integration Server Express>Toolset Express>Administration>Console

Définition des droits d'accès à la console

Pour être en mesure d'exploiter l'ensemble des fonctions de la console, le profil i5/OS de l'utilisateur de l'outil doit disposer des droits d'accès spécifiques suivants : *ALLOBJ et *JOBCTL.

L'aide de la console répertorie les droits d'accès spécifiques qui sont requis pour exécuter l'outil.

Gestion du serveur à l'aide de la console

Vous pouvez utiliser la console pour créer, configurer et détecter les instances de serveur sur un système i5/OS.

Création d'une instance de serveur à l'aide de la console

Vous pouvez utiliser la console pour créer des instances InterChange Server Express sur un système i5/OS. Pour ce faire, procédez comme suit :

  1. Cliquez sur Fichier>Créer une instance.
  2. Saisissez les informations suivantes :
  3. Cliquez sur Créer une instance.
    Figure 22. Création d'une fenêtre Windows

Configuration d'une instance de serveur à l'aide de la console

Pour configurer les propriétés avancées d'une instance dans le panneau de création d'instance, cliquez sur l'ongletAvancé.

Figure 23. Création d'une fenêtre dans l'instance, propriétés avancées

Vous pouvez configurer le nouveau serveur afin d'utiliser un nom de répertoire précis ; le nom du serveur est indiqué par défaut comme répertoire. Vous pouvez également définir pour le serveur un nouveau gestionnaire de files d'attente ou gestionnaire existant. La valeur indiquée par défaut est <NOMINSTANCE>. GESTIONNAIRE.FILES. Vous pouvez activer RBAC (Role Based Access Control) et configurer le serveur afin de disposer d'une base de données à distance.

Lors du processus de création, des messages indiquant le statut s'affichent à l'écran. Pour voir le fichier journal de création de l'instance de serveur, cliquez sur Afficher le journal.

Suppression d'une instance de serveur

Vous pouvez supprimer une instance de serveur du système i5/OS à l'aide de la console :

  1. Cliquez avec le bouton droit de la souris sur le nom du serveur et sélectionnez l'option de suppression de l'instance. Une invite de confirmation s'affiche.
  2. Dans cette invite, cliquez sur Oui. Un message s'affiche dans la fenêtre de statut lorsque l'instance est supprimée.
    Remarque :
    L'utilisation de cette fonction produit le même résultat que l'exécution du script delete_instance.sh sur le système i5/OS.

Configuration du serveur pour un lancement automatique

Vous pouvez configurer le serveur pour qu'il démarre automatiquement à l'aide de l'option Démarrage automatique. Pour ce faire, procédez comme suit :

  1. Cliquez avec le bouton droit de la souris sur le nom du serveur.
  2. Cochez la case Démarrage automatique.
Figure 24. Définissez la fenêtre de démarrage automatique

Remarque :
Pour désactiver l'option de démarrage automatique, désélectionnez la caseDémarrage automatique.

Démarrage, arrêt et actualisation du statut du serveur

La console vous permet de démarrer et d'arrêter facilement InterChange Server Express.

Pour démarrer le serveur, cliquez sur l'icône avec la flèche verte à droite du nom du serveur, comme indiqué dans l'exemple ci-dessus. Pour l'arrêter, cliquez sur l'icône avec la case rouge. Pour afficher le statut actuel du serveur, cliquez sur Régénérer.

Consultation du journal du serveur

La console vous permet de voir le fichier journal InterChange System (InterChangeSystem.log) pour une instance de serveur donnée. Elle ouvre l'outil LogViewer du programme Toolset Express pour afficher une vue du fichier journal du serveur. Vous pouvez définir une propriété autorisant LogViewer à régénérer le fichier journal à partir du système i5/OS. Aucune valeur par défaut n'est indiquée pour cette propriété ; pour actualiser le journal, vous devez donc mapper un disque de l'ordinateur sur le système i5/OS.

  1. Accédez au fichier de propriétés C:\IBM\WebSphereServer\Console\console.properties.
  2. Pour activer la fonction de régénération, ajoutez dans le fichier de propriétés une ligne semblable à la suivante :

    wbi.remote.dir=Z\:/QIBM/UserData/WBIServer44

  3. Pour consulter le journal, cliquez avec le bouton droit de la souris sur le nom du serveur, puis sur Afficher le journal.

Configuration des gestionnaires de files d'attente

La console permet de configurer des gestionnaires de files d'attente pour une instance de serveur donnée. Effectuez les étapes suivantes pour configurer un gestionnaire de files d'attente:

  1. Cliquez avec le bouton droit de la souris sur le nom du serveur et sélectionnez l'option de configuration des gestionnaires de files d'attente.
  2. Dans le fichier qui s'ouvre alors, changez "nomadaptateur" par le nom de l'adaptateur approprié pour lequel vous effectuez cette configuration (par exemple, JTEXT ou JDBC).

Gestion des agents de connecteur à l'aide de la console

Avec la console, vous pouvez ajouter et supprimer des agents de connecteur.

Ajout d'un agent de connecteur

Vous pouvez ajouter des agents de connecteur dans la vue Console. Ces agents peuvent être des agents de connecteur personnalisés ou un agent de connecteur supprimé précédemment de la vue Console.

Condition préalable : Vous devez créer la description du travail sur le système i5/OS avant d'ajouter un agent de connecteur.

Remarque :
Plusieurs agents de connecteur peuvent utiliser la même description de travail.

Effectuez les étapes suivantes afin d'ajouter un agent de connecteur :

  1. Cliquez avec le bouton droit de la souris sur le nom du serveur, puis surAjouter un agent de connecteur.
  2. Saisissez le nom de l'agent de connecteur et la description de travail, puis lancez le script.
  3. Cliquez sur Ajouter un agent de connecteur.

Remarque :
Vous pouvez également ajouter des agents de connecteur supprimés précédemment en utilisant la fonction de régénération de liste décrite ci-après.

L'agent de connecteur que vous ajoutez apparaît uniquement dans la vue Console. Aucune modification n'est effectuée dans le système i5/OS.

Suppression d'un agent de connecteur à partir de la console

Une fois un agent de connecteur supprimé, il n'apparaît plus dans la console. Vous pouvez toutefois utiliser les options permettant d'ajouter un agent de connecteur ou de régénérer la liste afin de le réintégrer dans la console. Pour supprimer un agent de connecteur :

Configuration du lancement automatique d'un agent de connecteur

Vous pouvez facilement configurer un agent de connecteur pour qu'il se lance automatiquement avec le serveur correspondant. Pour ce faire, procédez comme suit :

  1. Cliquez avec le bouton droit de la souris sur le nom du connecteur.
  2. Cochez la case Démarrage automatique.

Remarque :
Pour désactiver l'option de démarrage automatique, désélectionnez la case Démarrage automatique.

Gestion des agents ODA à l'aide de la console

Utilisez la console pour ajouter et supprimer des agents ODA dans le système i5/OS.

Ajout d'un agent ODA

Vous pouvez ajouter un nouveau agent ODA ou un agent supprimé antérieurement dans la vue Console. Pour ce faire, procédez comme suit :

  1. Dans le menu ODA en haut de l'écran, cliquez sur l'option permettant d'ajouter un agent ODA.
  2. Saisissez les informations suivantes :

Remarque :
Contrairement aux agents de connecteur, plusieurs agents ODA ne peuvent pas partager la même description de travail. Vous devez attribuer à chaque agent ODA sa propre description de travail. Les descriptions doivent être créées sur le système i5/OS avant de procéder à l'ajout des agents dans la vue Console.

Suppression d'un agent ODA

Lorsque vous supprimez un agent ODA, il n'apparaît plus dans la vue Console. Cependant, aucune modification n'a été effectuée dans le système i5/OS.

  1. Dans le menu ODA situé dans la barre des menus, cliquez sur Supprimer un agent ODA de la liste.
  2. Sélectionnez dans la liste l'agent ODA adéquat, puis cliquez sur l'option de suppression.

Démarrage, arrêt et actualisation des agents de connecteur et des agents ODA à l'aide de la console

Le processus de démarrage, d'arrêt et d'actualisation des agents de connecteur et des agents ODA est identique au processus relatif aux instances de serveur.

Les agents de connecteur sont répertoriés dans la vue Console, sous le nom de leur serveur associé.

Les agents ODA sont répertoriés séparément, sous l'onglet ODA.

Actualisation et régénération des composants à l'aide de la console

Le menu Configuration de la console vous permet d'actualiser le statut des composants dans la console. L'option d'actualisation de l'ensemble des composants extrait le statut actuel des composants à partir du système i5/OS.

L'option d'actualisation automatique vous permet de définir un intervalle précis pour l'actualisation du statut de tous les composants via la console. L'intervalle par défaut est 30 secondes.

Dans le menu de configuration, vous pouvez également sélectionner l'option de régénération des composants de la console. Cette option ajoute les composants qui avaient été supprimés précédemment dans la vue Console. Elle ajoute, en outre, toute nouvelle fonction à la vue Console.

Affichage et utilisation des journaux de la console

Le journal de la console peut servir au diagnostic de pannes. Vous pouvez trouver le journal, nommé wbi-console-xx.log, dans le répertoire suivant :

C:\IBM\WebSphereServer\log

Pour afficher davantage d'informations dans le journal, définissez le niveau de journalisation le plus fin dans le fichier de propriétés. Pour ce faire, procédez comme suit :

  1. Ouvrez le fichier C:\IBM\WebSphereServer\log.properties.
  2. Supprimez la mise en commentaire des trois dernières lignes du fichier log.properties en supprimant le signe dièse(#) au début de chaque ligne.
  3. Cliquez sur Fichier>Sauvegarder pour enregistrer vos modifications.

Copyright IBM Corp. 2004, 2005