NetBackup 백업 플러그인 개발

[Dajeong-Park]

Mold 백업 플러그인 구조

NetBackup 구성 요소

• Master Server : 백업 정책 과 설정 값이 보관되고, media/pool/unit 정보가 Catalog DB에 관리됨
• Media Server : 대용량 백업을 위해 SAN으로 연결된 백업장치를 갖고있는 시스템
• Client : 백업의 대상이 되는 시스템, Master Server 및 Media Server도 하나의 클라이언트로 백업 대상으로 관리

NetBackup 패키지 파일 : https://download.ablecloud.io/OS-ISO/Etc_OS/NetBackup_10.5_LinuxR_x86_64.tar.gz
NetBackup 라이센스 파일 : https://download.ablecloud.io/OS-ISO/Etc_OS/A9257164704_QTY25_NBU_10_5_COMPLETE_ED_FLEX_LIC_6062734399.slf
11.1 버전부터 KVM 백업/복원 지원

Step 1. Master & Media Server 통합 구성 NetBackup 가상머신 생성

• Rocky linux 9.4 OS : 4Core 16GB L2 Network (IP: 10.10.254.108), DATA 300GB 파티션 pool /usr/openv/dj
• webUI : https://netbackup/webui (호스트명으로만 접근가능), 계정정보 가상머신 root 계정 정보와 동일
• 개발 완료 후 11.0 버전 패키지 설치 및 기능 테스트 필요

Step 2. 호스트에 NetBackup Client 패키지 설치

• hosts 파일 변경, 마스터 서버에서 토큰 생성 후 설치 시 입력, 방화벽 포트 1556, 13724, 13782 추가

Step 3. webUI

• 클라이언트 확인 : Security > Certificates 연결된 호스트
• 정책 추가 : Protection > Policies 해당 호스트의 Policy Type을 Standard로 설정 후 스케줄 Full Backup 추가하여 백업 경로 설정
• 백업 : Protection > Policies 해당 정책 선택 후 Maual backup
• 백업 결과 : Activity monitor > Backup job 확인 성공 시 결과 0
• 복원 : Recovery > Start recovery (Standard, Normal backups, 클라이언트 선택, 백업된 경로 선택)
• 백업 삭제 : Catalog > 백업ID, Policy, Schedule, Date 확인 후 특정 백업을 선택하여 Expire

메모장 관리자 권한 실행 C:\Windows\System32\drivers\etc '모든 파일(.)'로 변경한 뒤 hosts 파일 열기

[Dajeong-Park]

사전 구성

클라이언트 자동 설치는 지원하지 않으며, 사전에 호스트에 클라이언트 패키지 설치 및 연결 후 API Key 생성

REST API

REST API 호출 시 토큰 생성하지 않고, API key(Authorization Bearer Token) 사용하는 방식으로 적용
Authorization Bearer Token, Headers Content-Type application/vnd.netbackup+json;version=3.0

NetBackup REST API Request 위한 글로벌 설정 필요 항목

backup.framework.provider.plugin = netbackup
backup.plugin.netbackup.url = https://[NetBackupIP]:1556/netbackup
backup.plugin.netbackup.apikey = [API Key]
backup.plugin.netbackup.request.timeout = 300
backup.plugin.netbackup.validate.ssl = false

Mold 와 NetBackup 매칭

Mold 백업 오퍼링 가져오기 -> retention 입력 받아야 함
넷백업 policy 추가 API 호출 (policy 명은 호스트 이름, policy 타입은 Standard, 스케줄은 Full backup, Retention 설정, 클라이언트3대 호스트 추가, backup selections 경로 /tmp/mold/netbackup// 픽스)
Mold 가상머신에 백업 오퍼링 할당 -> 별도의 작업 필요 없음

Mold UI / API & NetBackup REST API 매칭

• 정책 조회
• Mold UI :
• Mold API :
• NetBackup API : GET https://netbackup:1556/netbackup/config/policies
• NetBackup UI : Protection > Policies

{
    "data": [
        {
            "type": "policy",
            "id": "ablecube31-1",
            "attributes": {
                "policy": {
                    "policyType": "Standard",
                    "policyAttributes": {
                        "dataClassification": null,
                        "storage": null,
                        "volumePool": "NetBackup",
                        "mediaOwner": "*ANY*",
                        "checkpointIntervalMinutes": null,
                        "jobLimit": 0,
                        "priority": 0,
                        "active": true,
                        "effectiveDateUTC": "2026-02-26T01:07:36Z",
                        "clientCompress": false,
                        "clientEncrypt": false,
                        "blockIncremental": false,
                        "followNFSMounts": false,
                        "crossMountPoints": false,
                        "individualFileRestore": false,
                        "collectTrueImageRestoreInfo": "Off",
                        "collectBareMetalRestoreInfo": false,
                        "disableClientSideDeduplication": false,
                        "enableClientSideDeduplication": false,
                        "granularRecovery": false,
                        "snapshotBackup": false,
                        "retainSnapshot": false,
                        "alternateClientHostname": null,
                        "dataMoverMachine": null,
                        "backupHost": null,
                        "snapshotMethod": null,
                        "keyword": null,
                        "exchangeServerList": [],
                        "useAccelerator": false,
                        "calculateFileHash": false,
                        "optimizedBackup": false,
                        "useMultipleDataStreams": false,
                        "exchangeDatabaseBackupSource": "Off",
                        "autoManagedType": 0,
                        "backupHostPool": null,
                        "useVirtualMachine": 0,
                        "hypervServer": null,
                        "generationId": 2
                    }
                }
            },
            "links": {
                "self": {
                    "href": "/config/policies/ablecube31-1"
                }
            }
        }
    ],
    "meta": {
        "pagination": {
            "pages": 1,
            "offset": 0,
            "last": 0,
            "limit": 10,
            "count": 1,
            "page": 0,
            "first": 0
        }
    },
    "links": {
        "last": {
            "href": "https://netbackup:1556/netbackup/config/policies?page%5Boffset%5D=0&page%5Blimit%5D=10&sort=policyName"
        },
        "self": {
            "href": "https://netbackup:1556/netbackup/config/policies?page%5Boffset%5D=0&page%5Blimit%5D=10&sort=policyName"
        },
        "first": {
            "href": "https://netbackup:1556/netbackup/config/policies?page%5Boffset%5D=0&page%5Blimit%5D=10&sort=policyName"
        }
    }
}

[Dajeong-Park]

Custom Plug-in

• Policy Script 방식 : NetBackup 정책에서 backup 전에 사용자 스크립트를 실행하도록 구성하는 방법

• NetBackup policy 실행 로직

백업
└─ bpstart_notify -> 백업 직전 준비 작업 (클라이언트 측 스크립트)
                     예: 백업 오퍼링 할당된 가상머신 조회 Mold API 호출
                          백업 생성 mold API 호출 (가상머신 libvirt push 백업 실행, 특정 경로에 백업 파일 생성)

└─ Netbackup 백업 수행

└─ bpend_notify -> 백업 직후 정리 작업 (클라이언트 측 스크립트)
                     예: 백업 파일 삭제

└─ backup_exit_notify -> 백업 작업 최종 결과 기준 후처리 (마스터서버 측 스크립트)

복원

└─ Netbackup 복원 수행

└─ restore_notify -> 복원 작업 최종 결과 기준 후처리 (마스터서버 측 스크립트) 
                     해당부분에서 서버 → 클라이언트 SSH/원격 실행 방식으로 처리하려면 키 기반 SSH 설정 필요)
                     특정 복원 작업에 대한 설정은 없으며, 모든 복원 작업의 후처리 시점에 실행하며 특정 policy 조건은 스크립트 내부에서 제어

• 특정 policy나 schedule 적용에 따른 스크립트 명
  *백업
  특정 policy : /usr/openv/netbackup/bin/bpstart_notify.<정책명>
  특정 policy + schedule : /usr/openv/netbackup/bin/bpstart_notify.<정책명>.<스케줄명>
  *복원
  모든 복원 작업 : /usr/openv/netbackup/bin/restore_notify

• 스크립트 작성 주의 및 샘플
  스크립트 작성 시 로그를 파일로 남기고 화면으로 echo 나 stdout 출력하지 않아야하며 인자 검증, 로그 기록, 별도 스크립트 호출만 수행하도록 작성해야함, 사용 가능한 인자는 client, policy, schedule, schedule type 정도로 가상머신 관련 인자는 넘어갈 수 없음

bpstart_notify.ablecube31-1.schedule

#!/bin/sh

CLIENT="$1"
POLICY="$2"
SCHEDULE="$3"
TYPE="$4"

LOG="/var/log/netbackup-cloudstack-hook.log"

# stdout 사용 금지, 파일로만 기록
echo "$(date '+%F %T') START client=$CLIENT policy=$POLICY schedule=$SCHEDULE type=$TYPE" >> "$LOG" 2>&1

# 예시: mold backup 스크립트 파일 생성 (별도 스크립트로 분리 - 해당 스크립트에서 가상머신 백업 관련 처리)
/usr/local/bin/netbackup.sh "$CLIENT" "$POLICY" "$SCHEDULE" >> "$LOG" 2>&1
RC=$?

echo "$(date '+%F %T') PRE rc=$RC" >> "$LOG" 2>&1
exit $RC

• 수동 백업 테스트

1. 호스트의 해당 경로에 스크립트 파일 작성 및 권한 755

/usr/openv/netbackup/bin/bpstart_notify.ablecube31-1.schedule
/usr/openv/netbackup/bin/bpend_notify.ablecube31-1.schedule

2. 마스터 서버에서 수동백업 진행

# /usr/openv/netbackup/bin/bpbackup -i -p ablecube31-1 -s schedule -h ablecube31-1

3. 스크립트 정상동작 확인하여 특정 경로에 생긴 테스트 파일 확인

[Dajeong-Park]

1차 미팅

-NetBackup Windows OS 설치 테스트 필요
-백업 유형은 Incremental 백업 고정 (우선순위로 증분 백업 개발 예정)
-백업 대상은 호스트에 실행중인 모든 가상머신에 대해 고정
-NetBackup에서 복원 시 moldAPI 호출하도록 개발 필요
-Mold 에서는 NetBackup 백업 데이터 조회만 가능하도록 개발 필요