하드웨어 설정
Xisom Edge AI Box는 NVIDIA Jetson에서 실행됩니다. 소프트웨어를 설치하기 전에 장치를 준비하고, 추론이 GPU를 사용하는 방식을 확인한 뒤 공장 네트워크에 연결하세요.
지원 하드웨어
섹션 제목: “지원 하드웨어”| 항목 | 요구사항 |
|---|---|
| 장치 | NVIDIA Jetson TX2 |
| 운영체제 | JetPack 4.5 (L4T r32.5) |
| 추론 | 통합 GPU(CUDA)에서 ONNX Runtime 실행, CPU 폴백 지원 |
| 메모리 | 4 GB 이상. 약 3.5 GB 미만이면 설치 프로그램이 경고합니다. |
| 여유 디스크 | 릴리스 번들을 복사하는 위치에 약 6 GB |
GPU 사전 요구사항
섹션 제목: “GPU 사전 요구사항”Xisom을 설치하기 전에 JetPack 이미지에 다음이 준비되어 있어야 합니다. 설치 프로그램은 이를 확인하고 하나라도 없으면 중단합니다. 대신 설치해 주지는 않습니다.
- Docker에 등록된 NVIDIA 컨테이너 런타임.
docker info에nvidia런타임이 표시되어야 합니다. - 실제 Jetson(L4T) 시스템. 설치 프로그램은
/etc/nv_tegra_release를 확인합니다.
추론이 GPU를 사용하는 방식
섹션 제목: “추론이 GPU를 사용하는 방식”추론 서비스는 시작할 때 실행 공급자를 선택합니다. TX2에서는 CUDA를 사용하고, CUDA를 시작할 수 없으면 CPU로 폴백합니다. 대시보드에 활성 공급자가 표시됩니다.
기본 모드. 모델이 CUDA를 통해 TX2의 통합 GPU에서 실행됩니다. 대시보드에 CUDA가 표시됩니다.
- 호스트에 NVIDIA 컨테이너 런타임이 필요합니다.
- 모델은 ONNX opset 15 이하로 내보내세요. modelctl로 모델 준비하기를 참조하세요.
- 첫 시작 시 추론 서비스가 CUDA를 초기화합니다. 헬스 체크에 90초의 시작 유예
기간이 있으므로, 최대 약 1분 30초 동안
starting으로 표시됩니다. 정상적인 동작입니다.
안전망. CUDA를 시작할 수 없으면 서비스가 CPU로 폴백합니다. 추론은 계속되지만 지연 시간이 커집니다. 대시보드에 **CPU (fallback)**이 표시되며, 이 배지가 믿을 수 있는 신호입니다. 경고는 컨테이너에 CUDA 공급자가 아예 없을 때만 기록됩니다.
- 폴백 대신 박스가 시작을 거부하도록 하려면 GPU가 예상되는데 CPU에서 실행될 때를 참조하세요.
TX2에서는 TensorRT를 사용하지 않습니다. JetPack 4.5용 ONNX Runtime 빌드는 플랫폼이 제공하는 것보다 새로운 TensorRT가 필요하므로, 서비스는 이를 건너뛰고 CUDA에서 실행됩니다. 첫 시작 시 엔진 컴파일은 없습니다.
네트워크 요구사항
섹션 제목: “네트워크 요구사항”- 운영자 브라우저가 접근할 수 있는 LAN 연결. 대시보드는 포트 80(대체 포트 3000)에서, HTTPS를 켜면 443에서 수신합니다.
- 공장 장치(OPC UA 서버, MQTT 브로커, PLC)로 가는 경로.
- 아웃바운드 인터넷 접근은 필요 없습니다. 설치와 업데이트는 오프라인 번들로 합니다.
추론 서비스의 내부 포트(50051)는 박스의 루프백 주소에만 바인딩됩니다. 네트워크에서는 접근할 수 없습니다.
첫 부팅
섹션 제목: “첫 부팅”- 전원과 네트워크 케이블을 연결합니다.
- 설치 프로그램이 출력한 대시보드 URL로 접속합니다. 기본값은
http://<box-ip>이고, HTTPS를 켰다면https://<box-ip>입니다. - 설치 프로그램이 출력한 비밀번호로
admin에 로그인합니다. - 입력 데이터소스 연결로 계속 진행합니다.
문제가 발생하면
섹션 제목: “문제가 발생하면”- 박스가 **CPU (fallback)**으로 실행되거나, 시작 유예 기간 이후에도 추론이
unhealthy에 멈춘 경우 — 문제 해결 런북을 참조하세요.