Konfigurationsoptionen für das MERLIC RTE

Sie können verschiedene Porteinstellungen für MERLIC RTE konfigurieren, z. B. die Ports für „Ereignisse“ und Befehle, die im Rahmen der Prozessintegration übertragen werden. Die Ports für die Konfigurationsdienste des Image Source Managers (ISM) können ebenfalls angepasst werden. Dies kann erforderlich sein, wenn Sie Bildquellen auf einem Remote-System konfigurieren und feste Porteinstellungen verwenden möchten.

Die folgenden Konfigurationsoptionen sind verfügbar:

Ports für „Ereignisse“ und Befehle

MERLIC verwendet bestimmte Standardports für „Ereignisse“ (21590) und Befehle (21591), d. h. „Aktionen“. Falls keine anderen Ports in der verwendeten INI-Datei definiert sind, versucht MERLIC beim Starten von MERLIC RTE, die Standardports zu verwenden. Wenn mindestens einer der beiden Ports bereits verwendet wird, verwendet MERLIC stattdessen zufällige andere Ports, d. h. zwei verschiedene vorübergehende Ports. Die ausgewählten Ports werden beim Start in der jeweiligen MERLIC RTE-Log-Datei protokolliert.

Um die Verwendung zufälliger Ports für „Ereignisse“ und Befehle zu vermeiden, können Sie die Porteinstellungen so anpassen, dass bestimmte Ports verwendet werden. Die Ports können in der INI-Konfigurationsdatei oder über die Kommandozeile konfiguriert werden.

Ports in der INI-Datei definieren

Die Porteinstellungen für „Ereignisse“ und Befehle können im [Communicator]-Abschnitt der INI-Datei konfiguriert werden.

  1. Öffnen Sie die INI-Datei, die verwendet werden soll.
  2. Stellen Sie fest, ob die INI-Datei einen [Communicator]-Abschnitt enthält. Wenn nicht, fügen Sie die Überschrift [Communicator] hinzu, um diesen Abschnitt hinzuzufügen.
  3. Fügen Sie die Ports wie unten gezeigt zum [Communicator]-Abschnitt hinzu. Sie können Portnummern im Bereich von 1 bis 65535 einstellen.
    Kopieren
    [Communicator]
    EventPort=<event port>
    CommandPort=<command port>

Wenn MERLIC RTE gestartet wird, werden die in der jeweiligen INI-Datei konfigurierten Ports für „Ereignisse“ und Befehle verwendet. Wenn Sie die Porteinstellungen in der standardmäßigen INI-Datei „MERLIC5.ini“ konfiguriert haben, werden diese automatisch verwendet, wenn MERLIC RTE ohne Angabe einer INI-Datei gestartet wird. Wenn Sie die Ports in einer anderen INI-Datei definiert haben, müssen Sie die gewünschte INI-Datei beim Starten von MERLIC RTE angeben. Dafür müssen Sie die Kommandozeilenoption „--ini“ verwenden. Weitere Informationen finden Sie unter Mehrere MERLIC RTE-Instanzen verwenden.

Weitere Informationen zu den verfügbaren Einstellungen in der INI-Datei finden Sie unter Die INI-Datei von MERLIC.

Ports über die Kommandozeile definieren

Wenn Sie lediglich für die aktuelle MERLIC RTE-Sitzung Ports für „Ereignisse“ und Befehle festlegen möchten, können Sie die Ports beim Starten von MERLIC RTE in der Kommandozeile definieren.

  1. Öffnen Sie eine Eingabeaufforderung und wechseln Sie in das Verzeichnis „bin\x64-win64“ unter dem MERLIC-Installationspfad, z. B. „%PROGRAMFILES%\MVTec\MERLIC-5.8\bin\x64-win64“.
  2. Starten Sie MERLIC RTE und verwenden Sie die Kommandozeilenoptionen „--event_port“ und „--command_port“, um die Ports zu definieren.
    Kopieren
    merlic_rte.exe --event_port <PORT1> --command_port <PORT2>

    Hinter jedem Flag Kommandozeilenflags geben Optionen für Kommandozeilenprogramme an. Weitere Informationen zu verfügbaren Flags erhalten Sie über die Option „--help“, z. B. „merlic_creator.exe --help“. muss die jeweilige Portnummer im Bereich 1 bis 65535 angegeben werden.

Ports für die Remote-Konfiguration von Bildquellen

Standardmäßig verwendet MERLIC vorübergehende Ports für die Konfigurationsdienste des Image Source Managers (ISM), wenn eine Verbindung zu einem MERLIC RTE Setup auf einem Remote-System hergestellt wird.

Wenn Sie stattdessen feste Ports verwenden möchten, können Sie die Porteinstellungen anpassen. Die Ports können in der INI-Konfigurationsdatei anhand der Eigenschaft „ImageSourceConfigurationPorts“ oder über die Kommandozeilenoption „--image_source_config_ports“ konfiguriert werden.

Sie müssen drei Ports angeben, damit die Remote-Konfiguration ordnungsgemäß funktioniert, z. B. „10123;10124;10125“. Sie können Ports im Bereich von 1024 bis 65535 verwenden.

Wenn Sie feste Ports festlegen, müssen Sie sicherstellen, dass die folgenden Bedingungen erfüllt sind:

  • Die angegebenen Ports müssen frei sein. Andernfalls wird das MERLIC RTE nicht gestartet, sodass im MERLIC RTE Setup kein Zugriff auf die Konfiguration möglich ist.
  • Die angegebenen Ports dürfen sich nicht mit den Ports überlappen, die für die Eigenschaft PluginConfigurationPorts im [Communicator]-Abschnitt festgelegt sind. Andernfalls können die Konfigurationsdienste nicht gleichzeitig verwendet werden.

Ports in der INI-Datei definieren

Die Porteinstellungen für Remote-Konfigurationsdienste des Image Source Managers können im [General]-Abschnitt der INI-Datei konfiguriert werden.

  1. Öffnen Sie die INI-Datei, die verwendet werden soll.
  2. Fügen Sie die Ports wie unten gezeigt zum [General]-Abschnitt hinzu. Sie können Ports im Bereich von 1024 bis 65535 verwenden.
    Kopieren
    ImageSourceConfigurationPorts=<PORT1;PORT2;PORT3>

Wenn MERLIC RTE gestartet wird, werden die in der jeweiligen INI-Datei konfigurierten Ports für die ISM-Konfigurationsdienste verwendet. Wenn Sie die Porteinstellungen in der standardmäßigen INI-Datei „MERLIC5.ini“ konfiguriert haben, werden diese automatisch verwendet, wenn MERLIC RTE ohne Angabe einer INI-Datei gestartet wird. Wenn Sie die Ports in einer anderen INI-Datei definiert haben, müssen Sie die gewünschte INI-Datei beim Starten von MERLIC RTE angeben. Dafür müssen Sie die Kommandozeilenoption „--ini“ verwenden. Weitere Informationen finden Sie unter Mehrere MERLIC RTE-Instanzen verwenden.

Ports über die Kommandozeile definieren

Wenn Sie lediglich für die aktuelle MERLIC RTE-Sitzung Ports festlegen möchten, können Sie die Ports beim Starten von MERLIC RTE in der Kommandozeile definieren.

  1. Öffnen Sie eine Eingabeaufforderung und wechseln Sie in das Verzeichnis „bin\x64-win64“ unter dem MERLIC-Installationspfad, z. B. „%PROGRAMFILES%\MVTec\MERLIC-5.8\bin\x64-win64“.
  2. Starten Sie MERLIC RTE und verwenden Sie die Kommandozeilenoption „--image_source_config_ports“, um die Ports zu definieren.
    Kopieren
    merlic_rte.exe --image_source_config_ports <PORT1;PORT2;PORT3>

    Hinter dem Flag muss die jeweilige Portnummer im Bereich 1024 bis 65535 angegeben werden.

Wenn die Kommandozeilenoption „--image_source_config_ports“ oder die Konfigurationseigenschaft „ImageSourceConfigurationPorts“ in der INI-Datei zum Definieren von festen Ports verwendet wird, kann nur eine MERLIC RTE-Instanz gestartet werden.