Telepítés és használat

KOFA Lite: gráf exportálása önálló programként

A KOFA Lite egy kész gráfból készült, önálló, offline is futó program. Egy kisebb, kevesebbet tudó KOFA: a gráf rögzített, a program csak futtatja, és a profil dashboardját mutatja. Nincs benne gráf szerkesztő, Komod lista, Komod tár, MCP, felhasználókezelés és adatbázis; csak a gráfban használt Komod csomagok és a példányok fájljai (pl. ONNX modellek) kerülnek bele.

Tipikus példa: egy vitorlás „tanácsadó” (GPS + szél → útvonalkövetés → kormány- és vitorlautasítások) a hajón lévő Raspberry Pi-n, saját kijelzővel kiosk módban, a telefon a gép saját Wi-Fi hotspotjára csatlakozik, internet nincs.

Mit kapsz, és mit nem

1. Az export előkészítése

Az export a gráf mentett állapotát használja, ezért:

1. A teljes KOFA Gráf oldalán nyisd meg a profilt, amit exportálni szeretnél.
2. Ellenőrizd, hogy minden használt Komod telepítve és engedélyezve van (Komodok).
3. Ellenőrizd, hogy a dashboardon minden Komodnak, amit a programban kezelni akarsz, van widgetje: a Lite-ban nem lehet a gráfot átírni, csak a dashboardról kezelni.

2. Exportálás a felületről

A Gráf oldal felső sorában kattints az Exportálás programként (KOFA Lite) ikonra (az Exportálás fájlba mellett). Csak Admin teheti meg, mert az export csomagokat, modelleket és Wi-Fi jelszavakat visz ki a gépről.

A dialógus egy oldalon mutat mindent; az alábbiakban szakaszonként.

Program, elérhetőség, bejelentkezés

A szerepek:

Kiosk mód, hálózat és Bluetooth

Kiosk mód: bekapcsolva a gép saját kijelzőjén (HDMI vagy érintőkijelző) induláskor egy teljes képernyős böngésző nyílik a Lite felülettel, amiből nem lehet kilépni (nincs címsor, nincs fejlesztői eszköz, nincs konzolváltás). Állítható: böngésző (Chromium vagy a könnyebb cog), képernyő forgatás (0/90/180/270°), képernyő elsötétítés (perc, 0 = soha), kurzor elrejtése érintőkijelzőhöz. Kilépni adminként lehet: a felületről (Kiosk kikapcsolása) vagy SSH-n (sudo kofa-app kiosk off).

Hálózat és Bluetooth:

Egyéb beállítások és előnézet

Az Előnézet a letöltés előtt megmutatja, mi kerül a csomagba:

• a fájlnevet és a becsült méretet (tömörítés előtt),
• a csomagok listáját verzióval, a bennük lévő Komodokkal és mérettel,
• a példány fájlokat (modellek, útvonalak): mappánként kizárhatók, pl. egy adatgyűjtő gigabájtos felvételei,
• a hibákat (ezek tiltják az exportot) és figyelmeztetéseket.

A Komod beállítások fül (csak ha van ilyen a csomagban) a Komodok telepítési beállításait mutatja, pl. a Bluetooth nevet vagy a szimulátor-connector címeit; ezek a példányok saját beállítása fölé íródnak.

Az Exportálás gomb egy kofa-app-<név>-linux-arm64.tar.gz fájlt tölt le.

Gyakori hibák az exportnál

3. Exportálás parancssorból

Ugyanezt a szolgáltatást a szerver nélkül is használhatod (CI-ban, szkriptben):

dotnet run --project tools/Kofa.Export -- \
  --graph examples/graphs/vitorlas-tanacsado-szimulator.kofa-graph.json \
  --packages artifacts/komods \
  --template artifacts/lite \
  --options opciok.json \
  -o ./ki

Az --options fájl a dialógus beállításait tartalmazza JSON-ban, pl.:

{
  "name": "Vitorlas tanacsado",
  "rid": "linux-arm64",
  "access": { "mode": "lan", "port": 5090 },
  "auth": { "mode": "password", "operatorPassword": "…", "adminPassword": "…" },
  "hardwareBackend": "auto",
  "instanceControl": true
}

A --preview kapcsoló csak az előnézetet írja ki, fájl nélkül. A futtató sablont a tools/build-lite.sh készíti (artifacts/lite/<rid>/); kiadásban a kofa-lite-<verzió>-<rid>.tar.gz fájl.

4. Mi van az exportált csomagban

kofa-app-<név>/
  install.sh, uninstall.sh   telepítő és eltávolító
  bin/                       a Kofa.Lite program és a kliens, a kofa-app segédparancs
  app/                       app.json, graph.json, dashboard.json, komods/, instances/
  system/                    systemd unitok, polkit szabályok, böngésző policy
  OLVASS-EL.txt              rövid útmutató az adott exporthoz

5. Telepítés a célgépre

A célgép egy friss Ubuntu Server 24.04 arm64 Raspberry Pi 4-en (SSH-val). A program önálló, a gépre nem kell .NET.

scp kofa-app-vitorlas-linux-arm64.tar.gz ubuntu@<gép>.local:/tmp/
ssh ubuntu@<gép>.local
cd /tmp && tar xzf kofa-app-vitorlas-linux-arm64.tar.gz
cd kofa-app-vitorlas
sudo ./install.sh

A telepítő sorban:

1. ellenőrzi a gépet (root, aarch64, systemd, Ubuntu, szabad hely) és a csomagot (formátum, platform, SHA-256);
2. leállítja és letiltja a teljes KOFA-t, ha ugyanazon a gépen fut (ugyanazt a hardvert foglalnák); másik program cseréjekor rákérdez, és a régi adatokat backup-<dátum> alá menti;
3. felteszi a hiányzó rendszercsomagokat, csak ami a beállításokhoz kell: BlueZ (Bluetooth), NetworkManager + dnsmasq-base + avahi-daemon + iw (hálózat), cage + böngésző (kiosk), libusb USB-s Komodnál; bekapcsolja az I2C-t, ha hardver Komod van a gráfban;
4. létrehozza a kofa-app (és kiosk esetén a kofa-kiosk) rendszerfelhasználót;
5. a programot az /opt/kofa-app mappába másolja, a titkokat (Wi-Fi jelszavak) feldolgozza, és létrehozza az /etc/kofa-app/local.json gépi beállításfájlt;
6. beállítja a hálózatot (hotspot / kliens), telepíti a kofa-app.service és kiosk esetén a kofa-kiosk.service unitot;
7. elindítja a programot, megvárja, hogy válaszoljon, és összefoglalót ír: a felület címei (IP, <gépnév>.local, hotspot esetén az SSID és a 10.42.0.1), a kiosk állapota és a jelszócsere helye.

A telepítő kapcsolói

Felülírják az exportkor választottat:

Az újrafuttatás frissítés: a program cserélődik, a /var/lib/kofa-app (adatok) és az /etc/kofa-app (gépi beállítások) megmarad.

Egy paranccsal a fejlesztői gépről

tools/deploy-lite.sh --host 192.168.2.224 --user kofa-hw1 --key ~/.ssh/KOFA-HW1 \
    --app ~/Downloads/kofa-app-vitorlas-linux-arm64.tar.gz [--remove-full] [-- --no-kiosk --port 5090]

A szkript kicsomagolja az exportot, kiegészíti a futtató sablonnal, feltölti, és a célgépen sudo ./install.sh --yes fut (a sudo jelszót a terminálban kéri). A --remove-full a sikeres telepítés után törli a gépről a teljes KOFA-t. A -- utáni kapcsolók az install.sh-nak mennek. Több gépre ugyanazzal a csomaggal, más --host-tal.

Hol van minden telepítés után

6. A Lite felülete

Megnyitás: http://<gép>:5090 (vagy http://<gépnév>.local:5090, hotspoton http://10.42.0.1:5090); kiosk módban a gép kijelzőjén magától.

Bejelentkezés

Jelszavas módban az oldalak a kezelői jelszót kérik. Admin funkciókhoz a menüben a Belépés adminként pont visz az admin jelszó oldalára.

Dashboard

A rögzített dashboard a gráf Komod nézeteivel. A fejlécben mindig ott a piros STOP (vészleállító), a figyelmeztető jelvény (az Állapot oldalra visz) és a menü.

Állapot

Az Állapot oldal a program nevét és revízióját, a gráf állapotát, a hardver backendet, az indulás idejét, a vészleállítók számát, a kapcsolatot és a gráf problémáit mutatja.

Hálózat

A Hálózat oldal (Admin) ugyanaz, mint a teljes KOFA-ban: Wi-Fi állapot, csatlakozás, saját hotspot, tartalék hotspot, Bluetooth és a csatlakozási QR kód a KOFA apphoz. Ami a kapcsolatot megszakíthatja, próba módban indul: ha 2 percen belül nem erősíted meg, az előző beállítás visszaáll.

Adminisztráció

Az Adminisztráció oldalon (Admin) cserélheted a jelszavakat, feltölthetsz egy újabb exportot (Frissítés új exporttal), újraindíthatod a programot és kikapcsolhatod a gépet (a hajón így vehető el biztonságosan az áram). Relay módban itt látszik a párosító kód is.

7. A gép kezelése SSH-n: kofa-app

Telepítés után a kofa-app parancs a gépen mindig kezelhetővé teszi a programot, akkor is, ha a felület nem érhető el.

Eltávolítás: sudo ./uninstall.sh (vagy sudo kofa-app uninstall) leállítja és törli a szolgáltatásokat és az /opt/kofa-app-ot; a --purge kapcsoló az adatokat és a gépi beállításokat is törli. A hálózati beállításokhoz nem nyúl.

8. Frissítés

Két mód:

• A felületről (ha az export engedte): Adminisztráció → Frissítés új exporttal: tölts fel egy újabb kofa-app-….tar.gz exportot. A gép ellenőrzi, rootként telepíti, és újraindítja a programot. Ha az új program nem indul el, az előző áll vissza; az eredményt (succeeded, rolled-back, failed) és a telepítő naplóját az Adminisztráció oldal mutatja. A jelszavak, a kiosk, a port és az adatok maradnak.
• SSH-n: a sudo ./install.sh az új csomagból, vagy tools/deploy-lite.sh.

9. Hibaelhárítás

Továbbiak: KOFA telepítése és első beállítása, Hibaelhárítás.