Chapitre 9 SunPlex Agent Builder

Ce chapitre présente l'outil SunPlex Agent Builder et le module Cluster Agent pour Agent Builder, permettant tous deux d'automatiser la création des types de ressources ou des services de données. Ils doivent être exécutés sous le contrôle du RGM (Resource Group Manager). Un type de ressources est un wrapper qui enveloppe une application afin de lui permettre de s'exécuter dans un environnement clusterisé sous le contrôle du RGM.

Ce chapitre couvre les rubriques suivantes :

• Présentation d'Agent Builder

• Avant d'utiliser Agent Builder

• Utilisation d'Agent Builder

• Structure de répertoire

• Sortie d'Agent Builder

• Module Cluster Agent pour Agent Builder

Présentation d'Agent Builder

Agent Builder fournit une interface constituée d'écrans permettant de saisir des informations sur votre application et le type de ressources que vous souhaitez créer.

Si la version de l'interface utilisateur graphique d'Agent Builder n'est pas accessible, vous pouvez accéder à Agent Builder via une interface de ligne de commande. Voir la rubrique Utilisation de la version de ligne de commande d'Agent Builder.

En fonction des données entrées, Agent Builder génère les logiciels suivants :

• un ensemble de fichiers sources C, korn shell (ksh) ou de service de données générique (Generic Data Service, GDS) pour un type de ressources évolutif ou de basculement correspondant aux rappels de méthode du type de ressources, pour des applications qui sont compatibles ou non avec le réseau (modèle client-serveur ou modèle sans client) ;

• un fichier RTR (Resource Type Registration) personnalisé (si vous générez un code source en C ou korn shell) ;

• des scripts d'utilitaire personnalisés pour le démarrage, l'arrêt et la suppression d'une instance (ressource) d'un type de ressources, ainsi que des pages man personnalisées fournissant de plus amples informations sur l'utilisation de chacun de ces fichiers ;

• un package Solaris comprenant les codes binaires (si vous générez une source C), un fichier RTR (si vous générez un code source en C ou korn shell) et les scripts d'utilitaire.

Avant d'utiliser Agent Builder

La section ci-dessous présente des informations que vous devez connaître avant d'utiliser Agent Builder.

Création de types de ressources contenant plusieurs arborescences de processus indépendantes

Agent Builder peut créer des types de ressources pour des applications comportant plusieurs arborescences de processus indépendantes. Ces arborescences de processus sont indépendantes dans le sens où la fonction PMF les contrôle et les démarre individuellement. La fonction PMF démarre chaque arborescence de processus avec sa propre balise.

Agent Builder vous permet de créer des types de ressources avec plusieurs arborescences de processus indépendantes, uniquement si le code source généré que vous indiquez est de type C ou GDS. Vous ne pouvez pas utiliser Agent Builder pour créer ces types de ressources avec le code source korn shell. Dans ce cas, vous devez écrire le code manuellement.

Dans le cadre d'une application de base contenant plusieurs arborescences de processus indépendantes, la spécification d'une ligne de commande unique ne suffit pas pour démarrer l'application. Dans ce cas, vous devez créer un fichier texte dont chaque ligne indique le chemin d'accès complet à une commande permettant de démarrer l'une des arborescences de processus de l'application. Ce fichier ne doit contenir aucune ligne vide et être spécifié dans le champ Commande de démarrage de l'écran Configurer.

Vous devez vous assurer qu'il ne contient aucune autorisation d'exécution, ce qui permet à Agent Builder de distinguer ce fichier permettant de démarrer plusieurs arborescences de processus à partir d'un simple script exécutable contenant plusieurs commandes. Si ce fichier texte contient des autorisations d'exécution, les ressources s'affichent sans problème ni erreur sur le cluster, mais toutes les commandes sont exécutées sous une seule balise PMF. Dans ce cas, la fonction PMF ne peut pas contrôler et redémarrer individuellement les arborescences de processus.

Utilisation d'Agent Builder

Cette section décrit comment utiliser Agent Builder et présente les différentes tâches à effectuer avant de pouvoir l'utiliser. Vous y découvrirez également comment profiter de cet outil après avoir généré le code du type de ressources.

Les rubriques traitées sont les suivantes :

• Analyse de l'application

• Installation et configuration d'Agent Builder

• Écrans d'Agent Builder

• Lancement d'Agent Builder

• Navigation dans Agent Builder

• Utilisation de l'écran Créer

• Utilisation de l'écran Configurer

• Utilisation de la variable $hostnames korn shell d'Agent Builder

• Variables de propriété

• Clonage d'un type de ressources existant

• Édition du code source généré

• Utilisation de la version de ligne de commande d'Agent Builder

Analyse de l'application

Avant d'utiliser Agent Builder, vous devez déterminer si l'application répond aux critères requis en termes de haute disponibilité et évolutivité. Agent Builder ne peut pas réaliser cette analyse s'appuyant uniquement sur les caractéristiques du temps d'exécution de l'application. Vous trouverez de plus amples informations à ce sujet dans la rubrique Analyse du caractère approprié de l'application.

Il se peut qu'Agent Builder ne puisse pas toujours créer un type de ressources complet pour votre application. Dans la plupart des cas, cependant, il propose au moins une solution partielle. Par exemple, les applications particulièrement complexes peuvent nécessiter un code supplémentaire qu'Agent Builder ne génère pas par défaut. Il peut notamment s'agir d'un code permettant d'ajouter des contrôles de validation pour des propriétés supplémentaires ou de régler des paramètres qu'Agent Builder n'affiche pas. Le cas échéant, vous devez apporter des modifications au code source généré ou au fichier RTR. La conception d'Agent Builder vise justement à offrir cette souplesse.

De fait, Agent Builder insère des commentaires aux endroits du code source généré où vous pouvez ajouter votre propre code de type de ressources. Une fois le code source modifié, vous pouvez utiliser le fichier makefile généré par Agent Builder pour recompiler le code source et générer de nouveau le package de type de ressources.

Même si vous écrivez l'intégralité du code de type de ressources sans utiliser aucun code généré par Agent Builder, vous pouvez utiliser le fichier makefile et la structure fournis par Agent Builder pour créer le package Solaris de votre type de ressources.

Installation et configuration d'Agent Builder

Agent Builder ne requiert aucune installation spéciale. Agent Builder est livré avec le package SUNWscdev, installé par défaut dans le cadre de l'installation logicielle standard de Sun Cluster. Pour de plus amples informations, reportez-vous au manuel Sun Cluster Software Installation Guide for Solaris OS.

Avant d'utiliser Agent Builder, vérifiez les points suivants :

• L'environnement d'exécution Java est inclus dans la variable $PATH. Agent Builder dépend de Java (Java Development Kit, version 1.3.1 minimum). Si Java n'est pas inclus dans la variable $PATH , la commande scdsbuilder renvoie et affiche un message d'erreur.

• Vous avez installé le groupe de logiciels « Developer System Support », Solaris 8 ou version supérieure.

• Le compilateur cc est inclus dans la variable $PATH. Agent Builder utilise la première occurrence de cc dans la variable $PATH pour identifier le compilateur avec lequel générer le code binaire C pour le type de ressources. Si cc n'est pas intégré dans la variable $PATH, Agent Builder désactive l'option de génération de code C. Voir la rubrique Utilisation de l'écran Créer.

vous pouvez utiliser un autre compilateur que le compilateur cc standard avec Agent Builder. Pour ce faire, vous pouvez créer un lien symbolique dans $PATH entre cc et un autre compilateur, par exemple gcc. Vous pouvez également remplacer la spécification du compilateur dans le fichier makefile (actuellement CC=cc) par le chemin d'accès complet d'un autre compilateur. Par exemple, dans le fichier makefile généré par Agent Builder, remplacez CC=cc par CC=nomchemin/gcc . Dans ce cas, vous ne pouvez pas exécuter Agent Builder directement. Vous devez utiliser les commandes make et make pkg pour générer un code de service de données et un package.

Écrans d'Agent Builder

Agent Builder est un assistant en deux étapes, chacune d'elles disposant d'un écran. Agent Builder affiche les deux écrans suivants, destinés à vous guider tout au long du processus de création d'un type de ressources :

1. l'écran de création : sur cet écran, vous indiquez les informations de base sur le type de ressources à créer, par exemple son nom et le répertoire de travail des fichiers générés. Le répertoire de travail constitue l'emplacement de création et de configuration du modèle de type de ressource. Vous pouvez également identifier le type de ressources à créer (évolutives ou de basculement), si l'application de base est sensible au réseau (c'est-à-dire si elle passe par le réseau pour communiquer avec ses clients) et le type de code (C, korn shell ksh ou GDS (service de données générique)) à générer. Pour de plus amples informations sur GDS, voir le Chapitre 10, Services de données génériques. Vous devez indiquer toutes les informations sur cet écran et sélectionner l'option de création pour générer la sortie correspondante. Ensuite, vous pouvez afficher l'écran de configuration.

2. l'écran de configuration : sur cet écran, vous devez indiquer la ligne de commande complète qui peut être transmise à n'importe quel shell UNIX® pour démarrer l'application de base. Si vous le souhaitez, vous pouvez fournir des commandes permettant d'arrêter et d'analyser l'application. À défaut, la sortie générée utilise des signaux pour arrêter l'application et fournit un mécanisme d'analyse par défaut. Voir la description de la commande d'analyse, sous la rubrique Utilisation de l'écran Configurer. Cet écran vous permet également de modifier les valeurs de délai pour chacune de ces trois commandes.

Lancement d'Agent Builder

Si la version de l'interface utilisateur graphique d'Agent Builder n'est pas accessible, vous pouvez accéder à Agent Builder via une interface de ligne de commande. Voir la rubrique Utilisation de la version de ligne de commande d'Agent Builder.

si vous lancez Agent Builder à partir du répertoire de travail d'un type de ressources existant, Agent Builder initialise les écrans Créer et Configurer en reprenant les valeurs du type de ressources existant.

Pour lancer Agent Builder, entrez la commande suivante :

% /usr/cluster/bin/scdsbuilder

L'écran Créer apparaît.

Figure 9–1 Écran Créer

Navigation dans Agent Builder

Pour entrer des informations sur les écrans Créer et Configurer, effectuez les opérations suivantes :

• Entrez des informations dans un champ.

• Parcourez la structure de répertoires et sélectionnez un fichier ou un répertoire.

• Sélectionnez l'une des cases d'option mutuellement exclusives, par exemple Évolutif ou Basculement.

• Cliquez sur une case d'activation ou de désactivation. Par exemple, si vous cliquez sur l'option Compatible réseau, l'application de base est identifiée comme étant sensible au réseau, tandis que si vous laissez la case vide, l'application est considérée comme non dépendante du réseau.

Les options en bas de chaque écran vous permettent d'effectuer une tâche, de passer à l'écran suivant ou précédent ou de quitter Agent Builder. Les options apparaissent en grisé ou en surbrillance selon qu'elles correspondent à des actions que vous pouvez effectuer ou non.

Par exemple, après avoir renseigné les champs et coché les options souhaitées dans l'écran Créer, cliquez sur le bouton Créer en bas de l'écran. Les boutons Précédent et Suivant sont désactivés car il n'existe pas d'écran précédent et vous ne pouvez pas accéder à l'écran suivant tant que vous n'avez pas terminé de renseigner l'écran actuel.

Agent Builder affiche des messages de progression dans la zone du journal située en bas de l'écran. Lorsqu'il a terminé, il affiche un message indiquant que l'opération a été correctement effectuée ou un avertissement vous invitant à consulter le journal. Le bouton Suivant est activé ou, s'il s'agit du dernier écran, seul le bouton Annuler est mis en surbrillance.

Vous pouvez sélectionner à tout moment l'option Annuler pour quitter Agent Builder.

Parcourir

Certains champs d'Agent Builder vous permettent d'entrer des informations ou de cliquer sur Parcourir pour rechercher un fichier ou un répertoire dans la structure de répertoires.

Lorsque vous cliquez sur Parcourir, un écran similaire à celui-ci apparaît :

Double-cliquez sur un dossier pour l'ouvrir. Lorsque vous déplacez le curseur sur un fichier, son nom apparaît dans le champ Nom de fichier. Après avoir localisé le fichier souhaité et pointé le curseur dessus, cliquez sur Sélectionner.

Si vous recherchez un répertoire, positionnez le curseur sur le répertoire souhaité et cliquez sur Ouvrir. S'il ne contient aucun sous-répertoire, Agent Builder ferme la fenêtre Parcourir et insère le nom du répertoire sur lequel pointe le curseur dans le champ approprié. S'il contient des sous-répertoires, cliquez sur Fermer pour faire disparaître la fenêtre et revenir à l'écran précédent. Agent Builder insère le nom du répertoire sur lequel vous avez positionné le curseur dans le champ approprié.

Fonction des icônes situées dans le coin supérieur droit de l'écran :

Menus

Agent Builder comporte deux menus déroulants : le menu Fichier et le menu Éditer.

Menu Fichier

Le menu Fichier comporte deux options :

• Charger type de ressources : permet de charger un type de ressources existant. Dans Agent Builder, un écran de recherche vous permet de sélectionner le répertoire de travail d'un type de ressources existant. Si le répertoire à partir duquel vous avez lancé Agent Builder contient un type de ressources, Agent Builder charge automatiquement ce type de ressources. L'option Charger type de ressources vous permet de lancer Agent Builder à partir de n'importe quel répertoire et de sélectionner un type de ressources existant à utiliser comme modèle pour créer un nouveau type de ressources. Voir la rubrique Clonage d'un type de ressources existant.

• Quitter : permet de quitter Agent Builder. Vous pouvez également quitter Agent Builder en cliquant sur Annuler dans l'écran Créer ou Configurer.

Menu Éditer

Le menu Éditer comporte les options suivantes :

• Effacer le journal de sortie : permet de supprimer les informations du journal. Chaque fois que vous sélectionnez Créer ou Configurer, Agent Builder ajoute des messages d'état dans le journal. Lors d'un processus répétitif de modification de votre code source nécessitant de générer de nouveau la sortie dans Agent Builder, vous pouvez enregistrer et effacer le fichier journal avant chaque utilisation si vous souhaitez isoler les messages d'état.

• Enregistrer journal : permet d'enregistrer le journal dans un fichier. Dans Agent Builder, un écran de recherche vous permet de sélectionner le répertoire et d'indiquer un nom de fichier.

Utilisation de l'écran Créer

Écran Créer

La première étape de création d'un type de ressources consiste à renseigner l'écran Créer qui s'affiche au lancement d'Agent Builder. L'illustration suivante présente l'écran Créer une fois que vous avez renseigné les champs.

Figure 9–2 Écran Créer

L'écran Créer contient les champs, les cases d'option et les cases à cocher suivantes :

• ID du fournisseur : nom identifiant le fournisseur du type de ressources. Si vous indiquez en règle générale le symbole de référencement du fournisseur, sachez toutefois que n'importe quel nom unique d'identification du fournisseur est valide. N'utilisez que des caractères alphanumériques.

• Nom de l'application : nom du type de ressources. N'utilisez que des caractères alphanumériques.

  ---

  Remarque –

  le nom du fournisseur et le nom d'application constituent le nom complet du type de ressources. Ce nom complet ne doit pas excéder neuf caractères.

  ---

• Version TR : version du type de ressources. Le champ Version TR fait la distinction entre les différentes versions enregistrées ou les mises à niveau d'un même type de ressources.

  Dans ce champ, vous ne pouvez utiliser aucun des caractères suivants : espace, tabulation, barre oblique (/), barre oblique inverse (\), astérisque (*), point d'interrogation (?), virgule (,), point-virgule (;), crochet gauche ([) ou crochet droit (]).

• Répertoire de travail : répertoire dans lequel Agent Builder crée une structure de répertoires contenant tous les fichiers créés pour le type de ressources cible. Quel que soit le répertoire de travail, vous ne pouvez y créer qu'un seul type de ressources. Agent Builder initialise ce champ avec le chemin du répertoire à partir duquel vous l'avez lancé, mais vous pouvez entrer un autre nom ou utiliser le bouton Parcourir pour rechercher un autre répertoire.

  Sous le répertoire de travail, Agent Builder crée un sous-répertoire contenant le nom du type de ressources. Par exemple, si le nom du fournisseur et le nom de l'application sont respectivement SUNW et ftp, Agent Builder appelle le sous-répertoire SUNWftp.

  Agent Builder place tous les répertoires et fichiers du type de ressources cible dans ce sous-répertoire. Voir la rubrique Structure de répertoire.

• Évolutif ou Basculement : détermine si le type de ressources cible sera évolutif ou de basculement.

• Compatible réseau : indique si l'application de base est sensible au réseau, c'est-à-dire si elle utilise le réseau pour communiquer avec ses clients. Sélectionnez la case pour activer la compatibilité réseau et désélectionnez-la pour définir une application autonome.

• C, ksh : indique le langage du code source généré. Bien que ces options soient mutuellement exclusives, avec Agent Builder vous pouvez créer un type de ressources avec un code korn shell, puis réutiliser les mêmes informations pour créer un code C. Voir la rubrique Clonage d'un type de ressources existant.

• GDS : indique qu'il s'agit d'un service de données générique (Generic Data Service, GDS). Reportez-vous au Chapitre 10, Services de données génériques pour de plus amples informations sur la création et la configuration d'un service de données générique.

Si le compilateur cc ne figure pas dans la variable $PATH, Agent Builder affiche l'option C en grisé et vous permet de sélectionner l'option ksh. Pour spécifier un compilateur différent, reportez-vous à la remarque figurant à la fin de la rubrique Installation et configuration d'Agent Builder.

Après avoir entré les informations requises, cliquez sur Créer. La fenêtre du journal, en bas de l'écran, présente les actions entreprises par Agent Builder. Vous pouvez choisir l'option Enregistrer journal du menu Éditer pour enregistrer les informations dans le journal.

Une fois l'opération terminée, Agent Builder affiche un message indiquant qu'elle a été correctement effectuée ou un avertissement.

• Si Agent Builder n'a pas été en mesure de terminer correctement cette étape, consultez les informations détaillées dans le journal.

• Si Agent Builder a correctement terminé cette étape, cliquez sur Suivant pour afficher l'écran Configurer permettant de terminer la génération du type de ressources.

Bien que le processus de génération d'un type de ressources complet soit composé de deux étapes, vous pouvez quitter Agent Builder une fois la première étape (création) terminée sans perdre les données entrées ou le travail exécuté par Agent Builder. Voir la rubrique Réutilisation d'un travail terminé.

Utilisation de l'écran Configurer

Écran Configurer

L'écran Configurer, présenté ci-après, apparaît une fois qu'Agent Builder a terminé la création du type de ressources et que vous avez sélectionné Suivant sur l'écran Créer. Vous ne pouvez pas accéder à l'écran Configurer avant d'avoir créé le type de ressources.

Figure 9–3 Écran Configurer

L'écran Configurer contient les champs suivants :

• Commande de démarrage : Ligne de commande complète pouvant être transmise à n'importe quel shell UNIX pour lancer l'application de base. Vous devez indiquer une commande de démarrage. Pour ce faire, vous pouvez entrer la commande dans le champ correspondant ou indiquer le fichier la contenant, à l'aide de l'option Parcourir.

  La ligne de commande complète doit contenir toutes les informations requises pour démarrer l'application (noms d'hôte, numéros de port, chemin d'accès aux fichiers de configuration, etc.). Vous pouvez également indiquer les variables de propriété, décrites sous la rubrique Variables de propriété. Si l'application korn shell requiert la définition d'un nom d'hôte dans la ligne de commande, vous pouvez utiliser la variable $hostnames définie par Agent Builder. Voir la rubrique Utilisation de la variable $hostnames korn shell d'Agent Builder.

  Ne placez pas la commande entre guillemets (””).

  ---

  Remarque –

  si l'application de base comprend plusieurs arborescences de processus indépendantes et que chaque processus est exécuté à partir de sa propre balise sous la fonction PMF (Process Monitor Facility ), vous ne pouvez indiquer aucune commande. Vous devez plus exactement créer un fichier texte contenant les commandes individuelles de démarrage de chaque arborescence de processus et indiquer le chemin d'accès à ce fichier dans le champ Commande de démarrage. Reportez-vous à la rubrique Création de types de ressources contenant plusieurs arborescences de processus indépendantes. Vous y découvrirez quelques-unes des caractéristiques spécifiques que requiert ce fichier pour fonctionner correctement.

  ---

• Commande d'arrêt : ligne de commande complète pouvant être transmise à n'importe quel shell UNIX pour arrêter l'application de base. Vous pouvez entrer cette commande dans le champ correspondant ou indiquer le fichier la contenant, à l'aide de l'option Parcourir. Vous pouvez également indiquer les variables de propriété, décrites sous la rubrique Variables de propriété. Si l'application korn shell requiert la définition d'un nom d'hôte dans la ligne de commande, vous pouvez utiliser la variable $hostnames définie par Agent Builder. Voir la rubrique Utilisation de la variable $hostnames korn shell d'Agent Builder.

  Cette commande est facultative. Si vous n'indiquez pas de commande d'arrêt, le code généré utilise les signaux (de la méthode Stop) pour arrêter l'application, comme suit :

  • La méthode Stop envoie le signal SIGTERM pour arrêter l'application et laisse s'écouler 80% du délai d'attente pour que l'application se ferme.

  • Si le signal SIGTERM échoue, la méthode Stop envoie le signal SIGKILL pour arrêter l'application et laisse s'écouler 15% du délai d'attente pour que l'application se ferme.

  • Si le signal SIGKILL échoue, la méthode Stop se ferme sans arrêter l'application. Les 5 % restants du délai d'attente sont considérés comme temps système.

  ---

  Attention –

  veillez à ce que la commande d'arrêt ne soit pas renvoyée avant l'arrêt complet de l'application.

  ---

• Commande d'analyse : commande pouvant être exécutée périodiquement pour vérifier l'état de l'application et obtenir un état de sortie compris entre 0 (succès) et 100 (échec total). Cette commande est facultative. Vous pouvez entrer le chemin d'accès complet à cette commande ou indiquer le fichier qui la contient, à l'aide de l'option Parcourir.

  En règle générale, vous indiquez un client unique de l'application de base. Si vous n'indiquez pas de commande d'analyse, le code généré se contente de se connecter au port utilisé par la ressource puis de se déconnecter. Si cette opération réussit, l'application est déclarée comme étant parfaitement opérationnelle. Vous pouvez également indiquer les variables de propriété, décrites sous la rubrique Variables de propriété. Si l'application korn shell requiert la définition d'un nom d'hôte dans la ligne de commande, vous pouvez utiliser la variable $hostnames définie par Agent Builder. Voir la rubrique Utilisation de la variable $hostnames korn shell d'Agent Builder.

• Délai d'attente : valeur de délai d'attente (en secondes) pour chaque commande. Vous pouvez indiquer une nouvelle valeur ou accepter la valeur par défaut fournie par Agent Builder (300 secondes pour le démarrage et l'arrêt et 30 secondes pour l'analyse).

Utilisation de la variable $hostnames korn shell d'Agent Builder

Pour un certain nombre d'applications, notamment les applications compatibles réseau, le nom de l'hôte sur lequel l'application écoute et traite les requêtes des clients doit être transmis à l'application sur la ligne de commande. Souvent, vous devez indiquer le paramètre de nom d'hôte pour les commandes de démarrage, d'arrêt et d'analyse du type de ressources cible (sur l'écran Configurer). Le nom d'hôte d'écoute de l'application est propre au cluster. Il est déterminé lorsque la ressource est exécutée sur un cluster, mais il ne peut pas être déterminé lorsqu'Agent Builder génère le code du type de ressource.

Pour pallier ce problème, Agent Builder propose la variable $hostnames que vous pouvez spécifier sur la ligne de commande pour les commandes de démarrage, d'arrêt et de détection.

La variable $hostnames n'est prise en charge que lorsqu'elle est utilisée avec les services korn shell. Elle ne peut pas être utilisée avec les services C et GDS.

Vous spécifiez la variable $hostnames exactement comme vous indiqueriez un nom d'hôte réel. Exemple :

% /opt/network_aware/echo_server -p num_port -l $hostnames

Lorsqu'une ressource du type de ressources cible est exécutée sur un cluster, le nom d'hôte LogicalHostname (NomHôteLogique) ou SharedAddress (AdressePartagée) de cette ressource (défini dans la propriété de ressource Network_resources_used (Ressources_réseau_utilisées) de cette ressource) est remplacé par la valeur de la variable $hostnames.

Si vous configurez la propriété Network_resources_used (Ressources_réseau_utilisées) avec plusieurs noms d'hôte, ils sont tous contenus dans la variable $hostnames, séparés par une virgule.

Variables de propriété

Vous pouvez récupérer dans l'infrastructure du RGM (Resource Group Manager), les valeurs des propriétés de groupe de ressources, de type de ressource et de ressource Sun Cluster sélectionnées, à l'aide des variables de propriété. Agent Builder recherche des variables de propriété dans le script de démarrage, d'analyse ou d'arrêt et les remplace par leur valeur, avant de lancer le script.

Les variables de propriété ne peuvent pas être utilisées avec des services korn shell.

Liste des variables de propriété

La liste ci-après répertorie les variables de propriété susceptibles d'être utilisées dans les scripts. Les propriétés de groupe de ressources, de type de ressource et de ressource Sun Cluster sont présentées dans Annexe A, Propriétés standard.

La liste ci-dessous présente les variables de propriété de ressource :

• HOSTNAMES

• RS_CHEAP_PROBE_INTERVAL

• RS_MONITOR_START_TIMEOUT

• RS_MONITOR_STOP_TIMEOUT

• RS_NAME

• RS_NUM_RESTARTS

• RS_RESOURCE_DEPENDENCIES

• RS_RESOURCE_DEPENDENCIES_WEAK

• RS_RETRY_COUNT

• RS_RETRY_INTERVAL

• RS_SCALABLE

• RS_START_TIMEOUT

• RS_STOP_TIMEOUT

• RS_THOROUGH_PROBE_INTERVAL

• SCHA_STATUS

La liste ci-dessous répertorie les variables de propriété des types de ressources :

• RT_API_VERSION

• RT_BASEDIR

• RT_FAILOVER

• RT_INSTALLED_NODES

• RT_NAME

• RT_RT_VERSION

• RT_SINGLE_INSTANCE

La liste ci-dessous répertorie les variables de propriété des groupes de ressources :

• RG_DESIRED_PRIMARIES

• RG_GLOBAL_RESOURCES_USED

• RG_IMPLICIT_NETWORK_DEPENDENCIES

• RG_MAXIMUM_PRIMARIES

• RG_NAME

• RG_NODELIST

• RG_NUM_RESTARTS

• RG_PATHPREFIX

• RG_PINGPONG_INTERVAL

• RG_RESOURCE_LIST

Syntaxe des variables de propriété

Vous devez ajouter le symbole de pourcentage (%) devant un nom de propriété pour indiquer une variable de propriété, comme illustré dans l'exemple suivant :

# /opt/network_aware/echo_server -t %RS_STOP_TIMEOUT -n %RG_NODELIST

Selon l'exemple ci-dessus, Agent Builder peut interpréter les variables de propriété et lancer le script echo_server avec les valeurs suivantes :

# /opt/network_aware/echo_server -t 300 -n nœud-phys-1,nœud-phys-2,nœud-phys-3

Interprétation et remplacement des variables de propriété par Agent Builder

La liste ci-dessous présente les clés de l'interprétation des types de variables de propriété par Agent Builder :

• Un entier est remplacé par sa valeur réelle ( 300, par exemple).

• Une valeur booléenne est remplacée par la chaîne TRUE ou FALSE.

• Une chaîne est remplacée par la chaîne réelle ( nœud-phys-1, par exemple).

• Une liste de chaînes est remplacée par tous les membres de la liste, chacun étant séparé par une virgule (nœud-phys-1,nœud-phys-2,nœud-phys-3, par exemple).

• Une liste d'entiers est remplacée par tous les membres de la liste, séparés par une virgule (1,2,3, par exemple).

• Un type énuméré est remplacé par sa valeur, sous forme de chaîne.

Réutilisation d'un travail terminé

Agent Builder permet de réutiliser un travail terminé de l'une des manières suivantes :

• Vous pouvez cloner un type de ressources existant créé avec Agent Builder.

• Vous pouvez éditer le code source généré par Agent Builder puis recompiler le code pour créer un nouveau package.

Clonage d'un type de ressources existant

Procédez comme suit pour cloner un type de ressources existant généré par Agent Builder :

1. Chargez un type de ressources existant dans Agent Builder, de l'une des manières suivantes :

   • Lancez Agent Builder à partir du répertoire de travail (contenant le fichier rtconfig) d'un type de ressources existant (créé avec Agent Builder). Agent Builder charge les valeurs du type de ressources sur les écrans Créer et Configurer.

   • Utilisez l'option Charger type de ressources, accessible à partir du menu déroulant Fichier.

2. Modifiez le répertoire de travail dans l'écran Créer.

   Vous devez utiliser l'option Parcourir pour sélectionner un répertoire. La saisie d'un nouveau nom de répertoire est insuffisante. Une fois le répertoire sélectionné, Agent Builder active de nouveau le bouton Créer.

3. Apportez les modifications requises.

   Cette procédure vous permet notamment de modifier le type de code généré pour le type de ressources. Par exemple, si vous avez commencé par créer une version korn shell d'un type de ressources avant de constater qu'il vous faut une version C, vous pouvez charger le type de ressources korn shell existant, remplacer le langage de sortie par C, puis utiliser Agent Builder pour concevoir une version C du type de ressources.

4. Créez le clone du type de ressources.

   Cliquez sur Créer pour créer le type de ressources. Cliquez sur Suivant pour afficher l'écran Configurer. Cliquez sur Configurer pour configurer le type de ressources, puis cliquez sur Annuler pour terminer.

Édition du code source généré

Pour que le processus de création d'un type de ressources reste simple, Agent Builder limite le nombre d'entrées, ce qui restreint la portée du type de ressources généré. Par conséquent, si vous souhaitez ajouter des fonctions plus complexes (des contrôles de validation de propriétés supplémentaires, par exemple) ou régler des paramètres qu'Agent Builder n'affiche pas, vous devez modifier le code source généré ou le fichier RTR.

Les fichiers sources sont disponibles dans le répertoire répertoire_installation /nom_type_res/src. Agent Builder intègre des commentaires dans le code source là où vous pouvez ajouter un code. Exemple (pour un code C) :

/* Code ajouté par l'utilisateur -- BEGIN vvvvvvvvvvvvvvv */
/* Code ajouté par l'utilisateur -- END   ^^^^^^^^^^^^^^^ */

Ces commentaires sont identiques dans le code source korn shell, à l'exception du signe dièse (#) indiquant le début d'un commentaire.

Par exemple, nom_typ_res.h déclare toutes les routines utilitaires que les différents programmes utilisent. À la fin de la liste des déclarations, vous trouverez des commentaires vous permettant de déclarer les autres routines que vous aimeriez ajouter à n'importe quel code source.

Agent Builder génère également un fichier makefile dans le répertoire répertoire_installation/nom_type_res/src avec les cibles appropriées. Les commandes make et make pkg permettent respectivement de recompiler le code source et de générer de nouveau le package du type de ressources.

Le fichier RTR figure dans le répertoire répertoire_installation/ nom_type_res/etc. Vous pouvez le modifier à l'aide d'un éditeur de texte standard. Voir la rubrique Paramétrage des propriétés de ressources et de types de ressources pour obtenir plus d'informations sur le fichier RTR et l'Annexe A, Propriétés standard pour plus d'informations sur les propriétés.

Utilisation de la version de ligne de commande d'Agent Builder

La version de ligne de commande d'Agent Builder s'appuie sur la même procédure de base que l'interface utilisateur graphique. Néanmoins, au lieu de saisir des informations dans l'interface utilisateur graphique, vous devez transmettre les paramètres aux commandes scdscreate et scdsconfig. Voir les pages man de scdscreate(1HA) et scdsconfig(1HA).

Procédez comme suit pour utiliser la version ligne de commande d'Agent Builder :

1. Utilisez la commande scdscreate pour créer un modèle de type de ressources Sun Cluster permettant de concevoir une application hautement disponible ou évolutive.

2. Utilisez la commande scdsconfig pour configurer le modèle de type de ressources créé avec scdscreate.

   Vous pouvez indiquer des variables de propriété, décrites sous la rubrique Variables de propriété.

3. Remplacez les répertoires par le sous-répertoire pkg dans le répertoire de travail.

4. Utilisez la commande pkgadd pour installer les packages créés avec scdscreate.

5. Éditez le code source généré, si vous le souhaitez.

6. Exécutez le script de démarrage.

Structure de répertoire

Agent Builder crée une structure de répertoire afin de stocker tous les fichiers générés pour le type de ressources cible. Le répertoire de travail est défini à partir de l'écran Créer. Vous devez indiquer des répertoires d'installation distincts pour chaque type de ressources que vous développez. Dans le répertoire de travail, Agent Builder crée un sous-répertoire dont le nom résulte de la concaténation du nom du fournisseur et du nom du type de ressources (à partir de l'écran Créer). Par exemple, si vous spécifiez SUNW comme nom de fournisseur et que vous créiez un type de ressources appelé ftp, Agent Builder crée le répertoire SUNWftp sous le répertoire de travail.

Dans ce sous-répertoire, Agent Builder crée et remplit les répertoires présentés dans le tableau suivant :

# man -M répertoire_installation/SUNWftp/man removeftp

Sortie d'Agent Builder

Cette rubrique décrit la sortie générée par Agent Builder.

Fichiers sources et binaires

Le RGM (Resource Group Manager) permet de gérer les groupes de ressources et, en définitive, les ressources sur un cluster. Il utilise pour ce faire un modèle de rappel (callback). Lorsqu'un événement spécifique se produit, comme un nœud tombant en panne par exemple, le RGM appelle les méthodes du type de ressources de toutes les ressources exécutées sur le nœud défectueux. Par exemple, le RGM appelle la méthode Stop pour arrêter une ressource exécutée sur le nœud défectueux, puis il appelle la méthode Start de cette ressource pour la lancer sur un autre nœud. Voir les rubriques Modèle RGM, Méthodes de rappel et la page rt_callbacks(1HA) pour obtenir plus d'informations sur le modèle.

Pour prendre en charge ce modèle, Agent Builder génère huit scripts korn shell ou programmes C exécutables dans le répertoire répertoire_installation/ nom_type_res/bin utilisés comme méthodes de rappel.

Le programme nom_type_res _probe mettant en œuvre un système de détection des pannes, n'est pas à proprement parler un programme de rappel. Le RGM n'appelle pas directement nom_type_res _probe ; il appelle nom_type_res _monitor_start ou nom_type_res _monitor_stop qui exécute ou arrête respectivement le système de détection des pannes en appelant nom_type_res_probe.

Les huit méthodes générées par Agent Builder sont les suivantes :

• nom_type_res_monitor_check ;

• nom_type_res_monitor_start ;

• nom_type_res_monitor_stop ;

• nom_type_res_probe ;

• nom_type_res_svc_start ;

• nom_type_res_svc_stop ;

• nom_type_res_update ;

• nom_type_res_validate.

Reportez-vous à la page man rt_callbacks( 1HA) pour de plus amples informations sur chacune de ces méthodes.

Agent Builder génère les fichiers suivants dans le répertoire répertoire_installation/ nom_type_res/src (sortie C) :

• un fichier d'en-tête (nom_type_res.h) ;

• un fichier source (nom_type_res .c) contenant le code commun à toutes les méthodes ;

• un fichier d'objets (nom_type_res.o) pour le code commun ;

• des fichiers sources (*.c) pour chacune des méthodes ;

• des fichiers d'objets (*.o) pour chacune des méthodes.

Agent Builder lie le fichier nom_type_res .o à chaque fichier .o de méthode pour créer les exécutables dans le répertoire répertoire_installation/ nom_type_res/bin.

Dans le cadre d'une sortie korn shell, les répertoires répertoire_installation /nom_type_res/bin et répertoire_installation/nom_type_res/src sont identiques. Chacun d'eux comporte huit scripts d'exécution correspondant aux sept méthodes de rappel et à la méthode Probe.

La sortie korn shell comprend deux programmes utilitaires compilés (gettime et gethostnames) requis par certaines méthodes de rappel pour obtenir l'heure ou effectuer une analyse.

Vous pouvez éditer le code source, exécuter la commande make pour recompiler le code, puis exécuter la commande make pkg pour générer un nouveau package. Pour permettre la modification du code source, Agent Builder insère des commentaires dans le code source aux emplacements auxquels il est possible d'ajouter du code. Reportez-vous à la rubrique Édition du code source généré.

Scripts d'utilitaire et pages man

Vous avez généré un type de ressources et installé le package correspondant sur un cluster. Vous devez encore exécuter une instance (ressource) du type de ressources sur un cluster à l'aide, en règle générale, de commandes administratives ou de SunPlex Manager. Pourtant, par souci de simplicité, Agent Builder génère à cet effet un script d'utilitaire personnalisé (le script de démarrage), ainsi que des scripts d'arrêt et de suppression d'une ressource du type de ressources cible. Ces trois scripts, disponibles dans le répertoire répertoire_installation/nom_type_res/util, ont les fonctions suivantes :

• Script de démarrage : enregistre le type de ressources et crée les ressources et les groupes de ressources nécessaires. Il crée également les ressources d'adresse réseau (LogicalHostname ou SharedAddress) permettant à l'application de communiquer avec les clients sur le réseau.

• Script d'arrêt : arrête et désactive la ressource.

• Script de suppression : annule les actions du script de démarrage. Il permet d'arrêter les ressources, les groupes de ressources et le type de ressources cible et de les supprimer du système.

vous ne pouvez utiliser le script de suppression qu'avec une ressource exécutée à l'aide du script de démarrage car ces scripts utilisent des conventions internes pour nommer les ressources et les groupes de ressources.

Agent Builder attribue un nom à ces scripts en ajoutant le nom d'application aux noms de script. Par exemple, si le nom d'application est ftp , les scripts sont appelés startftp, stopftp et removeftp.

Agent Builder contient des pages man dans le répertoire répertoire_installation/nom_type_res/man/man1m de chaque script d'utilitaire. Vous devez les lire avant de lancer ces scripts car elles présentent les paramètres qu'il vous faut fournir au script.

Pour consulter ces pages man, indiquez le chemin d'accès au répertoire correspondant en utilisant l'option -M avec la commande man. Par exemple, si le nom du fournisseur est SUNW et le nom d'application ftp, utilisez la commande suivante pour afficher la page man startftp (1M) :

% man -M répertoire_installation/SUNWftp/man startftp

Les scripts d'utilitaire des pages man sont également disponibles auprès de l'administrateur du cluster. Lorsqu'un package généré par Agent Builder est installé sur un cluster, les pages man des scripts d'utilitaire sont placées dans le répertoire /opt/ nom_type_res/man. Par exemple, utilisez la commande suivante pour afficher la page man de startftp(1M) :

% man -M /opt/SUNWftp/man startftp

Fichiers de prise en charge

Agent Builder place les fichiers de prise en charge, comme pkginfo, postinstall, postremove et preremove, dans le répertoire répertoire_installation/nom_type_res/etc. Ce répertoire contient également le fichier RTR (Resource Type Registration), déclarant les propriétés de ressources et de type de ressources disponibles pour le type de ressources cible et initialisant les valeurs de propriétés lors de l'enregistrement d'une ressource sur un cluster. Pour plus d'informations, voir la rubrique Paramétrage des propriétés de ressources et de types de ressources. Le nom du fichier RTR est créé de la manière suivante : nom_fournisseur.nom_type_ressources, par exemple SUNW.ftp.

Vous pouvez modifier ce fichier à l'aide d'un éditeur de texte standard et apporter des modifications sans recompiler votre code source. Vous devez, cependant, reconstituer le package avec la commande make pkg.

Répertoire du package

Le répertoire répertoire_installation/nom_type_res/pkg contient un package Solaris. Le nom du package est une concaténation du nom du fournisseur et du nom d'application, par exemple SUNWftp. Le fichier Makefile situé dans le répertoire répertoire_installation/nom_type_res/src prend en charge la création d'un nouveau package. Par exemple, si vous modifiez les fichiers sources et recompilez le code ou si vous modifiez les scripts d'utilitaire du package, vous devez utiliser la commande make pkg pour créer un nouveau package.

La commande pkgrm peut échouer lors de la suppression d'un package d'un cluster si vous tentez de l'exécuter sur plusieurs nœuds simultanément. Vous pouvez pallier ce problème de l'une des deux façons suivantes :

• Exécutez le script remove nom_type_res à partir d'un nœud du cluster, avant d'exécuter la commande pkgrm à partir de n'importe quel nœud.

• Exécutez la commande pkgrm à partir de l'un des nœuds du cluster (afin d'effectuer toutes les opérations de nettoyage requises), puis exécutez-la à partir des nœuds restants, simultanément si nécessaire.

Si la commande pkgrm échoue car vous tentez de l'exécuter simultanément sur plusieurs nœuds, lancez-la de nouveau nœud par nœud, puis sur les nœuds restants.

Fichier rtconfig

Si vous générez un code source C ou korn shell dans le répertoire de travail, Agent Builder génère un fichier de configuration rtconfig contenant les informations que vous avez entrées dans les écrans Créer et Configurer. Si vous lancez Agent Builder à partir du répertoire de travail d'un type de ressources existant (ou si vous chargez un type de ressources existant en sélectionnant l'option Charger type de ressources dans le menu déroulant Fichier), Agent Builder lit le fichier rtconfig et remplit les champs des écrans Créer et Configurer avec les informations indiquées pour le type de ressources existant. Cette fonction est particulièrement utile lorsque vous souhaitez cloner un type de ressources existant. Voir la rubrique Clonage d'un type de ressources existant.

Module Cluster Agent pour Agent Builder

Le module Cluster Agent pour Agent Builder est un module NetBeans^TM permettant aux utilisateurs de Sun Java Studio (précédemment Sun ONE Studio) de créer des types de ressources ou des services de données pour le logiciel Sun Cluster à l'aide d'un environnement de développement intégré. Ce module se caractérise par une interface écran permettant de décrire chaque sorte de type de ressources que vous souhaitez créer.

la documentation de Sun Java Studio présente les procédures de configuration, d'installation et d'utilisation de ce logiciel.

Installation et configuration du module Cluster Agent

Le module Cluster Agent est installé en même temps que le logiciel Sun Cluster. L'outil d'installation de Sun Cluster enregistre le fichier du module Cluster Agent scdsbuilder.jar sous /usr/cluster/lib/scdsbuilder. Pour utiliser le module Cluster Agent avec le logiciel Sun Java Studio, vous devez créer un lien symbolique vers ce fichier.

Les logiciels Sun Cluster, Sun Java Studio et Java 1.4 doivent être installés et accessibles sur le système sur lequel vous envisagez d'exécuter le module Cluster Agent.

1. Configurez un accès multi-utilisateur ou mono-utilisateur au module Cluster Agent.

   • Pour permettre à tous les utilisateurs d'accéder au module Cluster Agent, connectez-vous en tant que superutilisateur, ou avec un rôle équivalent, et créez un lien symbolique dans le répertoire global du module :

     # cd /opt/s1studio/ee/modules # ln -s /usr/cluster/lib/scdsbuilder/scdsbuilder.jar

     ---

     Remarque –

     si vous installez le logiciel Sun Java Studio dans un autre répertoire que /opt/s1studio/ee, remplacez ce chemin d'accès par le chemin d'accès approprié.

     ---

   • Pour permettre uniquement à vous-même d'accéder au module, créez le lien symbolique dans votre sous-répertoire modules :

     % cd ~votre_rép_personnel/ffjuser40ee/modules % ln -s /usr/cluster/lib/scdsbuilder/scdsbuilder.jar

2. Fermez et relancez le logiciel Sun Java Studio.

Démarrage du module Cluster Agent

La procédure suivante décrit comment démarrer le module Cluster Agent à partir du logiciel Sun Java Studio.

1. À partir du menu Fichier de Sun Java Studio, sélectionnez Nouveau, ou dans la barre d'outils, cliquez sur l'icône illustrée ci-dessous :

   L'écran Assistant Nouveau apparaît.

   

2. Dans la fenêtre Sélectionner un modèle, faites défiler la liste (si nécessaire), puis cliquez sur la clé en regard du dossier Autre :

   Le dossier Autre s'ouvre.

   

3. Dans le dossier Autre, sélectionnez Sun Cluster Agent Builder, puis cliquez sur Suivant.

   Le module Cluster Agent pour Sun Java Studio démarre. Le premier écran Assistant Nouveau - Sun Cluster Agent Builder apparaît.

   

Utilisation du module Cluster Agent

Utilisez le module Cluster Agent de la même façon que le logiciel Agent Builder. Leurs interfaces sont identiques. Par exemple, les illustrations suivantes montrent que l'écran Créer du logiciel Agent Builder et le premier écran Assistant Nouveau - Sun Cluster Agent Builder du module Cluster Agent contiennent les mêmes champs et sélections.

Figure 9–4 Écran Créer du logiciel Agent Builder

Figure 9–5 Écran Assistant Nouveau - Sun Cluster Agent Builder du module Cluster Agent

Différences entre le module Cluster Agent et Agent Builder

Malgré la grande similitude entre le module Cluster Agent et Agent Builder, il existe quelques petites différences :

• Dans le module Cluster Agent, le type de ressources n'est créé et configuré qu'après avoir cliqué sur Terminer dans le second Assistant Nouveau - Sun Cluster Agent Builder. Le type de ressources n'est pas créé lorsque vous cliquez sur Suivant dans le premier écran Assistant Nouveau - Sun Cluster Agent Builder.

  Dans Agent Builder, le type de ressources est créé immédiatement lorsque vous cliquez sur Créer dans l'écran Créer. Il est de même configuré immédiatement lorsque vous cliquez sur Configurer dans l'écran Configurer.

• Les données figurant dans la fenêtre Journal d'Agent Builder apparaissent dans une fenêtre de résultat dans le logiciel Sun Java Studio.