Guide des services de données Sun Cluster pour Sun Java System Application Server pour SE Solaris

Enregistrement et configuration de Sun Cluster HA pour Sun Java System Application Server Versions antérieures à 8.1

Les procédures suivantes décrivent l'utilisation de la commande scrgadm pour enregistrer et configurer Sun Cluster HA pour Sun Java System Application Server. Ces instructions expliquent comment définir les propriétés d'extension décrites à l'Annexe A, Propriétés d'extension de Sun Cluster HA pour Sun Java System Application Server Versions 8.1 et ultérieures.

Les composants DAS et NA sont tous les deux configurés comme des services de basculement.


Remarque –

pour obtenir des informations générales sur l'enregistrement et la configuration des services de données, reportez-vous à la section Tools for Data Service Resource Administration du Sun Cluster Data Services Planning and Administration Guide for Solaris OS.


Définition des propriétés d'extension de Sun Cluster HA pour Sun Java System Application Server

Les sections suivantes contiennent des instructions relatives à l'enregistrement et à la configuration des ressources. Ces instructions expliquent comment définir uniquement les propriétés d'extension que Sun Cluster HA pour Sun Java System Application Server souhaite vous voir définir. Pour plus d'informations sur toutes les propriétés d'extension de Sun Cluster HA pour Sun Java System Application Server, reportez-vous à l'Annexe A, Propriétés d'extension de Sun Cluster HA pour Sun Java System Application Server Versions 8.1 et ultérieures. Vous pouvez mettre certaines propriétés d'extension à jour de façon dynamique. Cependant, certaines autres propriétés ne peuvent être mises à jour qu'au moment où vous créez ou désactivez une ressource. L'entrée Réglable indique le moment où vous pouvez mettre à jour une propriété.

Pour définir la propriété d'extension d'une ressource, incluez l'option suivante dans la commande scrgadm(1M) qui crée ou modifie la ressource :


-x property=value
-x property

Identifie la propriété d'extension que vous définissez

valeur

Spécifie la valeur sur laquelle vous définissez la propriété d'extension

Vous pouvez également utiliser les procédures du Chapitre 2, Administering Data Service Resources du Sun Cluster Data Services Planning and Administration Guide for Solaris OS pour configurer les ressources une fois qu'elles sont créées.

ProcedureEnregistrement et configuration de Sun Cluster HA pour Sun Java System Application Server en tant que composant DAS et NA de basculement

Notez que dans la section Procédure de configuration et d'activation des ressources réseau, vous avez créé les groupes de ressources de basculement pour les composants DAS et NA, ajouté les adresses IP de basculement et les hôtes logiques aux groupes de ressources et mis les groupes de ressources en ligne.

Étapes
  1. Connectez-vous en tant que superutilisateur sur un membre du cluster.

  2. Enregistrez le type de ressource du composant DAS.


    # scrgadm -a -t SUNW.jsas
    
    -a

    Ajoute le type de ressource au composant DAS

    -t SUNW.jsas

    Spécifie le nom prédéfini du type de ressource.

  3. Ajoutez l'instance de ressource DAS au groupe de ressources de basculement créé pour vos ressources réseau.

    Pour obtenir une description détaillée des propriétés d'extension de ce type de ressources, reportez-vous à la section Propriétés d'extension de SUNW.jsas .


    # scrgadm -a -j DAS-resource -g DAS-resource-group \ 
    -t SUNW.jsas \
    -y Network_resources_used=logical-hostname \ 
    -x Adminuser=DAS-admin-username \ 
    -x Domain_name=domain-name \ 
    -x Passwordfile=password-file \ 
    -x Confdir_list=install-directory \ 
    -x Domaindir=domain-directory \ 
    -x Monitor_Uri_List=http://logical-hostname[:port][/path]
    
    -a

    Ajoute une ressource.

    -j DAS-resource

    Indique le nom de la ressource DAS.

    -g DAS-resource-group

    Indique le groupe de ressources du composant DAS.

    -t SUNW.jsas

    Indique le type de ressource du composant DAS.

    -y Network_resources_used =logical-hostname

    Indique l'adresse IP de basculement utilisée par le DAS.

    -x Adminuser= DAS-admin-username

    Indique le nom d'utilisateur administratif du DAS.

    -x Domain_name= domain-name

    Indique le nom de domaine.

    -x Passwordfile= password-file

    Indique le chemin absolu du fichier contenant le mot de passe administratif DAS et le mot de passe principal.

    -x Confdir_list= install-directory

    Indique le chemin absolu du répertoire d'installation de Sun Java System Application Server. Par défaut, cette propriété d'extension a la valeur /opt/SUNWappserver : elle indique le répertoire d'installation standard.

    -x Domaindir= domain-directory

    Indique le chemin absolu du répertoire du domaine. Cette propriété d'extension est facultative si le répertoire du domaine est le répertoire par défaut spécifié lors de l'installation de Sun Java System Application Server.

    -x Monitor_Uri_List =logical-hostname[:port][/path]

    (Facultatif) Indique une liste d'URI séparés par des virgules, à partir de laquelle Sun Cluster HA pour Sun Java System Application Server effectue des requêtes. La propriété d'extension Monitor_Uri_List est requise si la propriété Port_list n'est pas configurée. La propriété Port_list est l'une des propriétés standard d'une ressource, qui spécifie une liste des numéros de ports écoutés par un serveur. Pour obtenir une description complète de la propriété Port_list, reportez-vous à la section Resource Properties du Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

  4. Enregistrez le type de ressource du composant NA.


    # scrgadm -a -t SUNW.jsas-na
    
    -a

    Ajoute le type de ressource du composant NA

    -t SUNW.jsas-na

    Spécifie le nom prédéfini du type de ressource.

  5. Ajoutez l'instance de ressource NA au groupe de ressources de basculement créé pour vos ressources réseau.

    Pour obtenir une description détaillée des propriétés d'extension pour ce type de ressources, reportez-vous à la section Propriétés d'extension de SUNW.jsas-na .


    # scrgadm -a -j NA-resource -g NA-resource-group \
    -t SUNW.jsas-na \
    -y Resource_Dependencies=DAS-resource \
    -x Adminuser=DAS-admin-username \
    -x Confdir_list=install-directory \
    -x Adminhost=DAS-hostname \
    -x Adminport=DAS-port \
    -x Agentdir=NA-directory \
    -x Passwordfile=password-file
    
    -a

    Ajoute une ressource.

    -j NA-resource

    Indique le nom de la ressource NA.

    -g NA-resource-group

    Indique le groupe de ressources du composant NA.

    -t SUNW.jsas-na

    Indique le type de ressource du composant NA.

    -y Resource_Dependencies =DAS-resource

    Indique que la ressource DAS doit être en ligne pour que la ressource NA puisse démarrer.

    -x Adminuser= DAS-admin-username

    Indique le nom d'utilisateur administratif DAS.

    -x Confdir_list= install-directory

    Indique le chemin d'accès complet au répertoire d'installation de Sun Java System Application Server. La valeur par défaut pour cette propriété d'extension est /opt/SUNWappserver , qui est le répertoire d'installation standard.

    -x Adminhost= DAS-hostname

    Indique le nom d'hôte du composant DAS.

    -x Adminport= DAS-port

    Indique le port d'écoute du composant DAS.

    -x Agentdir= NA-directory

    Indique le chemin absolu du répertoire NA.

    -x Passwordfile= password-file

    Indique le chemin d'accès complet au fichier contenant le mot de passe administratif DAS et le mot de passe principal.

Exemples d'enregistrement et de configuration du composant DAS de basculement de Sun Cluster HA pour Sun Java System Application Server

Ces exemples supposent que le groupe de ressources DAS a déjà été créé, que l'adresse IP de basculement a déjà été ajoutée et que le groupe de ressources a déjà été mis en ligne.


Exemple 1–1 Création d'une ressource DAS simple

Dans cet exemple, les valeurs par défaut pour les propriétés d'extension sont utilisées.


# scrgadm -a -t SUNW.jsas

# scrgadm -a -j das-rs  -g das-rg  \
-t SUNW.jsas \
-y Network_resources_used=IP1 \
-x Adminuser=admin \
-x Domain_name=new-domain \
-x Passwordfile=/global/disk1/passwordfile

Dans cet exemple, les valeurs suivantes sont définies.



Exemple 1–2 Créer une ressource DAS en spécifiant le répertoire d'installation et le répertoire du domaine

Dans cet exemple, le serveur d'application n'est pas installé à l'emplacement par défaut et le répertoire du domaine n'a pas la valeur par défaut.


# scrgadm -a -t SUNW.jsas

# scrgadm -a -j das-rs  -g das-rg  \
-t SUNW.jsas \
-y Network_resources_used=IP1 \
-x Adminuser=admin \
-x Domain_name=new-domain \
-x Passwordfile=/global/disk1/passwordfile \
-x Confdir_list=/global/disk1/SUNWappserver \
-x Domaindir=/global/disk1/my-domain

Dans cet exemple, les valeurs suivantes sont définies.



Exemple 1–3 Création d'une ressource DAS et spécification d'une liste d'URI à surveiller

Dans cet exemple, la propriété d'extension Monitor_Uri_Lis indique l'URI supervisé par les applications sur le serveur d'application. La sonde du détecteur de pannes surveille cet URI pour tester la fonctionnalité du serveur d'application.


# scrgadm -a -t SUNW.jsas

# scrgadm -a -j das-rs  -g das-rg  \
-t SUNW.jsas \
-y Network_resources_used=IP1 \
-x Adminuser=admin \
-x Domain_name=new-domain \
-x Passwordfile=/global/disk1/passwordfile \
-x Confdir_list=/global/disk1/SUNWappserver \
-x Domaindir=/global/disk1/my-domain \
-x Monitor_Uri_List=http://IP1:4848/web-service

Dans cet exemple, les valeurs suivantes sont définies.


Exemple de création du composant d'agent NA de basculement de Sun Cluster HA pour Sun Java System Application Server

L'exemple de cette section utilise la configuration suivante, où les adresses IP de basculement sont représentées par des noms d'hôtes logiques.


Exemple 1–4 Création des ressources de l'agent NA de basculement

  1. Pour enregistrer le type de ressource du composant NA, exécutez la commande suivante.


    # scrgadm -a -t SUNW.jsas-na
    
  2. Pour créer le groupe de ressources de basculement na-rg1, qui doit contenir l'adresse IP de basculement IP1 et la ressource d'agent de nœud pour les agents NA1 et NA2, exécutez la commande suivante.


    # scrgadm -a -g na-rg1
    
  3. Pour créer le groupe de ressources de basculement na-rg2, qui doit contenir l'adresse IP de basculement IP2 et la ressource d'agent de nœud pour les agents NA3 et NA4, exécutez la commande suivante.


    # scrgadm -a -g na-rg2
    
  4. Pour ajouter la ressource d'adresse IP de basculement IP1 au groupe de ressources na-rg1, exécutez la commande suivante.


    # scrgadm -a -L -g na-rg1 -l IP1
    
  5. Pour ajouter la ressource d'adresse IP de basculement IP2 au groupe de ressources na-rg2, exécutez la commande suivante.


    # scrgadm -a -L -g na-rg2 -l IP2
    
  6. Pour créer la ressource d'agent NA na-rs1 dans le groupe de ressources na-rg1, exécutez la commande suivante.


    Remarque –

    Une seule ressource Agent du noeud est créée pour tous les agents de noeud configurés pour une adresse IP de basculement. Le service de données détecte automatiquement les agents du noeud configurés sur l'adresse IP de basculement créée dans le groupe de ressources de basculement.

    Dans cet exemple, les agents NA1 et NA2, ainsi que toutes leurs instances de serveur (I1, I2, I3 et I4), sont configurés sur IP1. Par conséquent, une seule ressource na-rs1 est créée pour NA1 et NA2.


    • Exécutez cette commande si vous utilisez les valeurs par défaut des propriétés d'extension.


      # scrgadm -a -j na-rs1  -g na-rg1  \
      -t SUNW.jsas-na \
      -y Resource_Dependencies=das-rs \
      -x Adminhost=host-1 \
      -x Adminuser=admin \
      -x Agentdir=/global/dg1/na-dir \
      -x Passwordfile=/global/dg1/p
      
    • Exécutez cette commande si l'installation ne se trouve pas à l'emplacement par défaut et que le port administratif n'est pas la valeur par défaut.


      # scrgadm -a -j na-rs1  -g na-rg1  \
      -t SUNW.jsas-na \
      -y Resource_Dependencies=das-rs \
      -x Adminhost=host-1 \
      -x Adminuser=admin \
      -x Agentdir=/global/dg1/na-dir \
      -x Passwordfile=/global/dg1/p \
      -x Confdir_list=/global/disk1/appserver-install-dir \
      -x Adminport=6162
      
  7. Pour créer la ressource d'agent NA na-rs2 dans le groupe de ressources na-rg2, exécutez la commande suivante.


    Remarque –

    Une seule ressource Agent du noeud est créée pour tous les agents de noeud configurés pour une adresse IP de basculement. Le service de données détecte automatiquement les agents du noeud configurés sur l'adresse IP de basculement créée dans le groupe de ressources de basculement.

    Dans cet exemple, les agents NA3 et NA4, ainsi que toutes leurs instances de serveur (I5, I6, I7 et I8), sont configurés sur IP2. Par conséquent, une seule ressource na-rs2 est créée pour NA3 et NA4.


    • Exécutez cette commande si vous utilisez les valeurs par défaut pour les porpriétés d'extension.


      # scrgadm -a -j na-rs2  -g na-rg2  \
      -t SUNW.jsas-na \
      -y Resource_Dependencies=das-rs \
      -x Adminhost=host-1 \
      -x Adminuser=admin \
      -x Agentdir=/global/dg1/na-dir \
      -x Passwordfile=/global/dg1/p
      
    • Exécutez cette commande si l'installation ne se trouve pas à l'emplacement par défaut et si le port administratif n'est pas la valeur par défaut.


      # scrgadm -a -j na-rs2  -g na-rg2  \
      -t SUNW.jsas-na \
      -y Resource_Dependencies=das-rs \
      -x Adminhost=host-1 \
      -x Adminuser=admin \
      -x Agentdir=/global/dg1/na-dir \
      -x Passwordfile=/global/dg1/p \
      -x Confdir_list=/global/disk1/appserver-install-dir \
      -x Adminport=6162
      
  8. Pour mettre en ligne le groupe de ressources de l'agent NA, na-rg1, exécutez la commande suivante.


    # scswitch -Z -g na-rg1
    

    En mettant le groupe de ressources na-rg1 en ligne, vous activez les ressources suivantes.

    • L'agent NA1 et les instances de serveur I1 et I2, qui sont configurées dans NA1.

    • L'agent NA2 et les instances de serveur I3 et I4, qui sont configurées dans NA2.

  9. Pour mettre en ligne le groupe de ressources de l'agent de nœud na-rg2, exécutez la commande suivante.


    # scswitch -Z -g na-rg2
    

    En mettant en ligne le groupe de ressources na-rg2, vous activez les ressources suivantes.

    • L'agent de nœud NA3 et les instances de serveur I5 et I6, qui sont configurées dans NA3.

    • L'agent de nœud NA4 et les instances de serveur I7 et I8, qui sont configurées dans NA4.