Das MERLIC RTE Setup verbinden

Das MERLIC RTE Setup kann mit MERLIC-Instanzen auf dem lokalen System sowie auf einem Remote-System verbunden werden. Auf lokalen Systemen kann es sich bei der jeweiligen MERLIC-Instanz um eine MERLIC Creator- oder MERLIC RTE-Instanz handeln. Bei Remote-Systemen können dagegen ausschließlich Instanzen von MERLIC RTE verbunden werden.

Während der Entwicklung

Bei der Implementierung einer MERLIC-Vision-App (MVApp) starten Sie das MERLIC RTE Setup in der Regel mit einer Verbindung zu Ihrem lokalen System, um den Bildeinzug sowie Rezeptdateien und Kommunikations-Plugins für den Laufzeitmodus einzurichten.

In der Produktion

Beim Einsatz in der Produktion ist das MERLIC RTE Setup typischerweise mit einem Remote-System verbunden, beispielsweise während der abschließenden Einrichtung des Bildeinzugs oder der Kommunikations-Plugins für die Produktionsumgebung oder zur Behebung von Fehlern während der Laufzeit.

Sie können das System und die MERLIC-Instanz, mit denen Sie eine Verbindung herstellen möchten, direkt nach dem Start des MERLIC RTE Setups auswählen. Alternativ können Sie die gewünschte Verbindung im Voraus festlegen, beispielsweise über die INI-Datei von MERLIC oder über Kommandozeilenoptionen.

Visualisierung des Verbindungsstatus

Das Symbol, das auf der Schaltfläche zum Öffnen des Verbindungs-Dialogfensters angezeigt wird, veranschaulicht den MERLIC RTE Setup-Verbindungsstatus.

Symbol

Status

Verbunden

Verbindung wird hergestellt

Getrennt

Lokales System im Vergleich zu einem Remote-System

Auf dem lokalen System können alle Konfigurationsoptionen des MERLIC RTE Setups verwendet werden. Sie können Bildquellen für den Bildeinzug konfigurieren, Rezeptdateien verwalten sowie alle I/O-Plugins und Kommunikations-Plugins konfigurieren, die auf dem lokalen System verfügbar sind. Auf Remote-Systemen können Sie lediglich Bildquellen und Kommunikations-Plugins konfigurieren.

Die folgende Tabelle enthält eine Übersicht über die Komponenten, die für ein lokales System und ein Remote-System konfiguriert werden können:

Registerkarte „Konfiguration“

Lokales System

Remote-System

Bildquellen

✔

✔

Kommunikation

✔

✔

Rezepte

✔

✘

I/O

✔

✘

Voraussetzungen für die Registerkarten „Kommunikation“ und „Bildquellen“

Die Konfigurationsoptionen auf der Registerkarte „Kommunikation“ sind nur verfügbar, wenn das MERLIC RTE Setup mit einer MERLIC RTE-Instanz verbunden ist.

Die Konfigurationsoptionen in der Registerkarte „Bildquellen“ sind nur verfügbar, wenn eine der folgenden Bedingungen erfüllt ist. Andernfalls kann keine Bildquelle konfiguriert werden, weil kein Dienst für die Bildquellen-Konfiguration verfügbar ist.

  • MERLIC RTE Setup ist mit einer MERLIC Creator-Instanz auf dem lokalen System verbunden.
  • MERLIC RTE Setup ist mit einer MERLIC RTE-Instanz verbunden, und MERLICbefindet sich derzeit in einem der folgenden Zustände: „Preoperational“, „Initialized“ oder „Error“ (unter gewissen Umständen).

Weitere Informationen finden Sie unter Bildquellen im Prozessintegrationsmodus konfigurieren.

Eine Instanz über das Verbindungs-Dialogfenster verbinden

Wenn das MERLIC RTE Setup bereits ausgeführt wird, können Sie jederzeit das Verbindungs-Dialogfenster öffnen, um zu einem anderen System oder einer anderen MERLIC-Instanz zu wechseln. Über das Verbindungs-Dialogfenster können Sie auch die HTML-Übersichtsseite für ein bestimmtes System öffnen. Weitere Informationen finden Sie unter HTML-Übersicht über MERLIC-Instanzen.

  1. Klicken Sie im MERLIC RTE Setup auf die Schaltfläche oben rechts im Fenster, um das Verbindungs-Dialogfenster zu öffnen.

  1. Wählen Sie das System aus, zu dem eine Verbindung hergestellt werden soll. MERLIC listet automatisch Systeme auf, die zuvor verwendet wurden.

    Das Symbol neben dem Hostnamen zeigt den Verbindungsstatus und die erforderliche Sicherheitsstufe für die Verbindung mit dieser Instanz an.

    Symbol

    Beschreibung

    Die MERLIC-Instanz auf dem lokalen System ist für eine Verbindung über Unix-Domain-Sockets (UDS) verfügbar.

    		Die MERLIC-Instanz ist für eine Verbindung über eine unverschlüsselte WebSocket-Verbindung verfügbar.

    		Die MERLIC-Instanz ist für eine Verbindung über eine TLS-verschlüsselte WebSocket-Verbindung verfügbar. Die Verbindung zur Instanz kann nur hergestellt werden, wenn die erforderlichen Zertifikate vorhanden sind.

    Sie können den Hostnamen und den Port auch manuell eingeben, falls das gewünschte System nicht aufgeführt ist. Der Port muss mit dem in der MERLIC Directory Agent-Konfiguration des gewünschten Systems definierten Port übereinstimmen. Weitere Informationen finden Sie unter Den Directory Agent für Remote-Verbindungen konfigurieren.

  2. Wählen Sie die MERLIC-Instanz auf der rechten Seite aus. Die Liste zeigt nur MERLIC-Instanzen an, die auf dem ausgewählten System für eine Verbindung verfügbar sind. Bei Remote-Systemen werden nur MERLIC RTE-Instanzen angezeigt, die derzeit auf dem ausgewählten System ausgeführt werden und deren Dienste über den angegebenen Port verfügbar sind. Für das lokale System werden auch MERLIC Creator-Instanzen angezeigt.

  3. Bestätigen Sie Ihre Auswahl mit „Verbinden“.

Das MERLIC RTE Setup wird mit der ausgewählten MERLIC-Instanz verbunden. Im Fenstertitel des MERLIC RTE Setups wird die jeweilige Verbindungs-URL angezeigt. Diese enthält den Hostnamen des verbundenen Systems, die MERLIC-Instanz und den Port, über den die jeweiligen MERLIC-Dienste bereitgestellt werden.

Es darf sich jeweils nur ein Benutzer mit einer MERLIC-Instanz verbinden. Wenn bereits ein anderer Benutzer mit der ausgewählten MERLIC-Instanz verbunden ist, wird eine Warnung angezeigt. Sie haben jedoch weiterhin die Möglichkeit, die Verbindung zur MERLIC-Instanz zu erzwingen. Alle nicht gespeicherten Konfigurationsänderungen des anderen Benutzers gehen verloren.

HTML-Übersicht

Über das Verbindungs-Dialogfenster können Sie außerdem eine HTML-Übersicht in einem Browser öffnen, um detaillierte Informationen zu den verfügbaren MERLIC-Instanzen und deren Diensten auf dem ausgewählten System abzurufen.

Klicken Sie auf den Link oberhalb der Instanzliste, um die Seite im Browser zu öffnen. Weitere Informationen finden Sie unter HTML-Übersicht über MERLIC-Instanzen.

Verbindung über die Kommandozeile

Wenn Sie das MERLIC RTE Setup über die Kommandozeile starten, können Sie über die Kommandozeilenoption „‑‑url“ das gewünschte System und die MERLIC-Instanz, mit der Sie sich verbinden möchten, im Voraus angeben. In diesem Fall stellt das MERLIC RTE Setup direkt eine Verbindung zur angegebenen MERLIC-Instanz her.

  1. Öffnen Sie eine Eingabeaufforderung und wechseln Sie in das Verzeichnis „bin\x64-win64“ unter dem MERLIC-Installationspfad, z. B. „%PROGRAMFILES%\MVTec\MERLIC-26.10\bin\x64-win64“.
  2. Geben Sie den folgenden Befehl ein und verwenden Sie die Kommandozeilenoption „‑‑url“, um das MERLIC RTE Setup mit einer Verbindung zum angegebenen System und zur angegebenen MERLIC-Instanz zu öffnen:
    Kopieren
    merlic_rte_setup.exe --url <CONNECTION_URL>

    Das genaue Format der Verbindungs-URL hängt davon ab, mit welchem System Sie eine Verbindung herstellen möchten. Weitere Informationen finden Sie im Abschnitt Verbindungs-URL angeben auf der Seite Das MERLIC RTE Setup starten.

Das MERLIC RTE Setup wird gestartet und stellt automatisch eine Verbindung zum System und zur MERLIC-Instanz her, die in der URL angegeben sind.

Wenn Sie das MERLIC RTE Setup wiederholt mit derselben Verbindung zu einem System und derselben MERLIC-Instanz starten müssen, können Sie eine Verknüpfung für diesen Befehl erstellen. Auf diese Weise können Sie das MERLIC RTE Setup mit einem Doppelklick auf die Verknüpfung starten, um automatisch eine Verbindung zum gewünschten System herzustellen.

Verbindung zum System wiederherstellen

In einigen Fällen kann die Verbindung zur ausgewählten MERLIC-Instanz oder zum aktuellen Dienst im MERLIC RTE Setup (z. B. zur Registerkarte „Kommunikation“) getrennt werden, so dass Sie die Verbindung zur erforderlichen MERLIC-Anwendung wiederherstellen müssen bzw. die Anwendung starten müssen, um die Konfiguration fortzusetzen.

Abhängig von der Ursache für die Trennung der Verbindung sind unterschiedliche Aktionen notwendig, um die Verbindung wiederherzustellen. Im Folgenden sind die häufigsten Anwendungsfälle für die jeweiligen Registerkarten im MERLIC RTE Setup aufgelistet.

Fehlender Konfigurationsdienst für die Registerkarte „Bildquellen“

Die Konfigurationsoptionen auf der Registerkarte „Bildquellen“ sind nur verfügbar, wenn das MERLIC RTE Setup mit einer MERLIC Creator-Instanz auf dem lokalen System oder mit einer MERLIC RTE-Instanz in bestimmten MERLIC-Zuständen verbunden ist. Andernfalls kann keine Bildquelle konfiguriert werden, weil kein Dienst für die Bildquellen-Konfiguration verfügbar ist.

Auf lokalen Systemen

Wenn Sie mit dem lokalen System verbunden sind und die Verbindung zum Konfigurationsdienst für die Registerkarte „Bildquellen“ getrennt wurde, haben Sie verschiedene Möglichkeiten, die Verbindung wiederherzustellen.

  • Starten Sie die zuvor verbundene MERLIC-Instanz neu und klicken Sie dann auf die Schaltfläche „Erneut verbinden“.
  • Klicken Sie auf die Schaltfläche oben rechts, um das Verbindungs-Dialogfenster zu öffnen, und stellen Sie erneut eine Verbindung zum lokalen System her. Anschließend können Sie über die entsprechenden Schaltflächen eine neue MERLIC-Instanz starten.

Auf Remote-Systemen

Wenn Sie mit einem Remote-System verbunden waren, als die Verbindung zur MERLIC RTE-Instanz getrennt wurde, müssen Sie zunächst die MERLIC RTE-Instanz auf dem Remote-System neu starten. Klicken Sie anschließend auf „Erneut verbinden“, um die Verbindung wiederherzustellen. Achten Sie dabei darauf, dieselbe MERLIC RTE-Instanz zu starten, die zuvor verbunden war.

Alle nicht gespeicherten Änderungen der Bildquellen-Konfiguration gehen verloren, wenn die Verbindung zum Konfigurationsdienst getrennt wird.

Fehlender Konfigurationsdienst für die Registerkarte „Kommunikation“

Die Konfigurationsoptionen auf der Registerkarte „Kommunikation“ sind nur verfügbar, wenn das MERLIC RTE Setup mit einer MERLIC RTE-Instanz verbunden ist.

Auf lokalen Systemen

Wenn Sie mit dem lokalen System verbunden sind und die Verbindung zum Konfigurationsdienst für die Registerkarte „Kommunikation“ getrennt wurde, haben Sie verschiedene Möglichkeiten, die Verbindung wiederherzustellen.

  • Starten Sie die zuvor verbundene MERLIC RTE-Instanz neu und klicken Sie dann auf die Schaltfläche „Erneut verbinden“.
  • Klicken Sie auf die Schaltfläche oben rechts, um das Verbindungs-Dialogfenster zu öffnen. Anschließend können Sie eine MERLIC RTE-Instanz auswählen. Wenn Sie die Verbindung zu derselben MERLIC RTE-Instanz wiederherstellen möchten, zu der die Verbindung getrennt wurde, müssen Sie die MERLIC RTE-Instanz jedoch außerhalb des MERLIC RTE Setups neu starten (z. B. über die Kommandozeile). Andernfalls wird die Instanz im Verbindungs-Dialogfenster nicht angezeigt.

Auf Remote-Systemen

Wenn Sie mit einem Remote-System verbunden waren, als die Verbindung zur MERLIC RTE-Instanz getrennt wurde, müssen Sie zunächst die MERLIC RTE-Instanz auf dem Remote-System neu starten. Klicken Sie anschließend auf „Erneut verbinden“, um die Verbindung wiederherzustellen. Achten Sie dabei darauf, dieselbe MERLIC RTE-Instanz zu starten, die zuvor verbunden war.

Alle nicht gespeicherten Änderungen an der Konfiguration der Kommunikations-Plugins gehen verloren, wenn die Verbindung zum Konfigurationsdienst getrennt wird.

Registerkarte „Rezepte“ und „I/O“ nicht verfügbar

Die Konfigurationsoptionen auf den Registerkarten „Rezepte“ und „I/O“ des MERLIC RTE Setups sind wie nachstehend beschrieben u. U. in einigen Fällen nicht verfügbar.

MERLIC RTE wird ausgeführt

Rezepte und I/O-Plugins können nur konfiguriert werden, wenn das MERLIC RTE Setup nicht mit einer MERLIC RTE-Instanz verbunden ist. Andernfalls ist kein Zugriff auf die Rezepte und Konfigurationsoptionen möglich. Dadurch wird sichergestellt, dass die Konfiguration für MERLIC RTE während der Verarbeitung nicht geändert wird. Stellen Sie daher sicher, dass das MERLIC RTE Setup nicht mit einer MERLIC RTE-Instanz verbunden ist.

Verbindung zu einem Remote-System

Wenn das MERLIC RTE Setup mit einer MERLIC-Instanz auf einem Remote-System verbunden ist, stehen die Konfigurationsoptionen auf den Registerkarten „Rezepte“ und „I/O“ nicht zur Verfügung. Die Konfiguration von Rezepten und I/O-Plugins ist nur für lokale Systeme möglich.

Um auf die Rezeptverwaltung zuzugreifen, müssen Sie das MERLIC RTE Setup auf dem System starten, auf dem sich die Rezepte befinden. Gleiches gilt für die Konfiguration von I/O-Plugins.

Abgelaufene Sitzung

Wenn ein anderer Benutzer eine Verbindung zu der MERLIC-Instanz erzwingt, mit der Sie derzeit verbunden sind, wird Ihre Sitzung beendet, sodass die Konfiguration nicht fortgesetzt werden kann. Alle nicht gespeicherten Änderungen gehen verloren. Das Verbindungs-Dialogfenster wird angezeigt und Sie haben die Möglichkeit, die Verbindung zur jeweiligen MERLIC-Instanz zu erzwingen. Der Benutzer, der zuvor verbunden war, erhält dann ebenfalls die Meldung, dass die Sitzung des Benutzers abgelaufen ist.