Il comando "manualvacuum" di nz

Il comando nz manualvacuum esegue un'operazione completa di pulizia e reindicizzazione su tutti i database presenti nell'istanza di NPSaaS. Questa operazione di manutenzione consente di recuperare spazio su disco e ottimizzare le prestazioni del database, rimuovendo i dati obsoleti e ricostruendo gli indici. Questo comando è stato introdotto nella versione 11.3.1.3 di nzcli.

Panoramica

L'operazione manuale di svuotamento è un'attività di manutenzione fondamentale che:

  • Arresta il sistema NPS (nzstop)
  • Crea un backup dei dati del catalogo
  • Esegue operazioni di svuotamento e reindicizzazione su tutti i database
  • Riavvia il sistema NPS (nzstart)

Il sistema non sarà disponibile durante questa operazione, che potrebbe richiedere molto tempo a seconda delle dimensioni dei database.

Prerequisiti

Prima di eseguire l'operazione di svuotamento manuale, assicurarsi che:

  • Hai diritti di amministratore sull'istanza di NPSaaS
  • Hai scaricato e configurato lo strumento da riga di comando nz versione 11.3.1.3 o successiva
  • Hai impostato le variabili d'ambiente richieste (APISERVER_URL, NZ_USER, NZ_PASSWORD) oppure sei pronto a fornirle come opzioni di comando
  • Hai programmato una finestra di manutenzione, poiché il sistema non sarà disponibile durante l'operazione
  • Hai spazio su disco sufficiente per il backup del catalogo

Sintassi

nz manualvacuum [options]

Opzioni

Opzione Descrizione
-apiserver <APISERVER> L' URL e del server API. Può essere impostato tramite la variabile d'ambiente APISERVER_URL. (obbligatorio)
-u <USER> Nome utente NPS. Può essere impostato tramite la variabile d'ambiente NZ_USER. (obbligatorio)
-pw <PASSWORD> Password NPS. Può essere impostato tramite la variabile d'ambiente NZ_PASSWORD. (obbligatorio)
-force Ignora la richiesta di conferma e procedi immediatamente con l'operazione
-format <FORMAT> Formato di output dei risultati del comando
-host <HOST> L' URL e del server API. Può essere impostato tramite la variabile d'ambiente NZ_HOST

Esempi

Esecuzione del vuoto manuale con richiesta di conferma

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

Il comando visualizza un avviso e richiede una conferma:

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

Esecuzione del vuoto manuale senza conferma

Utilizza l'opzione " -force " per saltare la richiesta di conferma:

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

Utilizzo delle variabili d'ambiente

Imposta le variabili d'ambiente per evitare di specificare le credenziali nel comando:

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

Flusso di lavoro operativo

Quando si esegue il comando nz manualvacuum , viene eseguito il seguente flusso di lavoro. A livello interno, il comando richiama il binario di sistema “ nz_manual_vacuum ” sull’host NPS.

  1. Arresto del sistema : il sistema NPS viene arrestato tramite il comando nzstop
  2. Backup del catalogo: viene creato un backup dei dati del catalogo alle /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz
  3. Vacuum e reindex: l'operazione esegue il vacuum e il reindex su:
    • La tabella di sistema " _T_OBJECT "
    • Tutti i database utente e di sistema in ordine sequenziale
  4. Avvio del sistema : il sistema NPS viene riavviato utilizzando il comando nzstart
  5. Completamento: l'operazione viene completata e viene visualizzato un riepilogo dei risultati

Output e log

Il funzionamento manuale a depressione genera:

  • File di log: /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.log
  • File di backup: /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz
  • Output della console: informazioni dettagliate sullo stato di avanzamento, tra cui:
    • Maniglia operativa e data/ora
    • Stato di esecuzione del comando
    • Informazioni sui tempi per ciascun database
    • Confronto delle dimensioni (prima e dopo)
    • Stato di completamento

Output di esempio

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
================================================================================

Procedure consigliate

  • Pianificare le operazioni di svuotamento manuale durante le finestre di manutenzione, quando il sistema può essere messo fuori servizio
  • Controllare lo spazio su disco prima di eseguire l'operazione per assicurarsi che vi sia spazio sufficiente per il backup del catalogo
  • Al termine dell'operazione, controllare i file di log per verificare che l'esecuzione sia avvenuta correttamente
  • Quando pianificate la finestra di manutenzione, tenete conto delle dimensioni dei vostri database, poiché quelli più grandi richiedono più tempo
  • Conserva i file di backup a scopo di ripristino fino a quando non avrai verificato che l'operazione sia stata completata con successo