Guide des développeurs pour les services de données Sun Cluster 3.1 10/03

Utilisation de SunPlex Agent Builder pour créer un service basé sur le module GDS

SunPlex Agent Builder vous permet de créer le service utilisant le module GDS. SunPlex Agent Builder est présenté plus en détail dans le Chapitre 9.

Création d'un service dans SunPlex Agent Builder à l'aide du module GDS

Création d'un service basé sur le module GDS dans Agent Builder
  1. Lancez SunPlex Agent Builder.


    # /usr/cluster/bin/scdsbuilder
    
  2. Le panneau SunPlex Agent Builder apparaît.

    Boîte de dialogue intitulée SunPlex Agent Builder présentant l'écran principal d'Agent Builder
  3. Renseignez le champ Nom du fournisseur.

  4. Renseignez le champ Nom de l'application.


    Remarque :

    la combinaison du nom du fournisseur et de celui de l'application ne doit pas excéder neuf caractères. Cette combinaison sert de nom au package des scripts moteurs.


  5. Accédez au répertoire de travail.

    Vous pouvez utiliser le bouton Parcourir pour sélectionner le répertoire de votre choix plutôt que d'entrer son chemin d'accès.

  6. Indiquez si le service de données est évolutif ou de basculement.

    Vous n'êtes pas tenu de sélectionner l'option Compatible réseau, celle-ci étant celle attribuée par défaut lors de la création du module GDS.

  7. Sélectionnez GDS.

  8. Cliquez sur le bouton Créer pour créer les scripts moteurs.

  9. Le panneau SunPlex Agent Builder affiche les résultats de la création du service. Le bouton Créer est grisé. Vous pouvez à présent utiliser le bouton Suivant.

    Boîte de dialogue présentant l'écran Créer une fois les champs renseignés
Configuration des scripts moteurs

Une fois que vous avez créé les scripts moteurs, vous devez utiliser SunPlex Agent Builder pour configurer le nouveau service.

  1. Cliquez sur le bouton Suivant pour afficher le panneau de configuration.

  2. Entrez le chemin d'accès à la commande de démarrage ou utilisez le bouton Parcourir pour sélectionner la commande de démarrage.

  3. (Facultatif) Entrez la commande d'arrêt ou utilisez le bouton Parcourir pour sélectionner la commande d'arrêt.

  4. (Facultatif) Entrez la commande de détection ou utilisez le bouton Parcourir pour sélectionner la commande de détection.

  5. (Facultatif) Spécifiez les valeurs de délai d'attente des commandes d'arrêt, de démarrage et de détection.

  6. Cliquez sur Configurer pour démarrer la configuration des scripts moteurs.


    Remarque :

    le nom du package se compose d'une concaténation du nom du fournisseur et de celui de l'application.


    Un package de scripts moteurs est ainsi créé et placé dans :


    <rép_travail>/<nom_fournisseur><application>/pkg
    
    Par exemple, /export/wdir/NETapp/pkg

  7. Installez le package complet sur tous les noeuds du cluster.


    # cd /export/wdir/NETapp/pkg
    # pkgadd -d . NETapp
    

  8. Les fichiers suivants sont installés au cours de pkgadd :


    /opt/NETapp
    /opt/NETapp/README.app
    /opt/NETapp/man
    /opt/NETapp/man/man1m
    /opt/NETapp/man/man1m/removeapp.1m
    /opt/NETapp/man/man1m/startapp.1m
    /opt/NETapp/man/man1m/stopapp.1m
    /opt/NETapp/man/man1m/app_config.1m
    /opt/NETapp/util
    /opt/NETapp/util/removeapp
    /opt/NETapp/util/startapp
    /opt/NETapp/util/stopapp
    /opt/NETapp/util/app_config


    Remarque :

    les pages man et les noms des scripts correspondront au nom de l'application que vous avez entré ci-dessus, précédé du nom du script ; par exemple, startapp.


    Pour afficher les pages man, vous devez spécifier leur chemin d'accès. Par exemple, pour afficher les pages man startapp, utilisez :


    # man -M /opt/NETapp/man startapp
    
  9. Sur l'un des noeuds du cluster, configurez les ressources et démarrez l'application.


    # /opt/NETapp/util/startapp -h <nom_hôte_logique> -p <liste_ports_et_protocole>
    

    Les arguments du script de démarrage varient en fonction du type de ressources : de basculement ou évolutives. Vérifiez la page man personnalisée ou exécutez le script de démarrage sans argument pour obtenir une déclaration d'utilisation.


    # /opt/NETapp/util/startapp
     Vous devez spécifier le nom de ressource de LogicalHostname ou de SharedAddress.
     Pour des services de basculement :
     Utilisation : startapp -h <nom_hôte_logique>
              -p <liste_ports_et_protocoles>
              [-n <liste_groupes_mp_ip_et_adaptateur>]
     Pour des services évolutifs :
     Utilisation : startapp
              -h <nom_adresse_partagée>
              -p <liste_ports_et_protocoles>
              [-l <règle_équilibrage_charge>]
              [-n <liste_groupe_mp_ip_et_adaptateur>]
              [-w <poids_équilibrage_charge>]

Sortie de SunPlex Agent Builder

SunPlex Agent Builder génère trois scripts de commande et un fichier de configuration en fonction des données que vous saisissez à la création du package. Le fichier de configuration spécifie les noms du groupe de ressources et du type de ressources.

Les scripts moteurs sont :

Ces scripts moteurs ont la même interface et se comportent de la même façon que les scripts utilitaires générés par SunPlex Agent Builder pour les agents qui ne sont pas basés sur GDS. Les scripts sont regroupés en un package compatible avec Solaris et réutilisable sur plusieurs clusters.

Vous pouvez personnaliser le fichier de configuration pour y indiquer les noms de vos groupes de ressources ou d'autres paramètres qui correspondent généralement à des entrées de la commande scrgadm. Si vous ne personnalisez pas les scripts, SunPlex Agent Builder fournit des valeurs par défaut rationnelles aux paramètres scrgadm.