리소스 및 에이전트

Classic/VPC 환경에서 이용 가능합니다.

백업 지원 버전

리소스 생성 및 에이전트 설치

필수 네트워크 정보

백업 에이전트의 설치 및 통신에 필요한 네트워크 정보는 아래와 같습니다.

• Linux 에이전트

  • Classic 환경

    • 에이전트 통신 IP 대역: 10.0.0.0/8
    • 에이전트 백업 통신 포트: 8400~8440
    • 에이전트 설치 포트: 22(SSH)

  • VPC 환경

    • OS/DBMS 에이전트 통신 IP 대역: 169.254.0.0/16
    • OS/DBMS 에이전트 백업 통신 포트: 8400~8440
    • OS/DBMS 에이전트 설치 포트: 22(SSH)

• Windows 에이전트

  • Classic 환경

    • 에이전트 통신 IP 대역: 10.0.0.0/8
    • 에이전트 백업 통신 포트: 135 / 139 / 445 / 24158 / 8400~8440
    • WMI PORT 고정
    • Remote Registry Service 활성화

  • VPC 환경

    • 에이전트 통신 IP 대역: 169.254.0.0/16
    • 에이전트 백업 통신 포트: 135 / 139 / 445 / 24158 / 8400~8440
    • WMI PORT 고정
    • Remote Registry Service 활성화

리소스 생성 전 사전 작업

백업 리소스를 생성하려는 대상 서버가 다음과 같다면, OS 종류에 따라 각각의 사전 작업이 필요합니다.

• 과거 백업 에이전트를 설치한 이력이 있어 에이전트 관련 잔여 파일이 남아 있는 서버
• 백업 에이전트가 설치되어 있는 내 서버 이미지를 기반으로 생성된 서버

Linux 서버 대상

현재 실행 중인 백업 서비스를 종료하고 에이전트 관련 디렉토리를 삭제하는 방법은 다음과 같습니다.

1. 설치된 백업 프로세스를 중지해 주십시오.

   • 명령어: commvault stop -all ()
   • root user 권한으로 수행하며, 만약 명령어가 동작하지 않을 경우 아래 3번 명령을 수행합니다.

   # commvault stop -all
   Redirecting stopping service for Instance001 to systemd ...
   Running "systemctl stop commvault.Instance001.service" ...
   Stopping Commvault services for Instance001 ...
   All services stopped.
   

2. 남아있는 백업 프로세스를 확인해 주십시오.

   • 프로세스: cvlaunchd, cvd, cvfwd, ClMgrS
   • 명령어: ps -ef | grep -i "cvlaunchd|cvd|cvfwd|ClMgrS"
     
     

3. 프로세스를 종료해 주십시오.

   • 명령어: commvault stop -all
   • 만약 명령어가 동작하지 않거나 상기 프로세스가 남아있는 경우 kill 명령어로 "cvlaunchd, cvd, cvfwd, ClMgrS" 프로세스 종료
     
     

4. 백업 에이전트 관련 디렉토리를 삭제해 주십시오.

   • 기본 경로: /opt에 commvault로 시작하는 폴더 ex) /opt/commvault, /opt/commvault1.. 뒤에 숫자가 증가
   • log 경로: /var/log에 commvault로 시작하는 폴더 ex) /opt/commvault, /opt/commvault1.. 뒤에 숫자가 증가
   • Registry 경로: /etc/CommVaultRegistry (폴더 1개만 있음)

Windows 서버 대상

현재 실행 중인 백업 서비스를 종료하고 에이전트 관련 디렉토리를 삭제하는 방법은 다음과 같습니다.

1. 설치된 백업 프로세스를 중지해 주십시오.

   • 윈도우 앱에서 commvault > Commvault Process (프로세스 관리자) 실행
   • 서비스 탭에서 [All Services] 버튼을 클릭한 후 하단의 빨간색 네모를 클릭하여 서비스 중지
     
     

2. 남아있는 프로세스를 확인해 주십시오.

   • 프로세스 탭에서 [Services] 에 남아 있는 프로세스는 백업 관련 프로세스로 마우스 우클릭하여 kill로 종료
     
     

3. 백업 에이전트를 삭제해 주십시오.

   • 윈도우 앱에서 프로그램 및 기능 > 프로그램 제거 또는 변경 실행
   • 하단에 Commvault ContrntStore 선택 후 제거
   • Commvault 제거 프로그램의 제거 옵션 중 인스턴스로의 모든 패키지를 제거합니다 선택 후 제거

리소스 생성

백업 서비스를 이용하려면 가장 먼저 리소스 생성을 해야 합니다.

리소스는 백업을 수행할 서버를 선택하여 백업 리소스로 생성하는 과정으로 리소스를 생성하는 방법은 다음과 같습니다.

1. Backup > Resource 메뉴를 차례대로 클릭해 주십시오.

2. 보유 중인 리소스가 없을 경우 [리소스 생성] 버튼을 클릭해 주십시오.

3. 개인정보 수집 및 이용동의 약관에 동의 후, 및 확인 버튼을 클릭해 주십시오.

4. 리소스 이름을 입력해 주십시오.

   • 영어 소문자, 숫자, 특수문자 '-'를 조합하여 최소 3글자, 최대 30글자로 입력해 주십시오.

5. 존을 선택해 주십시오.

6. 백업할 서버를 선택해 주십시오.

   • VM, BM 중에서 원하는 백업 서버를 선택해 주십시오.

7. (Windows 서버의 경우) 호스트명 입력 및 WMI Port를 설정해 주십시오.

   • 실제 호스트명과 동일해야 백업 에이전트가 정상적으로 설치됩니다. 입력하지 않을 경우 서버 이름과 동일하게 입력됩니다.
   • Windows 사용자 가이드

8. 에이전트 유형을 선택해 주십시오.

   • Data, DB를 선택할 수 있으며 중복 선택할 수 있습니다.
   • Data: OS 영역을 제외한 모든 데이터 영역에 대해 백업을 수행할 수 있습니다.
   • DB: VM에 설치된 DB 영역에 대해 백업을 수행할 수 있습니다. (지원 DB: MSSQL, MySQL, PostgreSQL)
     • 서버가 linux OS인 경우, mssql agent 설치 불가

9. 아이디와 비밀번호를 입력해 주십시오.

   • 에이전트 설치 시 리소스 서버에 접속하기 위한 일회성 로그인 정보입니다. 일회성 로그인 정보는 별도로 저장되지 않습니다.
   • 아이디: 영문, 숫자, 특수문자 '-', '_' 를 조합하여 256자 이내로 입력해 주십시오.
     • DB 에이전트 사용을 위한 계정 요건
       • MSSQL Server User: administrators 그룹에 속해 있어야 하며, sysadmin 권한을 가져야 함(Windows 인증 방식)
       • MySQL Server User: OS admin 권한의 NT or linux 유저와 SA 권한을 가진 유저
       • PostgreSQL Server User: admin 권한을 가진 postgres 유저
   • Linux의 경우
     - root 계정으로 agent를 설치해야 합니다.
     - root 계정 사용 불가 시, 백업 에이전트 설치용 계정에 대해 다음과 같이 설정 후 사용하시면 됩니다. 백업 에이전트 설치 완료 후 부여한 root 권한은 삭제하시기 바랍니다.

   에이전트 설치용으로 사용할 계정: test01 
   [root@backup-linux01 ~]# vi /etc/sudoers 
   ## Allow root to run any commands anywhere 
   root    ALL=(ALL)       ALL 
   test01  ALL=(ALL) NOPASSWD:   ALL
   

   • Windows의 경우
     - administrator 계정을 사용 해야하며 administrator 계정을 사용하지 못할 경우, 에이전트 설치용으로 사용할 계정에 대해 administrator 권한을 부여 하시기 바랍니다.
     - 백업 에이전트 설치 완료 후 administrator 권한은 삭제하시기 바랍니다.

10. [다음] 버튼을 클릭해 주십시오.

11. 리소스 생성을 위한 정보를 최종 확인 후 [리소스 생성] 버튼을 클릭해 주십시오.

    • DB 유형 에이전트를 설치한 경우 리소스 생성 이후 [DB 인스턴스 추가] 버튼을 클릭하여 DB 정보를 추가로 입력해 주십시오.

리소스 및 에이전트 관리

리소스 생성 후 리소스를 선택하면 리소스 상세 정보 확인 및 리소스 관련 다음과 같은 작업을 할 수 있습니다.

• 리소스, 에이전트, DB 인스턴스 상태 확인
• DB 인스턴스 추가, 수정, 삭제
• 에이전트 추가, 재설치, 삭제, 설치 기록 확인
• 리소스 삭제

상태 확인

리소스, 에이전트, DB 인스턴스 상태를 확인할 수 있으며 각 항목별 상태 정보는 다음과 같습니다.

• 리소스: 생성 완료, 생성중, 삭제 중, 설치 중, 재설치 중, 반납 중
• 에이전트: 생성 완료, 설치 중, 삭제 중, 설치 실패
  • 설치 실패 상태일 경우 에이전트 삭제없이 다시 설치
• DB 인스턴스 삭제 : 생성 완료, 생성 중, 삭제 중, 수정 중, 생성 실패, 수정 실패
  • 생성 실패: 인스턴스 생성하며 이슈가 생긴 상태(인스턴스 삭제만 가능)
  • 수정 실패: 인스턴스 수정하며 이슈가 생긴 상태(인스턴스 수정/삭제 가능)

DB 인스턴스 추가

리소스 생성 시 DB 유형 에이전트를 설치한 경우, DB 인스턴스에 대한 추가 설정이 필요하며 방법은 다음과 같습니다.

1. Backup > Resource 메뉴를 차례대로 클릭해 주십시오.
2. 리소스 선택 후 [DB 인스턴스 추가] 버튼을 클릭해 주십시오.
3. DB 솔루션별로 아래의 정보를 입력한 후 [저장] 버튼을 클릭해 주십시오.

• MSSQL
  • DB 인스턴스 이름
    • 영문, 숫자, 특수문자 '-' 를 조합하여 256자 이내로 입력
    • SSMS DB 명과 동일(대소문자 구분 없음)
    • backslash(￦) 허용
  • 정책
    • Backup > Policy의 정책 중에서 선택
  • 아이디
    • 영문, 숫자, 특수문자 '-', '_' 를 조합하여 256자 이내로 입력
    • administrators 그룹에 속해 있어야하며, sysadmin 권한을 가져야 함(Windows 인증방식)
  • 비밀번호
    • 영문, 숫자, 특수 문자를 허용하며, 8자~20자 이내로 입력
  • Data Directory
    • MSSQL > Database Default Location의 Data 경로를 복사하여 Data Directory 항목에 입력

• MySQL
  • DB 인스턴스 이름
    • 영문, 숫자, 특수문자 '-' 를 조합하여 256자 이내로 입력
  • 정책
    • Backup > Policy의 정책 중에서 선택
  • 아이디
    • 영문, 숫자, 특수문자 '-', '_' 를 조합하여 256자 이내로 입력
    • OS admin 권한의 NT or linux 유저와 SA 권한을 가진 유저
  • 비밀번호
    • 영문, 숫자, 특수 문자를 허용하며, 8자~20자 이내로 입력
  • Binary directory
    • MySQL의 실행 파일 경로 예시: /usr/bin/
  • Log directory
    • MySQL의 bin-log 경로 예시: /var/lib/mysql
  • Config file
    • MySQL의 my.cnf 파일 경로 예시: /etc/my.cnf
  • Socket file
    • 서버 OS가 Linux인 경우만 입력 활성화
    • MySQL.sock 파일 경로 예시: /var/lib/mysql/mysql.sock
  • Port
    • 서버 OS가 Windows인 경우만 입력 활성화
    • 1~65535 이내로 입력
  • 추가 사항
    • binary logging 활성화시, 로그 백업 및 증분 백업 가능
• PostgreSQL
  • DB 인스턴스 이름
    • 영문, 숫자, 특수문자 '-'를 조합하여 256자 이내로 입력
  • 정책
    • Backup > Policy의 정책 중에서 선택
  • 아이디
    • 영문, 숫자, 특수문자 '-', '_' 를 조합하여 256자 이내로 입력
    • admin 권한을 가진 postgres 유저
  • 비밀번호
    • 영문, 숫자, 특수 문자를 허용하며, 8자~20자 이내로 입력
  • Maintenance DB
  • Binary directory
  • Library directory
  • Archive log directory
  • Port
    • 1~65535 이내로 입력

DB 인스턴스 수정

설정된 DB 인스턴스 정보를 수정하는 방법은 다음과 같습니다.

1. Backup > Resource 메뉴를 차례대로 클릭해 주십시오.
2. 리소스 선택 후 [DB 인스턴스 수정] 버튼을 클릭해 주십시오.
3. 설정된 값을 수정하고 [저장] 버튼을 클릭해 주십시오

DB 인스턴스 삭제

생성된 DB 인스턴스 정보를 삭제하는 방법은 다음과 같습니다.

1. Backup > Resource 메뉴를 차례대로 클릭해 주십시오.
2. 리소스 선택 후 [DB 인스턴스 삭제] 버튼을 클릭해 주십시오.
   • DB 인스턴스 삭제 시 관련된 모든 값과 백업된 데이터 및 히스토리까지 삭제된다는 내용을 확인하고 [DB 인스턴스 삭제] 버튼을 클릭해 주십시오.

에이전트 추가

최초 설치 이후 에이전트를 추가로 설치할 수 있으며 방법은 다음과 같습니다.

1. Backup > Resource 메뉴를 차례대로 클릭해 주십시오.
2. 리소스 선택 후 [에이전트 관리] > [에이전트 추가] 버튼을 차례대로 클릭해 주십시오.
3. 에이전트 추가 팝업 창에서 에이전트 유형, 아이디, 호스트명 등을 입력하여 에이전트를 추가로 설치해 주십시오.

에이전트 재설치

에이전트 상태 중 설치에 실패했을 경우 에이전트 재설치가 필요하며 방법은 다음과 같습니다.

1. Backup > Resource 메뉴를 차례대로 클릭해 주십시오.
2. 리소스 선택 후 [에이전트 관리] > [에이전트 재설치] 버튼을 차례대로 클릭해 주십시오.
3. 에이전트 재설치 팝업 창에서 에이전트 유형, 아이디, 호스트명 등을 입력하여 에이전트를 추가로 설치해 주십시오.

에이전트 삭제

리소스에 설치된 에이전트를 삭제하는 방법은 다음과 같습니다.

1. Backup > Resource 메뉴를 차례대로 클릭해 주십시오.
2. 리소스 선택 후 [에이전트 관리] > [에이전트 삭제] 버튼을 차례대로 클릭해 주십시오.
3. 에이전트 삭제 팝업 창에서 삭제할 에이전트를 선택 후 [삭제] 버튼을 클릭해 주십시오.
4. 에이전트 삭제 시 관련된 모든 값과 백업된 데이터 및 히스토리까지 삭제된다는 팝업을 확인힌 후 [삭제] 버튼을 클릭해 주십시오.

에이전트 히스토리

리소스에 설치된 에이전트 설치 기록을 확인하는 방법은 다음과 같습니다.

1. Backup > Resource 메뉴를 차례대로 클릭해 주십시오.
2. 리소스 선택 후 [에이전트 관리] > [에이전트 설치 기록] 버튼을 차례대로 클릭해 주십시오.
3. 에이전트 설치 기록 팝업 창에서 아래의 정보를 확인할 수 있습니다.
   • 에이전트 설치/삭제 시작 일시, 작업, 상태, 진행률

리소스 삭제

리소스에 삭제를 하는 방법은 다음과 같습니다.

1. Backup > Resource 메뉴를 차례대로 클릭해 주십시오.
2. 리소스 선택 후 [리소스 삭제] 버튼을 클릭해 주십시오.
3. 삭제 대상 리소스의 이름, OS 정보를 확인한 후 [삭제] 버튼을 클릭해 주십시오.
   • 리소스를 삭제 하기 전에 에이전트(Agent), 작업(Job), 일정(Schedule), 소산 이중화 백업(Remote Backup) 설정 내역이 있으면 리소스 삭제가 실행되지 않습니다. 해당 내역을 모두 삭제한 후 리소스 삭제를 진행해 주십시오.

Windows 사용자 가이드

Windows OS 서버를 사용하여 리소스를 생성하는 경우, 다음과 같은 설정이 필요합니다.

WMI Port 고정 (필수)

1. cmd 창을 관리자 권한으로 실행
2. Windows Management Instrumentation 서비스 자동 실행

   # winmgmt -standalonehost
   

3. Windows Management Instrumentation 서비스 정지 후 재시작

   # net stop Windows Management Instrumentation
   # net start Windows Management Instrumentation
   

4. 윈도우 방화벽 아웃바운드 룰에 24158 포트 오픈 추가

   # netsh firewall add portopening TCP 24158 WMIFixedPort
   

   • 예시
     

ADMIN$ 공유 (옵션)

1. share name에 ADMIN$ 확인

   # net share
   

   • 예시
     

2. ADMIN$ 없는 경우 레지스트리에 추가

   1. regedit 실행 (Registry Editor)
   2. HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\LanmanServer\Parameters 이동
   3. DWORD (32-bit) Value로 AutoShareServer, AutoShareWks 추가
   4. AutoShareServer, AutoShareWks의 Value data 1로 지정
   5. Reboot
      

Remote Registry enable (필수)

1. Services 이동

2. Remote Registry의 Start Type을 Automatic으로 수정
   a. 일부 Windows 서버의 이미지는 Automatic으로 Default 설정되어 있을 수 있음

3. Status Running 확인
   

4. 일정 시간 뒤 Status가 disabled로 변경되지 않도록 Registry 수정
   a. regedit 실행 (Registry Editor)
   b. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\RemoteRegistry 이동
   c. DisableIdleStop의 Value Data 1로 지정

ACG 설정 (필수)

Classic 환경에서 Backup 서비스를 사용하시는 경우, 다음과 같은 설정이 필요합니다.

1. Server > ACG 메뉴를 차례대로 클릭
2. Backup Agent 설치 대상 서버의 ACG를 선택 후 [ACG 설정] 버튼 클릭
3. Inbound 규칙에서 아래 IP에 대해 4개 포트 오픈 정책 추가
   • IP 대역: 10.0.0.0/8
   • 포트: 135 / 139 / 445 / 24158