Les instructions de configuration du document Sun Cluster Data Service for Apache Tomcat Guide for Solaris OS s'appliquent à la version de Sun Cluster 3.1 8/05 dans Sun Java Enterprise System 5 sauf ce qui est mentionné dans les rubriques suivantes.
La liste suivante décrit des fonctions ajoutées au service de données Sun Cluster HA pour Apache Tomcat :
Fichier de configuration : Sun Cluster HA pour Apache Tomcat fourni avec Sun Java Enterprise System 5 permet d'utiliser un fichier de configuration en option avec les commandes d'enregistrement. Vous pouvez utiliser le fichier par défaut, /opt/SUNWsctomcat/util/sctomcat_config, ou une copie du fichier dans lequel vous modifiez les valeurs de paramètres si nécessaire. La syntaxe de commande est la suivante :
# ksh /opt/SUNWsctomcat/util/sctomcat_command [-f filename] |
Une des commandes d'enregistrement de Sun Cluster HA pour Apache Tomcat suivantes :
sctomcat_register
sctomcat_smf_register
sctomcat_smf_remove
Spécifie le nom du fichier de configuration.
Nom du fichier de configuration. Le fichier par défaut est /opt/SUNWsctomcat/util/sctomcat_config.
Variable DEBUG : le service de données Sun Cluster HA pour Apache Tomcat fourni avec Sun Java Enterprise System 5 accepte une liste de ressources séparée par des virgules dans la variable DEBUG du fichier /opt/SUNWsctomcat/etc/config. Un suivi de shell korn des méthodes de début et de fin dans une configuration de zone de basculement est enregistré si l'une des conditions suivantes existe :
Le nom de ressource correspond à une ressource de la liste contenue dans la variable DEBUG.
La variable DEBUG est définie sur ALL.
Le suivi de shell korn des méthodes de début et de fin est enregistré dans le fichier /var/svc/log/application-sczone-agents:resource.log.
Cette procédure utilise le fichier de configuration pour enregistrer Sun Cluster HA pour Apache Tomcat dans une zone de basculement.
Avant d'enregistrer Sun Cluster HA pour Apache Tomcat dans une zone de basculement, effectuez les tâches suivantes. Suivez les procédures des rubriques Sun Cluster Data Service for Solaris Containers Guide et Sun Cluster Data Service for Apache Tomcat Guide for Solaris OS .
Installez les packages de service de données Sun Cluster HA pour conteneurs et Sun Cluster HA pour Apache Tomcat dans la zone globale de chaque nœud de cluster exécutant la zone de basculement.
Créez la zone de basculement.
Héritez au moins le répertoire qui contiendra le service de données Sun Cluster HA pour Apache Tomcat. Pour disposer de tous les répertoires du service de données au même emplacement, héritez le répertoire /opt.
Configurez le composant d'initialisation pour qu'il contrôle la zone de basculement.
Prenez le rôle de superutilisateur dans la zone globale.
Effectuez une copie du fichier /opt/SUNWsctomcat/util/sctomcat_config à utiliser comme fichier de configuration.
Vous pouvez placer ce fichier de configuration dans un quelconque répertoire accessible à la zone de basculement.
Ouvrez votre fichier de configuration pour édition et modifiez les variables des zones non globales.
Ces variables ne sont utilisées que lorsque le service de données est installé dans une zone non globale. Définissez les valeurs de ces variables comme suit :
Définissez le nom de la zone dans laquelle Sun Cluster HA pour Apache Tomcat doit être exécuté.
Définissez le nom de la ressource contrôlant la zone.
Définissez le nom de Sun Resource Manager Project dans la zone de basculement. Si la variable PROJECT n'existe pas dans le fichier de configuration, le service de données utilise le projet par défaut de l'utilisateur, :default, dans un contexte Solaris Service Management Facility (SMF). Ce nom de projet est placé dans les propriétés start/project et stop/project du service SMF.
Conservez ce fichier de configuration modifié pour une éventuelle utilisation ultérieure.
Connectez-vous en tant que superutilisateur à la console de la zone de basculement.
Installez le logiciel Apache Tomcat dans la zone.
Copiez et modifiez le fichier de paramètres /opt/SUNWsctomcat/pfile.
Suivez les instructions de la rubrique How to Register and Configure Sun Cluster HA for Apache Tomcat as a failover data service du Sun Cluster Data Service for Apache Tomcat Guide for Solaris OS.
Créez le script d'environnement.
Suivez les instructions de la rubrique How to Register and Configure Sun Cluster HA for Apache Tomcat as a failover data service du Sun Cluster Data Service for Apache Tomcat Guide for Solaris OS.
Déconnectez-vous de la console de la zone de basculement.
Enregistrez Sun Cluster HA pour Apache Tomcat avec SMF.
# ksh /opt/SUNWsctomcat/util/sctomcat_register -f filename |
Spécifie le nom du fichier de configuration.
Nom du fichier de configuration.
L'enregistrement de Sun Cluster HA pour Apache Tomcat génère un manifeste SMF et enregistre un service SMF dans la zone de basculement spécifiée dans la variable ZONE du fichier de configuration. Le manifeste est nommé resourcename.xml, où resource est le nom spécifié dans la variable RS du fichier de configuration. Ce manifeste est placé dans le répertoire /var/svc/manifest/application/sczone-agents/. Le service SMF est nommé svc:/application/sczone-agents/ resource.
Le service de données Sun Cluster HA pour Apache Tomcat utilise le composant SMF du service de données Sun Cluster HA pour conteneurs pour contrôler et évaluer ce service SMF de Sun Cluster HA pour Apache Tomcat. Il enregistre un composant Sun Cluster HA pour conteneurs SMF au-dessus du service SMF déjà créé. Le nom du script de début et de fin du manifeste ainsi que des sondes du composant SMF est control_sctomcat.
Effectuez cette tâche pour modifier des paramètres du manifeste Sun Cluster HA pour Apache Tomcat et pour valider les paramètres de la zone de basculement. Les paramètres du manifeste Sun Cluster HA pour Apache Tomcat sont stockés sous forme de propriétés du service SMF. Pour modifier des paramètres du manifeste, modifiez les propriétés correspondantes du service SMF, puis validez les changements.
Connectez-vous en tant que superutilisateur à la console de la zone de basculement.
Modifiez les propriétés Solaris Service Management Facility (SMF) du manifeste Sun Cluster HA pour Apache Tomcat.
# svccfg svc:/application/sczone-agents:resource |
Pour plus d'informations, reportez-vous à la page de manuel svccfg(1M).
Validez les changements de paramètres.
# /opt/SUNWsctomcat/bin/control_sctomcat validate resource |
Les messages relatifs à cette commande sont stockés dans le répertoire /var/adm/messages/ de la zone de basculement.
Déconnectez-vous de la console de la zone de basculement.
Prenez le rôle de superutilisateur dans la zone globale.
Désactivez et supprimez la ressource utilisée par le service de données Sun Cluster HA pour Apache Tomcat.
# scswitch -n resource # scrgadm -r -j resource |
Connectez-vous en tant que superutilisateur à la console de la zone de basculement.
Annulez l'enregistrement de Sun Cluster HA pour Apache Tomcat du service Solaris Service Management Facility (SMF).
# /opt/SUNWsctomcat/sctomcat_smf_remove -f filename |
Spécifie le nom du fichier de configuration.
Nom du fichier de configuration utilisé pour enregistrer Sun Cluster HA pour Apache Tomcat avec le service SMF.
Si vous ne disposez plus du fichier de configuration utilisé pour enregistrer Sun Cluster HA pour Apache Tomcat avec le service SMF, créez un fichier de configuration de remplacement :
Effectuez une copie du fichier par défaut, /opt/SUNWsctomcat/util/sctomcat_config.
Définissez les paramètres ZONE et RS sur les valeurs utilisées par le service de données.
Exécutez la commande sctomcat_smf_remove et utilisez l'option -f pour spécifier ce fichier de configuration.
Déconnectez-vous de la console de la zone de basculement.