---
title: "Ncloud Tool Kit"
slug: "server-ntk-lin"
tags: ["Server", "Linux", "ncloud tool kit", "NTK"]
updated: 2026-09-17T09:07:32Z
published: 2026-09-17T09:07:32Z
canonical: "guide.ncloud-docs.com/server-ntk-lin"
---

> ## 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.

# Ncloud Tool Kit (Linux)

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

Linux Ncloud Tool Kit (Linux NTK)는 네이버 클라우드 플랫폼에서 제공하는 Linux VM을 위한 Tool Kit 입니다. 서버의 상태 진단, Disk I/O 테스트, 로그 수집, 시스템 패치 등 다양한 기능을 사용할 수 있습니다. 이를 통해 NCP VM 운영 및 유지보수를 용이하게 하고, NCP VM 이슈 해결을 위한 커뮤니케이션 도구로 활용할 수 있습니다.

          참고

          

- KVM 하이퍼바이저 기반의 Linux VM에서는 NTK의 서버의 상태 진단, 로그 수집 기능만 사용 가능합니다.
- XEN 하이퍼바이저 기반의 Linux VM에서 Fade out 된 서버 이미지에 대해서는 NTK 버전 업그레이드 지원을 종료할 예정입니다. 관련해서 자세한 내용은 [공지사항](https://www.ncloud.com/support/notice/all/1543?page=2)을 참고 부탁드립니다.

## Linux NTK 실행

Linux 서버에서 NTK를 실행하는 방법은 다음과 같습니다.

1. VM이 호스팅되고 있는 하이퍼바이저의 종류를 확인해 주십시오. 하이퍼바이저의 종류에 따라 NTK 압축 파일명과 NTK 파일 다운로드 링크가 상이합니다.

```
 [root@xen-server etc]# dmesg | grep "Hypervisor detected" | awk -F': ' '{print $2}'
 Xen HVM
```

```
[root@kvm-server etc]# dmesg | grep "Hypervisor detected" | awk -F': ' '{print $2}'
KVM
```
  - XEN 기반의 서버
  - KVM 기반의 서버
2. NTK 파일이 위치한 경로로 이동해 주십시오.

```
 [root@xen-server ~]# cd /usr/local/etc
```
3. NTK 파일 압축을 해제해 주십시오.

```
[root@xen-server etc]# tar zxvf ntk.tar.gz
```

```
 [root@kvm-server etc]# tar zxvf ntk-kvm.tar.gz
```

단, ntk.tar.gz 파일이 없거나 해당 파일을 최신 버전으로 교체하려면 우선 파일을 다운로드해 주십시오.

```
[root@xen-server etc]# wget -P /usr/local/etc http://init.ncloud.com/server/ntk/linux/xen/ntk.tar.gz
```

```
[root@kvm-server etc]# wget -P /usr/local/etc http://init.ncloud.com/server/ntk/linux/kvm/ntk-kvm.tar.gz
```
  - XEN 기반의 서버
  - KVM 기반의 서버
  - XEN 기반의 서버
  - KVM 기반의 서버
4. NTK를 실행해 주십시오.

```
[root@xen-server etc]# /usr/local/etc/ntk/ntk
```

## Linux NTK 사용

### 메인 화면

![server-ntk-linux](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/server-ntk-linux.png?sv=2026-02-06&spr=https&st=2026-11-07T01%3A34%3A07Z&se=2026-11-07T02%3A34%3A07Z&sr=c&sp=r&sig=nNrLX9seWobA6x2xHitkLs20vXonmXceMHyGNg1qQhw%3D)

| 영역 | 설명 |
| --- | --- |
| ① 프로그램 명, 버전 표기 | 프로그램 명 및 버전을 확인할 수 있습니다. |
| ② 메뉴 탭 | 사용 가능한 메뉴가 표시됩니다. |
| ③ 액션 탭 | 커서가 위치한 메뉴에 대해 실행 확인 또는 취소할 수 있습니다. |

NTK에서 사용 가능한 키는 다음과 같이 제한되어 있습니다. 원하는 기능을 사용하기 위해 키 사용법을 숙지해 주십시오.

- **[Enter]** 키: 커서가 위치한 항목 선택
- 상하 방향키: 메뉴 간 이동
- **[Tab]** 키/좌우 방향키: 메뉴 영역과 액션 영역 간 이동

NTK에서 사용 가능한 메뉴는 다음과 같습니다.

          참고

          

서버 유형에 따라 표시되는 메뉴가 다를 수 있습니다.

#### 1. EXECUTE MENU

NTK에서 제공하는 주요 툴들을 실행합니다.

| 툴 | 설명 |
| --- | --- |
| SYSTEM CHECKING | VM의 상태를 진단하여 증상 및 원인을 파악하고, 진단 결과 로그를 저장합니다. 내 서버 이미지 생성 전 수행하면 사전 오류를 방지할 수 있습니다. SYSTEM CHECKING 관련한 자세한 내용은 아래의 가이드를 참고해 주십시오. - [Linux 서버 상태 진단 가이드 (Classic)](/docs/server-ts-ntk-lin-classic) - [Linux 서버 상태 진단 가이드 (VPC)](/docs/server-ts-ntk-lin-vpc#linux%EC%84%9C%EB%B2%84%EC%83%81%ED%83%9C%EC%A7%84%EB%8B%A8) |
| FIO TEST | VM의 디스크를 대상으로 I/O 테스트를 진행하고, 테스트 결과 로그를 저장합니다. FIO TEST 관련한 자세한 내용은 아래의 가이드를 참고해 주십시오. - [FIO TEST 가이드 (Classic)](/docs/server-ts-ntk-lin-classic#%EC%8A%A4%ED%86%A0%EB%A6%AC%EC%A7%80IOPS%EC%B8%A1%EC%A0%95) - [FIO TEST 가이드 (VPC)](/docs/server-ts-ntk-lin-vpc#%EC%8A%A4%ED%86%A0%EB%A6%AC%EC%A7%80IOPS%EC%B8%A1%EC%A0%95) |
| GPU DEBUG COLLECTING | GPU 서버 이용 시 NVIDIA 디버그 로그를 수집하고, 수집 결과 로그를 저장합니다. GPU DEBUG COLLECTING 관련한 자세한 내용은 아래의 가이드를 참고해 주십시오. - [GPU DEBUG COLLECTING 가이드 (Classic)](/docs/server-gpuserver-classic#ntk%EB%A5%BC-%ED%86%B5%ED%95%9C-%EC%A7%84%EB%8B%A8-%EB%8D%B0%EC%9D%B4%ED%84%B0-%EC%88%98%EC%A7%91%EC%A0%84%EB%8B%AC-%EB%B0%A9%EB%B2%95) - [GPU DEBUG COLLECTING 가이드 (VPC)](/docs/server-gpuserver-vpc#ntk%EB%A5%BC-%ED%86%B5%ED%95%9C-%EC%A7%84%EB%8B%A8-%EB%8D%B0%EC%9D%B4%ED%84%B0-%EC%88%98%EC%A7%91%EC%A0%84%EB%8B%AC-%EB%B0%A9%EB%B2%95) |
| XENTOOLS | Xentools 재설치를 수행합니다. XENTOOLS 관련한 자세한 내용은 아래의 가이드를 참고해 주십시오. - [Xentools 재설치 가이드 (Classic)](/docs/server-ts-xen-lin-classic#ntk%EB%A5%BC-%ED%99%9C%EC%9A%A9%ED%95%9C-%EC%9E%AC%EC%84%A4%EC%B9%98) - [Xentools 재설치 가이드 (VPC)](/docs/server-ts-xen-lin-vpc#ntk%EB%A5%BC-%ED%99%9C%EC%9A%A9%ED%95%9C-%EC%9E%AC%EC%84%A4%EC%B9%98) |
| BACKUP CHECKING | Backup 상품 이용시 에이전트 설치를 위한 Status와 포트를 점검하고 Backup 에이전트가 정상적으로 설치되지 않을 때 재설치가 가능합니다. BACKUP CHECKING 관련한 자세한 내용은 아래의 가이드를 참고해 주십시오. - [BACKUP CHECKING 가이드 (Classic/VPC)](/docs/backup-agent-ntk) |
| KVM GUEST AGENT | KVM 환경에서 CB2 상품의 스냅샷 서비스를 이용하기 위해 KVM Guest Agent를 점검하고 에이전트가 정상적으로 설치되지 않을 때 재설치가 가능합니다. KVM GUEST AGENT 관련한 자세한 내용은 아래의 가이드를 참고해 주십시오. - [KVM Guest Agent 점검(Linux) 가이드](/docs/kvm-guest-agent-check-linux) |

#### 2. VIEW MENU

EXECUTE에서 툴을 실행한 후, 생성된 로그를 확인하거나 업로드합니다.

| 툴 | 설명 |
| --- | --- |
| SYSTEM CHECKING | SYSTEM CHECKING 로그를 확인합니다. |
| FIO TEST | 디스크 I/O 테스트 로그를 확인합니다. |
| GPU DEBUG COLLECTING | GPU 디버그 로그를 확인합니다. |
| BACKUP CHECKING LOG | BACKUP CHECKING 로그를 확인합니다. |

### 툴 실행

NTK에서 툴을 선택해 실행하는 방법은 다음과 같습니다.

1. NTK 메인 화면에서 **EXECUTE** 메뉴를 선택해 주십시오.
2. 원하는 툴을 선택해 주십시오.
3. 화면의 안내에 따라 작업 시작 여부를 물으면 **[Yes]** 버튼을 클릭해 주십시오.
  - 선택한 작업이 시작됩니다.
4. 작업이 완료되면 화면의 안내에 따라 결과를 확인한 후 **[OK]** 버튼을 클릭해 주십시오.
  - 추가적으로 네이버 클라우드의 기술지원센터로 로그 파일을 전송할 수 있습니다. 화면에서 로그 전송 여부를 물으면 **[Yes]** 버튼을 클릭해 주십시오. 로그가 전송되면, 전송 성공 메시지와 사용자의 로그 저장용 단축 URL이 표시됩니다. [고객 문의](https://www.ncloud.com/support/question)가 필요한 경우 단축 URL을 첨부할 수 있습니다.

### 로그 확인

툴을 실행하여 생성된 로그를 확인하는 방법은 다음과 같습니다.

1. NTK 메인 화면에서 **VIEW** 메뉴를 선택해 주십시오.
2. 원하는 로그 종류 및 파일을 선택해 주십시오.
  - VM 진단 로그의 경우, 로그 전체(full log)를 확인할지 문제가 있는 로그 일부(NOK log)만 확인할지 선택해 주십시오.
3. 로그를 확인한 후 **[OK]** 버튼을 클릭해 주십시오.
4. 로그 전송 여부를 선택해 주십시오.
  - **[Yes]** 버튼 클릭 시 로그가 네이버 클라우드의 기술지원센터로 전송됩니다. 전송 후에는 전송 성공 메시지와 사용자의 로그 저장용 단축 URL이 표시됩니다. [고객 문의](https://www.ncloud.com/support/question)가 필요한 경우 단축 URL을 첨부할 수 있습니다.

          참고

          

네트워크 오류로 인해 로그가 정상적으로 전송되지 않으면 VM에 저장된 파일을 첨부해서 [고객 문의](https://www.ncloud.com/support/question)로 전달할 수 있습니다. 파일은 `/usr/local/etc/ntk/logs/` 하위에 있습니다.