Befehl "refsensor"

Zweck

Aktualisiert einen Sensor oder einen Mikrosensor, der für das RMC-Subsystem (Resource Monitoring and Control) definiert ist.

Syntax

Sendor aktualisieren:

refsensor [–a | –n host1[,host2...] | –N { Knotendatei | "–" } ] [–h ] [ –v | –V ] Sensorname

Mikrosensor aktualisieren:

refsensor –m [–a | –n host1[,host2...] | –N { Knotendatei | "–" } ] [–h ] [ –v | –V ] Sensorname

Beschreibung

Der Befehl refsensor aktualisiert eine Sensor-oder Mikrosensorressource, die für das RMC-Subsystem definiert ist. Sensoren und Mikrosensoren sind RMC-Ressourcen mit Attributen, die überwacht werden können. Sensoren und Mikrosensoren müssen überwacht werden, damit refsensor erfolgreich ausgeführt werden kann.

Ein Sensor kann mithilfe von refsensor auf zwei Arten aktualisiert werden: entweder durch Ausführen des Sensorbefehls, der für die Sensorressource definiert ist, oder durch Angeben von Werten für bestimmte Sensorattribute. Ein Mikrosensor kann mit refsensor aktualisiert werden, um die Werte des Lademoduls des Mikrosensors abzufragen. Verwenden Sie das Flag -m , um einen Mikrosensor zu aktualisieren.

Wenn der Befehl refsensor ausgeführt wird, wirkt sich dies nicht auf das Intervall (sofern vorhanden) aus, das (mithilfe von mksensor) für die Ausführung des Sensorbefehls oder für die Abfrage des Mikrosensorlademoduls definiert ist. Wenn also ein überwachter Sensor oder Mikrosensor alle 60 Sekunden aktualisiert wird, führt die Ausführung von refsensor nicht dazu, dass der Intervallzeitgeber auf 60 Sekunden zurückgesetzt wird.

Der Befehl refsensor wird auf einem beliebigen Knoten ausgeführt. Wenn Sie möchten, dass refsensor auf allen Knoten in einer Domäne ausgeführt wird, verwenden Sie das Flag -a . Wenn refsensor auf einer Untergruppe von Knoten in einer Domäne ausgeführt werden soll, verwenden Sie das Flag -n . Anstatt mehrere Knotennamen mit dem Flag -n anzugeben, können Sie mit dem Flag -N Knotendatei angeben, dass sich die Knotennamen in einer Datei befinden. Verwenden Sie -N "–" , um die Knotennamen aus der Standardeingabe zu lesen.

Wenn Cluster Systems Management (CSM) auf Ihrem System installiert ist, können Sie CSM-definierte Knotengruppen als Knotennamenswerte verwenden, um auf mehrere Knoten zu verweisen. Informationen zum Arbeiten mit CSM-Knotengruppen und zur Verwendung des CSM-Befehls nodegrp finden Sie im Handbuch CSM: Administration Guide und im Handbuch CSM: Command and Technical Reference.

refsensor Sensor1 Int32=45 Float32=7.8

Mikrosensorattribute können nicht separat aktualisiert werden.

Flags

–a

Aktualisiert Sensoren, die dem angegebenen Namen auf allen Knoten in der Domäne entsprechen. Die Umgebungsvariable CT_MANAGEMENT_SCOPE bestimmt den Umfang des Clusters. Wenn die Umgebungsvariable "CT_MANAGEMENT_SCOPE" nicht gesetzt ist, wird der gültige Bereich für den Befehl in der folgenden Reihenfolge gesucht: Managementdomäne, Peerdomäne, lokaler Bereich. Der Befehl wird ein einziges Mal für den ersten gefundenen gültigen Bereich ausgeführt. Wenn beispielsweise sowohl eine Managementdomäne als auch eine Peerdomäne vorhanden sind, wird refsensor -a ohne Angabe von CT_MANAGEMENT_SCOPE in der Managementdomäne ausgeführt. In diesem Fall müssen Sie "CT_MANAGEMENT_SCOPE" auf 2 setzen, um den Befehl in der Peerdomäne auszuführen.

–m

Gibt an, dass die zu aktualisierende Ressource eine Mikrosensorressource ist.

-n Host1[,Host2...]

Gibt einen oder mehrere Knoten an, auf denen der Sensor aktualisiert werden soll. Standardmäßig wird der Sensor auf dem lokalen Knoten aktualisiert. Dieses Flag ist nur in einer Managementdomäne oder einer Peerdomäne geeignet.

-N { Knotendatei | "-" }

Gibt an, dass die Knotennamen aus einer Datei oder aus der Standardeingabe gelesen werden.

Verwenden Sie -N Knotendatei , um anzugeben, dass sich die Knotennamen in einer Datei befinden.

• In der Knotendatei wird ein Knotenname pro Zeile aufgelistet.
• Ein Nummernzeichen (#) in Spalte 1 gibt an, dass die Zeile ein Kommentar ist.
• Alle Leerzeichen vor einem Knotennamen werden ignoriert
• Alle Zeichen nach einem Knotennamen werden ignoriert.

Verwenden Sie -N "–" in einer Managementdomäne oder Peerdomäne, um die Knotennamen aus der Standardeingabe zu lesen.

–h

Schreibt den Verwendungshinweis für den Befehl in die Standardausgabe.

–v | –V

Schreibt die ausführlichen Nachrichten des Befehls in die Standardausgabe.

Parameter

Sensorname

Gibt den Namen des Sensors an, der aktualisiert werden soll.

attr=wert

Gibt an, welche Sensorattribute aktualisiert und auf welche Werte sie gesetzt werden.

Sicherheit

Um Sensoren mit diesem Befehl zu aktualisieren, benötigen Sie Schreibberechtigung für die Ressourcenklasse IBM.Sensor .

Um Mikrosensoren mit diesem Befehl zu aktualisieren, benötigen Sie Schreibberechtigung für die Ressourcenklasse IBM.MicroSensor .

Berechtigungen werden in der ACL-Datei (Access Control List) auf dem kontaktierten System angegeben. Einzelheiten zu ACL-Dateien und deren Änderung finden Sie in der Veröffentlichung RSCT: Administration Guide.

Exitstatus

0

Der Befehl wurde erfolgreich ausgeführt.

1

Es wurde eine ungültige Kombination von Flags und Parametern eingegeben.

4

Der Sensor wird nicht überwacht und kann nicht aktualisiert werden.

6

Es wurden keine Sensorressourcen gefunden.

n

Basiert auf anderen Fehlern, die vom RMC-Subsystem zurückgegeben werden können.

Umgebungsvariablen

CT_CONTACT

Wenn die Umgebungsvariable CT_CONTACT auf einen Hostnamen oder eine IP-Adresse gesetzt ist, stellt der Befehl eine Verbindung zum RMC-Dämon (Resource Monitoring and Control) auf dem angegebenen Host her. Wenn diese Umgebungsvariable nicht gesetzt wird, stellt der Befehl eine Verbindung zum RMC-Dämon auf dem lokalen System, auf dem der Befehl ausgeführt wird. Die Ressourcenklasse oder Ressourcen, die vom Befehl angezeigt oder geändert werden, befinden sich auf dem System, zu dem die Verbindung aufgebaut wird.

CT_IP_AUTHENT

Wenn die Umgebungsvariable CT_IP_AUTHENT vorhanden ist, verwendet der RMC-Dämon die IP-basierte Netzauthentifizierung, um die Verbindung zum RMC-Dämon auf dem System herzustellen, das mit der IP-Adresse angegeben ist, auf die die Umgebungsvariable CT_CONTACT gesetzt ist. Die Umgebungsvariable CT_IP_AUTHENT hat nur Bedeutung, wenn CT_CONTACT auf eine IP-Adresse gesetzt ist. Sie stützt sich nicht auf den DNS-Service (Domain Name System, Domänennamensservice).

CT_MANAGEMENT_SCOPE

Bestimmt den Managementbereich, der für die Sitzung mit dem RMC-Dämon verwendet wird, um die Ressourcen und Ressourcenklassen zu überwachen und zu steuern. Der Managementbereich bestimmt die Gruppe möglicher Zielknoten, auf denen die Ressourcen und Ressourcenklassen überwacht und gesteuert werden können.

Die gültigen Werte sind im Folgenden beschrieben:

0

Gibt den lokalen Bereich an.

1

Gibt den lokalen Bereich an.

2

Gibt den Peerdomänenbereich an.

3

Gibt den Managementdomänenbereich an.

Wenn diese Umgebungsvariable nicht gesetzt ist, wird der lokale Bereich verwendet.

Implementierungsspezifikationen

Dieser Befehl ist Teil der Dateigruppe rsct.core für AIX® und rsct.core-3.1.0.0-0.-Plattform.rpm -Paket für Linux®, Solaris und Windows, wobei -Plattform i386, ppc, ppc64, s390oder x86_64ist.

Beispiele

1. Geben Sie Folgendes ein, um den Sensor Sensor1 so zu aktualisieren, dass der zugehörige definierte Sensorbefehl ausgeführt wird:

   refsensor Sensor1

2. Geben Sie Folgendes ein, um den Sensor Sensor1 so zu aktualisieren, dass Int32 auf 50, Float32 auf 123.45und String auf "test input"gesetzt ist:

   refsensor Sensor1 Int32=50 Float32=123.45 String="test input"

3. Geben Sie Folgendes ein, um den Sensor Sensor1 auf den Knoten zu aktualisieren, die in der Datei /u/joe/common_nodes aufgelistet sind, sodass der definierte Sensorbefehl von Sensor1ausgeführt wird:

   refsensor -N /u/joe/common_nodes Sensor1

   Dabei enthält /u/joe/common_nodes Folgendes:

   # common node file
   #
   node1.myhost.com    main node
   node2.myhost.com    backup node

4. Geben Sie Folgendes ein, um den Mikrosensor mit dem Namen IBM.Sensor1 so zu aktualisieren, dass die Attributwerte mithilfe des definierten Mikrosensorlademoduls abgefragt werden:

   refsensor -m IBM.Sensor1

Position

/opt/rsct/bin/refsensor