Installation

Wichtig: Bitte beachten Sie unsere Voraussetzungen (IT), um einen reibungslose Funktion von EasySightPro zu gewährleisten.

Hinweis: Deinstallieren Sie EasySightPro vor jedem Update über die Systemeinstellungen 'Apps und Features'. Bei einem Wechsel der Hauptversion müssen zusätzlich alle Cognex Pakete deinstalliert werden.

  • Starten Sie die Installation und wählen Sie die Setup-Sprache aus

  • Vor der Installation wird überprüft, ob noch laufende Programme die Installation blockieren.

  • Wählen Sie alle zu installierenden Komponenten aus:

    Komponenten Standard Beschreibung
    .Net Abhängigkeiten ü Microsoft .Net Abhängigkeiten für den Betrieb von EasySightPro®.
    Allied Vision Vimba X   Alternativer Kamera Treiber statt Cognex Treiber. Bietet einen erweiterten Kamerasupport für nicht Cognex Kameras.
    Cognex VisionPro ü Cognex VisionPro Bildverarbeitungs-Bibliothek. Ist für den Betrieb von EasySightPro® notwendig.
    Cognex Deep-Learning   Wird für die Integration von Deep Learning Anwendungen benötigt.
    cifX Feldbus ü Enthält alle Treiber für die Kommunikation mittels Feldbus (EASYSIGHTPRO-COMM Karten)
    EasySightPro ü EasySightPro® Programmdateien.
    EasySightPro Halcon Runtime   Mvtec Halcon Erweiterung für EasySightPro®.
    C# Beispiele   C# Beispiele für die Integration eigener Plugins in EasySightPro®

    • Wählen Sie den Installationspfad aus. Standard ist C:\Program Files\RELISTE GesmbH\EasySightPro

    • Starten Sie die Installation. Bestätigen Sie während der Installation eventuelle Popups.

      • Akzeptieren Sie die Geräte Treiber mittels 'Installieren'

    • Um die Installation abzuschliessen, ist ein Neustart des Kontrollers notwendig.

Windows Benutzerrechte

Ab Version 14.0 läuft EasySightPro® als Windows-Standardbenutzer, ohne UAC-Abfrage. Administratorrechte sind nur für Installation, Update und Deinstallation notwendig.

Das Setup richtet dafür ein:

  • den Datenordner %PROGRAMDATA%\EasySightPro mit Vollzugriff für alle Benutzer des PCs

  • die TLS-Zertifikate für WebAPI und WebHMI inklusive HTTPS-Portbindung sowie die geplante Aufgabe „EasySightPro Zertifikate“, die die Zertifikate rechtzeitig vor Ablauf erneuert (siehe TLS-Zertifikatsverwaltung)

  • die Firewall-Regel für die WebHMI (Ports 8080 und 5000, nur für WebHMI.exe). Die WebAPI (Port 9000) ist ab Version 14.0 nur auf diesem PC erreichbar; die WebHMI leitet die Aufrufe des Browsers über Port 8080 weiter (siehe WebAPI im Netzwerk freigeben)

  • den EasySightPro-Dienst

Funktionen, die höhere Rechte brauchen, führt der EasySightPro-Dienst (läuft als SYSTEM) im Auftrag von EasySightPro® aus:

  • RVCC Digital-IO

  • Herunterfahren und Neustart von Windows (auch wenn dem Windows-Benutzer das Recht „Herunterfahren des Systems“ per Gruppenrichtlinie entzogen ist)

  • Starten bei Anmeldung des Windows-Benutzers (geplante Aufgabe „EasySightPro_Autostart“, ohne erhöhte Rechte)

  • Firewall-Freigabe der konfigurierten TCP-Server (Ethernet-Terminal, Datalink, Visu-Server): Regel „EasySightPro TCP-Server“, nur für EasySightPro.exe und nur für die Ports, auf denen EasySightPro® gerade lauscht

Benötigte Ordnerrechte für den Windows-Benutzer:

  • %PROGRAMDATA%\EasySightPro (Vollzugriff, setzt das Setup)

  • %ESP_ROOT% (Lesen und Ausführen; der Programmordner wird nur vom Setup bzw. der Aufgabe „EasySightPro Zertifikate“ geschrieben)

  • %VPRO_ROOT% (Lesen)

  • frei konfigurierte Pfade wie Backup, Testlauf, Bildablage oder Netzlaufwerke (Schreibrechte)

Administratorrechte sind weiterhin notwendig für:

  • das Kopieren fehlender Abhängigkeiten nach %VPRO_ROOT% (z. B. nach einer Neuinstallation von VisionPro); EasySightPro® meldet das beim Start

  • ein eigenes Zertifikat (Custom-Modus der TLS-Zertifikatsverwaltung)

  • die Installation von Treibern und Herstellersoftware (Kameras, Framegrabber)

Hinweis: Bei den mit %% angegebenen Platzhalter handelt es sich um Umgebungsvariablen. Die während der Installation gesetzt werden. Sie können diese auflösen, indem Sie den kompletten Pfad in die Adressleiste des Windows Explorers kopieren und mit ENTER bestätigen. Damit werden Sie in den korrekten Ordner umgeleitet.

WebAPI im Netzwerk freigeben

Ab Version 14.0 nimmt die WebAPI von EasySightPro® (Port 9000) nur Anfragen von diesem PC an. Die WebHMI braucht dafür keine Freigabe: Der Browser greift nur auf Port 8080 zu, die WebHMI leitet die Aufrufe an die WebAPI weiter. Anfragen von anderen Rechnern an Port 9000 werden mit „403 Forbidden“ abgelehnt.

Nur wenn ein anderes System die WebAPI direkt über das Netzwerk aufruft (z. B. eine eigene Anbindung), muss die Freigabe eingeschaltet werden. Dazu das Setup als Administrator mit dem Parameter /WebApiRemote=1 ausführen:

Kopieren 
"EasySightPro 14.0.0.0.exe" /WebApiRemote=1

Das Setup setzt den Registry-Wert HKLM\SOFTWARE\Reliste\EasySightPro, DWORD WebApiRemoteAccess = 1, und legt die Firewall-Regel „EasySightPro-WebAPI“ an. Die Einstellung bleibt bei Updates erhalten. /WebApiRemote=0 schaltet die Freigabe wieder aus. Die Änderung wirkt nach einem Neustart von EasySightPro®.

Hinweis: Browser rufen die WebAPI nicht mehr direkt auf (keine CORS-Freigabe). Eigene Webseiten, die die WebAPI aus dem Browser aufrufen, werden nicht unterstützt.

Automatisierte Installation

EasySightPro® unterstützt eine automatisierte Installation über Kommandozeilenparameter mittels Json Konfigurationsdatei:

  • /S oder /s: Silent Installation. Aktiviert /log automatisch.

  • /LOG oder /log: Erstelle eine Log Datei (ZEITSTEMPEL_EasySightPro_Setup.log) im Ordner der Setup Datei

  • /WRITECONFIG oder /writeconfig: Erstellt eine aktuelle Konfigurationsdatei (SetupConfig.json) mit den Standard-Parameter

  • /WebApiRemote=1 bzw. /WebApiRemote=0: WebAPI (Port 9000) im Netzwerk freigeben bzw. wieder nur lokal (siehe WebAPI im Netzwerk freigeben). Ohne Parameter bleibt die bisherige Einstellung erhalten.

Wenn im Ordner der Setup Datei eine SetupConfig.json Konfiguration existiert, dann wird diese als Standard Auswahl im Komponenten-Konfigurationsdialog verwendet.

Beispiel einer automatisierten Installation

  • Aktuelle Konfigurationsdatei erstellen.

    Kopieren 
    "EasySightPro 14.0.0.0.exe" /writeconfig

  • Generierte Konfigurationsdatei SetupCOnfig.json editieren und Standardwerte anpassen.
    Beispiel: Installation von VimbaX: true ergänzt.

    Kopieren 
    {
      "components": {
        "DotNet": true,
        "VisionPro": true,
        "DeepLearning": false,
        "Fieldbus": false,
        "EasySightPro": true,
        "Halcon": false,
        "VimbaX": true,
        "CSharpSamples": false
      }
    }

  • Die Konfiguration wird bei der Installation als Standard geladen. Wird das Setup im Silent Mode aufgerufen, wenn werden die Dialoge so gut wie möglich unterdrückt.
    Beispiel: Start einer Silent Installation mit automatischem Logging.

    Kopieren 
    "EasySightPro 14.0.0.0.exe" /S