---
title: "에이전트 문제"
slug: "backup-troubleshoot-agent"
tags: ["Backup", "문제 해결", "에이전트"]
updated: 2026-07-23T09:03:01Z
published: 2026-07-23T09:03:01Z
canonical: "guide-fin.ncloud-docs.com/backup-troubleshoot-agent"
---

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

# 에이전트 문제

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

## 에이전트 설치 실패

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

#### 원인

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

#### 해결 방법

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

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

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

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

**통신 설정 확인**

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

          참고

          

SSH 포트를 변경할 경우, 에이전트를 설치할 수 없습니다.
    - OS/DBMS 에이전트 통신 IP 대역: 169.254.0.0/16
    - OS/DBMS 에이전트 백업 통신 포트: 8400~8440
    - OS/DBMS 에이전트 설치 포트: 22(SSH)
  - Windows 에이전트

          참고

          

WMI Port, Remote Registry Service 설정이 완료되어야 에이전트를 설치할 수 있습니다.
    - 에이전트 통신 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.fin-ncloud.com/support/library) 메뉴에서 **Backup** 파일을 참고해 주십시오.

          참고

          

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