설치 가이드 (Linux)
이 가이드는 Linux 시스템에서 MipMapEngine SDK를 배포하고 실행하는 방법에 대한 자세한 지침을 제공합니다.
📋 시스템 요구 사항
권장 구성
| 구성 요소 | 요구 사항 |
|---|---|
| 운영 체제 | Ubuntu 22.04 |
| CPU | Intel/AMD x86_64 8코어 이상 |
| 메모리 | 32 GB RAM |
| GPU | NVIDIA GPU (CUDA 지원) |
| 그래픽 드라이버 | NVIDIA Driver >= 525.60.33 |
| CUDA | CUDA 12.8 |
| 디스크 공간 | 1 TB 여유 공간 |
🚀 설치 단계
1단계: 하드웨어 및 드라이버 확인
GPU 정보 확인
# NVIDIA GPU가 설치되어 있는지 확인
lspci | grep -i nvidia
# NVIDIA 드라이버 버전 확인
nvidia-smi
드라이버가 설치되지 않았거나 버전이 너무 낮은 경우:
# Ubuntu NVIDIA 드라이버 설치
sudo apt update
sudo apt install nvidia-driver-***
2단계: Virbox 드라이버 설치
Virbox는 SDK의 암호화 도구이며 설치해야 합니다.
# Virbox 사용자 도구 설치
https://lm.virbox.com/tools.html
3단계: 라이선스 활성화
# SDK에서 제공하는 license_engine을 사용하여 활성화
./license_engine -bind YOUR-LICENSE-KEY
# 라이선스 상태 조회
./license_engine -enum license_info.json
cat license_info.json
4단계: SDK 압축 해제
# SDK 패키지 압축 해제
tar -xzvf MipMapEngine_SDK_Linux_v4.0.tar.gz
# 디렉토리 구조 확인
cd MipMapEngine_SDK
ls -la
# 다음을 포함해야 함:
# - bin/ # 실행 파일 및 동적 라이브러리
# - gdal_data/ # GDAL 데이터 파일
# - docs/ # 사용자 매뉴얼
# - examples/ # 예제 스크립트
5단계: 환경 변수 구성
# SDK 경로 설정 (실제 경로로 교체)
export MIPMAP_SDK_PATH=/path/to/MipMapEngine_SDK
# 라이브러리 경로 설정
export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH
# ~/.bashrc 또는 ~/.profile에 추가하는 것을 권장
echo 'export MIPMAP_SDK_PATH=/path/to/MipMapEngine_SDK' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc
6단계: 종속성 확인
# 실행 파일 종속성 확인
ldd $MIPMAP_SDK_PATH/lib/reconstruct_full_engine
# 라이브러리가 누락된 경우 시스템 패키지 설치
# Ubuntu
apt-get update && apt-get install -y libgl1-mesa-dev libgeos-dev libgomp1 liblcms2-2 libquadmath0 libjbig0 libdeflate0 libopenexr25 libproj22
7단계: 설치 확인
테스트 구성 파일 test.json 생성:
{
"working_dir": "./test_output",
"gdal_folder": "/path/to/MipMapEngine_SDK/gdal_data",
"input_image_type": 1,
"resolution_level": 3,
"coordinate_system": {
"type": 2,
"epsg_code": 4326
},
"image_meta_data": [
{
"id": 1,
"path": "/path/to/test/image1.jpg"
},
{
"id": 2,
"path": "/path/to/test/image2.jpg"
}
]
}
테스트 실행:
# SDK 디렉토리로 이동
cd $MIPMAP_SDK_PATH/bin
# 재구성 실행
./reconstruct_full_engine -reconstruct_type 0 -task_json test.json
# 출력 확인
ls -la ./test_output/
🔧 일반적인 문제
1. libmipmap_engine.so 누락
오류 메시지:
error while loading shared libraries: libmipmap_engine.so: cannot open shared object file
해결 방법:
# 라이브러리 경로가 올바른지 확인
export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH
2. CUDA 관련 오류
오류 메시지:
CUDA error: no CUDA-capable device is detected
해결 방법:
# GPU 드라이버 확인
nvidia-smi
# 드라이버 업데이트
sudo apt update
sudo apt upgrade nvidia-driver-*
4. 라이브러리 버전 충돌
일부 시스템 라이브러리가 SDK에서 제공하는 라이브러리와 충돌할 수 있습니다:
# 충돌하는 라이브러리 식별
ldd -v $MIPMAP_SDK_PATH/bin/reconstruct_full_engine
# 충돌하는 라이브러리를 일시적으로 제거
mv $MIPMAP_SDK_PATH/libconflict.so $MIPMAP_SDK_PATH/libconflict.so.bak
# 시스템 라이브러리 사용
# 시스템이 자동으로 /usr/lib에서 로드합니다
다음 단계
팁: Linux 배포는 배포판과 환경의 차이로 인해 조정이 필요할 수 있습니다. 프로덕션에 배포하기 전에 테스트 환경에서 확인하는 것이 좋습니다.