Comando manualvacuum de nz

El comando nz manualvacuum realiza una operación completa de limpieza y reindexación en todas las bases de datos de su instancia de NPSaaS. Esta operación de mantenimiento ayuda a recuperar espacio en disco y a optimizar el rendimiento de la base de datos mediante la eliminación de datos obsoletos y la reconstrucción de índices. Este comando se introdujo en la versión 11.3.1.3 de nzcli.

Visión general

La operación manual de vacío es una tarea de mantenimiento fundamental que:

  • Detiene el sistema NPS (nzstop)
  • Crea una copia de seguridad de los datos del catálogo
  • Realiza operaciones de limpieza y reindexación en todas las bases de datos
  • Reinicia el sistema NPS (nzstart)

El sistema no estará disponible durante esta operación, que puede tardar bastante tiempo en completarse, dependiendo del tamaño de sus bases de datos.

Requisitos previos

Antes de realizar la operación de vacío manual, asegúrese de que:

  • Tienes acceso de administrador a la instancia de NPSaaS
  • Has descargado y configurado el nz Herramienta de línea comando versión 11.3.1.3 o posterior
  • Ha configurado las variables de entorno necesarias (APISERVER_URL, NZ_USER, NZ_PASSWORD) o está preparado para proporcionarlas como opciones comando
  • Ha programado un periodo de mantenimiento, ya que el sistema no estará disponible durante la operación
  • Dispone de espacio suficiente en disco para la copia de seguridad del catálogo

Sintaxis

nz manualvacuum [options]

Opciones

Opción Descripción
-apiserver <APISERVER> URL o del servidor de la API. Se puede configurar mediante la variable de entorno APISERVER_URL. (obligatorio)
-u <USER> Nombre de usuario de NPS. Se puede configurar mediante la variable de entorno NZ_USER. (obligatorio)
-pw <PASSWORD> Contraseña de NPS. Se puede configurar mediante la variable de entorno NZ_PASSWORD. (obligatorio)
-force Omite el mensaje de confirmación y continúa con la operación inmediatamente
-format <FORMAT> Formato de salida de los resultados comando
-host <HOST> URL o del servidor de la API. Se puede configurar mediante la variable de entorno NZ_HOST

Ejemplos

Ejecución del modo de vacío manual con mensaje de confirmación

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

El comando muestra una advertencia y solicita confirmación:

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

Ejecución del modo de vacío manual sin confirmación

Utiliza la opción -force para omitir el mensaje de confirmación:

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

Uso de variables de entorno

Configura las variables de entorno para evitar tener que especificar credenciales en el comando :

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

Flujo de trabajo operativo

Al ejecutar el comando nz manualvacuum, se lleva a cabo el siguiente flujo de trabajo. Internamente, el comando invoca el binario del sistema nz_manual_vacuum en el host NPS.

  1. Parada del sistema: El sistema NPS se detiene mediante el comando nzstop
  2. Copia de seguridad del catálogo: Se crea una copia de seguridad de los datos del catálogo en /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz
  3. Vaciar y reindexar: La operación vacía y reindexa en:
    • La tabla del sistema _T_OBJECT
    • Todas las bases de datos de usuarios y del sistema en orden
  4. Inicio del sistema: El sistema NPS se reinicia mediante el comando nzstart
  5. Finalización: La operación finaliza y muestra un resumen de los resultados

Resultados y registros

El funcionamiento manual del sistema de aspiración genera:

  • Archivo de registro: /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.log
  • Archivo de copia de seguridad: /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz
  • Salida de la consola: información detallada sobre el progreso, que incluye:
    • Identificador de operación y marca de tiempo
    • Estado de ejecución comando
    • Información sobre los tiempos de cada base de datos
    • Comparación de tamaños (antes y después)
    • Estado de finalización

Salida de ejemplo

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

Prácticas recomendadas

  • Programa las operaciones manuales de limpieza durante las ventanas de mantenimiento, cuando el sistema pueda estar fuera de servicio
  • Comprueba el espacio en disco antes de ejecutar la operación para asegurarte de que hay espacio suficiente para la copia de seguridad del catálogo
  • Revisa los archivos de registro una vez finalizado el proceso para comprobar que se ha ejecutado correctamente
  • Ten en cuenta el tamaño de tus bases de datos a la hora de planificar la ventana de mantenimiento, ya que las bases de datos más grandes requieren más tiempo
  • Conserva los archivos de copia de seguridad para poder restaurar los datos hasta que compruebes que la operación se ha completado correctamente