nzhw (Befehl)

Verwenden Sie den Befehl ' nzhw, um die Hardware zu verwalten.

Der nzhw-Befehl ersetzt die nzspu- und nzsfi-Befehle. Mit diesem Befehl können Sie Informationen zur Systemhardware anzeigen und Komponenten aktivieren oder inaktivieren, sie suchen oder aus dem System löschen.

Syntax

Der nzhw-Befehl hat die folgende Syntax:
nzhw [-h|-rev] [-hc] subcmd [subcmd options]

Eingaben

Der nzhw-Befehl akzeptiert folgende Eingaben:
Tabelle 1. Eingabeoptionen für nzhw
Eingabe Beschreibung
nzhw activate -id hwId Aktiviert eine angegebene Hardwarekomponente wie eine SPU oder Platte mit einer nicht aktiven Rolle (wie z. B. 'Failed' oder 'Mismatched') als Ersatzspeicher. Geben Sie die Hardwarekennung der SPU oder Platte an, die Sie aktivieren wollen.

Ab der Version 11.0.7.0 führt die Aktivierung einer SPU nicht mehr automatisch zu einem Rebalancing der Datenscheiben. Da das Rebalancing eine Änderung des Systemzustands und eine Unterbrechung des Dienstes zur Folge hat, können Sie den Zeitpunkt dieser Unterbrechung wählen und den Befehl " nzds rebalance dann explizit ausführen.

Sie können die automatische Neugewichtung bei aktivierter SPU, die in den Versionen 11.0.7.0 und niedriger standardmäßig eingestellt ist, durch Setzen von ' sysmgr.enableAutoRebalance=yes erreichen. Wenn sysmgr.enableAutoRebalance=yes in " /nz/data/config/system.cfg eingestellt ist, werden die Datenscheiben in " nzstartautomatisch neu abgeglichen, wenn ein Neuabgleich erforderlich ist.

Hinweis: In einigen Fällen kann das System eine Meldung anzeigen, dass die Festplatte noch nicht aktiviert werden kann, weil die SPU eine bestehende Aktivierungsanforderung noch nicht abgeschlossen hat. Die Aktivierung des Datenträgers erfolgt in der Regel schnell, es sei denn, es finden mehrere Aktivierungen zur gleichen Zeit statt. In diesem Fall warten spätere Aktivierungen, bis sie der Reihe nach verarbeitet wurden.
nzhw deactivate -id hwId [-force] Ändert die Rolle einer Ersatz-SPU in 'Inactive', wodurch die Komponente im System nicht mehr verfügbar ist. Der Versuch, eine aktive Komponente mit einer anderen Rolle als 'Spare' zu inaktivieren, führt zu einem Fehler.

Geben Sie die Hardwarekennung der Ersatz-SPU an, die Sie inaktivieren wollen. Schließen Sie die Option -force ein, wenn Sie nicht nach einer Bestätigung gefragt werden wollen.

nzhw failover -id hwId [-force] Ändert die Rolle einer SPU oder Platte in 'Failed', wodurch die Komponente im System nicht mehr verfügbar ist. Wenn Sie für eine SPU einen Failover durchführen, weist das System die Datenausschnitte, die von dieser SPU verwaltet werden oder deren Eigner diese SPU ist, anderen aktiven SPUs im Gehäuse neu zu. Wird für eine Platte ein Failover durchgeführt, verwendet das System die Plattenspiegelpartition als primäre Partition. Weitere Informationen über die Verarbeitung eines Failover finden Sie unter Failover-Informationen.

Geben Sie die Hardwarekennung der Ersatz-SPU oder Ersatzplatte an, für die Sie einen Failover durchführen wollen. Schließen Sie die Option -force ein, wenn Sie nicht nach einer Bestätigung gefragt werden wollen.

nzhw locate [-id hwId | [-off] Gibt eine Komponente und ihre Position im System an.

Bei Verwendung mit -id zeigt der Befehl eine Zeichenfolge für den physischen Standort der Hardwarekomponente an, die durch den Wert hwid identifiziert wird. Bei SPUs, Festplatten und Festplattengehäusen schaltet der Befehl auch die LED-Anzeige ein, damit ein Techniker am Netezza Performance Server die Komponente im Rack finden kann.

Die Option -off schaltet die LED für die angegebene Komponente oder alle SPUs und Platten aus.

Hinweis: Wenn der für den Befehl angegebene Hardwaretyp nicht über eine LED verfügt, zeigt der Befehl nur den Positionsstring für diese Komponente an.
nzhw reset {-id hwId | -all | -spa spaId } [-force] Setzt die angegebene Hardwarekomponente zurück. Zurzeit wird nur eine SPU als Rücksetzziel von diesem Befehl unterstützt.

Sie können eine der folgenden Zieloptionen angeben:

  • -id hwid zum Zurücksetzen einer bestimmten SPU, die durch ihre Hardware-ID gekennzeichnet ist
  • -all, um alle SPUs im System zurückzusetzen.
  • -spa SPA-ID, um alle SPUs im bestimmten SPA zurückzusetzen, das durch die SPA-ID angegeben ist.

Schließen Sie die Option -force ein, wenn Sie nicht nach einer Bestätigung gefragt werden wollen.

nzhw delete -id hwId [-force] Löscht die angegebene Hardwarekomponente aus der Systemdatenbank. Die Hardwarekomponente muss die Rolle 'Mismatched', 'Failed' oder 'Inactive' haben. Eine Hardwarekomponente in einer anderen Rolle führt zu einem Fehler. Eine SPU oder Platte kann durch ihre eindeutige Hardwarekennung ermittelt werden.

Geben Sie die Hardwarekennung der Komponente an, die Sie löschen wollen. Schließen Sie die Option -force ein, wenn Sie nicht nach einer Bestätigung gefragt werden wollen.

nzhw listTypes Zeigt eine Liste der gültigen Hardwaretypen an, die Sie für den Befehl nzhw show -type Hardwaretyp eingeben können.
nzhw show [options] Zeigt Informationen zu den angegebenen Hardwarekomponenten an. Wenn Sie keine Optionen angeben, zeigt der Befehl eine Liste aller Komponenten im System und Typ, Hardwarekennung, Position, Rolle und Status an. Sie können mindestens eine Option angeben (so wie im Folgenden beschrieben), um eine bestimmte Ausgabe anzuzeigen.
nzhw show -caCertFile Gibt den Pfadnamen der CA-Stammzertifikatsdatei auf dem Clientsystem an. Dieses Argument wird von Netezza Performance Server verwendet, die die Peer-Authentifizierung verwenden, um das Netezza Performance Server zu verifizieren. Der Standardwert ist NULL. Dabei wird der Peerauthentifizierungsprozess übersprungen.
nzhw show -securityLevel Gibt die Sicherheitsstufe an, die für die Sitzung verwendet werden soll. Diese Option gilt nicht, wenn Sie am Netezza Performance Server angemeldet sind und den Befehl ausführen. Das Argument weist vier Werte auf:
preferredUnsecured
Dies ist der Standardwert. Geben Sie diese Option an, wenn Sie eine ungesicherte Verbindung bevorzugen würden, aber eine gesicherte Verbindung akzeptieren, wenn das Netezza Performance Server eine solche erfordert.
preferredSecured
Geben Sie diese Option an, wenn Sie eine gesicherte Verbindung zum Netezza Performance Server wünschen, aber eine ungesicherte Verbindung akzeptieren, wenn das Netezza Performance Server so konfiguriert ist, dass nur ungesicherte Verbindungen verwendet werden.
onlyUnsecured
Geben Sie diese Option an, wenn Sie eine ungesicherte Verbindung zum Netezza Performance Server wünschen. Wenn das Netezza Performance Server eine gesicherte Verbindung erfordert, wird die Verbindung abgelehnt.
onlySecured
Geben Sie diese Option an, wenn Sie eine gesicherte Verbindung zum Netezza Performance Server wünschen. Wenn das Netezza Performance Server nur ungesicherte Verbindungen akzeptiert oder wenn Sie versuchen, eine Verbindung zu einem Netezza Performance Server herzustellen, auf dem eine Version vor 4.5 läuft, wird die Verbindung abgewiesen.
nzhw show -id hwId [-detail] Zeigt Informationen nur zu der Komponente mit der angegebenen Hardwarekennung an. Schließen Sie die Option -detail ein, um weitere Informationen wie die Seriennummer, die Hardwareversion und weitere Details abzurufen.
nzhw show -spa [SPA-ID] Zeigt Informationen über die Hardwarekomponenten an, die zu einem bestimmten S-Blade in SPA gehören.
nzhw show -type hwType [-detail] Zeigt Informationen nur zu den Komponenten des angegebenen Hardwaretyps an. Mit dem nzhw listTypes-Befehl können Sie die unterstützten Hardwaretypen anzeigen.

Wenn das System keine Hardware des angegebenen Typs enthält oder wenn der Typ nicht unterstützt wird, zeigt der Befehl eine Nachricht an. Schließen Sie die Option -detail ein, um weitere Informationen wie die Seriennummer, die Hardwareversion und weitere Details abzurufen.

nzhw show -issues [-detail] Zeigt Informationen zu Hardwarekomponenten an, die Probleme melden. Der Befehl zeigt eine Liste zu untersuchender Komponenten und Typ, Hardwarekennung, Position, Rolle und Status an. Schließen Sie die Option -detail ein, um weitere Informationen wie die Seriennummer, die Hardwareversion und weitere Details abzurufen.

Optionen

Der nzhw-Befehl kann folgende Optionen verwenden:
Tabelle 2. nzhw-Optionen
Option Beschreibung
-hostHostname Gibt den Hostnamen oder die IP-Adresse des Netezza Performance Server an.
-u Benutzer Gibt den Datenbank-Benutzernamen [NZ_USER] an.
-pw Kennwort Gibt das Benutzerkennwort [NZ_PASSWORD] an.
-timeout Sekunden Gibt die Zeit in Sekunden an, die auf den Abschluss des Befehls gewartet werden soll, bevor er mit einer Zeitüberschreitung beendet wird. Die Standardeinstellung ist 300.

Beschreibung

Der nzhw-Befehl hat die folgende Beschreibung.
Zugriffsrechte erforderlich
Bei nzhw show-Operationen erfordert Ihr Datenbankbenutzerkonto keine besonderen Berechtigungen. Für nzhw-Befehle zum Verwalten der Hardware wie z. B. 'activate' oder 'deactivate' muss Ihr Datenbankbenutzerkonto jedoch über die Hardwareverwaltungsberechtigung verfügen.
Allgemeine Aufgaben
Der Befehl ' nzhw ist der wichtigste Befehl zur Verwaltung und Anzeige von Informationen über das Netezza® und seine Hardwarekomponenten.

Failover-Informationen

Wenn Sie den nzhw-Befehl für den Failover einer Komponente verwenden, prüft der Befehl das System und die betroffene Komponente, um sicherzustellen, dass der Befehl geeignet ist, bevor der Vorgang fortgesetzt wird. Zurzeit funktioniert der Befehl nur für SPUs und Platten.

Wenn Sie beispielsweise versuchen, einen Failover für eine aktive Komponente durchzuführen, für die keine sekundäre Komponente verfügbar ist (z. B. SPUs, die das Eigentum an den Daten-Slices übernehmen können, die von der SPU verwaltet werden, deren Failover Sie durchführen möchten, oder ein aktiver Mirror für die Festplatte, deren Failover Sie durchführen möchten), gibt der Befehl einen Fehler zurück. Außerdem gibt der Befehl einen Fehler zurück, wenn Sie einen Failover für eine Komponente ohne Hochverfügbarkeit versuchen.

Verwendung

Es folgen Verwendungsbeispiele:
  • Mit dem folgenden Befehl aktivieren Sie eine ausgefallene oder abweichende SPU mit der ID 1003:
    nzhw activate -id 1003 -u user -pw password
  • Mit dem folgenden Befehl führen Sie einen Failover für die SPU mit der Hardwarekennung 1084 durch:
    nzhw failover -id 1084
  • Mit dem folgenden Befehl setzen Sie die SPU mit der Hardwarekennung 1084 zurück:
    nzhw reset -id 1084 
  • Mit dem folgenden Befehl setzen Sie alle SPUs im SPA mit der ID 1002 zurück:
    nzhw reset -spa 1002
  • Mit dem folgenden Befehl löschen Sie die Platte mit der Hardwarekennung 1081:
    nzhw delete -id 1081
  • Mit dem folgenden Befehl zeigen Sie die Hardwareinformationen für das System an:
    nzhw show 
    Description   HW ID Location              Role   State  Security
    ------------- ----- --------------------- ------ ------ ----------
    Rack           1001 rack1                 Active None   N/A
    SPA            1002 spa1                  Active None   N/A
    SPU            1003 spa1.spu7             Active Online N/A
    DiskEnclosure  1004 spa1.diskEncl4        Active Ok     N/A
    Fan            1005 spa1.diskEncl4.fan1   Active Ok     N/A
    Fan            1006 spa1.diskEncl4.fan2   Active Ok     N/A
    Fan            1007 spa1.diskEncl4.fan3   Active Ok     N/A
    Fan            1008 spa1.diskEncl4.fan4   Active Ok     N/A
    PowerSupply    1009 spa1.diskEncl4.pwr1   Active Ok     N/A
    PowerSupply    1010 spa1.diskEncl4.pwr2   Active Ok     N/A
    Disk           1011 spa1.diskEncl4.disk1  Active Ok     N/A
    Disk           1012 spa1.diskEncl4.disk2  Active Ok     N/A
    ...

    Die für diesen Befehl angezeigte Beispielausgabe wird in der Dokumentation abgeschnitten.

  • Mit dem folgenden Befehl zeigen Sie bestimmte Informationen für eine Komponente wie die SPUs an:
    nzhw show -type spu 
    Description HW ID Location   Role   State  Security
    ----------- ----- ---------- ------ ------ --------
    SPU          1003 spa1.spu7  Active Online N/A
    SPU          1080 spa1.spu1  Active Online N/A
    SPU          1081 spa1.spu3  Active Online N/A
    SPU          1082 spa1.spu11 Active Online N/A
    SPU          1084 spa1.spu5  Active Online N/A
    SPU          1085 spa1.spu9  Active Online N/A
  • Mit dem folgenden Befehl zeigen Sie die für das System gemeldeten Hardwareprobleme an:
    nzhw show -issues
    Type HW ID Location                    Role   State Security
    ---- ----- --------------------------- ------ ----- --------
    Disk  1041 rack1.spa1.diskEncl2.disk12 Failed Ok    N/A
  • Um die unterstützten Hardwaretypen für den Befehl ' nzhw show -type hwType aufzulisten, verwenden Sie den folgenden Befehl:
    nzhw listTypes
    Description          Type
    -------------------  --------
    rack                 rack
    spa                  spa
    spu                  spu
    diskenclosure        diskencl
    disk                 disk
    fan                  fan
    blower               blower
    power supply         pwr
    mm                   mm
    store group          storeGrp
    ethernet switch      ethsw
    host                 host
    SAS Controller       SASController
    host disk            hostDisk
    database accelerator dac