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 백업 데이터 조회만 가능하도록 개발 필요

[Dajeong-Park]

Linux OS install 10.5v

Netback 마스터 노드 설치

    1  ll
    2  fdisk -l
    3  mkdir /backup
    4  fdisk /dev/sdb
    5  pvcreate /dev/sdb1
    6  vgcreate data_vg /dev/sdb1
    7  lvcreate -l 100%FREE -n data_lv data_vg
    8  mkfs.xfs /dev/data_vg/data_lv
    9  mount /dev/data_vg/data_lv /backup
   10  cd /backup
   11  ll
   12  cd
   13  ll
   14  mount /dev/data_vg/data_lv /backup
   15  cd /
   16  ll
   17  rm -rf backup
   18  ll
   19  cd
   20  ll
   21  mkdir /usr/openv
   22  cd /usr/openv
   23  ll
   24  mkdir dj
   25  cd
   26  mount /dev/data_vg/data_lv /usr/openv/dj
   27  lsblk -f
   28  dmesg -T | egrep -i 'EUCLEAN|xfs|ext4|corrupt|I/O error' | tail -n 80
   29  xfs_repair -n /dev/data_vg/data_lv
   30  xfs_repair -L /dev/data_vg/data_lv
   31  mount /dev/data_vg/data_lv /usr/openv/dj
   32  hostname
   33  hostnamectl set-hostname netbackup
   34  ulimit -n 10000
   35  groupadd nbwebgrp
   36  useradd -g nbwebgrp nbwebsvc
   37  groupadd nbsvcgrp
   38  useradd -g nbsvcgrp -G nbwebgrp -m -s /bin/bash nbsvc
   39  passwd nbsvc
   40  firewall-cmd --permanent --zone=public --add-port=1556/tcp
   41  firewall-cmd --permanent --zone=public --add-port=13724/tcp
   42  firewall-cmd --permanent --zone=public --add-port=13782/tcp
   43  firewall-cmd --permanent --zone=public --add-port=10082/tcp
   44  firewall-cmd --permanent --zone=public --add-port=10102/tcp
   45  firewall-cmd --permanent --zone=public --add-port=902/tcp
   46  firewall-cmd --permanent --zone=public --add-port=443/tcp
   47  firewall-cmd --permanent --zone=public --add-port=8443/tcp
   48  firewall-cmd --permanent --zone=public --add-port=80/tcp
   49  firewall-cmd --reload
   50  cd /usr/openv/
   51  ll
   52  mkdir install
   53  cd install/
   54  dnf -y install wget tar
   55  wget https://download.ablecloud.io/OS-ISO/Etc_OS/NetBackup_10.5_LinuxR_x86_64.tar.gz --username support@ablecloud.io --password Ablecloud1!
   56  wget https://download.ablecloud.io/OS-ISO/Etc_OS/NetBackup_10.5_LinuxR_x86_64.tar.gz --user support@ablecloud.io --password Ablecloud1!
   57  wget https://download.ablecloud.io/OS-ISO/Etc_OS/A9257164704_QTY25_NBU_10_5_COMPLETE_ED_FLEX_LIC_6062734399.slf --user support@ablecloud.io --password Ablecloud1!
   58  ll
   59  chmod 755 A9257164704_QTY25_NBU_10_5_COMPLETE_ED_FLEX_LIC_6062734399.slf
   60  tar -xvf NetBackup_10.5_LinuxR_x86_64.tar.gz
   61  ulimit -a
   62  vi /etc/hosts
   63  ll
   64  cd NetBackup_10.5_LinuxR_x86_64
   65  ./install
   66  vi /etc/sysconfig/selinux
   67  reboot
   68  ulimit -a
   69  ulimit -n 10000
   70  ulimit -a
   71  cd /usr/openv/
   72  ll
   73  cd install/
   74  ll
   75  cd NetBackup_10.5_LinuxR_x86_64
   76  ll
   77  ./install
   78  /usr/openv/netbackup/bin/bpps -x
   79  /usr/openv/netbackup/bin/bpclntcmd -self
   80  df -h
   81  df -Th
   82  mount /dev/data_vg/data_lv /usr/openv/dj
   83  df -Th
   84  vi /etc/fstab
   85  /usr/openv/netbackup/bin/bpps -x | grep -i web
   86  ss -ntlp | grep 1556
   87  firewall-cmd --list-ports
   88  hostname -f
   89  /usr/openv/netbackup/bin/admincmd/bpnbaz -ListUsers
   90  /usr/openv/netbackup/bin/admincmd/bpnbaz -ListGroups
   91  /usr/openv/netbackup/bin/bpps -x | grep -i web
   92  /usr/openv/netbackup/bin/admincmd/nbcertcmd -listCACertDetails
   93  /usr/openv/netbackup/bin/admincmd/nbcertcmd -getCACertificate
   94  hostname -f
   95  ss -ntlp | grep 1556
   96  /usr/openv/netbackup/bin/bpps -x | grep -i web
   97  /usr/openv/netbackup/bin/admincmd/bpnbaz -SetupMaster
   98  /usr/openv/netbackup/bin/bp.restart_all
   99  /usr/openv/netbackup/bin/bp.kill_all
  100  /usr/openv/netbackup/bin/bp.start_all
  101  /usr/openv/netbackup/bin/admincmd/bpnbaz -ListUsers
  102  /usr/openv/netbackup/bin/admincmd/bpnbaz -AddUser root -Role Administrator
  103  /usr/openv/netbackup/bin/admincmd/bpnbaz -SetupMaster -fsa UNIX:root
  104  /usr/openv/netbackup/bin/admincmd/bpnbaz -SetupMaster -fsa root
  105  /usr/openv/netbackup/bin/bp.kill_all
  106  /usr/openv/netbackup/bin/bp.start_all
  107  /usr/openv/netbackup/bin/admincmd/bpnbaz -ListUsers
  108  tail -n 100 /usr/openv/wmc/webserver/logs/catalina.out
  109  tail -n 100 /usr/openv/wmc/webserver/logs/localhost*.log
  110  /usr/openv/netbackup/bin/admincmd/nbcertcmd -getCertificate -host netbackup | egrep -i 'Subject|DNS|IP|SAN'
  111  cd /usr/openv/netbackup/bin/admincmd/
  112  ll
  113  cat /usr/openv/netbackup/bp.conf
  114  history
  115  df -Th
  116  cd /usr/openv
  117  ll
  118  chown -R nbsvc:nbsvcgrp /dj
  119  chown -R nbsvc:nbsvcgrp dj
  120  chmod 750 dj

Windows-server 2022 OS install 10.5v

Netback 마스터 노드 설치

1. 사용자 생성 net user nbwebsvc Ablecloud2026! /add 
2. 그룹 생성 net localgroup nbwebgrp /add 
3. 그룹에 사용자 추가 net localgroup nbwebgrp nbwebsvc /add
3. 권한 추가 secpol.msc : Local Policies → User Rights Assignment → Log on as a service nbwebsvc, nbwebgrp 추가
4. User Account Control Settings Nerver notify 변경
5. 관리자 권한으로 powershell 실행 : New-ItemProperty -Path HKLM:Software\Microsoft\Windows\CurrentVersion\policies\system -Name EnableLUA -PropertyType DWord -Value 0 -Force
6. 방화벽 설정
netsh advfirewall firewall add rule name="NetBackup 443" dir=in action=allow protocol=TCP localport=443
netsh advfirewall firewall add rule name="NetBackup 1556" dir=in action=allow protocol=TCP localport=1556
netsh advfirewall firewall add rule name="NetBackup 13724" dir=in action=allow protocol=TCP localport=13724
7. hostname 변경 (netbackup)

[Dajeong-Park]

NetBackup Policy Script 기반 백업 및 복원을 위한 설정 및 메커니즘

Step 1) Ablestack Host에 NetBackup 클라이언트 수동 설치

Step 2) NetBackup WebUI 에서 호스트 별 정책 및 스케줄 생성 (백업 시간 호스트 별로 다르게 설정해야 함)

주의 : NetBackup WebUI 에서 정책 생성 시 Allow multiple data streams 해제 필수, Maximum jobs per client = 1 default 값 유지

Step 3) Ablestack Host 에서 netbackup_config.sh 파일 실행

1. 특정 policy의 모든 스케줄 / 특정 policy의 특정 스케줄 선택하여 적용 범위 선택
2. 필요 파라미터 받음

특정 policy의 모든 스케줄의 경우 : policy_name, vm_include, vm_exclude, max_incremental_chain, mold_url, admin_key, admin_secretkey
특정 policy의 특정 스케줄의 경우 : policy_name, schedule_name, vm_include, vm_exclude, max_incremental_chain, mold_url, admin_apikey, admin_secretkey

- policy_name : netbackup의 정책 명
- vm_include 와 vm_exclude : 기본은 실행중인 모든 가상머신 적용이며 VM_INCLUDE="*" VM_EXCLUDE="" 입력, 변경할 경우 libvirt domain name (i-2-3-VM)형식으로 콤마와 함께 구분하여 작성
- max_incremental_chain : 증분 최대 체인 수 설정
- mold_url : mold API 호출 시 사용 http://<moldIP>:8080/client/api 형식으로 입력
- admin_apikey : mold API 호출 시 사용
- admin_secretkey : mold API 호출 시 사용 (암호화용 passphrase 2번 입력)

3. 샘플 파일 복사하여 호스트의 특정 경로에 저장

특정 policy의 모든 스케줄의 경우

/usr/openv/netbackup/bin/bpstart_notify.<POLICY_NAME>
/usr/openv/netbackup/bin/bpend_notify.<POLICY_NAME>
/etc/ablestack/netbackup/<POLICY_NAME>.conf

특정 policy의 특정 스케줄의 경우

/usr/openv/netbackup/bin/bpstart_notify.<POLICY_NAME>.<SCHEDULE_NAME>
/usr/openv/netbackup/bin/bpend_notify.<POLICY_NAME>.<SCHEDULE_NAME>
/etc/ablestack/netbackup/<POLICY_NAME>.<SCHEDULE_NAME>.conf

4. ADMIN_SECRETKEY는 평문으로 저장하지 않고 암호화해서 저장
   /etc/ablestack/netbackup/secrets/secret.enc

5. /usr/openv/netbackup/bp.conf 파일 수정 후 netbackup 서비스 재시작

BPSTART_TIMEOUT = 14400 (bpstart_notify 최대 허용 실행시간)
BPEND_TIMEOUT = 3600
CLIENT_READ_TIMEOUT = 21600
CLIENT_CONNECT_TIMEOUT = 1800
SERVER_CONNECT_TIMEOUT = 1800