Jetson AGX Orin Ubuntu 22.04 설치 안내서
1. 서론: 개요 및 사전 준비
1.1 프로세스 요약
본 문서는 Ubuntu 22.04 LTS (x86_64) 운영체제를 사용하는 호스트 PC에서 NVIDIA SDK Manager를 활용하여 Jetson AGX Orin 개발자 키트에 JetPack 6.x 버전을 설치하는 전 과정을 상세히 기술한다. 이 과정은 Jetson AGX Orin의 내장 저장소(eMMC)에 Ubuntu 22.04 기반의 L4T(Linux for Tegra) 운영체제를 플래싱(Flashing)하고, CUDA, cuDNN, TensorRT를 포함한 핵심 개발자 SDK 컴포넌트를 설치하는 작업을 포함한다.1 이 가이드는 공식 문서와 개발자 커뮤니티의 실질적인 경험을 통합하여, 설치 과정에서 발생할 수 있는 잠재적 문제점을 사전에 방지하고 신속하게 해결하는 것을 목표로 한다.
1.2 필수 시스템 요구사항
설치를 시작하기 전에 호스트 PC와 대상 장치가 다음 요구사항을 충족하는지 반드시 확인해야 한다. 요구사항 미충족은 설치 실패의 주요 원인이 될 수 있다.
호스트 PC 요구사항:
-
운영체제: Ubuntu Desktop 22.04 LTS (x86_64). 공식적으로 18.04 및 20.04 버전도 지원되나, 본 문서는 22.04 환경에 초점을 맞춘다.3
-
메모리(RAM): 최소 8GB가 필요하다.4
-
저장 공간: 공식 문서에서는 최소 27GB(호스트)와 16GB(타겟)의 여유 공간을 요구한다.4 하지만 이는 실제 설치 과정에서 필요한 공간을 과소평가한 수치이다. 플래싱 과정은 단순히 파일을 복사하는 것을 넘어, 압축된 루트 파일 시스템(rootfs)을 해제하고, 이를 기반으로 파티션 전체 크기에 해당하는 거대한 원시 이미지 파일(
system.img.raw)을 생성한 뒤, 최종 이미지로 변환하는 복잡한 단계를 포함한다. 이 과정에서 상당한 양의 임시 공간이 소모되므로, 공식 요구사항만으로는 공간 부족 오류가 발생할 가능성이 매우 높다.6 따라서 안정적인 설치를 위해
최소 65GB 이상의 여유 공간 확보를 강력히 권장한다.8
대상 장치(Target Device):
- NVIDIA Jetson AGX Orin 개발자 키트 (32GB 또는 64GB 모델).4
네트워크:
- SDK Manager가 필요한 모든 패키지를 NVIDIA 서버로부터 다운로드하기 위해 안정적인 인터넷 연결이 필수적이다.4
1.3 필수 계정 및 하드웨어
- NVIDIA 개발자 계정: SDK Manager를 다운로드하고 로그인하기 위해 NVIDIA 개발자 프로그램 멤버십 계정이 반드시 필요하다. 계정이 없다면 설치 시작 전에 미리 생성해야 한다.9
- USB 케이블: 호스트 PC와 Jetson AGX Orin을 연결하기 위한 USB Type-A to Type-C 케이블이 필요하다. Jetson AGX Orin 개발자 키트에 동봉된 정품 케이블 사용을 권장한다.3
- 전원 공급 장치: Jetson AGX Orin 개발자 키트에 포함된 정품 USB Type-C 전원 어댑터를 사용하여 안정적인 전원을 공급해야 한다.13
표 1: 시스템 요구사항 요약
| 항목 | 호스트 PC | 대상 장치(Jetson AGX Orin) |
|---|---|---|
| 운영체제 | Ubuntu Desktop 22.04 LTS | Ubuntu 22.04 기반 L4T (JetPack 6.x) |
| 아키텍처 | x86_64 | aarch64 |
| 메모리(RAM) | 최소 8GB | 32GB 또는 64GB |
| 디스크 공간(공식 최소) | 27GB | 16GB |
| 디스크 공간(실제 권장) | 65GB 이상 | - |
| 필수 하드웨어 | 인터넷 연결 | USB Type-A to Type-C 케이블, 전원 어댑터 |
| 필수 계정 | NVIDIA 개발자 계정 | - |
2. 단계: 호스트 PC에 NVIDIA SDK Manager 설치
2.1 SDK Manager 다운로드
먼저 호스트 PC에 SDK Manager를 설치해야 한다.
- 웹 브라우저를 통해 NVIDIA SDK Manager 공식 다운로드 페이지(developer.nvidia.com/sdk-manager)에에) 접속한다.1
- 페이지에 접속하면 NVIDIA 개발자 계정으로 로그인하라는 메시지가 나타난다. 준비된 계정으로 로그인한다.
- 로그인 후, 호스트 운영체제인 Ubuntu에 맞는
.deb패키지를 다운로드한다. 파일명은sdkmanager_[version]-[build#]_amd64.deb와 같은 형식을 가진다.10
2.2 설치 및 실행
다운로드가 완료되면 다음 절차에 따라 설치를 진행한다.
-
터미널을 열고
.deb파일이 다운로드된 디렉터리로 이동한다. 일반적으로~/Downloads디렉터리이다. -
다음 명령어를 실행하여 패키지를 설치한다. 파일명은 다운로드한 버전에 맞게 자동으로 인식되도록 와일드카드(
*)를 사용할 수 있다.1
sudo apt install./sdkmanager_*.deb
- 설치가 완료되면 Ubuntu의 애플리케이션 런처에서 ’NVIDIA SDK Manager’를 찾아 실행하거나, 터미널에서 다음 명령어를 입력하여 실행할 수 있다.1
sdkmanager
- 최초 실행 시, SDK Manager는 로그인 창을 표시한다. ‘NVIDIA DEVELOPER’ 탭이 선택된 상태에서 ‘LOGIN’ 버튼을 클릭하면 웹 브라우저가 열린다. 웹 페이지에서 계정 인증을 완료하면 SDK Manager 애플리케이션이 자동으로 로그인 상태로 전환된다.3 QR 코드를 스캔하여 다른 기기에서 로그인하는 방식도 지원된다.14
한편, 일회성 설치가 아닌 장기적인 유지보수 관점에서는 시스템의 APT 저장소를 통해 SDK Manager를 설치하는 것이 더 효율적일 수 있다. 이 방법은 CUDA 저장소 키링을 시스템에 추가하고 sudo apt install sdkmanager 명령으로 설치하는 방식이다.1 이렇게 설치하면 향후 sudo apt update && sudo apt upgrade 명령을 통해 다른 시스템 패키지와 함께 SDK Manager를 최신 버전으로 손쉽게 관리할 수 있다는 장점이 있다.
3. 단계: Jetson AGX Orin 강제 복구 모드(Force Recovery Mode) 진입
Jetson AGX Orin에 새로운 운영체제를 플래싱하기 위해서는 장치를 ’강제 복구 모드’로 설정해야 한다. 이 모드는 부트로더(Bootloader)가 외부 USB 연결을 통해 플래싱 명령을 받아들일 수 있도록 하는 특수 상태이다.
3.1 하드웨어 연결
- Jetson AGX Orin의 전원이 완전히 꺼진 상태인지 확인한다. 전원 케이블이 연결되어 있다면 분리한다.12
- 호스트 PC의 USB-A 포트와 Jetson AGX Orin의 플래싱 전용 USB Type-C 포트를 준비된 케이블로 연결한다. 이 포트는 보드의 40핀 헤더 옆에 위치하며, 전원 공급용 USB-C 포트와는 다르므로 혼동하지 않도록 각별히 주의해야 한다.3
3.2 버튼 조합 절차
강제 복구 모드 진입 절차는 장치의 현재 전원 상태에 따라 달라진다. 이는 복구 버튼을 누른 상태에서 시스템에 리셋 신호(전원 인가 또는 리셋 버튼)를 가하여 부트롬(BootROM)이 복구 모드로 진입하도록 유도하는 원리에 기반한다.
- 장치 전원이 꺼져 있을 경우:
- 가운데에 위치한 강제 복구(Force Recovery) 버튼을 누른 상태를 유지한다.18
- 그 상태에서 전원(Power) 버튼을 한 번 눌러 장치를 켠다. 이후 모든 버튼에서 손을 뗀다.19
- 장치 전원이 이미 켜져 있을 경우:
- 강제 복구(Force Recovery) 버튼을 누른 상태를 유지한다.18
- 그 상태에서 리셋(Reset) 버튼을 한 번 눌렀다 뗀다.12
- 이후 강제 복구 버튼에서 손을 뗀다.
3.3 상태 확인
모드 진입이 성공했는지 확인하기 위해 호스트 PC의 터미널에서 다음 명령어를 실행한다.12
lsusb
출력된 USB 장치 목록 중에 ID 0955:7023 NVidia Corp.라는 항목이 보이면 성공적으로 강제 복구 모드에 진입한 것이다.12 만약 이 장치가 보이지 않는다면, USB 케이블 연결 상태와 위의 버튼 조합 절차를 다시 한번 신중하게 반복해야 한다.
4. 단계: SDK Manager를 이용한 Jetson OS 플래싱
이제 SDK Manager를 사용하여 Jetson AGX Orin에 운영체제를 설치할 준비가 되었다. 이 단계에서는 OS 설치와 SDK 컴포넌트 설치를 의도적으로 분리하여 진행한다. 이는 두 작업의 성격이 근본적으로 다르기 때문이다. OS 플래싱은 USB 연결과 복구 모드에 의존하는 저수준(low-level) 하드웨어 작업인 반면, SDK 컴포넌트 설치는 부팅된 OS 위에서 네트워크와 패키지 관리자를 사용하는 고수준(high-level) 소프트웨어 작업이다. 두 작업을 분리하면 문제 발생 시 원인을 명확히 진단하고 디버깅 시간을 획기적으로 단축할 수 있다.
4.1 개발 환경 설정 (STEP 01)
- SDK Manager를 실행하고 로그인하면 ‘STEP 01: Development Environment’ 화면이 나타난다.
- Product Category: ’Jetson’을 선택한다.3
- Hardware Configuration:
- ‘Host Machine’ 항목의 체크박스는 해제한다. 이는 호스트 PC에 CUDA 등의 개발 환경을 설치하지 않고, 오직 Jetson 플래싱 작업에만 집중하기 위함이다.
- ‘Target Hardware’ 드롭다운 메뉴에서 ‘Jetson AGX Orin’ 관련 모듈을 선택한다. 앞서 강제 복구 모드로 장치를 연결했다면, SDK Manager가 자동으로 해당 장치를 감지하여 목록에 표시해준다.3
- Target Operating System: ’Linux’를 선택한다.
- SDK Version: 설치하고자 하는 JetPack 버전을 선택한다. Jetson AGX Orin에 Ubuntu 22.04 기반의 L4T를 설치하기 위해서는 반드시 JetPack 6.0 이상 버전을 선택해야 한다.1
4.2 컴포넌트 선택 및 라이선스 동의 (STEP 02)
- ’Continue’를 클릭하여 ‘STEP 02: Details and License’ 화면으로 이동한다.
- 설치할 컴포넌트 목록이 표시된다. 여기서는 OS 플래싱에만 집중하기 위해 ’Jetson OS’만 선택하고, ‘Jetson SDK Components’ 항목의 체크박스는 모두 해제한다. 이 전략은 설치 과정의 안정성을 높이고 문제 해결을 용이하게 하는 핵심적인 모범 사례(Best Practice)이다.3
- 화면 하단의 라이선스 동의 체크박스를 활성화한 후 ’Continue’를 클릭한다.
4.3 플래싱 실행 및 옵션 분석 (STEP 03)
- ’Continue’를 클릭하면 SDK Manager가 필요한 파일들을 다운로드하고 플래싱에 필요한 OS 이미지를 생성한다. 이 과정이 완료되면 플래싱 옵션을 설정하는 팝업창이 나타난다.3
- 팝업창에서 다음 옵션들을 설정한다.
- Flashing Mode (설정 1): ’Manual Setup’을 선택한다. 이는 사용자가 2단계에서 직접 장치를 복구 모드로 설정한 방식과 일치하며, 가장 안정적이고 확실한 방법이다.17 ’Automatic Setup’은 이미 정상적으로 부팅된 장치를 원격으로 재부팅시키는 방식이므로 초기 플래싱에는 적합하지 않다.21
- OEM Configuration (설정 7): ’Runtime’을 선택한다. 이 옵션은 플래싱 후 Jetson이 처음 부팅될 때, 사용자가 직접 언어, 사용자 계정, 네트워크 등을 설정하도록 하는 표준 방식이다. 유연성이 높아 대부분의 경우에 권장된다.17 ’Pre-Config’는 SDK Manager에서 미리 사용자 정보를 입력하여 초기 설정 과정을 자동화하는 방식으로, 주로 다수의 장비를 동일하게 설정하는 무인 배포 환경에 유용하다.
- Storage Device (설정 8): OS를 설치할 저장 장치를 선택한다. Jetson AGX Orin 개발자 키트의 경우 내장 메모리인 eMMC를 선택한다.3
- 모든 설정을 확인한 후 ‘Flash’ 버튼을 클릭하여 플래싱을 시작한다. 진행 상황은 SDK Manager의 터미널 탭에서 상세하게 확인할 수 있다.
5. 단계: Jetson AGX Orin 초기 시스템 설정 (OEM-Config)
플래싱이 성공적으로 완료되면 Jetson AGX Orin은 자동으로 재부팅되며, 사용자는 시스템의 기본 설정을 완료해야 한다. 이 OEM-Config 과정은 단순히 사용자 계정을 만드는 것을 넘어, 시스템의 기본 파티션과 nvpmodel 같은 하드웨어 관련 설정을 최종적으로 확정하는 중요한 단계이다.18
5.1 최초 부팅 및 GUI 설정
- 플래싱이 완료되면 Jetson AGX Orin의 DisplayPort에 모니터를 연결하고, USB-A 포트에 키보드와 마우스를 연결한다.13
- 장치가 부팅되면 화면에 Ubuntu 설정 마법사(oem-config)가 나타난다. 화면의 지시에 따라 다음 항목들을 순서대로 설정한다 13:
- NVIDIA 소프트웨어 최종 사용자 라이선스 계약(EULA) 검토 및 동의
- 시스템 언어, 키보드 레이아웃, 시간대 선택
- 사용자 이름, 컴퓨터 이름, 그리고 로그인에 사용할 암호 생성
- 유선 또는 무선 네트워크 연결 설정 (필요시)
- 모든 설정이 완료되면 시스템이 재부팅되고, 방금 생성한 계정으로 로그인할 수 있는 Ubuntu 데스크톱 화면이 나타난다.
5.2 헤드리스(Headless) 설정
모니터, 키보드, 마우스 없이 설정을 진행해야 하는 경우, 헤드리스 모드를 사용할 수 있다.13
-
주의: 이 방법을 사용하려면 Jetson의 DisplayPort에 아무것도 연결되어 있지 않아야 한다. 디스플레이가 연결되면 설정 세션이 그래픽 환경으로 강제 전환되어 헤드리스 설정이 불가능해질 수 있다.13
-
플래싱에 사용했던 USB Type-C 케이블을 호스트 PC와 Jetson 사이에 그대로 연결해 둔다. 이 케이블은 가상 직렬 포트(Virtual UART) 역할을 한다.
-
호스트 PC에서
screen이나minicom과 같은 직렬 터미널 프로그램을 실행한다.
# 포트 이름은 시스템에 따라 /dev/ttyACM1 등으로 다를 수 있음
sudo screen /dev/ttyACM0 115200
- 터미널 화면에 텍스트 기반의 설정 마법사가 나타난다. 호스트 PC의 키보드를 사용하여 모든 설정 과정을 동일하게 완료할 수 있다.
6. 단계: Jetson SDK 컴포넌트 설치
Jetson OS 설치와 초기 설정이 완료되었으므로, 이제 AI 개발에 필수적인 CUDA, cuDNN, TensorRT 등의 SDK 컴포넌트를 설치한다.
6.1 SDK Manager 재연결
- Jetson AGX Orin이 정상적으로 부팅되어 네트워크에 연결되었고, 4단계에서 생성한 계정으로 로그인이 가능한 상태인지 확인한다.
- 호스트 PC에서 SDK Manager를 다시 실행한다.
- ‘STEP 01’ 화면에서 이전과 동일하게 ’Jetson AGX Orin’을 대상 하드웨어로 선택한다.
- ’STEP 02’로 넘어가면, 이번에는 반대로 ’Jetson OS’의 체크를 해제하고 ‘Jetson SDK Components’ 아래의 모든 항목을 선택한다.3
6.2 인증 및 설치
- ’Continue’를 클릭하면 SDK Manager가 Jetson에 연결하기 위한 정보 입력창을 띄운다.3
- 연결 정보를 입력한다.
- Connection: ’USB’를 선택한다. 이때 호스트 PC와 Jetson은 USB 케이블을 통해 가상 이더넷으로 연결된다. Jetson은 스스로에게
192.168.55.1이라는 고정 IP를 할당한다.18 - IP address: 기본값인
192.168.55.1을 그대로 사용한다.3 - Username / Password: 4단계(OEM-Config)에서 생성한 Jetson의 사용자 계정 이름과 암호를 정확하게 입력한다.21
- ‘Install’ 버튼을 클릭하면 설치가 시작된다. SDK Manager는 SSH와 유사한 방식으로 Jetson에 원격 접속하여
apt패키지 관리자를 통해 CUDA, cuDNN, TensorRT, OpenCV 등 필요한 모든 라이브러리와 도구를 자동으로 설치한다.
이 과정에서 사용되는 192.168.55.1 가상 이더넷 연결은 호스트 PC의 기존 네트워크 설정과 충돌할 수 있는 잠재적 실패 지점이다. 만약 호스트 PC가 이미 사내망 등에서 192.168.55.0/24 대역을 사용하고 있다면 IP 주소 충돌이 발생하여 Jetson과의 통신이 실패할 수 있다. 이 경우, 호스트 PC에서 ip addr 명령어로 네트워크 인터페이스를 확인하고, 충돌하는 네트워크 연결을 잠시 비활성화한 후 다시 시도해야 한다.
7. 단계: 설치 완료 검증
모든 설치 과정이 완료된 후, 소프트웨어 스택이 올바르게 구성되었는지 확인하는 것은 매우 중요하다. 이는 향후 개발 환경의 호환성을 보장하고 문제를 사전에 발견하는 데 도움이 된다.
7.1 핵심 버전 확인
Jetson AGX Orin에서 터미널을 열고 다음 명령어들을 실행하여 주요 컴포넌트의 버전을 확인한다.
- Ubuntu OS 버전:
lsb_release -a
- L4T (Linux for Tegra) 버전: JetPack 버전을 유추할 수 있는 가장 신뢰도 높은 방법이다.24
head -n 1 /etc/nv_gra_release
- JetPack 메타 패키지 버전: 설치된 JetPack의 전체 버전을 보여준다.27
sudo apt-cache show nvidia-jetpack
- CUDA Toolkit 버전: GPU 프로그래밍에 필수적인 CUDA 컴파일러의 버전을 확인한다.27
nvcc --version
7.2 시스템 상태 확인
jtop 유틸리티는 Jetson 장치의 CPU/GPU 사용량, 메모리, 온도뿐만 아니라 JetPack, L4T, CUDA, cuDNN, TensorRT 등 설치된 모든 소프트웨어의 버전을 한 화면에서 종합적으로 보여주는 매우 유용한 도구이다. 설치하여 실행하는 것을 강력히 권장한다.33
sudo apt update
sudo apt install python3-pip -y
sudo pip3 install -U jetson-stats
sudo reboot
재부팅 후 터미널에서 jtop을 실행하면 시스템의 모든 상태를 실시간으로 모니터링하고 설치된 버전을 검증할 수 있다.
표 2: 설치 검증 명령어
| 검증 대상 | 실행 명령어 | 설명 및 예상 출력 예시 |
|---|---|---|
| OS 버전 | lsb_release -a | Ubuntu 배포판 버전 확인 (예: Distributor ID: Ubuntu, Release: 22.04) |
| L4T 버전 | head -n 1 /etc/nv_tegra_release | NVIDIA의 Tegra용 Linux 버전 확인 (예: # R36 (release), REVISION: 2.0...) |
| JetPack 버전 | sudo apt-cache show nvidia-jetpack | 설치된 JetPack 메타 패키지 정보 확인 (예: Version: 6.0-b52) |
| CUDA 버전 | nvcc --version | CUDA 컴파일러 버전 확인 (예: Cuda compilation tools, release 12.2, V12.2.140) |
| 종합 정보 | jtop | CPU/GPU 사용량, 온도, 전력 및 모든 JetPack 컴포넌트 버전 종합 모니터링 |
8. 부록: 문제 해결 가이드
8.1 심층 분석: Jetson이 감지되지 않는 문제
SDK Manager 또는 호스트 PC의 lsusb 명령어가 Jetson AGX Orin을 인식하지 못하는 것은 설치 과정에서 가장 흔하게 발생하는 문제 중 하나이다. 이 문제는 단일 원인이 아닌, 물리적 연결, 소프트웨어 설정, 하드웨어 상태 등 복합적인 요인에 의해 발생할 수 있다. 아래는 문제의 원인을 체계적으로 진단하고 해결하기 위한 심층 분석 및 대책이다.
1. 근본 원인: 강제 복구 모드(Force Recovery Mode) 진입 실패
Jetson이 감지되지 않는 가장 근본적인 이유는 장치가 플래싱을 받을 준비 상태, 즉 강제 복구 모드에 성공적으로 진입하지 못했기 때문이다.
- 진단: 호스트 PC 터미널에서
lsusb명령을 실행했을 때ID 0955:7023 NVidia Corp.항목이 보이지 않는다면, 장치는 복구 모드가 아니다.12 - 대책:
- 정확한 버튼 절차 숙지: 본문 2단계에 기술된 버튼 조합을 정확히 따라야 한다. 특히 버튼을 누르고 떼는 타이밍이 중요하다. 전원이 꺼진 상태에서는 ‘복구 버튼 누른 상태 유지 -> 전원 버튼 누르기’ 순서이며, 켜진 상태에서는 ‘복구 버튼 누른 상태 유지 -> 리셋 버튼 눌렀다 떼기’ 순서이다.41
- 대안 절차 시도: 일부 사용자들은 기존 절차가 작동하지 않을 때, 전원과 USB 케이블이 모두 분리된 상태에서 ’복구 버튼을 누른 상태로 USB 케이블을 연결’하는 방식으로 성공하기도 했다.42 다양한 조합을 시도해볼 가치가 있다.
2. 물리적 연결 문제: 케이블과 포트 확인
물리적 연결의 미세한 결함은 감지 실패의 주된 원인이 된다.
- 원인 1: 잘못된 USB-C 포트 사용: Jetson AGX Orin 개발자 키트에는 여러 개의 USB-C 포트가 있다. 플래싱에는 반드시 40핀 헤더 옆에 위치한 전용 USB-C 포트를 사용해야 한다. 다른 포트(전원 공급용 등)에 연결하면 절대 감지되지 않는다.43
- 원인 2: 결함이 있거나 부적합한 USB 케이블: 데이터 전송이 불안정하거나 전력 공급이 부족한 케이블은 감지 실패를 유발한다. 다른 기기에서 정상 작동하던 케이블이라도 플래싱에는 적합하지 않을 수 있다.44
- 대책: 반드시 Jetson 키트에 동봉된 정품 케이블 또는 데이터 전송이 검증된 고품질의 USB-A to Type-C 케이블을 사용해야 한다.45
- 원인 3: 호스트 PC의 USB 포트 호환성: 일부 호스트 PC의 USB 3.0 포트는 Jetson 복구 모드와 호환성 문제를 일으킬 수 있다.38
- 대책: PC의 다른 USB 포트에 연결을 시도하라. 특히 메인보드 후면에 직접 연결된 USB 2.0 포트가 더 안정적인 경향이 있다.38 USB 허브를 사용하고 있다면 제거하고 직접 연결하는 것이 좋다.
3. 호스트 환경 문제: 가상 머신(VM) 및 권한
-
원인 1: 가상 머신(VM) 사용: VirtualBox, VMWare 등의 가상 머신 환경은 USB 장치 연결을 중재하는 과정에서 문제를 일으키기 쉽다. 특히 플래싱 과정 중 Jetson이 잠시 재연결될 때 VM이 이 연결을 놓치는 경우가 빈번하다. 이는 NVIDIA에서 공식적으로 지원하지 않는 방식이다.47
-
대책: 가장 확실한 해결책은 네이티브 Ubuntu 환경(듀얼 부팅 또는 별도 PC)을 사용하는 것이다.49 부득이하게 VM을 사용해야 한다면, VirtualBox Extension Pack 설치,
vboxusers 그룹에 사용자 추가, USB 필터 설정 등 USB 패스스루(passthrough) 설정을 완벽하게 구성해야 한다.51 플래싱 중 연결이 끊어지면 수동으로 USB 장치를 VM에 다시 연결하는 시도가 필요할 수도 있다.53
-
원인 2: 호스트 PC의 권한 부족: 드물지만, 호스트 PC의 사용자가 USB 장치에 접근할 권한이 없어
lsusb에서는 보이지만 SDK Manager가 장치를 제어하지 못하는 경우가 있다. -
대책: 현재 사용자를
dialout그룹에 추가하여 직렬 통신 장치에 대한 접근 권한을 부여한다. 터미널에서sudo usermod -a -G dialout $USER명령을 실행한 후, 시스템을 재부팅하거나 로그아웃 후 다시 로그인해야 변경 사항이 적용된다.54
4. 시스템 손상 문제: 부트로더 및 OS
이전의 잘못된 플래싱 시도나 시스템 파일 손상으로 인해 부트로더가 손상되면, 장치가 정상적으로 복구 모드로 진입하지 못할 수 있다.45
- 진단: NVIDIA 로고 화면 직후 검은 화면에서 멈추거나, 어떤 버튼 조합으로도 복구 모드 진입이 불가능한 경우 의심해볼 수 있다.44
- 대책: 이 경우에도 해결책은 결국 올바른 방법으로 다시 플래싱하는 것이다. 위의 1, 2, 3번 항목을 다시 한번 철저히 점검하여 안정적인 연결을 확보한 뒤 플래싱을 재시도해야 한다. 만약 모든 방법을 시도했음에도 장치가 전혀 반응하지 않는다면, 하드웨어 자체의 결함일 가능성도 고려해야 한다.57
8.2 일반적인 오류 및 해결 방안
다음 표는 설치 과정에서 빈번하게 발생하는 문제들과 그에 대한 해결책을 요약한 것이다.
표 3: 주요 오류 및 해결 방안
| 문제 증상 | 예상 원인 | 해결 방안 |
|---|---|---|
| SDK Manager가 호스트 PC의 디스크 공간 부족 오류를 보고함.6 | 공식 요구사항보다 많은 임시 공간 필요. 루트 파티션(/)의 공간 부족. | - 호스트 PC에 최소 65GB 이상의 여유 공간 확보. - SDK Manager 설정에서 다운로드 및 설치 폴더를 공간이 충분한 다른 파티션으로 변경. |
lsusb 또는 SDK Manager에서 Jetson이 감지되지 않음. | 강제 복구 모드 진입 실패, 물리적 연결(케이블/포트) 불량, 가상머신(VM) 사용, 호스트 PC 권한 문제 등 복합적 원인. | - 본 부록의 ‘심층 분석: Jetson이 감지되지 않는 문제’ 항목을 참조하여 단계별로 원인 진단 및 해결. |
| 파일 다운로드가 특정 지점에서 멈추거나 실패함.35 | 네트워크 방화벽 또는 프록시 서버. 일시적인 NVIDIA 서버 문제. | - 회사나 기관의 네트워크일 경우 프록시 설정을 비활성화. - VPN 사용 중지. - SDK Manager 설정에서 동시 다운로드 수를 1로 줄여서 재시도. |
| OS 플래싱이 특정 비율(예: 99%)에서 실패함.38 | USB 연결 불안정. 호스트 PC의 권한 문제. eMMC 칩 버전 차이로 인한 파티션 크기 불일치.40 | - USB 케이블 및 포트 재확인. - sdkmanager를 sudo 없이 실행하고, 필요시 나타나는 프롬프트에 암호 입력. - 최신 버전의 SDK Manager를 사용하여 알려진 버그 수정. |
SDK 컴포넌트 설치 실패 (IP 192.168.55.1 연결 불가). | Jetson이 정상적으로 부팅되지 않음. 호스트 PC의 네트워크 설정과 충돌. | - Jetson에 모니터를 연결하여 부팅 후 로그인 화면이 정상적으로 보이는지 확인. - 호스트 PC에서 ip addr 명령어로 192.168.55.0/24 대역을 사용하는 다른 네트워크 인터페이스가 있는지 확인하고, 있다면 잠시 비활성화. |
9. 참고 자료
- SDK Manager - NVIDIA Developer, https://developer.nvidia.com/sdk-manager
- NVIDIA SDK Manager Documentation, https://docs.nvidia.com/sdk-manager/
- Software Setup — NVIDIA Jetson AGX Orin Developer Kit - User Guide, https://docs.nvidia.com/jetson/agx-orin-devkit/user-guide/1.0/software-setup.html
- System Requirements — SDK Manager, https://docs.nvidia.com/sdk-manager/system-requirements/index.html
- System Requirements — sdk-manager 2.0.0 documentation, https://docs.nvidia.com/sdk-manager/2.0.0/system-requirements/index.html
- SDKmanager error:This is no enough disk - Jetson AGX Xavier - NVIDIA Developer Forums, https://forums.developer.nvidia.com/t/sdkmanager-error-this-is-no-enough-disk/281969
- Target disk space check failure while flashing by SDK Manager - NVIDIA Developer Forums, https://forums.developer.nvidia.com/t/target-disk-space-check-failure-while-flashing-by-sdk-manager/291207
- How do I FIX “not enough disk space to install” Issue for SDK manager 1.1.0.6343, https://forums.developer.nvidia.com/t/how-do-i-fix-not-enough-disk-space-to-install-issue-for-sdk-manager-1-1-0-6343/120989
- Download and Install NVIDIA® Jetson™ SDK Manager - Forecr.io, https://www.forecr.io/blogs/installation/download-and-install-nvidia-sdk-manager
- Download and Run SDK Manager | NVIDIA Docs, https://developer.nvidia.com/docs/drive/drive-os/6.0.6/public/drive-os-linux-sdk/external/drive-quickstart-guide/dita/common/topics/installation/download-run-sdkm/download-run.html
- Jetson AGX Orin Developer Kit User Guide - Two Ways to Set Up Software, https://developer.nvidia.com/embedded/learn/jetson-agx-orin-devkit-user-guide/two_ways_to_set_up_software.html
- NVIDIA Jetson Orin AGX - JetPack 5.0.2 - Flashing Board, https://developer.ridgerun.com/wiki/index.php/NVIDIA_Jetson_Orin/JetPack_5.0.2/Flashing_Board
- Getting Started with Jetson AGX Orin Developer Kit, https://developer.nvidia.com/embedded/learn/get-started-jetson-agx-orin-devkit
- Download and Run SDK Manager — sdk-manager 2.0.0 …, https://docs.nvidia.com/sdk-manager/2.0.0/download-run-sdkm/index.html
- Download and Run SDK Manager, https://docs.nvidia.com/sdk-manager/download-run-sdkm/index.html
- Jetson Orin Nano Developer Kit User Guide - Software Setup, https://developer.nvidia.com/embedded/learn/jetson-orin-nano-devkit-user-guide/software_setup.html
- NVIDIA Jetson Orin AGX - JetPack 5.0.2 - Getting Started - Wizard …, https://developer.ridgerun.com/wiki/index.php/NVIDIA_Jetson_Orin/JetPack_5.0.2/Getting_Started/Wizard_Flashing
- Jetson AGX Orin Developer Kit User Guide - How-to | NVIDIA Developer, https://developer.nvidia.com/embedded/learn/jetson-agx-orin-devkit-user-guide/howto.html
- Force recovery mode in AGX Orin during reflashing - NVIDIA Developer Forums, https://forums.developer.nvidia.com/t/force-recovery-mode-in-agx-orin-during-reflashing/318709
- NVIDIA Jetson Orin AGX - Flashing commands for emulation, https://developer.ridgerun.com/wiki/index.php/NVIDIA_Jetson_Orin/Flashing_commands_for_emulation
- Install Jetson Software with SDK Manager — SDK Manager, https://docs.nvidia.com/sdk-manager/install-with-sdkm-jetson/index.html
- NVIDIA Jetson AGX Orin Setup Guide | Prepare Devices - Viam Documentation, https://docs.viam.com/operate/reference/prepare/jetson-agx-orin-setup/
- Get started with Jetson AGX Orin. Quickly and easily, in a matter of minutes! | by Asier Arranz, https://medium.com/@asierarranz/get-started-with-jetson-agx-orin-quickly-and-easily-in-a-matter-of-minutes-4579987bd3dc
- How to verify the installed Jetpack version? - Aetina Corporation, https://www.aetina.com/support-faq-detail.php?i=63
- How do I know what version of L4T my Jetson TK1 is running? - NVIDIA Developer Forums, https://forums.developer.nvidia.com/t/how-do-i-know-what-version-of-l4t-my-jetson-tk1-is-running/38893
- How to find Jetpack version of NVIDIA Jetson Nano - Collabnix, https://collabnix.com/how-to-find-jetpack-version-of-nvidia-jetson-nano/
- different ways to check for nvidia jetpack versions - GitHub Gist, https://gist.github.com/jadwigo/86b905ca2573dc7b9a685652b82ef590
- How to find the JetPack version of NVIDIA Jetson Device? - Stack Overflow, https://stackoverflow.com/questions/72359090/how-to-find-the-jetpack-version-of-nvidia-jetson-device
- How to find JetPack version in NVIDIA Jetson Nano? - DEV Community, https://dev.to/docker/how-to-find-jetpack-version-in-nvidia-jetson-nano-2nd
- How to get and check the CUDA version? - LambdaTest Community, https://community.lambdatest.com/t/how-to-get-and-check-the-cuda-version/30606
- How to get the CUDA version? - Stack Overflow, https://stackoverflow.com/questions/9727688/how-to-get-the-cuda-version
- How to Check CUDA Version Easily - VarHowto, https://varhowto.com/check-cuda-version/
- NVIDIA SDK Manager Tutorial: Installing Jetson Software Explained - YouTube, https://www.youtube.com/watch?v=Ucg5Zqm9ZMk
- First Boot: Jetson Orin Setup with Script + LLM Help - JetsonHacks, https://jetsonhacks.com/2025/04/15/first-boot-jetson-orin-setup-with-script-llm-help/
- Flashing Issue with JetPack 6.2 on Jetson Orin Nano - Timeout & USB Detection Errors, https://forums.developer.nvidia.com/t/flashing-issue-with-jetpack-6-2-on-jetson-orin-nano-timeout-usb-detection-errors/324482
- Erro with Jetson Orin Nano flashing with sdkmanager - NVIDIA Developer Forums, https://forums.developer.nvidia.com/t/erro-with-jetson-orin-nano-flashing-with-sdkmanager/251773
- Nvidia SDKManager Download Issues - Jetson TX2, https://forums.developer.nvidia.com/t/nvidia-sdkmanager-download-issues/180427
- SDK manager download errors - Jetson TX2 - NVIDIA Developer Forums, https://forums.developer.nvidia.com/t/sdk-manager-download-errors/80137
- Sdkmanager login problem - Jetson AGX Xavier - NVIDIA Developer Forums, https://forums.developer.nvidia.com/t/sdkmanager-login-problem/71929
- SDK Manager v1.3 crashes before flashing a Jetson TX2 board …, https://forums.developer.nvidia.com/t/sdk-manager-v1-3-crashes-before-flashing-a-jetson-tx2-board/158309
- Unable to flash Jetson AGX Orin 64 GB developer kit with Jetpack 5.1.2 using SDK Manager 2.1.0, https://forums.developer.nvidia.com/t/unable-to-flash-jetson-agx-orin-64-gb-developer-kit-with-jetpack-5-1-2-using-sdk-manager-2-1-0/292514