Quickstart
In 30 Minuten von Null zur ersten beantworteten TRM-Frage.
Bevor du startest:
- ✓ Docker Desktop installiert: docker.com/get-started
- ✓ SAP-Voraussetzungen erfüllt → Setup-Checkliste
- ✓ Lizenz-Key bekommen (per Mail nach Trial-Registrierung)
1
Installer ausführen (5 Min)
curl -sSL https://trm-oracle.pages.dev/install.sh -o trm-oracle-install.sh
chmod +x trm-oracle-install.sh
./trm-oracle-install.sh
Der Wizard fragt interaktiv ab:
- SAP-Host, Mandant, User, Passwort
- TLS-Verify (false bei selbst-signierten Zerts)
- Anthropic API Key (optional, Enter zum Überspringen)
- Lizenz-Key (aus deiner Trial-E-Mail)
2
Crawl starten (3–15 Min)
Im Browser öffnen: http://localhost:8080/setup → Klick "Crawl starten".
Das Orakel zieht aus deinem System:
- • ~4.000 Transaktionen
- • ~14.000 Function Modules
- • ~27.000 BAPI-Parameter
- • ~85.000 DDIC-Felder
- • ~10.000 Domänen + Festwerte
- • ~1.500 Customizing-Werte
- • ~10.000 TRM-Messages
- • ~2.500 System-Doku-Chunks
3
Erste Frage stellen
Im Browser: http://localhost:8080
Drei Beispiele die immer funktionieren:
- 📋 "Welche Felder hat die Tabelle VTBFHA?"
- 🔧 "Welche Pflichtfelder hat BAPI_FTR_CREATEFROMDATA?"
- 📊 "Was macht die Transaktion TPM12?"
Tägliche Nutzung
Web-UI
Auf http://localhost:8080 öffnen und tippen. History links bleibt persistent.
Claude Desktop / Cursor / Continue.dev
MCP-Adapter integriert die 5 Tools in deine IDE. Setup-Anleitungen pro Tool sind im Repo unter integrations/mcp/.
Slack (Pro-Tier)
Bot installieren, @trm-orakel in Channels einladen, direkte Fragen tippen.
Operations
Logs anzeigen
cd ~/trm-oracle
docker compose logs -f trm-oracle
Re-Crawl (z.B. nach SAP-Release-Update)
Web-UI: Setup → "Crawl starten" — oder CLI:
docker compose exec trm-oracle python3 scripts/crawl_all.py --full
Service stoppen / starten
docker compose down # stoppen
docker compose up -d # starten
docker compose restart # neu starten
Update auf neue Version
cd ~/trm-oracle
git pull
docker compose build --no-cache
docker compose up -d
Daten sichern
tar czf trm-oracle-backup-$(date +%F).tgz data/
Troubleshooting
| Problem | Lösung |
|---|---|
| Web-UI lädt nicht | docker compose ps + docker compose logs trm-oracle |
| SAP nicht erreichbar | VPN/Cloud-Connector aktiv? docker compose exec trm-oracle ping host.docker.internal |
| Crawl hängt | docker compose restart trm-oracle — bei großen Systemen Quick-Modus statt Full |
| 0 Entities nach Crawl | TRM-Paket-Patterns nicht im System — config.py editieren, eigene Patterns ergänzen |
| Lizenz-Trial abgelaufen | Antworten funktionieren weiter. Lizenz kaufen → in .env als TRM_ORACLE_LICENSE_KEY |
| "401 Unauthorized" beim ADT-Call | SAP-User hat S_DEVELOP nicht. User-Rechte prüfen. |
Noch keinen Lizenz-Key?
30 Tage kostenlos testen, keine Kreditkarte.
Trial starten →