GUIDE FUSEKI RUNNING

Fuseki betreiben und pflegen

Letztes Update: 31. März 2026

Inhalt

1. Wozu dieser Guide?
2. Grundprinzip
3. Zugriff und Voraussetzungen
4. Zustand prüfen
5. Ontologie aktualisieren
6. Änderungen nach GitHub übertragen
7. Container verwalten
8. Container neu bauen
9. Deployment (Ansible)
10. Mögliche Probleme / Fragen
11. Aktueller Stand
12. Aussicht

---

Wozu dieser Guide?

Ziel: Technisch verantwortliche Personen sollen den Fuseki-Dienst prüfen, aktualisieren und bei Bedarf neu starten können.

Mit diesem Guide können Sie:

• den aktuellen Zustand prüfen
• die Ontologie aktualisieren
• den Container verwalten
• Probleme erkennen und eingrenzen

---

Grundprinzip

Der Betrieb folgt einem einfachen Muster:

1. Git ist die Quelle der Daten
   Die Ontologie liegt im Repository und wird von dort übernommen.

2. Fuseki läuft im Container
   Der Dienst läuft isoliert in einem Podman-Container.

3. Änderungen werden nicht direkt im System gemacht
   Änderungen erfolgen im Repository → dann Update auf dem Server.

---

Zugriff und Voraussetzungen

Für den Betrieb benötigen Sie:

• SSH-Zugang zum Server
• grundlegende Linux-Kenntnisse
• Zugriff auf das Repository

Verbindung zum Server:

ssh <server-user>@<server-host>

---

Zustand prüfen

Repository prüfen

cd ~/repos/ontology-development
git status

---

Container prüfen

sudo podman ps -a

---

Funktionstest durchführen

curl "http://127.0.0.1:3030/fuseki-rg/rg/query?query=ASK%20%7B%20?s%20?p%20?o%20%7D"

Erwartetes Ergebnis:

true

Wenn true zurückkommt, läuft der Dienst korrekt.

---

Ontologie aktualisieren

Wenn sich Daten im Repository geändert haben:

cd ~/repos/ontology-development
git pull
sudo podman restart fuseki-rg

---

Änderungen nach GitHub übertragen

Nur möglich, wenn Schreibzugriff eingerichtet ist:

cd ~/repos/ontology-development
git status
git add .
git commit -m "Update ontology"
git push

---

Container verwalten

Status anzeigen

sudo podman ps -a

Logs ansehen

sudo podman logs fuseki-rg

Neustarten

sudo podman restart fuseki-rg

Stoppen

sudo podman stop fuseki-rg

---

Container neu bauen

cd ~/fuseki-rg/container

sudo podman build -t localhost/fuseki-rg:latest .

sudo podman rm -f fuseki-rg 2>/dev/null || true

sudo podman run -d \
  --name fuseki-rg \
  --publish 127.0.0.1:3030:3030 \
  --restart unless-stopped \
  --volume "/home/<server-user>/repos/ontology-development/files/processed/rg_ontology.ttl:/app/data/rg_ontology.ttl:ro,Z" \
  localhost/fuseki-rg:latest

---

Deployment (Ansible)

Beispiel (HTTPS)

ansible-playbook -i inventory.ini deploy-fuseki-thulb.yml \
  -e fuseki_install_mode=remote_download \
  -e fuseki_version=6.0.0 \
  -e ontology_repo_url=https://github.com/HisQu/Ontology-Development.git \
  -e ontology_repo_version=main

---

Beispiel (SSH Deploy Key)

ansible-playbook -i inventory.ini deploy-fuseki-thulb.yml \
  -e fuseki_install_mode=remote_download \
  -e fuseki_version=6.0.0 \
  -e ontology_repo_url=git@github-ontology:HisQu/Ontology-Development.git \
  -e ontology_repo_version=main

---

Mögliche Probleme / Fragen

❗ Der curl-Test liefert kein Ergebnis

Mögliche Ursachen:

• Container läuft nicht
• falsche URL oder Port
• Fuseki ist nicht gestartet
• Netzwerkproblem

❗ Änderungen sind nicht sichtbar

Bitte prüfen:

• wurde git pull ausgeführt?
• wurde der Container neu gestartet?

---

Aktueller Stand

• Fuseki läuft in einem Podman-Container
• Ontologie kommt aus dem Git-Repository
• Zugriff erfolgt lokal + über Proxy
• Betrieb funktioniert, ist aber teilweise manuell

---

Aussicht

Langfristig soll der Betrieb stabiler und einfacher werden:

• eigener Service-User für Fuseki
• feste öffentliche URL
• automatisiertes Deployment
• klarer Git-basierter Workflow
• bessere Wartbarkeit für mehrere Personen