Befehl "mkcomg"

Zweck

Erstellt eine neue Kommunikationsgruppendefinition für eine Peerdomäne.

Syntax

mkcomg [-s sensitivity] [-p period ] [ -g grace ] [-t priority] [ ' -x ' b | ' r | ' br ] [ -N UseForNodeMembership ] [-e NIM_path] [-m NIM_parameters ] [ -M media_type ] [ -i {h | n}:interface1[:node1][,interface2[:node2]...] | -S {h | n}:"interface_selection_string" [ -6 ] [-h] [-TV] communication_group

Beschreibung

Der Befehl mkcomg erstellt eine neue Kommunikationsgruppendefinition für eine Online-Peerdomäne mit dem mit dem Parameter Kommunikationsgruppe angegebenen Namen. Die Kommunikationsgruppe wird verwendet, um Überwachungssignalringe für Topologieservices und die optimierbaren Parameter für jeden Überwachungssignalring zu definieren. Die Kommunikationsgruppe bestimmt, welche Einheiten für den Austausch von Überwachungssignalen (auch Heartbeating genannt) in der Peerdomäne verwendet werden. Es kann mehrere Kommunikationsgruppen in einer Peerdomäne geben.

Der Befehl mkcomg muss auf einem Knoten ausgeführt werden, der derzeit in der Peerdomäne online ist, in der die Kommunikationsgruppe definiert werden soll. Zum Erstellen einer neuen Kommunikationsgruppe für die Domäne muss mehr als die Hälfte der Knoten online sein.

Mit den Flags -e und -m werden der Pfad und die Parameter des Netzschnittstellenmoduls (Network Interface Module, NIM) festgelegt. Der Pfad ist der Pfad zu dem Netzschnittstellenmodul, das die in der Kommunikationsgruppe verwendeten Adaptertypen unterstützt. Die Parameter für das Netzschnittstellenmodul werden an das Netzschnittstellenmodul übergeben, wenn dieses gestartet wird. Wenn -m nicht angegeben wird, werden die von Topology Services vordefinierten Parameter verwendet.

Die Kommunikationsgruppe kann einer oder mehreren Schnittstellenressourcen zugewiesen werden. Verwenden Sie das Flag -i , um die Kommunikationsgruppe einem bestimmten Schnittstellenressourcennamen zuzuordnen. Die Schnittstellenressource kann auf einem bestimmten Knoten auf eine einzige Kommunikationsgruppe beschränkt werden. Eine Schnittstellenressource kann auch mit dem Flag -S und einer Auswahlzeichenfolge angegeben werden. Diese Methode wird verwendet, wenn die Angabe des Schnittstellenressourcennamens nicht ausreichend ist. Die Flags -i und -S können nicht zusammen verwendet werden. Der Befehl chcomg kann auch verwendet werden, um einer Schnittstellenressource eine Kommunikationsgruppe zuzuordnen.

Flags

--s Empfindlichkeit

Gibt die Überwachungssignalsensitivität an. Die Sensitivität ist die Anzahl verpasster Überwachungssignale, die einen Fehler darstellt. Der Empfindlichkeitswert ist eine ganze Zahl, die größer oder gleich 2 ist. Der Standardwert ist 4.

--p Zeitraum

Gibt den Zeitraum zwischen den einzelnen Überwachungssignalen an. Der Zeitraum wird in Sekunden (auf Millisekunden genau) angegeben. Er kann als ganze Zahl oder als Gleitkommazahl angegeben werden.

-g Karenz

Gibt die Karenzzeit an, die verwendet wird, wenn keine Überwachungssignale mehr empfangen werden. Wenn ein Überwachungssignal verpasst wird, wird ein ICMP-Echopaket (Internet Control Message Protocol) an den ausgefallenen Knoten gesendet. Wenn das Echo zurückgegeben wird, beginnt die Karenzzeit.

Die Karenzzeit ist ein Wert in Sekunden und kann auf Millisekunden genau angegeben werden. Sie kann als ganze Zahl, als Gleitkommazahl oder mit einem der folgenden Werte angegeben werden.

0

Gibt an, dass die Karenzzeit inaktiviert ist.

-1 | D

Gibt an, dass das Subsystem für die Topologieservices die Karenzzeit steuert. Dies ist die Standardeinstellung.

--t Priorität

Gibt die Priorität an. Dieser Wert zeigt den Stellenwert dieser Kommunikationsgruppe im Vergleich mit anderen an. Dieses Flag wird verwendet, um die Überwachungssignalringe zu sortieren. Je niedriger die Zahl ist, desto höher ist die Priorität. Die höchste Priorität ist 1. Der Standardwert ist 1 für IP-Netze und 255 für RS232-Netze.

-x b | r | br

Schließt Steuerelemente für Überwachungssignalmechanismen aus. Dieses Flag gibt an, dass mindestens ein Steuerelement für Überwachungssignalmechanismen selbst dann nicht verwendet werden soll, wenn es vom zugrunde liegenden Medium unterstützt wird. Die folgenden Features können ausgeschlossen werden:

b

Gibt an, dass das Broadcast-Feature auch dann nicht verwendet werden soll, wenn es vom zugrunde liegenden Medium unterstützt wird. Wenn -x b nicht angegeben ist, wird die Broadcastfunktion verwendet, wenn sie von den zugrunde liegenden Medien unterstützt wird.

r

Gibt an, dass das Source-Routing-Feature auch dann nicht verwendet werden soll, wenn es vom zugrunde liegenden Medium unterstützt wird. Wenn -x r nicht angegeben ist, wird das Source-Routing-Feature verwendet, wenn es von den zugrunde liegenden Medien unterstützt wird.

Sollen mehrere Steuerelemente ausgeschlossen werden, geben Sie die Featurezeichen nacheinander an: -x br.

-N UseForNodeMembership

Gibt an, ob Gruppenservices die Kommunikationsgruppe für die Berechnung der Knotenzugehörigkeit verwenden. Definiert das persistente Ressourcenattribut UseForNodeMembership für die Kommunikationsgruppenressource. Die gültigen Werte sind im Folgenden beschrieben:

0

Gibt an, dass Gruppenservices die Ergebnisse von Aktivitätsprüfungen, die für NetworkInterface-Ressourcen, die zu dieser Kommunikationsgruppe gehören, ausgeführt werden, nicht verwenden, um zu berechnen, ob der Eignerknoten der Schnittstellen online ist.

1

Gibt an, dass die Gruppenservices die Ergebnisse der Aktivitätsprüfungen, die für NetworkInterface-Ressourcen ausgeführt werden, für die Berechnung des Onlinestatus der Eignerknoten verwenden.

--e NIM_pfad

Gibt den Pfadnamen des Netzschnittstellenmoduls an. Diese Zeichenfolge gibt den Pfadnamen zu dem Netzschnittstellenmodul an, das die Adaptertypen in der Kommunikationsgruppe unterstützt.

--m NIM_Parameter

Gibt die Startparameter für das Netzschnittstellenmodul an. Diese Zeichenfolge wird an das Netzschnittstellenmodul übergeben, wenn es gestartet wird.

-M Medientyp

Gibt den Typ der Schnittstellen an, aus denen sich die Kommunikationsgruppe zusammensetzt. Die gültigen Werte sind im Folgenden beschrieben:

0

Gibt an, dass sich die Kommunikationsgruppe aus anderen Schnittstellenressourcen als IP- oder Plattenressourcen zusammensetzt.

1

Gibt an, dass sich die Kommunikationsgruppe aus IPv4- oder IPv6-Schnittstellenressourcen zusammensetzt.

Wenn das Flag -M nicht angegeben ist, ist dies der Standardwert.

2

Gibt an, dass sich die Kommunikationsgruppe aus Plattenschnittstellenressourcen zusammensetzt.

--i {h | n}:interface1[:node1] [,interface2[:node2]...

Weist die Kommunikationsgruppe einer oder mehreren Überwachungssignal- oder Netzschnittstellenressourcen und optional den Knoten zu, auf denen diese Ressourcen gefunden werden. Geben Sie -i h für Überwachungssignalschnittstellenressourcen bzw. -i n für Netzschnittstellenressourcen an.

Standardmäßig fügt das Flag -i n Netzschnittstellenressourcen, die IPv4-Adressen haben, zur Gruppe Kommunikationsgruppe zu. Wenn das Flag -6 angegeben ist, fügt das Flag -i n Netzschnittstellenressourcen hinzu, die IPv6-Adressen für die Kommunikationsgruppe haben.

Bei Angabe von -i kann -S nicht angegeben werden.

-S {h | n}:"Auswahlzeichenfolge_für_Netze"

Weist die Kommunikationsgruppe der mit Auswahlzeichenfolge_für_Netze angegebenen Überwachungssignal- oder Netzschnittstelle zu. Geben Sie -S h für Überwachungssignalschnittstellen oder -S n für Netzschnittstellen an.

Standardmäßig fügt das Flag -S n Netzschnittstellenressourcen, die IPv4-Adressen haben, zur Kommunikationsgruppe hinzu. Wenn das Flag -6 angegeben ist, fügt das Flag -S n Netzschnittstellenressourcen hinzu, die IPv6-Adressen für die Kommunikationsgruppe haben.

Bei Angabe von -S kann -i nicht angegeben werden.

-6

Gibt an, dass die Kommunikationsgruppe der als Ressourcen in jeder Schnittstelle dargestellten IPv6-Adressen in die angegebene Kommunikationsgruppe geändert wird. IPv4-Adressen, die als Ressourcen in den Schnittstellen dargestellt sind, sind nicht betroffen.

Standardmäßig (d. h., wenn das Flag -6 nicht angegeben ist) gilt das Gegenteil. Es wird nur die Kommunikationsgruppe von IPv4-Adressen geändert, die als Ressourcen in der Schnittstelle dargestellt sind.

-h

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

-T

Schreibt die Tracenachrichten des Befehls in die Standardfehlerausgabe. Dieses Flag ist nur für die Verwendung durch Ihre Software-Service-Organisation bestimmt.

-V

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

Parameter

Kommunikationsgruppe

Gibt den Namen der neuen Kommunikationsgruppe an, die für die Online-Peerdomäne erstellt werden soll. Für den Namen können alle druckbaren Zeichen verwendet werden.

Sicherheit

Der Benutzer des Befehls mkcomg benötigt Schreibberechtigung für die Ressourcenklasse IBM.CommunicationGroup . Die Schreibberechtigung für die IBM.NetworkInterface -Ressourcenklasse ist erforderlich, um die Kommunikationsgruppe für eine Netzschnittstellenressource festzulegen. Standardmäßig hat root auf jedem Knoten in der Peerdomäne über den Konfigurationsressourcenmanager Lese-und Schreibzugriff auf diese Ressourcenklassen.

Exitstatus

0

Der Befehl wurde erfolgreich ausgeführt.

1

Es ist ein Fehler in RMC aufgetreten.

2

Es ist ein Fehler in einem Befehlszeilenschnittstellenscript aufgetreten.

3

In der Befehlszeile wurde ein ungültiges Flag eingegeben.

4

In der Befehlszeile wurde ein falscher Parameter eingegeben.

5

Es ist ein Fehler aufgetreten, der auf eine ungültige Eingabe in der Befehlszeile zurückzuführen ist.

Umgebungsvariablen

CT_CONTACT

Bestimmt das System, auf dem die Sitzung mit dem RMC-Dämon (Resource Monitoring and Control) ausgeführt wird. Wenn CT_CONTACT auf einen Hostnamen oder eine IP-Adresse gesetzt ist, stellt der Befehl eine Verbindung zum RMC-Dämon auf dem angegebenen Host her. Wenn CT_CONTACT nicht gesetzt ist, stellt der Befehl eine Verbindung zum RMC-Dämon auf dem lokalen System, auf dem der Befehl ausgeführt wird, her. Das Ziel der RMC-Dämonsitzung und der Managementbereich bestimmen die Ressourcenklassen bzw. die Ressourcen, die verarbeitet werden.

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).

Einschränkungen

Dieser Befehl muss auf einem Knoten ausgeführt werden, der in der Peerdomäne definiert und online ist, in der Kommunikationsgruppe definiert werden soll.

Implementierungsspezifikationen

Dieser Befehl ist Teil des RSCT-Dateisets (Reliable Scalable Cluster Technology ) für AIX®.

Standardeingabe

Wenn das Flag -f "-" oder -F "-" angegeben ist, liest dieser Befehl einen oder mehrere Knotennamen aus der Standardeingabe.

Standardausgabe

Wenn das Flag -h angegeben ist, wird der Verwendungshinweis für diesen Befehl in die Standardausgabe geschrieben. Alle ausführlichen Nachrichten werden in die Standardausgabe geschrieben.

Standardfehlerausgabe

Alle Tracenachrichten werden in die Standardfehlerausgabe geschrieben.

Beispiele

1. Führen Sie den folgenden Befehl unter nodeAaus, um die Kommunikationsgruppe ComGrp1 für die Peerdomäne ApplDomain zu definieren und nodeA für ApplDomainzu definieren:

   mkcomg ComGrp1

2. Führen Sie den folgenden Befehl unter nodeAaus, wenn Sie die Kommunikationsgruppe ComGrp1 für die Peerdomäne ApplDomainmit der Sensitivität 1 und dem Zeitraum 3 definieren und nodeA für ApplDomaindefiniert und online ist:

   mkcomg -s 1 -p 3 ComGrp1

3. Um die Kommunikationsgruppe " ComGrp1 für die Peer-Domäne " ApplDomain zu definieren, ohne Broadcast, mit einer Priorität von 3, und " nodeA ist definiert und online zu " ApplDomain, führen Sie diesen Befehl auf " nodeA: aus

   mkcomg -x b -t 3 ComGrp1

4. Führen Sie den folgenden Befehl unter nodeAaus, um die Kommunikationsgruppe ComGrp1 für die Peerdomäne ApplDomainzu definieren, die kein Broadcast verwendet, kein Quellenrouting verwendet und nodeA für ApplDomaindefiniert und online ist:

   mkcomg -x br ComGrp1

5. Führen Sie den folgenden Befehl unter nodeAaus, wenn Sie die Kommunikationsgruppe ComGrp1 für die Peerdomäne ApplDomainmit dem NIM-Pfad /opt/rsct/bin/hats_nimund den NIM-Parametern -l 5 definieren, um die Protokollierungsstufe festzulegen, und nodeA für ApplDomaindefiniert und online ist:

   mkcomg -e /opt/rsct/bin/hats_nim -m "-l 5" ComGrp1

6. Führen Sie den folgenden Befehl auf dem Knoten nodeA aus, um die Kommunikationsgruppe ComGrp1 für die Peerdomäne ApplDomain zu definieren und ComGrp1 der Überwachungssignalschnittstellenressource mit dem Namen hbi0 auf Knoten nodeC zuzuweisen:

   mkcomg -i h:hbi0:nodeC ComGrp1

7. Um die Kommunikationsgruppe ComGrp1 für die Peerdomäne ApplDomainzu definieren, ordnen Sie ComGrp1 der Netzschnittstellenressource namens eth0 unter nodeBzu und nodeA ist für ApplDomaindefiniert und online. Führen Sie den folgenden Befehl unter nodeAaus:

   mkcomg -i n:eth0:nodeB ComGrp1

8. Führen Sie den folgenden Befehl auf dem Knoten nodeA aus, um die Kommunikationsgruppe ComGrp1 für die Domäne ApplDomain zu definieren und ComGrp1 der Überwachungssignalschnittstellenressource zuzuweisen, die das Teilnetz 9.345.67.812 verwendet:

   mkcomg -S h:"Subnet == 9.345.67.812" ComGrp1

9. Um die Kommunikationsgruppe ComGrp1 für die Peerdomäne ApplDomainzu definieren, ordnen Sie ComGrp1 der Netzschnittstellenressource zu, die das Teilnetz 9.123.45.678verwendet, und nodeA ist für ApplDomaindefiniert und online. Führen Sie den folgenden Befehl unter nodeAaus:

   mkcomg -S n:"Subnet == 9.123.45.678" ComGrp1

10. Führen Sie den folgenden Befehl auf dem Knoten nodeA aus, um die Kommunikationsgruppe ComGrp1 für die Domäne ApplDomain mit einem Zeitraum von 500 Millisekunden zu definieren:

    mkcomg -p 0.5 ComGrp1

Position

/opt/rsct/bin/mkcomg