Der Befehl manualvacuum unter NZ

Der Befehl nz manualvacuum führt eine umfassende Vakuum- und Neuindizierungsoperation für alle Datenbanken in Ihrer NPSaaS-Instanz durch. Dieser Wartungsvorgang hilft dabei, Speicherplatz freizugeben und die Datenbankleistung zu optimieren, indem veraltete Daten entfernt und Indizes neu erstellt werden. Dieser Befehl wurde in der nzcli-Version 11.3.1.3 eingeführt.

Übersicht

Der manuelle Vakuumbetrieb ist eine wichtige Wartungsmaßnahme, die:

  • Beendet das NPS-System (nzstop)
  • Erstellt eine Sicherungskopie der Katalogdaten
  • Führt Vakuum- und Neuindizierungsvorgänge für alle Datenbanken durch
  • Startet das NPS-System neu (nzstart)

Das System ist während dieses Vorgangs nicht verfügbar, der je nach Größe Ihrer Datenbanken einige Zeit in Anspruch nehmen kann.

Voraussetzungen

Bevor Sie den manuellen Vakuumvorgang starten, stellen Sie sicher, dass:

  • Sie verfügen über Administratorrechte für die NPSaaS-Instanz
  • Sie haben das nz Befehlszeilentool in der Version 11.3.1.3 oder höher heruntergeladen und konfiguriert
  • Sie haben die erforderlichen Umgebungsvariablen (APISERVER_URL, NZ_USER, NZ_PASSWORD) gesetzt oder sind bereit, diese als Befehlsoptionen anzugeben
  • Sie haben ein Wartungsfenster eingeplant, da das System während des Vorgangs nicht verfügbar sein wird
  • Sie verfügen über ausreichend Speicherplatz für die Katalogsicherung

Syntax

nz manualvacuum [options]

Optionen

Option Beschreibung
-apiserver <APISERVER> Die URL des API-Servers. Kann über die APISERVER_URL Umgebungsvariable festgelegt werden. (erforderlich)
-u <USER> NPS-Benutzername. Kann über die NZ_USER Umgebungsvariable festgelegt werden. (erforderlich)
-pw <PASSWORD> NPS-Passwort. Kann über die NZ_PASSWORD Umgebungsvariable festgelegt werden. (erforderlich)
-force Die Bestätigungsabfrage überspringen und den Vorgang sofort fortsetzen
-format <FORMAT> Ausgabeformat für die Befehlsergebnisse
-host <HOST> Die URL des API-Servers. Kann über die NZ_HOST Umgebungsvariable festgelegt werden

Beispiele

Manuelles Vakuumieren mit Bestätigungsabfrage ausführen

./nz manualvacuum -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>

Der Befehl zeigt eine Warnung an und fordert zur Bestätigung auf:

  WARNING: Manual Vacuum Operation
=====================================
This operation will:
  1. Stop NPS (nzstop)
  2. Run nz_manual_vacuum
  3. Start NPS (nzstart)
This process may take significant time and will restart the system.
The system will be unavailable during this operation.
Do you want to continue? (yes/no):

Manuelles Vakuumieren ohne Bestätigung ausführen

Verwenden Sie die Option -force, um die Bestätigungsabfrage zu überspringen:

./nz manualvacuum -force -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>

Verwendung von Umgebungsvariablen

Legen Sie Umgebungsvariablen fest, um die Angabe von Anmeldedaten im Befehl zu vermeiden:

export APISERVER_URL=<apiserver-url>
export NZ_USER=<nps-admin-user>
export NZ_PASSWORD=<nps-admin-user-password>
./nz manualvacuum -force

Betriebsablauf

Wenn Sie den Befehl nz manualvacuum ausführen, wird der folgende Workflow ausgeführt. Intern ruft der Befehl die nz_manual_vacuum Systembinärdatei auf dem NPS-Host auf.

  1. Systemstopp: Das NPS-System wird mit dem Befehl nzstop gestoppt
  2. Katalogsicherung: Eine Sicherung der Katalogdaten wird erstellt unter /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz
  3. Vacuum und Reindex: Der Vorgang führt Vacuum und Reindex für folgende Elemente durch:
    • Die _T_OBJECT Systemtabelle
    • Alle Benutzer- und Systemdatenbanken in der richtigen Reihenfolge
  4. Systemstart: Das NPS-System wird mit dem Befehl nzstart neu gestartet
  5. Abschluss: Der Vorgang wird abgeschlossen und eine Zusammenfassung der Ergebnisse angezeigt

Ausgaben und Protokolle

Der manuelle Vakuumbetrieb erzeugt:

  • Protokolldatei: /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.log
  • Sicherungsdatei: /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz
  • Konsolenausgabe: Detaillierte Informationen zum Fortschritt, darunter:
    • Vorgangs-ID und Zeitstempel
    • Status der Befehlsausführung
    • Zeitangaben für jede Datenbank
    • Größenvergleich (vorher und nachher)
    • Fertigstellungsstatus

Beispielausgabe

Manual vacuum completed successfully
Output:
================================================================================
Manual Vacuum Workflow Started
Handle: nzrest.68n6kkr8.manual_vacuum
User: admin
Timestamp: 2026-06-09 14:08:12,790
================================================================================
# Database 1 of 19          SYSTEM
     TIMINGS (vacuum    ):  Elapsed Time:     0.21
     TIMINGS (reindex   ):  Elapsed Time:     0.39
...
###############################################################################
    Size Before      Size After  Pathname
=============== ===============  =========================================================
     3924887043      3915646467  /data/catalog/data.1.0
###############################################################################
   log file: /nz/manual_vacuum/nz_manual_vacuum.20260609_140932.log
backup file: /nz/manual_vacuum/nz_manual_vacuum.20260609_140932.tar.gz
================================================================================
Manual Vacuum Workflow Completed Successfully
All commands executed without errors
================================================================================

Bewährte Verfahren

  • Planen Sie manuelle Vakuumvorgänge während Wartungsfenstern ein, in denen das System offline sein kann
  • Überprüfen Sie vor der Ausführung des Vorgangs den Speicherplatz, um sicherzustellen, dass ausreichend Speicherplatz für die Katalogsicherung vorhanden ist
  • Überprüfen Sie nach Abschluss die Protokolldateien, um die erfolgreiche Ausführung zu bestätigen
  • Berücksichtigen Sie bei der Planung des Wartungsfensters die Größe Ihrer Datenbanken, da größere Datenbanken mehr Zeit erfordern
  • Bewahren Sie die Sicherungsdateien zu Wiederherstellungszwecken auf, bis Sie überprüft haben, dass der Vorgang erfolgreich abgeschlossen wurde