Inštalačný sprievodca

Kompletný sprievodca inštaláciou Turka Vision VMS poháňaného frameworkom VALKKA

Obsah

1. Predpoklady

Pred inštaláciou Turka Vision sa uistite, že máte nasledujúce predpoklady:

  • Linux distribúcia (odporúča sa Ubuntu 20.04+) alebo Windows 10/11
  • Administrátorský/root prístup k systému
  • Stabilné internetové pripojenie na sťahovanie balíčkov
  • Základné znalosti príkazového riadka
  • Sieťový prístup k zariadeniam kamier (ak inštalujete na vyhradený server)

2. Systémové požiadavky

Minimálne požiadavky

  • CPU: Intel i5 alebo AMD Ryzen 5 (minimálne 4 jadrá)
  • RAM: 8 GB (odporúča sa 16 GB pre >10 kamier)
  • Úložisko: 100 GB voľného miesta (odporúča sa SSD)
  • GPU: Integrovaná grafika (odporúča sa vyhradená GPU pre AI funkcie)
  • Sieť: Gigabit Ethernet

Odporúčané pre produkciu

  • CPU: Intel i7/Xeon alebo AMD Ryzen 7/EPYC (8+ jadier)
  • RAM: 32 GB alebo viac
  • Úložisko: 1 TB+ NVMe SSD pre systém, samostatné úložisko pre nahrávky
  • GPU: NVIDIA GTX 1060+ alebo RTX séria pre AI zrýchlenie
  • Sieť: Vyhradené sieťové rozhranie pre prevádzku kamier

3. Inštalácia závislostí

Ubuntu/Debian

# Aktualizovať zoznam balíčkov
sudo apt update && sudo apt upgrade -y

# Inštalovať Python 3.8+ a vývojové nástroje
sudo apt install python3 python3-pip python3-dev build-essential -y

# Inštalovať multimediálne knižnice
sudo apt install ffmpeg libavformat-dev libavcodec-dev libavutil-dev -y
sudo apt install libswscale-dev libavfilter-dev libavdevice-dev -y

# Inštalovať závislosti OpenCV
sudo apt install libopencv-dev python3-opencv -y

# Inštalovať ďalšie knižnice
sudo apt install libx11-dev mesa-utils -y
sudo apt install git cmake pkg-config -y

Python závislosti

# Inštalovať Python balíčky
pip3 install --user numpy opencv-python
pip3 install --user imutils requests
pip3 install --user flask flask-cors
pip3 install --user psutil netifaces

4. Inštalácia VALKKA

Poznámka: VALKKA vyžaduje kompiláciu zo zdroja. Tento proces môže trvať 15-30 minút v závislosti od vášho systému.

Stiahnuť a skompilovať VALKKA

# Klonovať VALKKA repozitár
git clone https://github.com/elsampsa/valkka-core.git
cd valkka-core

# Vytvoriť adresár pre zostavenie
mkdir build && cd build

# Nakonfigurovať zostavenie pomocou CMake
cmake .. -DCMAKE_BUILD_TYPE=Release

# Skompilovať (použiť -j4 pre 4 jadrá, upraviť podľa vášho CPU)
make -j$(nproc)

# Inštalovať systémovo
sudo make install

# Aktualizovať cache knižníc
sudo ldconfig

Inštalovať Python väzby

# Vrátiť sa späť do koreňa projektu
cd ..

# Inštalovať Python väzby
python3 setup.py build_ext --inplace
pip3 install --user .

5. Nastavenie Turka Vision

Stiahnuť Turka Vision

# Vytvoriť inštalačný adresár
sudo mkdir -p /opt/turka-vision
cd /opt/turka-vision

# Stiahnuť balíček Turka Vision (nahradiť skutočným odkazom na stiahnutie)
wget https://releases.turkavi.net/turka-vision-latest.tar.gz

# Rozbaliť balíček
tar -xzf turka-vision-latest.tar.gz
cd turka-vision

Počiatočná konfigurácia

# Skopírovať predvolenú konfiguráciu
cp config/default.conf config/turka-vision.conf

# Vytvoriť adresáre pre logy a nahrávky
sudo mkdir -p /var/log/turka-vision
sudo mkdir -p /var/lib/turka-vision/recordings

# Nastaviť oprávnenia
sudo chown -R $USER:$USER /var/log/turka-vision
sudo chown -R $USER:$USER /var/lib/turka-vision

Inštalovať službu (voliteľné)

# Skopírovať systémový súbor služby
sudo cp scripts/turka-vision.service /etc/systemd/system/

# Obnoviť systemd a povoliť službu
sudo systemctl daemon-reload
sudo systemctl enable turka-vision.service

6. Overenie inštalácie

Testovať inštaláciu VALKKA

# Testovať import VALKKA v Pythone
python3 -c "import valkka; print('VALKKA verzia:', valkka.VERSION_MAJOR, valkka.VERSION_MINOR, valkka.VERSION_PATCH)"

# Testovať základnú funkčnosť
python3 -c "from valkka import core; print('VALKKA core úspešne načítaný')"

Spustiť Turka Vision

# Spustiť Turka Vision manuálne
cd /opt/turka-vision
python3 main.py --config config/turka-vision.conf

# Alebo spustiť ako službu
sudo systemctl start turka-vision.service
sudo systemctl status turka-vision.service

Prístup k webovému rozhraniu

Otvorte váš webový prehliadač a prejdite na:

http://localhost:8080

Predvolené prihlasovacie údaje: admin / admin (okamžite zmeňte po prvom prihlásení)

Ďalšie kroky