TVIP Knowledge Base TVIP Provisioning Server-Installation

TVIP Provisioning Server-Installation

TVIP Provisioning-Server (Ubuntu 22.04)

Diese Anleitung richtet einen TVIP Provisioning-Server auf Ubuntu 22.04 ein. Die Boxen holen /prov/tvip_provision.xml ab; ist ein MAC-Header vorhanden und ein passender Ordner angelegt, wird automatisch auf /prov.mac/<MAC>/tvip_provision.xml umgeleitet.

Voraussetzungen & Domain-Eingabe

  • Ubuntu 22.04 LTS mit sudo
  • Port 80 erreichbar (extern oder nur im LAN)
  • FQDN/Domain (kein IP-Wert), z. B. provisioning.example.com

Domain eingeben: Nur die Domain — ohne http:// oder https://, ohne Pfade/Ports. Der Name muss mit einer gültigen TLD enden (z. B. .com, .ch, .net).

  • Korrekt: provisioning.example.com
  • Falsch: http://provisioning.example.com, example.local/abc, 192.0.2.10

Installation

curl -fsSL https://raw.githubusercontent.com/AproAG-CH/tvip-provisioning-installer/main/install.sh | sudo -E bash

Der Installer fragt die Domain ab und richtet NGINX sowie die Verzeichnisstruktur ein.

Ablageorte

  • Default: /var/www/provisioning/prov/tvip_provision.xml
  • Per-MAC: /var/www/provisioning/prov.mac/<MAC>/tvip_provision.xml
  • Index: /var/www/provisioning/html/index.html

Per-MAC Beispiel anlegen:

MAC=00:11:22:33:44:55
sudo mkdir -p /var/www/provisioning/prov.mac/$MAC
sudo cp /var/www/provisioning/prov/tvip_provision.xml /var/www/provisioning/prov.mac/$MAC/
sudo chown -R www-data:www-data /var/www/provisioning/prov.mac/$MAC

# Test (liefert die MAC-Version, falls Ordner existiert)
curl -I -H "MAC-Address: $MAC" http://provisioning.example.com/prov/tvip_provision.xml

Schnelle Prüfung

# NGINX prüfen & neu laden
sudo nginx -t && sudo systemctl reload nginx

# Startseite
curl -I http://provisioning.example.com/

# Default-Provisioning-XML
curl -I http://provisioning.example.com/prov/tvip_provision.xml

# Optional: MAC-Override (wenn Datei existiert)
curl -I -H 'MAC-Address: 00:11:22:33:44:55' \
  http://provisioning.example.com/prov/tvip_provision.xml