Frontend über eine Remote-Verbindung starten

MERLIC bietet die Möglichkeit, ein Frontend zu starten, ohne einen lokal installierten MERLIC-Kern Die Verarbeitungseinheit einer aktiven MERLIC-Vision-App. starten zu müssen. Dies ist besonders dann nützlich, wenn Sie von einem Remote-System aus auf den MERLIC-Server zugreifen möchten. Der MERLIC-Server ist ein Teil des Kerns, der auf dem Hostrechner gestartet wurde. Um eine Remote-Verbindung herzustellen, müssen Sie den MERLIC-Server angeben, zu dem das Frontend eine Verbindung herstellen soll, d. h. die bereitgestellten Kanäle und den Hostrechner des MERLIC-Servers.

Sie können den MERLIC-Server angeben, indem Sie die Verbindungseinstellungen in der INI-Datei (standardmäßig „MERLIC5.ini“) oder als Kommandozeilenoption festlegen.

Weitere Informationen zu Konfiguration finden Sie in den Kapiteln zur Frontend-Konfiguration und zur Server-Konfiguration.

Voraussetzungen

  • MERLIC muss auf dem Server sowie auf dem Client installiert sein.
  • Damit eine Verbindung hergestellt werden kann, muss der Server bereits ausgeführt werden.

Kompatibilität von Remote-Frontend-Verbindungen zwischen MERLIC 5.7.1 und einer älteren Version:

Wenn das Frontend einer MERLIC 5.7.1-Installation remote mit einer MERLIC Creator- oder MERLIC RTE-Instanz einer MERLIC 5.1-Installation (oder älter) verbunden wird, wird die Verbindung erfolgreich hergestellt, das Frontend-Fenster bleibt jedoch leer. Umgekehrt wird im Frontend einer MERLIC 5.1-Installation (oder älter) kein Frontend einer verbundenen MERLIC Creator- oder MERLIC RTE-Instanz einer MERLIC 5.7.1-Installation angezeigt.

Verbindungseinstellungen in der INI-Datei

Die Verbindungseinstellungen für das Frontend in der INI-Konfigurationsdatei werden durch die Einstellungen für „Host“ und „Port“ definiert. Beide Einstellungen verfügen über einen vordefinierten Standardwert, der verwendet wird, wenn weder in der INI-Datei noch im Kommandozeilenbefehl ein Wert dafür angegeben wird:

Eigenschaft

Standardwert

Host

127.0.0.1

Port

9090

Sie können die Einstellungen in der Standard-MERLIC5.ini-Datei anpassen oder Ihre eigene INI-Konfigurationsdatei erstellen. Hier sehen Sie eine Beispielkonfiguration der Verbindungseinstellungen in der INI-Datei:

Kopieren 
[Frontend]
Host=localhost
Port=9090

Weitere Informationen zur Konfiguration finden Sie im Kapitel zur Frontend-Konfiguration.

Remote-Frontend mit Verbindungseinstellungen aus einer INI-Datei starten

Wenn Sie die Verbindungseinstellungen in Ihrer INI-Datei angepasst haben, können Sie ein Frontend über eine Remote-Verbindung starten.

  1. Stellen Sie auf dem Computer, auf dem das Frontend gestartet werden soll, eine Verbindung zu dem Remote-Computer her, auf dem MERLIC installiert ist.
  2. Öffnen Sie eine Eingabeaufforderung und wechseln Sie in das Verzeichnis „bin\x64-win64“ unter dem MERLIC-Installationspfad, z. B. "%PROGRAMFILES%\MVTec\MERLIC-5.7\bin\x64-win64".
  3. Starten Sie ein Remote-Frontend:
    • Verwenden Sie die Einstellungen der Standard-MERLIC5.ini-Datei:
      Kopieren
      merlic_frontend.exe
    • Verwenden Sie die Kommandozeilenoption --ini, um das Frontend mit den Einstellungen einer bestimmten INI-Datei zu öffnen:
      Kopieren
      merlic_frontend.exe --ini <FILENAME>.ini

Wenn in der jeweiligen INI-Datei keine Verbindungseinstellungen definiert wurden, werden die Standardwerte verwendet.

Verbindungseinstellungen als Kommandozeilenoption

Sie können die Verbindungseinstellungen für das Frontend beim Start eines Remote-Frontends auch als Kommandozeilenargument definieren. Dazu können Sie die Kommandozeilenoption „--tcp <HOST:PORT>“ verwenden (siehe Beschreibung im folgenden Abschnitt). Jede Verbindungseinstellung, die in Form einer Kommandozeilenoption angegeben wird, sorgt dafür, dass die entsprechende Verbindungseinstellung in der INI-Datei ignoriert wird, und zwar auch dann, wenn im Befehl eine INI-Datei angegeben wird.

Remote-Frontend mit in Kommandozeilenoptionen definierten Verbindungseinstellungen starten

  1. Stellen Sie eine Verbindung zu dem Remote-Computer her, auf dem MERLIC installiert ist.
  2. Öffnen Sie eine Eingabeaufforderung und wechseln Sie in das Verzeichnis „bin\x64-win64“ unter dem MERLIC-Installationspfad, z. B. "%PROGRAMFILES%\MVTec\MERLIC-5.7\bin\x64-win64".
  3. Starten Sie ein Remote-Frontend mit dem Befehl "merlic_frontend.exe", und verwenden Sie die Kommandozeilenoption „--tcp“, um eine Verbindung zwischen dem Frontend und dem mit <HOST:PORT> angegebenen MERLIC-Server herzustellen. HOST gibt den Namen bzw. die IP-Adresse des Hostrechners an, PORT definiert den Port, der vom Server überwacht wird.
    Kopieren
    merlic_frontend.exe --tcp <HOST:PORT>

    4. Eine vollständige Liste der Kommandozeilenoptionen für „merlic_frontend.exe“ finden Sie im Abschnitt Kommandozeilenoptionen. Über die Optionen "-h" und "--help" können Sie die Hilfe zu den verfügbaren Kommandozeilenoptionen anzeigen.

Kommandozeilenoptionen

MERLIC umfasst mehrere Kommandozeilenoptionen für „merlic_frontend.exe“.

Kommandozeilenoption

Beschreibung

-h, --help

zeigt die Hilfe zu den verfügbaren Kommandozeilenoptionen an.

-V, --version

Zeigt die MERLIC-Version an.

--ini

Gibt den vollständigen Pfad und den Dateinamen der INI-Datei an, die für die Konfiguration der MERLIC-Einstellungen (z. B. Einstellungen für das Frontend, den Prozessintegrationsmodus oder die Protokollierung) verwendet wird.

Wenn das Frontend aus dem MERLIC Creator gestartet wird, wird die .ini-Option, die zum Start des MERLIC Creators verwendet wurde, an das Frontend weitergeleitet.

--tcp <hostname or ip address>:<port>

Gibt einen Hostnamen oder eine IP-Adresse und den TCP/IP-Port an, um festzulegen, zu welchem Computer das Frontend eine Verbindung herstellen soll.

--hide_window_title_bar=true

Startet das MERLIC Frontend ohne Anzeige der Titelleiste des Anwendungsfensters. Dies wirkt sich auch auf die Tastenkombinationen aus, die verwendet werden können, z. B. zum Schließen des Fensters.

--icon_file

Gibt ein benutzerdefiniertes Symbol für das Frontend an. Dieses wird in der Titelleiste des Fensters und in der Taskleiste anstelle des MERLIC-Standardsymbols angezeigt. Sie müssen den absoluten Pfad und den Dateinamen des Symbols angeben.

--fullscreen

Startet das MERLIC Frontend im Vollbildmodus.