---
title: "에이전트 문제"
slug: "backup-troubleshoot-agent"
updated: 2026-09-17T09:08:22Z
published: 2026-09-17T09:08:22Z
canonical: "guide.ncloud-docs.com/backup-troubleshoot-agent"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트 문제

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

Backup 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오.

## 에이전트 설치 실패

백업 리소스를 생성하는 중에 에이전트 설치에 실패했습니다.

#### 원인

- 백업 리소스를 생성하기 전에 수행해야 하는 사전 작업을 수행하지 않았습니다.
- 계정, 패스워드, 권한에 문제가 있습니다.
- 통신 설정에 문제가 있습니다.
- 파일 경로에 문제가 있습니다.
- 백업 프로세스에 문제가 있습니다.

#### 해결 방법

**사전 작업 수행** 백업 리소스를 생성하기 전에 수행해야 하는 작업이 있습니다. 자세한 내용은 [사전 작업](/docs/backup-advance)을 참조해 주십시오.

**NTK (Ncloud Tool Kit) 실행** Linux 환경인 경우, [에이전트 점검](/docs/backup-agent-ntk)을 참조해 주십시오.

**계정, 패스워드, 권한 확인**

- 입력한 계정과 비밀번호에 오타가 없는지 확인해 주십시오.
- Linux 환경인 경우, root 계정을 이용할 것을 권고합니다. 일반 계정 사용 시 root 권한이 있는지 확인해 주십시오.
- Windows 환경인 경우, administrator 계정을 이용할 것을 권고합니다. 일반 계정 사용 시 administrator 권한이 있는지 확인해 주십시오.

**통신 설정 확인**

- 백업 에이전트 설치 및 통신을 위한 네트워크 통신이 허용되어 있는지 확인해 주십시오.
- ACG와 OS 내부 설정 확인을 통해 백업 통신이 허용되었는지 확인해 주십시오.
  - Linux 에이전트

          참고

          

SSH 포트를 변경할 경우, 에이전트를 설치할 수 없습니다.
    - 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 에이전트

          참고

          

WMI Port, Remote Registry Service 설정이 완료되어야 에이전트를 설치할 수 있습니다.
    - Classic 환경
      - 에이전트 통신 IP 대역: 10.0.0.0/8
      - 에이전트 백업 통신 포트: 135 / 139 / 445 / 24158 / 8400~8440
      - WMI PORT 고정
      - Remote Registry Service 활성화
      - ADMIN$ 공유
    - VPC 환경
      - 에이전트 통신 IP 대역: 169.254.0.0/16
      - 에이전트 백업 통신 포트 : 135 / 139 / 445 / 24158 / 8400~8440
      - WMI PORT 고정
      - Remote Registry Service 활성화
      - ADMIN$ 공유

**DB 인스턴스 파일 경로 점검** DB 에이전트를 설치한 경우, DB 인스턴스에 대한 추가 설정이 필요합니다. 파일 경로가 올바른지 확인해 주십시오.

- MSSQL

          참고

          

MSSQL에서 Data Director 내용을 확인하는 방법은 [DB 인스턴스 추가 > MSSQL](/docs/backup-db)을 참조해 주십시오.
  - Data Directory: MSSQL > Database Default Location의 "Data" 경로를 복사하여 입력해 주십시오.
- MySQL
  - Binary Directory: MySQL의 실행 파일 경로 (예시: /usr/bin/)
  - Log Data Directory: bin-log 경로 (예시: /var/lib/mysql)
  - Config File: my.cnf 파일 경로 (예시: /etc/my.cnf)
  - Socket File: MySQL.sock 파일 경로 (예시: /var/lib/mysql/mysql.sock)
- PostgreSQL  

별도의 경로 설정이 필요하지 않습니다.

**백업 프로세스 점검** 백업 프로세스가 정상적으로 실행되고 있는지 확인해 주십시오.

- Linux 에이전트 `commvault list` 입력 시 결과값 내 PID 값이 N/A로 표시될 경우, `commvault start` 명령어를 실행해 주십시오.
- Windows 에이전트 관리자 권한으로 PowerShell 실행하여 `Get-Service -Name Gx*` 입력 시 결괏값 내 Status 값이 Stopped로 표시될 경우, 다음 명령어를 순차적으로 실행해 주십시오.

```
Start-Service -Name "GxClMgrSD(Instance001)"
Start-Service -Name "GxFWD(Instance001)"
Start-Service -Name "GxCVD(Instance001)"
```

## cannot execute binary file 오류 메시지

Managed Backup Agent 설치 시 "cannot execute binary file" 오류 메시지가 나타납니다.

#### 원인

32bit OS와의 호환성 문제일 가능성이 높습니다.

#### 해결 방법

32bit OS를 사용 중인 경우, 네이버 클라우드 포털의 [**고객 지원** > **자료**](https://www.ncloud.com/support/library) 메뉴에서 **Backup** 파일을 참고해 주십시오.

## 에이전트 삭제 중 상태 유지

에이전트 삭제 중 상태가 유지됩니다.

#### 원인

- 계정, 패스워드 정보가 잘못 입력되었습니다.
- root 권한이 없습니다.
- 에이전트에 오류가 있습니다.

#### 해결 방법

**계정/패스워드 정보 확인** 계정 및 패스워드를 정확하게 입력했는지 확인해 주십시오.

**root 권한 확인** 에이전트 삭제 시 root 권한이 부여되어 있는지 확인해 주십시오.

1. 에이전트를 설치한 네이버 클라우드 플랫폼 계정으로 서비스를 중지해 주십시오.

```
#commvault stop
```
2. 경로 권한을 root 로 변경해 주십시오.

```
chown -R root:root root_directory
/home1/ncloud/commvault
/home1/ncloud/CommVaultRegistry
```
3. root 계정으로 서비스를 시작해 주십시오.

```
#/home1/ncloud/commvault/Base/commvault start
```
4. 다음 명령어를 입력한 후, 화면을 캡처하여 고객지원으로 전달해 주십시오.

```
commvault list
commvault status
commvault start
```
  - 삭제하는 과정에서 에이전트가 정상적으로 동작하는지 확인하기 위한 단계입니다.

          참고

          

이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.