MERLIC unter Linux installieren

Auf Linux-Systemen muss MERLIC über die Kommandozeile installiert werden. Die entsprechenden Archive für die Installation können von der MVTec-Website heruntergeladen werden. Darüber hinaus müssen nach der Installation einige manuelle Konfigurationsschritte durchgeführt werden, z. B. Bereitstellen der MERLIC5.ini-Datei und Überprüfen der Firewalleinstellungen.

Für Linux-Systeme sind nur bestimmte Komponenten von MERLIC verfügbar: Das MERLIC RTE, das MERLIC Frontend, MERLIC-Tools, MVApp-Beispiele, Kommunikations-Plugins und das SDK für die Entwicklung von Kommunikations-Plugins. Zum Erstellen von MERLIC-Vision-Apps müssen Sie weiterhin den MERLIC Creator auf einem Windows-System verwenden und ein Rezept für die Anwendung erstellen. Die MVApp und das Rezept können dann vom MERLIC RTE auf Linux-Systemen verwendet werden.

MERLIC herunterladen

Beachten Sie, dass Sie über Ihren MVLogin angemeldet sein müssen, um auf den Downloadbereich zugreifen zu können. Wenn Sie kein MVLogin-Konto haben, müssen Sie sich zuerst registrieren.

1. Melden Sie sich unter https://www.mvtec.com/downloads beim Downloadbereich von MVTec an.
2. Klicken Sie auf das MERLIC-Symbol, um auf die MERLIC-Pakete zuzugreifen. Mithilfe der Filteroptionen können Sie einstellen, dass nur die Pakete für Linux-Systeme und die gewünschte Architektur anzeigt werden.
3. Laden Sie die benötigten Pakete herunter. Im Abschnitt Verfügbare Pakete für Linux finden Sie eine Übersicht über die Pakete sowie Angaben dazu, welche Pakete abhängig vom jeweiligen Zweck obligatorisch sind.
4. (Optional) Laden Sie die Addon-Pakete für die Beispiele und das SDK für die Plugin-Entwicklung herunter.

Verfügbare Pakete für Linux

Für die jeweiligen Architekturen stehen die folgenden Archive zum Download zur Verfügung. Abhängig vom jeweiligen Zweck und der MERLIC-Komponente, die auf dem System verwendet werden soll, sind unterschiedliche Pakete obligatorisch.

Paket	Beschreibung	Obligatorisch für das RTE	Obligatorisch für das Frontend
Runtime-Version	Enthält das Archiv mit den Komponenten für MERLIC RTE und die Standard-Kommunikations-Plugins: merlic-5.7.1-aarch64-linux_merlic_rte-dl.tar.gz (aarch64-linux) merlic-5.7.1-x64-linux_merlic_rte-dl.tar.gz (x64-linux)	✔
Frontend	Enthält das Archiv für das MERLIC Frontend: merlic-5.7.1-aarch64-linux_merlic-frontend.tar.gz (aarch64-linux) merlic-5.7.1-x64-linux_merlic-frontend.tar.gz (x64-linux)		✔
Ergänzung zur Voll-/Runtime-Version – Tools	Enthält das Archiv mit allen MERLIC-Tools: merlic-5.7.1-tools_all.tar.gz	✔
Ergänzung zur Voll-/Runtime-Version – Beispiele	Enthält das Archiv mit allen Beispielen, z. B. MVApp-Beispiele, und alle für die Beispiele benötigten Dateien: merlic-5.7.1-examples.tar.gz
Ergänzung zur Voll-/Runtime-Version – Communicator SDK	Enthält das Archiv mit dem für die Implementierung von benutzerdefinierten Kommunikations-Plugins erforderlichen SDK: merlic-5.7.1-aarch64-linux_communicator-sdk.tar.gz (aarch64-linux) merlic-5.7.1-x64-linux_communicator-sdk.tar.gz (x64-linux)

Wenn Sie MERLIC RTE auf Ihrem System verwenden möchten, müssen Sie die Pakete für das Runtime Environment und die MERLIC-Tools herunterladen und installieren. Alle anderen Pakete sind optional.

Wenn Sie nur das MERLIC Frontend auf Ihrem System verwenden möchten, müssen Sie lediglich das „Frontend“-Paket herunterladen und installieren. Weitere Pakete sind in diesem Fall nicht erforderlich.

Das MERLIC RTE installieren

Für die Installation müssen Sie die heruntergeladenen Archive entpacken:

1. Wechseln Sie in das Verzeichnis, in dem Sie MERLIC RTE installieren möchten. Sie können ein beliebiges Verzeichnis auswählen, z. B. „/opt/projects/MVTec“.
2. Entpacken Sie das heruntergeladene Archiv für MERLIC RTE:

   Linux auf einem PC

   Kopieren

   tar xf merlic-5.7.1-x64-linux_merlic_rte-dl.tar.gz

   Linux auf einer ARM^®-basierten Plattform

   Kopieren

   tar xf merlic-5.7.1-aarch64-linux_merlic_rte-dl.tar.gz

3. Ein neues Verzeichnis namens „merlic-5.7.1“ wird erstellt. Wenn das MERLIC Frontend bereits im selben Verzeichnis installiert wurde, werden die Dateien im vorhandenen MERLIC-Installationsverzeichnis installiert.

4. Entpacken Sie das Archive für die MERLIC-Tools in das Verzeichnis „merlic-5.7.1“.

   Kopieren

   tar xf merlic-5.7.1-tools_all.tar.gz

5. Wenn Sie weitere optionale Archive heruntergeladen haben, müssen Sie die einzelnen Archive genauso wie die anderen Pakete in das neue Verzeichnis entpacken.

MERLIC ist jetzt auf dem Linux-System installiert. Weitere Installationsschritte sind nicht notwendig. Alle entpackten Archive befinden sich jetzt im Unterverzeichnis „merlic-5.7.1“.

Aktivieren Sie Ihre Lizenz, damit Sie MERLIC verwenden können. Weitere Informationen finden Sie unter MERLIC-Lizenz aktivieren.

MERLIC Frontend installieren

Für die Installation müssen Sie die heruntergeladenen Archive entpacken:

1. Wechseln Sie in das Verzeichnis, in dem Sie das MERLIC Frontend installieren möchten. Sie können ein beliebiges Verzeichnis auswählen, z. B. „/opt/projects/MVTec“.
2. Entpacken Sie das heruntergeladene Archiv für das MERLIC Frontend:

   Linux auf einem PC

   Kopieren

   tar xf merlic-5.7.1-x64-linux_merlic-frontend.tar.gz

   Linux auf einer ARM^®-basierten Plattform

   Kopieren

   tar xf merlic-5.7.1-aarch64-linux_merlic-frontend.tar.gz

3. Ein neues Verzeichnis namens „merlic-5.7.1“ wird erstellt. Wenn MERLIC RTE bereits im selben Verzeichnis installiert wurde, werden die Dateien im vorhandenen MERLIC-Installationsverzeichnis installiert.

Das MERLIC Frontend ist jetzt auf dem Linux-System installiert. Weitere Installationsschritte sind nicht notwendig. Alle entpackten Archive befinden sich jetzt im Unterverzeichnis „merlic-5.7.1“.

„MERLIC5.ini“-Datei bereitstellen

Für MERLIC RTE auf Linux-Systemen ist eine INI-Konfigurationsdatei erforderlich. Die Standardkonfigurationsdatei heißt „MERLIC5.ini“ und sollte sich im Verzeichnis „~/.config/MVTec/“ befinden.

Es gibt verschiedene Möglichkeiten, um die Konfigurationsdatei hinzuzufügen:

• Kopieren Sie eine vorhandene INI-Datei aus einer anderen Installation. Wenn Sie beispielsweise über eine MERLIC-Installation auf einem Windows-System verfügen, wird empfohlen, die INI-Datei zu verwenden, die beim Erstellen der MVApps verwendet wurde.
• Erstellen Sie eine neue INI-Datei.

Wenn Sie die standardmäßige INI-Datei verwenden möchten, müssen Sie die Datei „MERLIC5.ini“ nennen und im richtigen Verzeichnis speichern.

Speicherort der INI-Datei

Die standardmäßige INI-Datei „MERLIC5.ini“ wird in einem bestimmten Verzeichnis erwartet: „~/.config/MVTec/“. Sie wird standardmäßig beim Starten von MERLIC RTE unter Linux verwendet, wenn keine INI-Datei angegeben wird.

Wenn Sie eine andere Konfigurationsdatei verwenden möchten, können Sie die INI-Datei in einem beliebigen Verzeichnis und unter einem beliebigen Namen speichern. Sie können auch mehrere Konfigurationsdateien für unterschiedliche Anwendungsfälle hinzufügen. Beim Starten von MERLIC RTE müssen Sie den Pfad und den Namen der Konfigurationsdatei angeben, die verwendet werden soll. Dies kann über die Kommandozeilenoption „--ini“ bewerkstelligt werden. Die INI-Datei muss mit dem relativen Pfad zum aktuellen Verzeichnis angegeben werden, aus dem das MERLIC RTE gestartet wird.

Firewalleinstellungen überprüfen

Wenn Sie eine Firewall verwenden, müssen Sie sicherstellen, dass die Firewalleinstellungen eine Remote-Verbindung zwischen dem Linux-System und den entsprechenden MERLIC-Komponenten auf dem Windows-System zulassen, das für die Remote-Konfiguration verwendet wird.

Für die Remote-Verbindung werden Ports für verschiedene Komponenten und Dienste verwendet:

• Konfigurationsdienst des Image Source Managers (ISM) auf der MERLIC RTE Setup-Registerkarte „Bildquellen“
• Konfigurationsdienst der Kommunikations-Plugins auf der MERLIC RTE Setup-Registerkarte „Kommunikation“
• MERLIC Frontend
• MERLIC Directory Agent

Für einige davon gibt es feste Standardports, für einige andere sind standardmäßig vorübergehende Ports eingestellt, die manuell auf feste Ports umgestellt werden müssen. Nehmen Sie folgende Anpassungen vor, um die Remote-Verbindung zu ermöglichen:

1. Definieren Sie feste Ports für die Konfigurationsdienste des Image Source Managers (ISM) und die Kommunikations-Plugins. Die Ports können in der entsprechenden INI-Datei über die folgenden Eigenschaften festgelegt werden:

   Abschnitt	Name der Eigenschaft
   [General]	ImageSourceConfigurationPorts
   [Communicator]	PluginConfigurationPorts

   Beide Eigenschaften benötigen exakt drei Ports, damit die Remote-Konfiguration einwandfrei funktioniert (siehe folgendes Beispiel).

   Kopieren

   [General]
   ImageSourceConfigurationPorts=10123;10124;10125
   
   [Communicator]
   PluginConfigurationPorts=10126;10127;10128

2. Passen Sie die Firewalleinstellungen so an, dass die im vorherigen Schritt für den ISM und die Kommunikations-Plugins definierten Ports nicht blockiert werden.

3. Passen Sie die Firewalleinstellungen so an, dass der Port für das MERLIC Frontend nicht blockiert wird. Dies ist notwendig, um das MERLIC Frontend auf einem Remote-System starten und ausführen zu können. Sie können den Port in der entsprechenden INI-Datei überprüfen. Standardmäßig werden die Ports 9090-9099 für das MERLIC Frontend verwendet.

   Abschnitt	Name der Eigenschaft
   [Frontend]	Port

4. Passen Sie die Firewalleinstellungen so an, dass der feste Port 9650 nicht blockiert wird. Dieser Port wird für den Directory Agent verwendet (der MERLIC-Prozess, der die Verfügbarkeit der Konfigurationsdienste auf dem Hostgerät koordiniert). Dieser ermöglicht es dem MERLIC RTE Setup, eine Liste der verfügbaren MERLIC Creator- und MERLIC RTE-Instanzen abzufragen.

Weitere Informationen zu den konfigurierbaren Porteinstellungen finden Sie unter Die INI-Datei von MERLIC.

Weitere Informationen

Wenn MERLIC auf einem Linux-System verwendet wird, müssen beim Einrichten der Anwendung für MERLIC RTE und beim Starten von MERLIC RTE unter Linux einige zusätzliche Einrichtungsschritte beachtet werden. Weitere Informationen finden Sie auf den folgenden Seiten:

• Zusätzliche Einrichtungsschritte für Linux
• MERLIC RTE unter Linux starten
• Das MERLIC Frontend unter Linux starten