Перейти к основному содержимому

Руководство по установке (Linux)

Это руководство содержит подробные инструкции по развертыванию и запуску MipMapEngine SDK в системах Linux.

📋 Системные требования​

Рекомендуемая конфигурация​

КомпонентТребование
Операционная системаUbuntu 22.04
ЦПIntel/AMD x86_64 8 ядер или больше
Память32 ГБ ОЗУ
GPUNVIDIA GPU (поддержка CUDA)
Графический драйверNVIDIA Driver >= 525.60.33
CUDACUDA 12.8
Дисковое пространство1 ТБ свободного места

🚀 Шаги установки​

Шаг 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: Активация лицензии​

# Использовать license_engine, предоставленный SDK, для активации
./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 может потребовать корректировок из-за различий в дистрибутивах и средах. Рекомендуется проверить в тестовой среде перед развертыванием в производстве.