개요

수동 진공 작동은 다음과 같은 중요한 유지보수 작업입니다:

• NPS 시스템(nzstop)을 중지합니다
• 카탈로그 데이터의 백업을 생성합니다
• 모든 데이터베이스에 대해 진공 처리 및 재색인 작업을 수행합니다
• NPS 시스템(nzstart)을 다시 시작합니다

이 작업이 진행되는 동안 시스템은 사용할 수 없으며, 데이터베이스의 크기에 따라 상당한 시간이 소요될 수 있습니다.

전제조건

수동 진공 작업을 실행하기 전에 다음 사항을 확인하십시오:

• NPSaaS 인스턴스에 대한 관리자 권한이 있습니다
• nz 명령줄 도구 버전 11.3.1.3 또는 그 이후 버전을 다운로드하고 설정하셨습니다
• 필요한 환경 변수(APISERVER_URL, NZ_USER, NZ_PASSWORD)를 설정했거나, 명령줄 옵션으로 지정할 준비가 되어 있습니다
• 시스템이 작업 기간 동안 이용 불가능하므로, 유지보수 시간을 예약하셨습니다
• 카탈로그 백업을 수행하기에 충분한 디스크 공간이 있습니다

구문

nz manualvacuum [options]

옵션

예제

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

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

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

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

운영 워크플로우

nz manualvacuum 명령을 실행하면 다음 워크플로가 실행됩니다. 내부적으로 이 명령은 NPS 호스트에서 ‘ nz_manual_vacuum ’ 시스템 바이너리를 호출합니다.

1. 시스템 중지 : nzstop 명령을 사용하여 NPS 시스템이 중지되었습니다
2. 카탈로그 백업: 카탈로그 데이터의 백업이 다음 위치에 생성됩니다. /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz
3. 진공 정리 및 색인 재구축: 이 작업은 다음 대상에 대해 진공 정리 및 색인 재구축을 수행합니다:
   • _T_OBJECT 시스템 테이블
   • 모든 사용자 및 시스템 데이터베이스를 순서대로
4. 시스템 시작 : nzstart 명령을 사용하여 NPS 시스템을 다시 시작합니다
5. 완료: 작업이 완료되면 결과 요약이 표시됩니다

출력 및 로그

수동 진공 작동 시 다음이 발생합니다:

• 로그 파일: /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.log
• 백업 파일: /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz
• 콘솔 출력: 다음을 포함한 상세한 진행 상황 정보:
  • 작업 핸들 및 타임스탬프
  • 명령 실행 상태
  • 각 데이터베이스의 타이밍 정보
  • 크기 비교 (변경 전후)
  • 완료 상태

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

우수 사례

• 시스템을 오프라인 상태로 전환할 수 있는 유지보수 시간대에 수동 진공 작업을 예약하십시오
• 카탈로그 백업에 필요한 충분한 공간이 확보되어 있는지 확인하기 위해 작업을 실행하기 전에 디스크 여유 공간을 확인하십시오
• 작업 완료 후 로그 파일을 검토하여 실행이 성공적으로 이루어졌는지 확인하십시오
• 유지보수 시간을 계획할 때는 데이터베이스의 크기를 고려하십시오. 데이터베이스가 클수록 더 많은 시간이 소요되기 때문입니다
• 작업이 성공적으로 완료되었음을 확인할 때까지 복구 용도로 백업 파일을 보관하십시오

관련 명령

• nz_online_vacuum- 시스템 재시작 없이 온라인 진공 작업을 수행합니다
• nz_groom- 테이블을 정리하여 공간을 확보한다
• nzstate- 시스템 상태 확인
• nzstop 그리고 nzstart- NPS 시스템 중지 및 시작