Instalace a spuštění

Tato část je převzata a upravena se svolením z OpenDroneMap: The Missing Guide, autor Piero Toffanin.

Quickstart

Installers for OpenDroneMap are available for purchase, and are the easiest way to get started and come with support.

https://opendronemap.org/webodm/download/#installer

That said, OpenDroneMap is a free and open source ecoystem. Community support is available for those looking to install themselves and directions follow:

Doporučení k hardwaru

Minimální požadavky pro spuštění softwaru jsou:

64bitový procesor vyrobený v roce 2010 nebo později
20 GB místa na disku
4 GB RAM

S výše uvedenými specifikacemi lze zpracovat maximálně 100-200 snímků (software vyčerpá paměť). Doporučené požadavky jsou:

Nejnovější generace CPU
100 GB místa na disku
16 GB RAM

The above will allow the processing of a few hundred images with minimal issues. A CPU with more cores will allow for faster processing, while a graphics card (GPU) currently has no impact on performance. For processing more images, add more disk space and RAM linearly to the number of images you need to process.

Minimum RAM needed for N images
Number of images	RAM or RAM + Swap
40	4
250	16
500	32
1500	64
2500	128
3500	192
5000	256

Instalace

Pro spuštění ODM doporučujeme používat docker, ať už používáte Windows, MacOS nebo Linux.

Windows

Pro spuštění OpenDroneMap potřebujete alespoň Windows 7. Předchozí verze systému Windows nejsou podporovány.

Krok 1. Zkontrolujte podporu virtualizace

Docker vyžaduje od procesoru funkci zvanou virtualizace, která mu umožňuje spouštět virtuální počítače (VM). Ujistěte se, že ji máte povolenou! Někdy je tato funkce vypnutá. Chcete-li to zkontrolovat, můžete v systému Windows 8 nebo vyšším otevřít Správce úloh (stiskněte klávesy CTRL+SHIFT+ESC) a přepnout na kartu Výkon.

Obrázek kontroly virtualizace v systému Windows 8 nebo vyšším

Virtualizace by měla být povolena

V systému Windows 7 můžete pro zjištění, zda máte povolenou virtualizaci, použít místo toho nástroj Microsoft® Hardware-Assisted Virtualization Detection Tool.

Pokud je virtualizace zakázána, je třeba ji povolit. Postup se bohužel u každého modelu počítače trochu liší, takže nejlépe uděláte, když si ve vyhledávači vyhledáte „jak povolit vtx pro <type your computer model here>“. Často se jedná o restartování počítače, okamžité stisknutí klávesy F2 nebo F12 během spouštění, procházení spouštěcí nabídky a změnu nastavení pro povolení virtualizace (často nazývané „VT-X“).

Obvyklé klávesy, které je třeba stisknout při spuštění počítače pro přístup ke spouštěcí nabídce různých výrobců počítačů

Krok 2. Požadavky na instalaci

Nejprve je třeba nainstalovat:

Git: https://git-scm.com/downloads
Python (nejnovější verze 3): https://www.python.org/downloads/windows/

V případě Pythonu 3 se ujistěte, že jste během instalace zaškrtli políčko Přidat Python 3.x do PATH.

Snímek obrazovky procesu instalace Pythonu3

Nezapomeňte přidat spustitelný soubor Pythonu do cesty PATH (abyste s ním mohli spouštět příkazy).

Pouze pokud používáte systém Windows 10 Home, Windows 8 (jakoukoli verzi) nebo Windows 7 (jakoukoli verzi), nainstalujte jej:

Docker Toolbox: https://github.com/docker/toolbox/releases/download/v18.09.3/DockerToolbox-18.09.3.exe

Pokud používáte systém Windows 10 Professional nebo novější verzi, měli byste místo toho nainstalovat:

Docker for Windows:https://docs.docker.com/desktop/install/windows-install/

Prosím, NE instalujte oba programy docker. Jsou odlišné a pokud budou nainstalovány oba, vznikne nepořádek.

Po instalaci nástroje Docker jej spusťte z ikony na ploše, která byla vytvořena při instalaci (Docker Quickstart v případě Docker Toolbox, Docker for Windows pro Docker for Windows). Je to důležité, tento krok nevynechávejte. Pokud se objeví chyby, postupujte podle pokynů na obrazovce a opravte je.

Krok 3. Zkontrolujte přidělení paměti a procesoru

Docker v systému Windows funguje tak, že na pozadí běží virtuální počítač (virtuální počítač si představte jako „emulátor počítače“). Tento virtuální počítač má přiděleno určité množství paměti a WebODM může využívat pouze tolik paměti, kolik mu bylo přiděleno.

Pokud jste nainstalovali Docker Toolbox (pokud jste místo toho nainstalovali Docker pro Windows, viz níže):

Otevřete aplikaci VirtualBox Manager.
Klikněte pravým tlačítkem myši na defaultní virtuální počítač a stiskněte Close (ACPI Shutdown) pro zastavení počítače.
Klikněte pravým tlačítkem myši na výchozí virtuální počítač a stiskněte Nastavení…
Přesuňte posuvník Základní paměť z panelu Systém a přidělte 60-70 % veškeré dostupné paměti, případně přidejte také 50 % dostupných procesorů z karty Procesor.

Výchozí nastavení virtuálního počítače VirtualBox

Poté stiskněte tlačítko OK, klikněte pravým tlačítkem myši na výchozí virtuální počítač a stiskněte tlačítko Spustit.

Pokud jste místo toho nainstalovali Docker pro Windows:

Podívejte se do systémové lišty a klikněte pravým tlačítkem myši na ikonu „bílé velryby“.
V nabídce stiskněte Nastavení….
Na panelu klikněte na tlačítko Pokročilé a pomocí posuvníků přidělte 60-70 % dostupné paměti a využijte polovinu všech dostupných procesorů.
Stiskněte Použít.

Krok 1 Ikona Docker

Snímek obrazovky nastavení aplikace Docker

Krok 3 a 4 nastavení Dockeru

Krok 4. Stáhněte si WebODM

Otevřete program Git Gui, který je nainstalován se systémem Git. Odtud:

Po otevření nástroje Git Gui klikněte na možnost „Klonovat existující úložiště“.
Do pole Zdrojové umístění zadejte: https://github.com/OpenDroneMap/WebODM
V okně Cílový adresář klikněte na tlačítko procházet a přejděte do vybrané složky (v případě potřeby ji vytvořte).
Stiskněte tlačítko Klonovat

Git Gui

Pokud se stahování podařilo, mělo by se zobrazit toto okno:

Git Gui po úspěšném stažení (klonování)

Přejděte do nabídky Úložiště a klikněte na tlačítko Vytvořit ikonu na ploše. To vám umožní se v budoucnu k této aplikaci snadno vracet.

Krok 4. Spusťte WebODM

V prostředí Git Gui přejděte do nabídky Úložiště a klikněte na položku Git Bash. V terminálu příkazového řádku zadejte:

$ ./webodm.sh start &

V tomto okamžiku se do počítače stáhne několik komponent, včetně WebODM, NodeODM a ODM. Po stažení by vás měla přivítat následující obrazovka:

Snímek obrazovky po úspěšném stažení WebODM

Výstup konzoly po prvním spuštění WebODM

Pokud používáte Docker pro Windows, otevřete webový prohlížeč na adrese http://localhost:8000.
Pokud používáte Docker Toolbox, vyhledejte IP adresu, ke které se chcete připojit, zadáním:

$ docker-machine ip

Měli byste získat následující výsledek:

192.168.1.100

Poté se připojte k webu http://192.168.1.100:8000 (IP adresu nahraďte správnou).

macOS

Na většině moderních počítačů Mac (po roce 2010) se systémem macOS Sierra 10.12 nebo vyšším lze OpenDroneMap spustit pomocí dockeru, pokud je podporována hardwarová virtualizace (viz níže).

Krok 1. Zkontrolujte podporu virtualizace

Otevřete okno Terminálu a napište:

$ sysctl kern.hv_support

Dostanete podobnou odpověď, jako je tato:

kern.hv_support: 1

Pokud je výsledkem kern.hv_support: 1, pak je váš Mac podporován! Pokračujte krokem 2.

Pokud je výsledkem kern.hv_support: 0, To bohužel znamená, že váš Mac je příliš starý na spuštění OpenDroneMap :(.

Krok 2. Požadavky na instalaci

Je třeba nainstalovat pouze dva programy:

Po instalaci dockeru byste měli na hlavním panelu najít ikonu, která vypadá jako velryba.

Spuštěná aplikace Docker

Správné spuštění dockeru můžete ověřit tak, že otevřete aplikaci Terminál a zadáte:

$ docker run hello-world

Který by měl vrátit

Hello from Docker!

Chcete-li ověřit, zda je git nainstalován, jednoduše zadejte:

$ git --version

Který by měl vrátit něco podobného:

git version 2.20.1 (Apple Git-117)

Pokud se zobrazí hlášení „bash: git: command not found“, zkuste restartovat aplikaci Terminal a překontrolujte, zda během instalace nedošlo k chybě.

Krok 3. Zkontrolujte přidělení paměti a procesoru

Docker v systému macOS funguje tak, že na pozadí běží virtuální počítač (představte si ho jako „emulátor počítače“). Tento virtuální počítač má přiděleno určité množství paměti a WebODM může využívat pouze tolik paměti, kolik mu bylo přiděleno.

Klikněte pravým tlačítkem myši na ikonu velryby na hlavním panelu a klikněte na položku Předvolby…
Vyberte kartu Pokročilé
Nastavte posuvník CPU tak, aby využíval polovinu všech dostupných CPU, a paměť tak, aby využívala 60-70 % veškeré dostupné paměti.
Stiskněte tlačítko Použít a restartovat

Snímek obrazovky pokročilého nastavení Docker

Pokročilé nastavení Dockeru

Krok 4. Stažení a spuštění WebODM

V Terminálu napište:

$ git clone https://github.com/OpenDroneMap/WebODM
$ cd WebODM
$ ./webodm.sh start

Poté otevřete webový prohlížeč na adrese http://localhost:8000.

Linux

OpenDroneMap lze spustit na libovolné distribuci Linuxu, která podporuje docker. Podle webových stránek s dokumentací dockeru jsou oficiálně podporovanými distribucemi CentOS, Debian, Ubuntu a Fedora, pro ostatní jsou k dispozici statické binární soubory. Pokud si musíte vybrat distribuci výhradně pro spuštění OpenDroneMap, doporučuje se Ubuntu.

Krok 1. Instalace požadavků

Je třeba nainstalovat čtyři programy:

Docker
Git
Python (2 nebo 3)
Pip

Nemůžeme popsat instalační proces pro všechny distribuce Linuxu, takže se omezíme na ty, které jsou oficiálně podporovány dockerem. Ve všech případech jde jen o otevření terminálového příkazu a zadání několika příkazů.

Instalace na Ubuntu / Debian

Příkazy k zadání:

$ sudo apt update
$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo apt install -y git python python-pip

Instalace na CentOS / RHEL

Příkazy k zadání:

$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo yum -y install git python python-pip

Instalace v systému Fedora

Příkazy k zadání:

$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh
$ sudo dnf install git python python-pip

Instalace na Arch

Příkazy k zadání:

$ sudo pacman -Sy docker git python python-pip

Krok 2. Zkontrolujte další požadavky

Kromě tří výše uvedených programů je zapotřebí také skript dockercompose. Někdy je již nainstalován spolu s dockerem, ale někdy ne. Chcete-li ověřit, zda je nainstalován, zkuste zadat následující příkaz:

$ docker compose --version

Měli byste vidět něco podobného:

docker compose version 24.0.5, build ced0996600

Krok 3. Stažení a spuštění WebODM

Z terminálu typu:

$ git clone https://github.com/OpenDroneMap/WebODM
$ cd WebODM
$ ./webodm.sh start

Poté otevřete webový prohlížeč na adrese http://localhost:8000.

Základní příkazy a řešení potíží

Skvělé na používání dockeru je, že 99 % úloh, které kdy budete potřebovat provést při používání WebODM, lze provést pomocí skriptu ./webodm.sh. S jednou z nich jste se již setkali:

$ ./webodm.sh start

který se postará o spuštění WebODM a nastavení výchozího uzlu pro zpracování (node-odm-1). Pokud chcete službu WebODM zastavit, můžete již tušit, jaký je její příkaz:

$ ./webodm.sh stop

Existuje několik dalších příkazů, které můžete použít spolu s různými příznaky. Příznaky jsou parametry předávané příkazu ./webodm.sh a obvykle mají předponu „-“. Například příznak port dává WebODM pokyn k použití jiného síťového portu:

$ ./webodm.sh start --port 80

Další užitečné příkazy jsou uvedeny níže:

# Restart WebODM (useful if things get stuck)
$ ./webodm.sh restart

# Reset the admin user's password if you forget it
$ ./webodm.sh resetadminpassword newpass

# Update everything to the latest version
$ ./webodm.sh update

# Store processing results in the specified folder instead of the default location (inside docker)
$ ./webodm.sh restart --media-dir /path/to/webodm_results

# See all options
$ ./webodm.sh --help

Komunitní fórum je skvělým místem, kde můžete požádat o pomoc, pokud se zaseknete při některém z kroků instalace, a pro obecné otázky týkající se používání skriptu ./webodm.sh.

Dobrý den, WebODM!

Po spuštění souboru ./webodm.sh start a otevření WebODM v prohlížeči se zobrazí uvítací zpráva a budete vyzváni k vytvoření prvního uživatele. Věnujte nějaký čas seznámení s webovým rozhraním a prozkoumejte jeho různé nabídky.

Snímek obrazovky ovládacího panelu WebODM

WebODM Dashboard

Všimněte si, že v nabídce Processing Nodes je již nakonfigurován uzel „node-odm-1“, který můžete použít. Jedná se o uzel NodeODM a byl vytvořen automaticky pomocí WebODM. Tento uzel běží na stejném počítači jako WebODM.

Pokud jste se dostali až sem, gratulujeme vám! Nyní je čas začít zpracovávat data.

Spuštění na více než jednom počítači

Případně: Pokud máte jiný počítač, můžete proces instalace zopakovat (nainstalovat docker, git, python atd.) a spustit nový uzel NodeODM zadáním v okně Terminal/Git Bash:

docker run --rm -it -p 3000:3000 opendronemap/nodeodm -q 1 --token secret

Výše uvedený příkaz požádá docker o spuštění nového kontejneru pomocí obrazu opendronemap/nodeodm z Docker Hub (nejnovější verze NodeODM), použití portu 3000, nastavení maximálního počtu souběžných úloh na 1 a ochranu uzlu před neoprávněným přístupem pomocí hesla „secret“.

Ve WebODM pak můžete stisknout tlačítko Přidat nový v části Zpracovatelské uzly. Do pole název hostitele/IP zadejte IP adresu druhého počítače. Do pole port zadejte „3000“. Do pole token zadejte „secret“. Můžete také přidat nepovinný název uzlu, například „druhý počítač“. Poté stiskněte tlačítko Uložit.

Pokud vše proběhlo v pořádku, měli byste nyní mít dva zpracovatelské uzly! Budete moci paralelně zpracovávat více úloh na dvou různých strojích.

Naučte se upravovat a pomozte zlepšit tuto stránku!