Wartung

Regelmäßige Wartung stellt sicher, dass Admin Bud-E zuverlässig läuft, sicher bleibt und optimal konfiguriert ist. Dieser Abschnitt beschreibt tägliche, wöchentliche und monatliche Wartungsaufgaben.

Wartungs-Übersicht

Frequenz	Aufgaben	Dauer	Priorität
Täglich	Logs prüfen, Fehler-Monitoring	5-10 Min	Mittel
Wöchentlich	Usage analysieren, Credits prüfen	15-30 Min	Hoch
Monatlich	Updates, Backups testen, Budget-Review	1-2 Std	Hoch
Quartalsweise	Umfassende Wartung, Optimierung	2-4 Std	Mittel
Jährlich	Security-Audit, Archivierung	4-8 Std	Hoch

Tägliche Wartung

1. System-Status prüfen

bash

# Service-Status
sudo systemctl status admin-bude.service

# Erwartete Ausgabe:
# ● admin-bude.service - Admin Bud-E (Middleware)
#    Active: active (running)

Schnellcheck

Wenn der Service läuft, ist meist alles in Ordnung.

2. Logs überprüfen

bash

# Letzte 50 Zeilen der Logs
sudo journalctl -u admin-bude.service -n 50

# Fehler suchen
sudo journalctl -u admin-bude.service -p err -n 20

Achten Sie auf:

❌ HTTP 500 Fehler (Server-Fehler)
❌ HTTP 429 Fehler (Rate Limits)
❌ Timeout-Fehler
❌ Datenbank-Fehler

3. Speicherplatz prüfen

bash

# Festplatten-Nutzung
df -h

# Erwartung: / sollte < 80% sein

Bei > 80%

Alte Logs/Backups löschen oder Festplatte vergrößern.

4. Uptime prüfen

bash

uptime

Nutzen Sie Monitoring-Tools:

UptimeRobot (kostenlos für Basis-Monitoring)
Pingdom
StatusCake

Wöchentliche Wartung

1. Usage Reports analysieren

Im Admin-Dashboard:

Navigieren Sie zu Usage
Filter: Letzte 7 Tage
Prüfen Sie:

Gesamtverbrauch: ______ Credits
Durchschnitt/Tag: ______ Credits
Anzahl Anfragen: ______
Fehlerrate: ______%

Top-5-Nutzer:
1. ____________: ______ Credits
2. ____________: ______ Credits
3. ____________: ______ Credits
4. ____________: ______ Credits
5. ____________: ______ Credits

Alarme:

⚠️ Fehlerrate > 5%
⚠️ Ein Nutzer > 50% des Gesamt-Verbrauchs
🚨 Fehlerrate > 10%

2. Credit-Stände prüfen

Im Admin-Dashboard:

Navigieren Sie zu Users
Sortieren Sie nach Credits (aufsteigend)
Identifizieren Sie Nutzer mit < 10 Credits

Aktion:

Nutzer mit < 10 Credits: _______
→ Credits nachfüllen?
→ Allowance ausreichend?

3. Common Pool Status

Im Admin-Dashboard:

Navigieren Sie zu Projects
Prüfen Sie Common Pool für jedes Projekt

Projekt Schüler:
  Common Pool: 5.234 / 10.000 Credits (52%)
  Status: ✅ OK

Projekt Lehrkräfte:
  Common Pool: 345 / 3.000 Credits (12%)
  Status: ⚠️ Niedrig → Nachfüllen erwägen

4. Provider-Status

Prüfen Sie:

Sind alle Provider erreichbar?
Gibt es vermehrt Failover?
Funktioniert Vertex AI EU-Region?

bash

# Test-Anfrage an Provider
curl -X POST https://ihr-server/api/test-provider \
  -H "Authorization: Bearer ADMIN_TOKEN" \
  -d '{"provider": "vertex", "model": "gemini-1.5-flash"}'

Monatliche Wartung

1. Software-Updates

Betriebssystem

bash

# Ubuntu-Updates
sudo apt update
sudo apt upgrade -y

# Neustart bei Kernel-Updates
sudo reboot

Neustart

Planen Sie Neustarts für wartungsarme Zeiten (z.B. Sonntag 3 Uhr).

Middleware

bash

cd /opt/bud-e/school-bud-e-middleware

# Git Pull (neue Version)
git pull

# Virtual Environment aktivieren
source .venv/bin/activate

# Dependencies aktualisieren
pip install -r requirements.txt --upgrade

# Service neu starten
sudo systemctl restart admin-bude.service

# Status prüfen
sudo systemctl status admin-bude.service

2. Backup-Test

Mindestens monatlich:

Neuestes Backup herunterladen
Auf Test-System wiederherstellen
Funktionalität prüfen
Dokumentieren

Siehe Backups für Details.

3. Budget-Review

Für jedes Projekt:

Projekt: Schüler
─────────────────────────────────────
Gesamt-Budget: 50.000 Credits
Verbraucht: 34.567 Credits (69%)
Verbleibend: 15.433 Credits (31%)

Hochrechnung (bei gleichem Verbrauch):
→ Budget reicht noch: ~13 Tage

Aktion:
□ Budget aufstocken
□ Verbrauch optimieren
□ Allowance anpassen

4. Pricing-Aktualisierung

Prüfen Sie:

Haben Provider Preise geändert?
Sind neue Modelle verfügbar?
Gibt es günstigere Alternativen?

Provider: Google Vertex AI
Letzter Check: _________
Preisänderung: Ja / Nein
Neue Modelle: Ja / Nein

Aktion:
□ Pricing aktualisieren
□ Neue Modelle testen
□ Routen anpassen

5. Security-Patches

bash

# Sicherheitsupdates
sudo apt update
sudo apt list --upgradable | grep -i security

# Security Advisories prüfen
# - Ubuntu Security Notices: https://ubuntu.com/security/notices
# - Python: https://www.python.org/downloads/

6. Logs rotieren

bash

# Alte Logs komprimieren
sudo journalctl --rotate
sudo journalctl --vacuum-time=30d

# Speicherplatz nach Rotation
df -h

Quartalsweise Wartung

1. Umfassende Analyse

Usage-Trends (3 Monate):

Q4 2025 (Okt-Dez)
─────────────────────────────────────
Gesamt-Credits: 123.456
Gesamt-Anfragen: 234.567

Durchschnitt/Monat:
  Credits: 41.152
  Anfragen: 78.189

Trends:
  Oktober: 38.900 Credits
  November: 42.100 Credits ↑
  Dezember: 42.456 Credits ↑

Interpretation: Steigender Trend (+9%)
→ Budget für Q1 2026 entsprechend anpassen

2. Nutzer-Cleanup

Inaktive Nutzer:

bash

# Im Admin-Dashboard:
# Filter: "Letzte Nutzung > 90 Tage"

Inaktive Nutzer: _______
Aktion:
□ Deaktivieren
□ Löschen (nach Rücksprache)
□ Credits zurückbuchen

3. Datenbank-Optimierung

bash

# Datenbank-Größe vor Optimierung
ls -lh /opt/bud-e/school-bud-e-middleware/data/admin_bude.db

# SQLite VACUUM (komprimiert DB)
sqlite3 /opt/bud-e/school-bud-e-middleware/data/admin_bude.db "VACUUM;"

# Datenbank-Größe nach Optimierung
ls -lh /opt/bud-e/school-bud-e-middleware/data/admin_bude.db

# Integrität prüfen
sqlite3 /opt/bud-e/school-bud-e-middleware/data/admin_bude.db "PRAGMA integrity_check;"

4. Provider-Performance-Review

Für jeden Provider:

Provider: Vertex AI
─────────────────────────────────────
Anfragen gesamt: 150.234
Fehlerrate: 0.8% ✅
Ø Response-Zeit: 1.2s ✅
Kosten gesamt: $1.234,56

Provider: Together AI
─────────────────────────────────────
Anfragen gesamt: 45.678
Fehlerrate: 2.3% ⚠️
Ø Response-Zeit: 0.9s ✅
Kosten gesamt: $345,67

Aktion:
□ Together-Fehler analysieren
□ Ggf. Routen-Prioritäten anpassen

5. Dokumentation aktualisieren

✅ Änderungen seit letztem Quartal dokumentieren
✅ Neue Provider/Modelle ergänzen
✅ Preise aktualisieren
✅ Best Practices anpassen

Jährliche Wartung

1. Security-Audit

Prüfen Sie:

Sicherheits-Checkliste:
─────────────────────────────────────
□ Admin-Passwort geändert (< 6 Monate alt)
□ SSH-Keys rotiert
□ Firewall-Regeln aktuell
□ Alle Ports geschlossen außer 80/443/22
□ TLS-Zertifikat gültig
□ Keine veraltete Software (Ubuntu, Python)
□ API-Keys rotiert (bei Verdacht)
□ Backup-Verschlüsselung funktioniert
□ Zugriffs-Logs überprüft
□ Keine bekannten Schwachstellen (CVEs)

2. Compliance-Review (DSGVO)

Datenschutz-Checkliste:
─────────────────────────────────────
□ Verarbeitungsverzeichnis aktuell
□ DPAs mit allen Providern vorhanden
□ Datenschutzhinweise aktuell
□ Löschkonzept eingehalten
□ Alte Logs gelöscht (> Aufbewahrungsfrist)
□ Betroffenenrechte-Prozess getestet
□ DSFA (falls nötig) aktualisiert
□ Datenschutzbeauftragter informiert

3. Archivierung

Jahresabschluss-Daten:

bash

# Verzeichnis erstellen
mkdir -p /opt/bud-e/archives/2025/

# Usage-Report für gesamtes Jahr
# (Im Admin-Dashboard: Export Jan-Dez 2025)

# Alle monatlichen Backups
cp /opt/bud-e/backups/2025-*.db.gz /opt/bud-e/archives/2025/

# Compress
tar -czf /opt/bud-e/archives/archive_2025.tar.gz /opt/bud-e/archives/2025/

# Extern speichern
aws s3 cp /opt/bud-e/archives/archive_2025.tar.gz s3://bucket/archives/

4. Budget-Planung (nächstes Jahr)

Jahr 2026 Budget-Planung:
─────────────────────────────────────
Basis: Verbrauch 2025 = 500.000 Credits

Wachstum:
  Neue Nutzer: +30% → 150.000 Credits
  Neue Features: +10% → 50.000 Credits

Gesamt-Bedarf 2026: 700.000 Credits

Kosten (bei $0.01/Credit):
  $7.000 für 2026
  $583/Monat

Budget-Freigabe:
  □ Mit Schulleitung/Management besprochen
  □ Freigegeben
  □ In Admin Bud-E konfiguriert

5. Hardware-Review

Server-Review:
─────────────────────────────────────
CPU-Auslastung Ø: ____%
RAM-Auslastung Ø: ____%
Disk-Auslastung: ____%
Netzwerk-Traffic: _____GB/Monat

Empfehlung:
□ Keine Änderung nötig
□ RAM upgraden
□ CPU upgraden
□ Festplatte vergrößern
□ Server zu klein → Upgrade auf __________

Wartungs-Automatisierung

Monitoring-Script

bash

#!/bin/bash
# /opt/bud-e/monitor.sh

# Check service status
if ! systemctl is-active --quiet admin-bude.service; then
  echo "🚨 Service nicht aktiv!"
  # Send alert (z.B. E-Mail, Slack)
fi

# Check disk space
DISK_USAGE=$(df -h / | awk 'NR==2 {print $5}' | sed 's/%//')
if [ "$DISK_USAGE" -gt 80 ]; then
  echo "⚠️ Festplatte > 80% voll: ${DISK_USAGE}%"
fi

# Check last backup
LAST_BACKUP=$(find /opt/bud-e/backups/ -name "*.db.gz" -mtime -1 | wc -l)
if [ "$LAST_BACKUP" -eq 0 ]; then
  echo "🚨 Kein Backup in letzten 24h!"
fi

echo "✅ Alle Checks OK"

Cron (täglich 9 Uhr):

0 9 * * * /opt/bud-e/monitor.sh | mail -s "Admin Bud-E Status" admin@schule.de

Update-Script

bash

#!/bin/bash
# /opt/bud-e/update.sh

cd /opt/bud-e/school-bud-e-middleware

# Backup vor Update
./backup.sh

# Git pull
git pull

# Dependencies
source .venv/bin/activate
pip install -r requirements.txt --upgrade

# Restart
sudo systemctl restart admin-bude.service

# Status
sleep 3
sudo systemctl status admin-bude.service

Wartungs-Kalender

Beispiel für Schule

Wöchentlich: Montag 8:00

Usage-Report der letzten Woche
Credit-Stände prüfen
Fehler-Check

Monatlich: 1. des Monats

Budget-Review
Backup-Test
Software-Updates
Pricing-Check

Quartalsweise: Januar, April, Juli, Oktober

Umfassende Analyse
Provider-Review
Nutzer-Cleanup
Datenbank-Optimierung

Jährlich: August (vor Schuljahresbeginn)

Security-Audit
Compliance-Review
Budget-Planung (nächstes Schuljahr)
Hardware-Review
Archivierung

Wartungs-Log

Führen Sie ein Wartungs-Log:

markdown

# Wartungs-Log Admin Bud-E

## 2025-10-11 - Wöchentliche Wartung
- Usage geprüft: 12.345 Credits (OK)
- 3 Nutzer mit < 10 Credits (nachgefüllt)
- Common Pool OK
- Keine Fehler

## 2025-10-01 - Monatliche Wartung
- Software-Updates installiert
- Backup-Test erfolgreich
- Budget-Review: Schüler-Projekt bei 68%
- Pricing aktualisiert (Gemini Flash: $0.075→$0.10)

## 2025-07-01 - Quartalsweise Wartung
- Q2 2025 Analyse abgeschlossen
- 15 inaktive Nutzer deaktiviert
- Datenbank VACUUM: 245MB → 198MB
- Provider-Review: Alle OK

Best Practices

Konsistenz: Halten Sie sich an den Wartungsplan
Dokumentation: Protokollieren Sie alle Änderungen
Automatisierung: Nutzen Sie Scripts für wiederkehrende Aufgaben
Monitoring: Früherkennung verhindert größere Probleme
Testing: Testen Sie Updates/Änderungen zuerst auf Test-System

Nächste Schritte

Backups - Backup-Strategie umsetzen
FAQ - Häufige Wartungs-Fragen
Privacy - Datenschutz-Compliance prüfen

Wartung ​

Wartungs-Übersicht ​

Tägliche Wartung ​

1. System-Status prüfen ​

2. Logs überprüfen ​

3. Speicherplatz prüfen ​

4. Uptime prüfen ​

Wöchentliche Wartung ​

1. Usage Reports analysieren ​

2. Credit-Stände prüfen ​

3. Common Pool Status ​

4. Provider-Status ​

Monatliche Wartung ​

1. Software-Updates ​

Betriebssystem ​

Middleware ​

2. Backup-Test ​

3. Budget-Review ​

4. Pricing-Aktualisierung ​

5. Security-Patches ​

6. Logs rotieren ​

Quartalsweise Wartung ​

1. Umfassende Analyse ​

2. Nutzer-Cleanup ​

3. Datenbank-Optimierung ​

4. Provider-Performance-Review ​

5. Dokumentation aktualisieren ​

Jährliche Wartung ​

1. Security-Audit ​

2. Compliance-Review (DSGVO) ​

3. Archivierung ​

4. Budget-Planung (nächstes Jahr) ​

5. Hardware-Review ​

Wartungs-Automatisierung ​

Monitoring-Script ​

Update-Script ​

Wartungs-Kalender ​

Beispiel für Schule ​

Wartungs-Log ​

Best Practices ​

Nächste Schritte ​

Wartung

Wartungs-Übersicht

Tägliche Wartung

1. System-Status prüfen

2. Logs überprüfen

3. Speicherplatz prüfen

4. Uptime prüfen

Wöchentliche Wartung

1. Usage Reports analysieren

2. Credit-Stände prüfen

3. Common Pool Status

4. Provider-Status

Monatliche Wartung

1. Software-Updates

Betriebssystem

Middleware

2. Backup-Test

3. Budget-Review

4. Pricing-Aktualisierung

5. Security-Patches

6. Logs rotieren

Quartalsweise Wartung

1. Umfassende Analyse

2. Nutzer-Cleanup

3. Datenbank-Optimierung

4. Provider-Performance-Review

5. Dokumentation aktualisieren

Jährliche Wartung

1. Security-Audit

2. Compliance-Review (DSGVO)

3. Archivierung

4. Budget-Planung (nächstes Jahr)

5. Hardware-Review

Wartungs-Automatisierung

Monitoring-Script

Update-Script

Wartungs-Kalender

Beispiel für Schule

Wartungs-Log

Best Practices

Nächste Schritte