---
title: "Ncloud Tool Kit"
slug: "server-ntk"
tags: ["ncloud tool kit", "server"]
updated: 2026-05-21T09:01:34Z
published: 2026-05-21T09:03:10Z
canonical: "guide-gov.ncloud-docs.com/server-ntk"
---

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

# Ncloud Tool Kit (Linux)

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

          참고

          

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

## NTK 실행

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

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

```
 # XEN/RHV 기반의 서버
 $ dmesg | grep "Hypervisor detected" | awk -F': ' '{print $2}'
 Xen HVM

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

```
$ cd /usr/local/etc
```
3. NTK 파일 압축을 해제해 주십시오.

```
# XEN/RHV 기반의 서버 
$ tar zxvf ntk.tar.gz

# KVM 기반의 서버
$ tar zxvf ntk-kvm.tar.gz
```

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

```
# XEN/RHV 기반의 서버
$ wget -P /usr/local/etc http://init.gov-ncloud.com/server/ntk/linux/xen/ntk.tar.gz

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

```
$ /usr/local/etc/ntk/ntk
```

## NTK 사용

### 메인 화면

![server-ntk-linux](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/server-ntk-linux.png)

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

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

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

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

          참고

          

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

#### 1. EXECUTE MENU

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

| 툴 | 설명 |
| --- | --- |
| SYSTEM CHECKING | VM의 상태를 진단하여 증상 및 원인을 파악하고, 진단 결과 로그를 저장합니다. 내 서버 이미지 생성 전 수행하면 사전 오류를 방지할 수 있습니다. SYSTEM CHECKING 관련한 자세한 내용은 아래의 가이드를 참조해 주십시오. [Linux 서버 상태 진단 가이드 (Classic)](https://guide-gov.ncloud-docs.com/release-20260521/docs/compute-ntk-classic)[Linux 서버 상태 진단 가이드 (VPC)](https://guide-gov.ncloud-docs.com/release-20260521/docs/compute-ntk-vpc) |
| FIO TEST | VM의 디스크를 대상으로 I/O 테스트를 진행하고, 테스트 결과 로그를 저장합니다. FIO TEST 관련한 자세한 내용은 아래의 가이드를 참조해 주십시오. [FIO TEST 가이드 (Classic)](https://guide-gov.ncloud-docs.com/release-20260521/docs/compute-ntk-classic)[FIO TEST 가이드 (VPC)](https://guide-gov.ncloud-docs.com/release-20260521/docs/compute-ntk-vpc) |
| GPU DEBUG COLLECTING | GPU 서버 이용 시 NVIDIA 디버그 로그를 수집하고, 수집 결과 로그를 저장합니다. GPU DEBUG COLLECTING 관련한 자세한 내용은 아래의 가이드를 참조해 주십시오. [GPU DEBUG COLLECTING 가이드 (Classic)](https://guide-gov.ncloud-docs.com/release-20260521/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)](https://guide-gov.ncloud-docs.com/release-20260521/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)](https://guide-gov.ncloud-docs.com/release-20260521/docs/compute-xentoolslinux-classic#ntk-%EB%A5%BC-%ED%99%9C%EC%9A%A9%ED%95%9C-%EC%9E%AC%EC%84%A4%EC%B9%98-%EA%B0%80%EC%9D%B4%EB%93%9C)[Xentools 재설치 가이드 (VPC)](https://guide-gov.ncloud-docs.com/release-20260521/docs/compute-xentoolslinux-vpc#ntk-%EB%A5%BC-%ED%99%9C%EC%9A%A9%ED%95%9C-%EC%9E%AC%EC%84%A4%EC%B9%98-%EA%B0%80%EC%9D%B4%EB%93%9C) |
| BACKUP CHECKING | Backup 상품 이용시 에이전트 설치를 위한 Status와 포트를 점검하고 Backup 에이전트가 정상적으로 설치되지 않을 때 재설치가 가능합니다. BACKUP CHECKING 관련한 자세한 내용은 아래의 가이드를 참조해 주십시오. [BACKUP CHECKING 가이드 (Classic/VPC)](/docs/backup-agent-ntk) |

#### 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.gov-ncloud.com/support/question)가 필요한 경우 해당 URL을 첨부할 수 있습니다.

### 로그 확인

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

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

          참고

          

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