RFEM-Störungssuche

Das Einrichten steht unter RFEM verbinden. Diese Seite ist für den Fall, dass es nicht funktioniert.

Jeder Zustand unten hat seine eigene Adresse, damit Dlubal CALC dich direkt zu dem schicken kann, der gerade gilt: /docs/rfem/troubleshooting#rfem-not-running ist der Abschnitt für genau diese Blockade und für nichts anderes.

Verbindung zu RFEM wiederherstellen

Im RFEM-Menü öffnet „Verbindung zu RFEM wiederherstellen“ die geführte Prüfung. Mit deiner Freigabe prüft CALC den Connector, bietet bei Bedarf ein Update an, synchronisiert den Schlüssel deines angemeldeten Kontos und prüft die RFEM-Verbindung. Ein Setup oder eine Windows-Berechtigungsabfrage kann deine Bestätigung benötigen. RFEM-Modelle werden nicht verändert. RFEM wird nur gestartet, wenn du in diesem Dialog auf RFEM starten klickst, und nie geschlossen.

Ab Connector 2.30.7 kann ein erneuter ausdrücklicher Versuch auch einen bereits gespeicherten, aber noch nicht angewendeten Kontoschlüssel aktivieren. Verhindert ein laufender oder ungeklärter Vorgang den sicheren Neustart, meldet CALC die ausstehende Aktivierung. Prüfe den Vorgang und starte die Wiederherstellung danach erneut.

Die Einrichtung wartet höchstens zehn Minuten, die eigentliche Verbindungsprüfung höchstens drei Minuten. Schließen lässt die Prüfung auf dieser Seite im Hintergrund weiterlaufen; „Prüfung beenden“ beendet weitere Prüfungen. Bereits gestartete Aktionen können weiterlaufen. Erfolg setzt einen bestätigten RFEM-Zugriff voraus. Frühere Modellanfragen werden nicht automatisch wiederholt.

Unterstützt der installierte Connector native Updates, kann Prüfen und reparieren die angebotene Version prüfen und den Installer mit Standard-Einstellungen starten. Windows kann weiterhin eine UAC-Bestätigung verlangen. Bei fehlendem oder älterem Connector erfolgt die Installation über den angebotenen Download. Abbruch und zurückgestellte Installation werden getrennt angezeigt; ein unbekannter Ausgang löst keinen zweiten Installationsversuch aus.

Zuerst: welches Glied der Kette fehlt

Das RFEM-Menü und die RFEM-Zeile in den Einstellungen verwenden denselben Verbindungsstatus. Eine erfolgreiche Anmeldung am MCP-Server allein bestätigt keinen RFEM-Zugriff; eine bekannte API-Key-Ablehnung erscheint in beiden Anzeigen.

Drei Programme müssen zusammenspielen, und jedes kann für sich ausfallen:

Öffne zuerst das RFEM-Symbol in der Nachrichtenleiste und lies die gemeldete Blockade. http://127.0.0.1:8083/rfem-info liefert ergänzend Versionsangaben. Diese und eine erfolgreiche /health-Antwort beweisen keinen RFEM-API-Zugriff. Über das Cloud-Relay bleibt die Bereitschaft unbestätigt, solange kein aktueller Connector-Status vorliegt.

RFEM ist nicht installiert

Blockade: rfem_not_installed

Auf dem Rechner, auf dem der Connector läuft, wurde keine RFEM-6-Installation gefunden.

Installiere RFEM 6, oder koppel den Connector auf dem Rechner, der es hat. Connector und RFEM müssen auf demselben Rechner sein: der Connector spricht über eine lokale Schnittstelle mit RFEM, nicht über das Netzwerk.

RFEM läuft nicht

Blockade: rfem_not_running

RFEM6.exe läuft nicht. Öffne RFEM 6, dann löst sich der Zustand von selbst, meist innerhalb weniger Sekunden. Es muss nichts neu gestartet werden.

In „Verbindung zu RFEM wiederherstellen“ öffnet RFEM starten RFEM für dich; das geschieht nur bei diesem Klick. Der Dialog bleibt beim Schritt RFEM, solange RFEM startet, und setzt den Verbindungstest selbst fort, sobald RFEM bereit ist. Startet RFEM bereits, öffnet der Button keine zweite Instanz.

Ein Dialog in RFEM blockiert

Blockade: rfem_modal_dialog

Wechsel zu RFEM und schließ den Dialog. War bereits ein Auftrag gestartet, warte dessen Ergebnis ab und prüfe das Modell vor einer erneuten Anfrage. Eine Zeitüberschreitung im Chat bestätigt nicht, dass RFEM die Arbeit beendet hat.

RFEM wurde gestartet, aber sein Fenster erscheint nicht

RFEM kann schon beim eigenen Start stehen bleiben, bevor sich das Hauptfenster öffnet, weil es zuerst etwas fragt: einen Hinweis auf eine neue Version, einen Fehler oder ob ein Modell nach einem unerwarteten Beenden wiederhergestellt werden soll. RFEM läuft dann, aber du siehst es womöglich gar nicht; die Dialoge können auch auf einem anderen Monitor liegen.

„Verbindung zu RFEM wiederherstellen“ benennt diesen Fall: Es zeigt, wann RFEM gestartet wurde und welche Dialoge warten. RFEM-Dialog anzeigen holt den aktiven Dialog in den Vordergrund. Lässt Windows das nicht zu, blinkt der Dialog stattdessen in der Taskleiste. CALC beantwortet, verschiebt oder schließt nie einen RFEM-Dialog für dich. Sobald du alle beantwortet hast, setzt der Dialog den Verbindungstest selbst fort, solange er offen ist.

Die Komponente startet

Blockade: mcp_starting

Ein Start oder Neustart läuft gerade. Diese Phase ist zeitlich begrenzt: warten, dann löst es sich.

Die Ersteinrichtung installiert noch

Blockade: mcp_installing

Die Ersteinrichtung lädt die benötigten MCP-Pakete und prüft sie. Das kann Minuten dauern. Ab MCP 1.0.14 mit passendem Connector liegen diese Pakete außerhalb des RFEM-Installationsverzeichnisses. Python und die Dlubal-API kommen weiterhin aus dem laufenden Dlubal-Programm: RFEM, ab Connector 2.30.25 auch RSECTION oder RSTAB.

Nichts bedient die Verbindung

Blockade: mcp_down

RFEM läuft, aber keine Komponente antwortet für es. Starte den Connector neu.

Kommt der Zustand wieder, schau auf die Versionszeile unter Einstellungen → MCP-Server. Eine veraltete Komponente, die immer wieder aus einer früheren Sitzung übernommen wird, ist der übliche Grund dafür, dass ein Neustart eine Weile hilft und dann nicht mehr.

Die Komponente antwortet nicht mehr

Blockade: mcp_unresponsive

Prüfe zuerst in RFEM, ob ein Auftrag noch läuft. Danach kannst du einen kontrollierten Connector-Neustart versuchen. Ab MCP 1.0.14 mit passendem Connector verhindern laufende oder ungeklärte Vorgänge das Beenden des MCP-Prozesses. Lässt sich der Leerlauf nicht bestätigen, bleibt der Neustart gesperrt.

Mit aktualisiertem Connector wartet der Connector bei einem geschützten Neustart höchstens zwei Sekunden auf den Abschluss einer gerade laufenden Anfrage. Danach gelten weiterhin die bestehenden Prüfungen auf laufende RFEM-Vorgänge. Längere Anfragen oder unklare Zustände stellen den Neustart weiterhin zurück.

RFEM lauscht nicht auf seinem Schnittstellen-Port

Blockade: grpc_unreachable

Die Komponente läuft und RFEM läuft, aber RFEM antwortet nicht auf dem Port, den die Komponente benutzt. Starte RFEM neu.

Das ist der eine Zustand, in dem ein Neustart von RFEM richtig ist und nicht einer des Connectors.

Kein Dlubal-API-Schlüssel

Blockade: api_key_missing

Ohne Dlubal-API-Schlüssel wird die Komponente gar nicht erst gestartet. Öffne im RFEM-Menü Verbindungseinstellungen öffnen und wechsle über den Profil-Link zum Schlüssel. Automatisch verwaltete Schlüssel werden beim Anmelden bereitgestellt und teilweise verdeckt ohne Eingabefeld angezeigt. Bietet dein Profil stattdessen ein Eingabefeld an, hinterlege dort deinen eigenen Dlubal-API-Schlüssel und speichere ihn. Fehlt dir ein gültiger Schlüssel, kontaktiere den Dlubal-Support.

Meldest du dich bei CALC mit Google oder Microsoft an, kann CALC den Schlüssel nur bereitstellen, wenn für dieselbe E-Mail-Adresse ein Dlubal-Konto existiert. Ohne Konto bleiben RFEM, die Geo-Zonen-Abfrage und die Dateikonvertierung nicht verfügbar. Lege ein Dlubal-Konto an mit der E-Mail-Adresse, die du für CALC nutzt, melde dich dann bei CALC ab und wieder an.

Hast du bereits ein Dlubal-Konto, das aber keiner Firma zugeordnet ist, kann CALC den Schlüssel ebenfalls nicht bereitstellen. Lege kein zweites Konto an, sondern wende dich an den Dlubal-Support, damit das Konto vervollständigt wird. Melde dich danach bei CALC ab und wieder an.

RFEM weist deinen Dlubal-API-Schlüssel zurück

Blockade: api_key_rejected

Die häufigste Ursache: CALC und RFEM sind mit unterschiedlichen Dlubal-Konten angemeldet, etwa mit einem persönlichen Konto im Browser und einem Firmenkonto in RFEM. Prüfe, welches Konto auf beiden Seiten angemeldet ist. Weichen sie ab, melde eine Seite mit dem anderen Konto an und starte dann Verbindung zu RFEM wiederherstellen.

RFEM hat den aktuell verwendeten Schlüssel abgelehnt. Das beweist noch nicht, dass der laufende Verbindungsserver bereits den Schlüssel deines angemeldeten CALC-Kontos verwendet. Starte zunächst die geführte Wiederherstellung mit Connector 2.30.7 oder neuer. Sie gleicht gespeicherten und angewendeten Schlüssel ab. Der synchronisierte CALC-Schlüssel hat Vorrang vor einer geerbten Umgebungsvariable.

Bleibt die Ablehnung nach erfolgreicher Aktivierung bestehen, lass den Schlüssel und die API-Berechtigung deines angemeldeten Kontos durch Dlubal-Support oder Administrator prüfen. Wiederholte Neuinstallationen beheben eine fehlende Berechtigung nicht.

Eine frühere Operation hat kein gesichertes Ergebnis

Blockade: unknown_operation

Eine frühere RFEM-Operation wurde unterbrochen, bevor ihr Ergebnis aufgezeichnet werden konnte, typischerweise weil RFEM oder der Rechner während des Laufs zwangsbeendet wurde oder weil sich die Verbindung zu RFEM nach dem Lauf nicht sauber trennen ließ. Bis dieser Ausführungseintrag aufgelöst ist, verweigert RFEM neue modelländernde Aufträge (busy). Das ist eine absichtsvolle Sperre gegen das doppelte Anwenden von Teiländerungen.

Eine mögliche Teiländerung liegt in der RFEM-Sitzung, die die Operation ausgeführt hat. Endet diese Sitzung, öffnet RFEM das Modell aus dem zuletzt gespeicherten Stand, deshalb wird der Eintrag dann automatisch freigegeben: vom MCP-Server ab dlubal-mcp 1.0.16 und vom Connector-Setup ab Version 2.30.17 auch für ältere Server. Bis dahin hält die Sperre auch ein Connector-Update auf: Das Setup meldet „Setup deferred: An earlier RFEM operation has an unknown outcome“ und ändert keine Dateien.

Neuinstallation von RFEM oder MCP-Server, geänderte Ports und ein neuer Chat lösen den Eintrag nicht, er wird bewusst aufbewahrt. Stattdessen:

1. Öffne das Modell in RFEM, prüfe es auf Teiländerungen des abgebrochenen Laufs und speichere, was du behalten willst. Verwirf Ergebnisse einer gewaltsam beendeten Berechnung.

2. Schließe RFEM vollständig und starte es neu. Der Eintrag wird freigegeben, sobald die RFEM-Sitzung, die die Operation ausgeführt hat, beendet ist, und der Status verschwindet. Ein freigegebener Eintrag bleibt als failed mit dem Hinweis im Journal, das Modell neu einzulesen; er wird nie erneut ausgeführt.

3. Bleibt der Status nach diesem Neustart bestehen, aktualisiere den Dlubal Connector auf Version 2.30.17 oder neuer. Sein Setup gibt solche Einträge selbst frei, auch beim stillen Update aus CALC.

4. Bleibt er dann noch bestehen, wende dich mit dem Support-Report des Connectors an den Dlubal-Support. Der Report nennt die Execution-ID; der Support löst den Eintrag lokal mit dem Operator-Befehl des MCP-Servers auf. Er läuft mit dem Python von RFEM und dem aktiven privaten Paketpfad des Connectors (PowerShell, RFEM-Pfad anpassen):

   PowerShellKopieren

   $active = Get-ChildItem "$env:LOCALAPPDATA\Dlubal\Connector\mcp-runtimes\*\active.json" |
             Sort-Object LastWriteTime -Descending | Select-Object -First 1
   $packages = Join-Path $active.DirectoryName ((Get-Content $active.FullName -Raw | ConvertFrom-Json).current + '\packages')
   & "C:\Program Files\Dlubal\RFEM 6.15\bin\python.exe" -c "import sys,runpy; sys.path.insert(0, sys.argv.pop(1)); runpy.run_module('dlubal_mcp.rfem.execution', run_name='__main__', alter_sys=True)" $packages `
     --state-file "$env:LOCALAPPDATA\DlubalMCP\rfem-executions.sqlite3" `
     --resolve <execution-id> --confirmed-rfem-idle
   

   Ein einfaches python -m dlubal_mcp.rfem.execution findet das Modul nicht: Das Python von RFEM ignoriert PYTHONPATH. Der Befehl setzt den Eintrag auf failed und führt nichts erneut aus.

Connector-Port ist belegt

Ist Port 8083 beispielsweise durch python.exe belegt, kann der Connector auf Port 8383 weiterarbeiten. Bei erreichbarem Ausweichport bleibt der tatsächliche RFEM-Status maßgeblich; die Portbelegung erscheint als Zusatzhinweis. Beende keinen unbekannten Python-Prozess allein aufgrund dieser Meldung.

Alles läuft, aber nachweislich noch nichts

Blockade: not_proven

Der erfolgreiche RFEM-Zugriff ist noch nicht nachgewiesen. Warte zunächst kurz auf die automatische Verbindungsprüfung des Connectors. Eine neue Modelländerung ist dafür nicht erforderlich.

Bleibt er über Minuten statt Sekunden bestehen, sieh im Abschnitt darüber nach: Ältere Connector-Versionen meldeten einen zurückgewiesenen API-Schlüssel als diesen Aufwärmzustand, der dann nie verschwand.

Ein Auftrag wurde abgebrochen oder ist abgelaufen

„Abbrechen“ im Chat beendet das Warten des Browsers. Eine bereits gestartete RFEM-Berechnung kann weiterlaufen, und bereits ausgeführte Modelländerungen bleiben bestehen. Der Connector wartet die laufende Antwort bis zu seiner Zeitgrenze ab, bevor er einen weiteren Auftrag ausführt.

Prüfe in RFEM, ob die Berechnung noch läuft und welche Änderungen oder Ergebnisse bereits vorliegen. Sende dasselbe Skript nicht ungeprüft erneut. Ein unklarer Ausgang wird nicht durch automatisches Wiederholen des Skripts aufgelöst. Der Schutz vor nachträglicher Ausführung abgebrochener, noch wartender Relay-Aufträge benötigt aktuelle Versionen von Connector und Relay.

Wenn der MCP-Server Auftragsstatus unterstützt, kann die Assistentin den Auftrag über seine ID abfragen. Während er läuft, werden weitere Skripte abgewiesen. Ein ungeklärter Auftrag nach einem Serverabbruch bleibt gesperrt, bis der tatsächliche RFEM-Zustand geprüft und die Sperre durch den Betreiber aufgelöst wurde. Ein Neustart alleine gibt ihn nicht frei.

Bei unterstützten Versionen zeigt das RFEM-Menü die gespeicherte Vorgangs-ID und fragt nach einem Neuladen ihren Status erneut ab. „Unbekannt“ und „nicht gefunden“ sind keine Freigabe zum Wiederholen. Ein geleerter Browserspeicher entfernt den lokalen Verlauf, aber keinen Auftrag im MCP-Server.

Berechtigung oder Verbindung

Ein fehlendes Schreib- oder Python-Werkzeug bedeutet nicht automatisch, dass RFEM unerreichbar ist. Ab MCP 1.0.14 unterscheiden sich Lese-, Schreib- und Administratorrechte; Python-Ausführung muss der Betreiber zusätzlich einschalten. Prüfe die freigegebenen Fähigkeiten. Wiederholtes Koppeln erweitert sie nicht.

Im RFEM-Menü kannst du bei unterstützten Versionen einen Supportbericht laden. Er enthält begrenzte Verbindungs- und Zustandsangaben, keine Schlüssel, Modellinhalte oder Skriptausgaben. Ergänze beim Support die sichtbare Vorgangs-ID und beschreibe, was du in RFEM beobachtest.

Der Browser blockiert localhost

Chrome 142 und neuer fragen nach einer Erlaubnis, bevor eine Seite auf calc.dlubal.com mit localhost sprechen darf. Ist sie verweigert, sieht der Connector unerreichbar aus, während mit ihm nichts verkehrt ist.

Beispiel: Der Connector läuft, http://127.0.0.1:8083/rfem-info antwortet, wenn du es direkt in einem Tab öffnest, aber Dlubal CALC meldet ihn trotzdem als nicht erreichbar.

Hast du die Abfrage einmal mit „Blockieren" beantwortet, fragt Chrome nicht wieder. Dann:

1. Klicke links in der Adressleiste auf das Symbol für Website-Informationen.
2. Erlaube dort den Zugriff auf das lokale Netzwerk. Fehlt der Eintrag, öffne die Website-Einstellungen für calc.dlubal.com und stelle ihn dort auf „Zulassen".
3. Lade die Seite neu.

Das ist eine Browser-Berechtigung und kein fehlender Connector: Eine Neuinstallation hebt die Sperre nicht auf, und auch kein Neustart ändert daran etwas. Solange die Sperre besteht, sieht CALC aber nicht, ob der Connector überhaupt installiert ist. Hast du ihn auf diesem Rechner noch nie installiert, nutze den Link „Connector noch nicht installiert? Herunterladen“ unter dem Hinweis und erlaube danach den Zugriff auf das lokale Netzwerk wie oben beschrieben.

„Nicht erreichbar", das „nicht gekoppelt" heißt

Ein Connector, der läuft, aber nicht mit deinem Konto gekoppelt ist, weist die Anfrage ab. Je nachdem, wo diese Abweisung sichtbar wird, liest sie sich als „nicht erreichbar", und dann suchst du nach einem Netzwerkproblem, das es nicht gibt.

Bei direkter Browserverbindung und ausdrücklich gemeldeter fehlender Kopplung kannst du erneut koppeln. Eine bereits authentifizierte Cloud-Relay-Verbindung benötigt keine zusätzliche lokale Kopplung im Browser.

Die Version sagt eines und verhält sich anders

Der Connector installiert eine Komponente und startet sie dann. Das sind zwei getrennte Dinge, und sie können auseinanderlaufen: läuft beim Start des Connectors noch eine Komponente aus einer früheren Sitzung, übernimmt er sie, statt eine neue zu starten. Eine frisch installierte Version liegt dann auf der Platte, während die alte weiter bedient.

Einstellungen → MCP-Server zeigt beides in einer Zeile, zum Beispiel Dlubal-Connector 2.28.8 · MCP 1.0.11. Die zweite Zahl ist die, die läuft. Passen sie nicht zusammen, wird die Zahl gelb. Ab MCP 1.0.14 mit passendem Connector wird ein Update erst bei bestätigtem Leerlauf aktiviert. Laufende oder ungeklärte Aufträge haben Vorrang. Bei einer älteren Komponente ohne diese Prüfung muss der Betreiber die offenen Aufträge prüfen und sie kontrolliert beenden.

Beispiel: Eine Antwort sagt dir, eine Fähigkeit sei „in deiner RFEM-Version nicht verfügbar", und daneben steht ein grüner Punkt. Meist eine veraltete Komponente und nichts, was mit RFEM zu tun hat: sie hat das Werkzeug nie angeboten, das die Antwort benutzen wollte, also hat das Modell die Lücke mit einer Vermutung erklärt.

Erweiterte Diagnose

Fehlt nur die erweiterte Diagnose, kann eine ältere Connector-Version der Grund sein. Dieser Hinweis allein bestätigt keine unterbrochene RFEM-Verbindung. Ein Update schaltet die zusätzliche Diagnose frei; beachte weiterhin den eigentlichen RFEM-Status.

Ungültiger Tool-Aufruf

Diese Meldung bedeutet, dass das Modell unvollständige oder ungültige Argumente geliefert hat. Der betroffene Aufruf wurde nicht ausgeführt. Du kannst die Anfrage erneut versuchen oder den Fehler melden. Bereits abgeschlossene Aufrufe aus früheren Schritten bleiben bestehen; prüfe sie vor einer Wiederholung von Modelländerungen.

Der Connector beendet sich nach Minuten von selbst

Kein Connector-Prozess mehr, kein Eintrag im Windows-Ereignisprotokoll, und nach einem Neustart läuft alles wieder, bis es erneut passiert. Je mehr CALC-Tabs offen sind, desto schneller. Das ist ein Fehler der Connector-Versionen bis 2.30.9: Die Dialog-Erkennung für RFEM verbrauchte bei jeder Statusabfrage eine Systemressource, von der ein Prozess nur 2000 hat. Danach endete der Connector ohne Meldung.

Abhilfe ist das Update auf Connector 2.30.10 oder neuer. CALC bietet es im RFEM-Menü an, sobald der Connector wieder läuft; auch „Verbindung zu RFEM wiederherstellen“ installiert die aktuelle Version. Bis dahin hilft nur, den Connector über das Windows-Startmenü neu zu starten.

Der Connector startet nach dem Beenden erneut

Prüfe Windows-Watchdog für den Connector unter Einstellungen → KI-Assistent. Ein aktivierter Watchdog kann den Connector nach bis zu zehn Minuten erneut starten. Ab Connector 2.30.2 ist er standardmäßig ausgeschaltet und dort abschaltbar. Der Windows-Autostart bei der Anmeldung ist davon unabhängig. Details stehen unter Optionaler Windows-Watchdog.

Der Connector startet nicht

Wenn der Connector früher erkannt wurde, aber nicht mehr erreichbar ist, zeigt CALC die gespeicherte Version als „zuletzt erkannt“. Das ist kein Nachweis der aktuell installierten Version. Nach einem erfolglosen Start bietet der Assistent „Connector starten und prüfen“ an. Bestätige die Browserabfrage oder öffne Dlubal Connector über das Windows-Startmenü und prüfe erneut. Mit „Stattdessen Setup anfordern“ kannst du bei Bedarf ausdrücklich die Installation wählen. Ein fehlgeschlagener Start löst keine automatische Neuinstallation mehr aus.

Solange der Wiederherstellungsdialog geöffnet bleibt, prüft CALC nach einem erfolglosen Start weiter auf einen extern gestarteten Connector und setzt den Ablauf automatisch fort. Beim Schließen oder Kontowechsel endet diese Beobachtung; sie ist auf das ursprüngliche Zeitfenster von zehn Minuten begrenzt. Die gespeicherte Connector-Version stammt ausschließlich vom Connector selbst, nicht von der Versionsnummer eines MCP-Servers.