Commande cthagsctrl

Objectif

Contrôle le sous-système des services de groupe.

Syntaxe

cthagsctrl { -a [-p numéro-port ] -s | -k | -d | -r | -z | -h | -t | -o }

Descriptif

La commande de contrôle cthagsctrl contrôle le fonctionnement du sous-système de services de groupe (cthags) sous le contrôle du contrôleur de ressources système (SRC).

Une instance du sous-système de services de groupe s'exécute sur chaque noeud d'un cluster.

D'un point de vue opérationnel, le groupe de sous-systèmes "services de groupe" est organisé comme suit:

Sous-système

Services de groupe

Groupe de sous-système

cthags

Sous-systèmes SRC

cthags

Le sous-système cthags est associé au démon hagsd .

Le nom du sous-système sur les noeuds est cthags. Il existe un sous-système par noeud et chacun de ces sous-systèmes est associé à la grappe à laquelle appartient le noeud.

Daemon

hagsd

Fournit les fonctions de services de groupe.

En règle générale, la commande cthagsctrl n'est pas émise à partir de la ligne de commande. Il est normalement appelé par la commandecthactrl lors de la création du cluster.

La commande cthagsctrl fournit une variété de contrôles pour l'exploitation des sous-systèmes de services de groupe:

Ajout, démarrage, arrêt et suppression des sous-systèmes
Nettoyage des sous-systèmes (suppression des sous-systèmes du cluster)
Annulation de la configuration des sous-systèmes du cluster
Activation et désactivation de la fonction de trace

Adding the subsystem

Lorsque l'indicateur -a est spécifié, la commande de contrôle ajoute les sous-systèmes de services de groupe au code SRC. La commande de contrôle:

S'assure que le sous-système cthags est arrêté.
Obtient le numéro de port du sous-système cthags à partir des données du cluster.
Retire le sous-système cthags du code SRC (au cas où il serait encore présent).
Ajoute le sous-système cthags au code SRC.
N'ajoute pas actuellement d'entrée pour le groupe cthags dans le fichier /etc/inittab . Par conséquent, cthags doit être démarré par un autre sous-système lorsqu'il est nécessaire.

Starting the subsystem

Lorsque l'indicateur -s est spécifié, la commande de contrôle utilise la commande startsrc pour démarrer le sous-système de services de groupe, cthags.

Stopping the subsystem

Lorsque l'indicateur -k est spécifié, la commande de contrôle utilise la commande stopsrc pour arrêter le sous-système de services de groupe, cthags.

Deleting or cleaning the subsystem

Lorsque l'indicateur -d est spécifié, la commande de contrôle utilise la commande rmssys pour supprimer les sous-systèmes de services de groupe du code SRC. La commande de contrôle:

S'assure que le sous-système cthags est arrêté.
Retire le sous-système cthags du code SRC à l'aide de la commande rmssys .
Supprime le numéro de port du fichier /etc/services .

Turning tracing on

Lorsque l'indicateur -t est spécifié, la commande de contrôle active le traçage du démon hagsd à l'aide de la commande traceson .

Turning tracing off

Lorsque l'indicateur -o est spécifié, la commande de contrôle désactive la fonction de trace (elle revient à son niveau par défaut) pour le démon hagsd à l'aide de la commande tracesoff .

Refreshing the subsystem

L'indicateur -r actualise le sous-système cthags .

Logging

Lorsqu'ils sont en cours d'exécution, les démons des services de groupe fournissent des informations sur leurs opérations et leurs erreurs en écrivant des entrées dans trois fichiers journaux dans le répertoire /var/ct/nom_cluster/log/cthags . Les fichiers journaux sont les suivants:

/var/ct/nom_cluster/log/cthags_nodenum_instnum.nom_cluster
/var/ct/nom_cluster/log/cthags_nodenum_instnum.cluster_name.long
/var/ct/nom_cluster/log/cthags.default.nodenum_instnum

Les fichiers journaux contiennent le journal des démons hagsd sur les noeuds.

Les noms de fichier journal incluent les variables suivantes:

nodenum est le numéro de noeud sur lequel le démon s'exécute.
instnum est le numéro d'instance du démon.
nom_cluster est le nom du cluster dans lequel le démon s'exécute.

Chaque démon limite la taille du journal à un nombre de lignes préétabli. La valeur par défaut est 5000 lignes. Lorsque la limite est atteinte, le démon ajoute la chaîne .bak au nom du fichier journal en cours et commence un nouveau journal. Si une version de .bak existe déjà, elle est supprimée avant que le journal en cours ne soit renommé.

Indicateurs

--a [-p numéro de port]: Ajoute le sous-système.
-s: Démarre le sous-système.
-k: Arrête le sous-système.
-d: Supprime le sous-système.
-t: Active la fonction de trace pour le sous-système.
-o: Désactive la fonction de trace pour le sous-système.
-r: Actualise le sous-système.
-z: Désinstalle le sous-système cthags .
-h: Ecrit l'instruction de syntaxe de la commande dans la sortie standard.

Security

Vous devez disposer des droits root pour exécuter cette commande.

Statut de sortie

0: Indique que la commande a abouti.
valeur non nulle: Indique qu'une erreur s'est produite.

Restrictions

Cette commande est valide uniquement dans un domaine homologue.

Utilisez cette commande " seulement sous la direction du centre d'assistance " IBM

Sortie standard

Lorsque l'indicateur -h est spécifié, l'instruction de syntaxe de cette commande est écrite dans la sortie standard.

Erreur standard

Cette commande écrit des messages d'erreur, si nécessaire, dans l'erreur standard.

Exemples

Pour ajouter les sous-systèmes de services de groupe au code SRC dans la grappe en cours, entrez:
```
cthagsctrl -a
```
Pour ajouter les sous-systèmes de services de groupe avec le numéro de port 12347, entrez:
```
cthagsctrl -a -p 12347
```
Pour démarrer les sous-systèmes de services de groupe dans le cluster en cours, entrez:
```
cthagsctrl -s
```
Pour arrêter les sous-systèmes de services de groupe dans le cluster en cours, entrez:
```
cthagsctrl -k
```
Pour supprimer les sous-systèmes de services de groupe du code SRC dans la grappe en cours, entrez:
```
cthagsctrl -d
```
Pour activer la fonction de trace pour le démon des services de groupe dans le cluster en cours, entrez:
```
cthagsctrl -t
```
Pour désactiver la fonction de trace pour le démon des services de groupe dans le cluster en cours, entrez:
```
cthagsctrl -o
```

Emplacement

/opt/rsct/bin/cthagsctrl: Contient la commande cthagsctrl