Commande refsensor

Editer en ligne

Objectif

Actualise un détecteur ou un microsensor défini sur le sous-système RMC (Resource Monitoring and Control).

Syntaxe

Pour actualiser un détecteur:

refsensor [–a | –n hôte1[,hôte2... ] | –N { fichier_noeud | "–" } ] [–h ] [ –v | –V ] nom_détection

Pour actualiser un microsensor:

refsensor –m [–a | –n hôte1[,hôte2... ] | –N { fichier_noeud | "–" } ] [–h ] [ –v | –V ] nom_détection

Descriptif

La commande refsensor actualise un détecteur ou une ressource de microsensor qui est définie sur le sous-système RMC. Sensors et microsensors sont des ressources RMC dont les attributs peuvent être surveillés. Les détecteurs et les micro-détecteurs doivent être surveillés pour que refsensor s'exécute correctement.

Un détecteur peut être actualisé à l'aide de refsensor de l'une des deux manières suivantes: en exécutant la commande de détecteur définie pour la ressource de détecteur ou en spécifiant des valeurs pour des attributs de détecteur spécifiques. Un microsensor peut être actualisé à l'aide de refsensor pour interroger les valeurs du module de chargement du microsensor. Utilisez l'indicateur -m pour actualiser un microsensor.

Lorsque la commande refsensor s'exécute, elle n'affecte pas l'intervalle, le cas échéant, qui est défini (à l'aide de mksensor) pour l'exécution de la commande de détecteur ou pour l'interrogation du module de chargement microsensor. Autrement dit, si un détecteur ou un micro-détecteur surveillé est mis à jour toutes les 60 secondes, l'exécution de refsensor n'entraîne pas la réinitialisation du temporisateur d'intervalle à 60 secondes.

La commande refsensor s'exécute sur n'importe quel noeud. Si vous souhaitez que refsensor s'exécute sur tous les noeuds d'un domaine, utilisez l'indicateur -a . Si vous souhaitez que refsensor s'exécute sur un sous-ensemble de noeuds d'un domaine, utilisez l'indicateur -n . Au lieu de spécifier plusieurs noms de noeud à l'aide de l'indicateur -n , vous pouvez utiliser l'indicateur -N node_file pour indiquer que les noms de noeud se trouvent dans un fichier. Utilisez -N "–" pour lire les noms de noeud à partir d'une entrée standard.

Si Cluster Systems Management (CSM) est installé sur votre système, vous pouvez utiliser des groupes de noeuds définis par CSM comme valeurs de nom de noeud pour faire référence à plusieurs noeuds. Pour plus d'informations sur l'utilisation des groupes de noeuds CSM et de la commande CSM nodegrp , voir CSM: Guide d'administration et CSM: Command and Technical Reference.

Pour que refsensor mette à jour des attributs de détecteur spécifiques, spécifiez un ou plusieurs paramètres attr=value . Seuls les attributs spécifiés seront mis à jour. Aucun autre attribut de détecteur ne sera mis à jour. Les attributs de détecteur pouvant être spécifiés en tant que paramètres sont les suivants:

Float32: Type d'attribut float32 pour cette ressource de détecteur
Float64: Type d'attribut float64 pour cette ressource de détecteur
Int32: Type d'attribut int32 pour cette ressource de détecteur
Int64: Type d'attribut int64 pour cette ressource de détecteur
Quantique: Type d'attribut quantum pour cette ressource de détecteur
Chaîne: Type d'attribut string pour cette ressource de détecteur
Uint32: Type d'attribut uint32 pour cette ressource de détecteur
Uint64: Type d'attribut uint64 pour cette ressource de détecteur

Par exemple, pour mettre à jour les attributs de détecteur Int32 et Float32 pour le détecteur nommé Sensor1, entrez:

refsensor Sensor1 Int32=45 Float32=7.8

Les attributs de microsensor ne peuvent pas être mis à jour séparément.

Indicateurs

–a

Actualise les détecteurs qui correspondent au nom spécifié sur tous les noeuds du domaine. La variable d'environnement CT_MANAGEMENT_SCOPE détermine la portée du cluster. Si CT_MANAGEMENT_SCOPE n'est pas défini, la portée du domaine de gestion est d'abord choisie si elle existe, puis la portée du domaine homologue est choisie si elle existe, puis la portée locale est choisie, jusqu'à ce que la portée soit valide pour la commande. La commande s'exécute une seule fois pour la première portée valide trouvée. Par exemple, si un domaine de gestion et un domaine homologue existent, refsensor -a avec CT_MANAGEMENT_SCOPE non défini s'exécute dans le domaine de gestion. Dans ce cas, pour une exécution dans le domaine homologue, définissez CT_MANAGEMENT_SCOPE sur 2.

–m

Indique que la ressource à actualiser est une ressource microsensor.

-n hôte1[,hôte2... ]

Indique un ou plusieurs noeuds sur lesquels le détecteur doit être actualisé. Par défaut, le détecteur est actualisé sur le noeud local. Cet indicateur n'est approprié que dans un domaine de gestion ou un domaine homologue.

-N { fichier_noeud | "-" }

Indique que les noms de noeud sont lus à partir d'un fichier ou d'une entrée standard.

Utilisez -N fichier_noeud pour indiquer que les noms de noeud se trouvent dans un fichier.

Il existe un nom de noeud par ligne dans fichier_noeud
Un signe dièse (#) dans la colonne 1 indique que la ligne est un commentaire
Tout caractère blanc avant un nom de noeud est ignoré
Tous les caractères après un nom de noeud sont ignorés

Utilisez -N "–" dans un domaine de gestion ou un domaine homologue pour lire les noms de noeud à partir d'une entrée standard.

–h

Ecrit l'instruction de syntaxe de la commande dans la sortie standard.

-v | -V

Ecrit les messages prolixes de la commande dans la sortie standard.

Paramètres

nom_sensation: Indique le nom du détecteur à actualiser.
attr=valeur: Indique les attributs de détecteur qui seront actualisés et les valeurs auxquelles ils seront définis.

Security

Pour actualiser les détecteurs à l'aide de cette commande, vous devez disposer d'un droit d'accès en écriture pour la classe de ressources IBM.Sensor .

Pour actualiser les micro-capteurs à l'aide de cette commande, vous devez disposer d'un droit d'accès en écriture pour la classe de ressources IBM.MicroSensor .

Les droits sont spécifiés dans le fichier de liste de contrôle d'accès (ACL) sur le système contacté. Voir RSCT: Guide d'administration pour plus de détails sur le fichier ACL et pour savoir comment le modifier.

Statut de sortie

0: L'exécution de la commande a abouti.
1: Une combinaison incorrecte d'indicateurs et de paramètres a été entrée.
4: Le détecteur n'est pas surveillé et ne peut pas être actualisé.
6: Aucune ressource de détecteur n'a été trouvée.
n: En fonction d'autres erreurs pouvant être renvoyées par le sous-système RMC.

Variables d'environnement

CT_CONTACT

Lorsque la variable d'environnement CT_CONTACT est définie sur un nom d'hôte ou une adresse IP, la commande contacte le démon RMC (Resource Monitoring and Control) sur l'hôte spécifié. Si cette variable d'environnement n'est pas définie, la commande contacte le démon RMC sur le système local sur lequel la commande est exécutée. La ou les ressources affichées ou modifiées par la commande se trouvent sur le système sur lequel la connexion est établie.

CT_IP_AUTHENT

Lorsque la variable d'environnement CT_IP_AUTHENT existe, le démon RMC utilise l'authentification réseau IP pour contacter le démon RMC sur le système spécifié par l'adresse IP à laquelle la variable d'environnement CT_CONTACT est définie. CT_IP_AUTHENT n'a de signification que si CT_CONTACT est défini sur une adresse IP ; il ne repose pas sur le service DNS (Domain Name System).

CT_PORT_GESTION

Détermine la portée de gestion utilisée pour la session avec le démon RMC pour surveiller et contrôler les ressources et les classes de ressources. La portée de gestion détermine l'ensemble des noeuds cible possibles où les ressources et les classes de ressources peuvent être surveillées et contrôlées.

Les valeurs admises sont les suivantes :

0: Indique la portée locale .
1: Indique la portée locale .
2: Indique la portée du domaine homologue .
3: Indique la portée du domaine de gestion .

Si cette variable d'environnement n'est pas définie, la portée locale est utilisée.

Caractéristiques de mise en oeuvre

Cette commande fait partie de l'ensemble de fichiers rsct.core pour AIX® et rsct.core-3.1.0.0-0.plateforme.rpm pour Linux®, Solaris et Windows, où plateforme est i386, ppc, ppc64, s390ou x86_64.

Exemples

Pour actualiser le détecteur appelé Sensor1 afin que sa commande de détecteur définie soit exécutée, entrez:
```
refsensor Sensor1
```
Pour actualiser le détecteur appelé Sensor1 de sorte que Int32 soit défini sur 50, Float32 soit défini sur 123.45et String soit défini sur "test input", entrez:
```
refsensor Sensor1 Int32=50 Float32=123.45 String="test input"
```
Pour actualiser le détecteur appelé Sensor1 sur les noeuds répertoriés dans le fichier /u/joe/common_nodes afin que la commande de détecteur définie par Sensor1soit exécutée, entrez:
```
refsensor -N /u/joe/common_nodes Sensor1
```
où /u/joe/common_nodes contient:
```
# common node file
#
node1.myhost.com    main node
node2.myhost.com    backup node
```
Pour actualiser le microsensor appelé IBM.Sensor1 afin que les valeurs d'attribut soient interrogées à l'aide du module de chargement de microsensor défini, entrez:
```
refsensor -m IBM.Sensor1
```

Emplacement

/opt/rsct/bin/refsensor