Procédure d'enregistrement et de configuration de Sun Cluster HA pour Sun Java System Web Server (Guide des services de données Sun Cluster pour Sun Java System Web Server pour SE Solaris)

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

Procédure d'enregistrement et de configuration de Sun Cluster HA pour Sun Java System Web Server

Cette rubrique décrit la procédure d'enregistrement et de configuration de Sun Cluster HA pour Sun Java System Web Server.

Cette procédure décrit l'utilisation de la commande scrgadm (1M) pour enregistrer et configurer Sun Cluster HA pour Sun Java System Web Server.

Remarque –

il existe aussi d'autres options permettant d'enregistrer et de configurer le service de données. Pour obtenir des détails sur ces options, reportez-vous à la rubrique Tools for Data Service Resource Administration du Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

Pour effectuer cette procédure, vous avez besoin des informations suivantes :

Nom du type de ressource de Sun Cluster HA pour Sun Java System Web Server, Il s'agit de SUNW.iws.
Noms des nœuds du cluster contrôlant le service de données. Dans le cas d'un service de basculement, un seul nœud à la fois peut gérer un service de données.
Nom d'hôte logique (pour les services de basculement) ou adresse partagée (pour les services évolutifs) utilisée par les clients pour accéder au service de données
Chemin d'accès aux binaires de Sun Java System. Vous pouvez installer les binaires sur les disques locaux ou sur le système de fichiers du cluster. Pour connaître les avantages et les inconvénients de chaque emplacement, reportez-vous à la rubrique Configuration Guidelines for Sun Cluster Data Services du Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

Remarque –
le paramètre Ressources_réseau_utilisées de la ressource d'application Sun Java System détermine le jeu d'adresses IP utilisées par Sun Java System Web Server. Le paramètre Port_list de la ressource détermine la liste des numéros de port utilisés par Sun Java System Web Server. Le détecteur de pannes considère que le démon Sun Java System Web Server écoute sur toutes les combinaisons IP/port. Si vous avez personnalisé l'écoute du fichier magnus.conf de Sun Java System Web Server sur des numéros de port (autres que 80), le fichier magnus.conf en résultant doit contenir toutes les combinaisons adresse IP/port possibles. Le détecteur de pannes tente de sonder toutes les combinaisons de ce type et enregistre des erreurs si Sun Java System Web Server n'écoute pas sur l'une d'entre elles. Si Sun Java System Web Server ne sert pas toutes les combinaisons adresse IP/port, vous devez scinder Sun Java System Web Server en différentes instances les servant.

Remarque –

effectuez cette procédure sur n'importe quel membre du cluster.

Étapes

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

Enregistrez le type de ressource de Sun Cluster HA pour Sun Java System Web Server.
# scrgadm -a -t SUNW.iws
-a

Ajoute le type de ressource du service de données.

-t SUNW.iws

Indique le nom du type de ressource prédéfini pour le service de données.

Créez un groupe de ressources de basculement destiné à contenir les ressources réseau et d'application.

Pour les services de basculement, ce groupe de ressources contient également les ressources d'application.

Vous pouvez sélectionner le jeu de noeuds sur lequel exécuter le service de données à l'aide de l'option -h.
# scrgadm -a -g resource-group [-h nodelist]
-g groupe-ressources

Indique le nom du groupe de ressources de basculement. Vous pouvez choisir librement ce nom, mais il doit être différent pour chacun des groupes de ressources du cluster.

-h liste_nœuds

Une liste facultative, séparée par des virgules, de noms ou ID de noeuds physiques identifiant les maîtres potentiels. L'ordre de cette liste détermine l'ordre dans lequel les noeuds seront utilisés comme noeud principal durant un basculement.

Remarque –
utilisez -h pour déterminer l'ordre de la liste de noeuds. Si tous les noeuds du cluster sont des maîtres potentiels, vous n'avez pas besoin d'utiliser l'option h.

Vérifiez que toutes les adresses réseau que vous utilisez ont été ajoutées à la base de données du service d'attribution de noms.

Vous avez dû effectuer cette vérification au cours de l'installation de Sun Cluster. Reportez-vous au chapitre de planification du Sun Cluster Software Installation Guide for Solaris OS pour obtenir plus de détails.

Remarque –
pour éviter des erreurs de recherche, assurez-vous que les noms d'hôte logiques et les adresses partagées existent dans le fichier /etc/inet/hosts du serveur et du client. Avant de tenter d'accéder au NIS ou NIS+, définissez le mappage du service de noms de /etc/nsswitch.conf sur les serveurs pour vérifier les fichiers locaux.

Ajoutez une ressource réseau (nom d'hôte logique ou adresse partagée) au groupe de ressources de basculement.
# scrgadm -a {-S | -L} -g resource-group \ -l network-resource,… [-j resource] \ [-X auxnodelist=node, …] [-n netiflist]
-S | -L

Utilisez -S pour les ressources d'adresse partagée ou -L pour les ressources de nom d'hôte logique.

-g groupe-ressources

Indique le nom du groupe de ressources de basculement.

-l network-resource, …

Indique une liste de ressources réseau, séparées par des virgules, à ajouter. Vous pouvez utiliser l'option -j pour spécifier un nom pour les ressources. Dans le cas contraire, les ressources réseau prennent le nom de la première entrée de la liste.

-j ressource

Spécifie un nom de ressource facultatif. Si vous ne le fournissez pas, le nom par défaut est le premier indiqué après l'option -l.

-X liste_nœuds_aux =nœud, …

Indique une liste facultative d'ID de nœuds physiques, séparés par des virgules, identifiant les nœuds du cluster susceptibles d'héberger l'adresse partagée mais ne servant jamais de nœuds principaux en cas de basculement. Ceux-ci ne peuvent pas être définis en même temps que les éventuels noeuds de nodelist du groupe de ressouces.

-g groupe-ressources

Indique le nom du groupe de ressources. Vous pouvez choisir librement ce nom, mais il doit être différent pour chacun des groupes de ressources du cluster.

-h liste_nœuds

Indique une liste facultative, séparée par des virgules, de noms ou ID de noeuds physiques identifiant les maîtres potentiels. L'ordre de cette liste détermine l'ordre dans lequel les noeuds seront utilisés comme noeud principal durant un basculement.

-n liste_netif

Indique une liste optionnelle, séparée par des virgules, identifiant les groupes IPMP présents sur chaque noeud. Chaque élément de netiflist doit suivre le modèle netif@node. netif peut être fourni comme un nom de groupe IPMP, par exemple sc_ipmp0. Un nom ou ID permet d'identifier le noeud (par exemple, sc_ipmp0@1 ou sc_ipmp@phys-schost-1).

Remarque –
actuellement, Sun Cluster ne prend pas en charge l'utilisation du nom d'adaptateur de netif.

Pour les services évolutifs uniquement : créez un groupe de ressources évolutif destiné à tourner sur tous les noeuds du cluster souhaités.

Si vous utilisez Sun Cluster HA pour Sun Java System Web Server comme service de données de basculement, passez directement à l'Étape 8.

Créez un groupe de ressources destiné à contenir une ressource d'application du service de données. Vous devez spécifier non seulement les nombres maximal et souhaité de noeuds principaux, mais aussi une dépendance entre le groupe de ressources et celui de basculement créé à l'Étape 3. Cette dépendance assure qu'en cas de basculement, le gestionnaire de ressources démarre la ressource réseau avant tout service de données dépendant de celle-ci.
# scrgadm -a -g resource-group \ -y Maximum_primaries=m -y Desired_primaries=n \ -y RG_dependencies=resource-group
-y Éléments_principaux _max.=m

Indique le nombre maximum de noeuds principaux actifs autorisés pour ce groupe de ressources. Par défaut, la valeur de cette propriété est 1.

-y Desired_primaries=n

Indique le nombre souhaité de noeuds principaux actifs autorisés pour ce groupe de ressources. Par défaut, la valeur de cette propriété est 1.

-y dépendances_groupes_ressources= groupe_ressources

Identifie le groupe de ressources contenant la ressource d'adresse partagée dont dépend le groupe de ressources créé.

Pour les services évolutifs uniquement : créez une ressource d'application dans le groupe de ressources évolutives.

Si vous utilisez Sun Cluster HA pour Sun Java System Web Server comme service de données de basculement, passez directement à l'Étape 8.

Vous pouvez répéter cette étape pour ajouter plusieurs ressources d'application (par exemple, des versions sécurisées et non sécurisées) à un même groupe de ressources.

Il est également possible que vous souhaitiez définir l'équilibrage de la charge pour le service de données. Pour ce faire, utilisez les deux propriétés de ressources standard (Load_balancing_policy et Load_balancing_weights). Pour en obtenir une description, reportez-vous à l'Annexe A, Standard Properties du Sun Cluster Data Services Planning and Administration Guide for Solaris OS. Vous pouvez également consulter les exemples à la fin de cette rubrique.

# scrgadm -a -j resource -g resource-group \
-t resource-type -y Network_resources_used=network-resource, … \
-y Port_list=port-number/protocol, … -y Scalable=True \
-x Confdir_list=config-directory, …

-j ressource: Spécifie le nom de la ressource à ajouter.
-g groupe-ressources: Indique le nom du groupe de ressources évolutives dans lequel les ressources doivent être placées.
-t type_ressource: Indique le type de ressource à ajouter.
-y Network_resources_used = ressource-réseau, …: Indique une liste de ressources réseau, séparées par des virgules, identifiant les adresses partagées utilisées par le service de données.
-y Port_list= port-number/protocol, …: Indique une liste de numéros de ports et protocoles, séparés par des virgules, à utiliser, par exemple, 80/tcp,81/tcp.
-y Scalable= True: Indique une valeur booléenne requise pour les services évolutifs.
-x Confdir_list= config-directory, …: Indique une liste des emplacements des fichiers de configuration Sun Java System, séparés par des virgules. Cette propriété d'extension est requise pour Sun Cluster HA pour Sun Java System Web Server.

Remarque –

un mappage un à un s'applique à Confdir_List et à Port_List. En d'autres termes, chaque valeur d'une liste correspond à une valeur de l'autre liste dans l'odre spécifié.

Pour les services de basculement uniquement : créez une ressource d'application dans le groupe de ressources de basculement.

N'exécutez cette opération que si vous exécutez Sun Cluster HA pour Sun Java System Web Server en tant que service de données de basculement. Si vous utilisez Sun Cluster HA pour Sun Java System Web Server comme service évolutif, vous devez suivre l'Étape 6 et l'Étape 7, puis passer à l'Étape 10.

Vous pouvez répéter cette étape pour ajouter plusieurs ressources d'application (par exemple, des versions sécurisées et non sécurisées) à un même groupe de ressources.
# scrgadm -a -j resource -g resource-group \ -t resource-type -y Network_resources_used=logical-hostname-list \ -y Port_list=port-number/protocol \ -x Confdir_list=config-directory
-j ressource

Spécifie le nom de la ressource à ajouter.

-g groupe-ressources

Indique le nom du groupe de ressources de basculement dans lequel les ressources doivent être placées.

-t type_ressource

Indique le type de ressource à ajouter.

-y Network_resources_used =ressource-réseau, …

Indique une liste de ressources réseau, séparées par des virgules, identifiant les hôtes logiques utilisés par le service de données.

-y Port_list= port-number/protocol

Indique le numéro de port ainsi que le protocole à utiliser, par exemple 80/tcp. Pour les services de basculement, Port_list doit suivre la règle de mappage un à un avec Confdir_list.

-x Confdir_list= config-directory

Indique l'emplacement des fichiers de configuration Sun Java System. Le fichier Liste_rép_conf pour les services de basculement doit comporter exactement une entrée. La définition config-directory doit contenir le répertoire config. Cette propriété d'extension est requise pour Sun Cluster HA pour Sun Java System Web Server.

Remarque –
vous pouvez également définir d'autres propriétés d'extension appartenant à Sun Cluster HA pour Sun Java System Web Server afin d'ignorer les valeurs par défaut. Pour en obtenir la liste, reportez-vous à l'Annexe A, Propriétés d'extension de Sun Cluster HA pour Sun Java System Web Server .

Mettez en ligne le groupe de ressources de basculement.
# scswitch -Z -g resource-group
-Z

Permet non seulement d'activer la ressource réseau et le détecteur de pannes, mais aussi de mettre le groupe de ressources en état MANAGED et en ligne.

-g groupe-ressources

Indique le nom du groupe de ressources de basculement.

Pour les services évolutifs uniquement : mettez en ligne le groupe de ressources évolutives.
# scswitch -Z -g resource-group
-Z

Permet non seulement d'activer la ressource et le détecteur, mais aussi de mettre le groupe de ressources en état MANAGED et en ligne.

-g groupe-ressources

Indique le nom du groupe de ressources évolutives.

Exemple 3 Enregistrement d'un Sun Cluster HA pour Sun Java System Web Server évolutif

Cluster Information
Node names: phys-schost-1, phys-schost-2
Shared address: schost-1
Resource groups: sa-resource-group-1 (for shared addresses),
iws-resource-group-1 (for scalable application resources)
Resources: schost-1 (shared address), Sun-app-insecure-1 (insecure 
application resource), Sun-app-secure-1 (secure application resource)
 
(Add a failover resource group to contain shared addresses.)
# scrgadm -a -g sa-resource-group-1
 
(Add the shared address resource to the failover resource group.)
# scrgadm -a -S -g sa-resource-group-1 -l schost-1
 
(Add a scalable resource group.)
# scrgadm -a -g iws-resource-group-1 -y Maximum_primaries=2 \
-y Desired_primaries=2 -y RG_dependencies=sa-resource-group-1
 
(Register the resource type for the Sun Cluster HA pour Sun Java System Web Server.)
# scrgadm -a -t SUNW.iws
 
(Add an insecure application instance with default load balancing.)
# scrgadm -a -j Sun-app-insecure-1 -g iws-resource-group-1 -t SUNW.iws \
-x Confdir_List=/opt/SunONE/https-Sun-app-insecure-1 \
-y Scalable=True -y Network_resources_used=schost-1 -y Port_list=80/tcp 

(Add a secure application instance with sticky IP load balancing.)
# scrgadm -a -j Sun-app-secure-1 -g iws-resource-group-1 -t SUNW.iws \
-x Confdir_List=/opt/SunONE/https-Sun-app-secure-1 \
-y Scalable=True -y Network_resources_used=schost-1 \
-y Port_list=443/tcp -y Load_balancing_policy=LB_STICKY \
-y Load_balancing_weights=40@1,60@2
 

(Bring the failover resource group online.)
# scswitch -Z -g sa-resource-group-1
 
(Bring the scalable resource group online.)
# scswitch -Z -g iws-resource-group-1

Exemple 4 Enregistrement d'un Sun Cluster HA pour Sun Java System Web Server de basculement sur un cluster de deux noeuds

Cluster Information
Node names: phys-schost-1, phys-schost-2
Logical hostname: schost-1
Resource group: resource-group-1 (for all resources) 
Resources: schost-1 (logical hostname), Sun-app-insecure-1 (insecure application 
application resource), Sun-app-secure-1 (secure application resource)
 
(Add the resource group to contain all resources.)
# scrgadm -a -g resource-group-1
 
(Add the logical hostname resource to the resource group.)
# scrgadm -a -L -g resource-group-1 -l schost-1 
 
(Register the resource type for the Sun Cluster HA pour Sun Java System Web Server.)
# scrgadm -a -t SUNW.iws
 
(Add an insecure application resource instance.)
# scrgadm -a -j Sun-app-insecure-1 -g resource-group-1 -t SUNW.iws \
-x Confdir_list=/opt/SunONE/conf -y Scalable=False \
-y Network_resources_used=schost-1 -y Port_list=80/tcp\ 

(Add a secure application resource instance.)
# scrgadm -a -j Sun-app-secure-1 -g resource-group-1 -t SUNW.iws \ 
-x Confdir_List=/opt/SunONE/https-Sun-app-secure-1 -y Scalable=False \
-y Network_resources_used=schost-1 -y Port_list=443/tcp \ 

(Bring the failover resource group online.)
# scswitch -Z -g resource-group-1