Installation des QAWeb Agenten

Installationsübersicht

Bemerkung

Bevor Sie die Software auf einer Workstation installieren, lesen Sie die Systemanforderungen (siehe Systemanforderungen). Beachten Sie außerdem, dass die Installation des QAWeb-Agenten administrative Rechte auf der Workstation erfordert.

Die Installation kann auf zwei Arten durchgeführt werden:

  • Mit dem grafischen Installationsassistenten.

  • Verwenden der Befehlszeilenoberfläche So kann der QAWeb Agent auf einer großen Anzahl von Workstations mit Hilfe automatisierter Tools zur Softwarebereitstellung installiert werden.

Wenn bereits eine ältere Version des QAWeb Enterprise-Agenten installiert ist, wird diese durch den Installationsprozess automatisch aktualisiert. Die ältere Version muss nicht erst deinstalliert werden.

Die Installation von QAWeb Enterprise Agent besteht aus zwei Phasen: Installation und Konfiguration.

  • Software-Installation: Der Agent wird im Betriebssystem installiert.

  • Agent-Konfiguration: Die Einstellungen des Agenten können konfiguriert werden.

Bemerkung

Es ist möglich, jederzeit nach der Installation eine andere Konfiguration anzuwenden, ohne dass die Software neu installiert werden muss. Ein Agent, der im Standalone-Modus konfiguriert wurde, kann beispielsweise später für den Online-Modus konfiguriert werden.

Wenn der QAWeb Agent für die Verwendung im Online-Modus installiert werden soll, halten Sie bitte die folgenden Informationen bereit:

  • Rufen Sie über das QAWeb Enterprise-Portal die Organisations-ID und den Registrierungsschlüssel Ihrer QAWeb Enterprise-Organisation ab. Diese werden verwendet, um die Workstation während des Installationsvorgangs bei Ihrer Organisation zu registrieren.

  • Wenn ein HTTP-Proxy-Server für den Zugriff auf den Online-Dienst verwendet werden muss, halten Sie die Konfigurationsdetails bereit (Hostname oder Adresse des Servers, Port, Benutzer und Passwort).

Bemerkung

Die Installation von QAWeb Enterprise Agent erfordert Administrator -Berechtigungen. Sie kann von jedem autorisierten Benutzer mit ausreichenden Berechtigungen durchgeführt werden. Es ist keine besondere Schulung erforderlich.

Agent-Installationssoftware herunterladen

Die neueste Version der QAWeb Agent-Software kann vom QAWeb Enterprise Portal heruntergeladen werden.

  1. Anmeldung im Portal (https://qaweb.healthcare.barco.com).

  2. Klicken Sie im Kopfzeilenmenü auf Administration.

  3. Klicken Sie im Seitenmenü auf Meine Organisation.

  4. Klicken Sie auf die Schaltfläche Download, um das Installationsprogramm für QAWeb Enterprise Agent herunterzuladen.

Die QAWeb Agent-Software kann auch von der Barco Support-Seite heruntergeladen werden (https://www.barco.com/support/qaweb-enterprise).Dies ist nützlich, wenn Sie den Agenten nur im Standalone-Modus verwenden, da Sie sich nicht für das QAWeb Enterprise Portal anmelden müssen.

Installation des Agenten mit Hilfe des grafischen Installationsassistenten

Starten Sie den grafischen Installationsassistenten durch Ausführen von qaweb-agent-installer.exe.

  1. Klicken Sie auf der ersten Seite auf die Schaltfläche Weiter.

    ../../_images/agent_installer_welcome.png

  2. Bestätigen Sie die Endbenutzer-Lizenzvereinbarung (EULA).

    ../../_images/agent_installer_EULA.png

  3. Warten Sie, bis die Installation der Software abgeschlossen ist.

    ../../_images/agent_installer_in_progress.png

  4. Lassen Sie die Option ‚QAWeb Agent konfigurieren‘ ausgewählt und klicken Sie auf die Schaltfläche Weiter.

In der zweiten Phase vervollständigen Sie den Konfigurationsassistenten.

  1. Wählen Sie die Betriebsart.

    ../../_images/agent_configurator_select_mode.png

  2. Konfigurieren Sie die Einstellungen des HTTP-Proxyservers. Dieser Schritt wird übersprungen, wenn der Standalone-Modus gewählt wurde und wenn weder die Option ‚Auf Aktualisierungen prüfen‘ noch die Option ‚Anonymer Informationsaustausch‘ ausgewählt wurde.

    ../../_images/agent_configurator_proxy_config.png

  3. Geben Sie die Organisations-ID und den Registrierungsschlüssel ein. Dieser Schritt wird übersprungen, wenn der Standalone-Modus gewählt wurde.

    ../../_images/agent_configurator_registration_info.png

  4. Bestätigen Sie Ihre Einstellungen.

    ../../_images/agent_configurator_apply_confirm.png

  5. Im letzten Schritt werden die Einstellungen übernommen.

    ../../_images/agent_configurator_finish_online.png

Installation des Agent über die Befehlszeile

Für die Befehlszeileninstallation sind die folgenden Argumente erforderlich:

qaweb-agent-installer.exe /S /ORG <organization ID> /REGKEY <registrationkey>

Beachten Sie, dass alle Optionen die Groß- und Kleinschreibung beachten.

Zusätzlich können die folgenden Befehlszeilenparameter verwendet werden:

  • /MODE select the operating mode. Options: online/standalone/localserver (default: online).

  • /PROXY use a proxy server for the connection. Options: no/system/custom (default: no).

  • /PROXY_NAME hostname of the proxy server. (implies /PROXY custom).

  • /PROXY_PORT port number of the proxy server (implies /PROXY custom).

  • /PROXY_USR optional username for proxy authentication (implies /PROXY custom).

  • /PROXY_PWD optional password for proxy authentication (implies /PROXY custom).

  • /WORKSTATION_DETAIL_SHORTCUT to add a shortcut to the desktop to open the workstation detail window of the agent (default: no).

  • /SERVER to specify the hostname of the local server. (implies /MODE localserver).

  • /UPDATES enable periodic check for updates. Options: yes/no (default: yes). This is only applicable to standalone configurations.

  • /SHARE_DIAGNOSTICS enable periodic sharing of relevant info to improve our product. Options: yes/no (default: no). This is only applicable to standalone configurations.

  • /QAWEB1_ACTION specify the behavior when MediCal QAWeb Agent is found on the workstation. Options: abort/disable/uninstall (default: abort).

Deinstallation des Agenten

Die Deinstallation des Agenten kann auf verschiedene Arten eingeleitet werden:

  • Über „Programme hinzufügen oder entfernen“ in der „Windows-Systemsteuerung“: Scrollen Sie zum Eintrag „QAWeb Enterprise Agent“ und deinstallieren Sie die Anwendung.

  • Über die Anwendung „Deinstallieren“ im Installationsverzeichnis (Standard: C:\Programme\Barco\QAWeb).

Warnung

Durch die Deinstallation des QAWeb Enterprise Agenten werden alle Konfigurationsdaten entfernt. Das beinhaltet:

  • Lokale Konfiguration

  • Persönliche Einstellungen

  • Registrierung beim QAWeb Enterprise Portal (falls zutreffend)

  • Protokolldateien

Deinstallation des Agenten über die Befehlszeile

Um den Agenten über die Befehlszeile zu deinstallieren, verwenden Sie den folgenden Befehl im Installationsverzeichnis (standardmäßig ‚C:\Programme\Barco\QAWeb‘):

uninstall.exe /S

Schritte nach der Installation

Nach erfolgreicher Installation und Registrierung erscheint das Symbol des QAWeb Enterprise-Agenten im Windows-Infobereich. Es wird empfohlen, Windows so zu konfigurieren, dass dieses Symbol immer im Infobereich angezeigt wird.

../../_images/agent_windows10_icons_in_taskbar.png

Unmittelbar nach erfolgreicher Installation und Registrierung kann der Agent mehrere QA-Tests starten und Anzeigeeinstellungen übernehmen. Der Agent bewertet die auszuführenden Aufgaben anhand der folgenden Standardwerte:

  • Die Monitore, die mit der Workstation verbunden sind, erhalten eine Standardverwendung (basierend auf dem Barco-Monitormodell).

  • Zur Berechnung des reflektierten Umgebungslichts während der Kalibrierung und der QA-Tests wird ein Standardwert von 35 Lux verwendet.

Ändern der Agent-Konfiguration nach der Installation

Eine Reihe von Einstellungen kann nach der Registrierung mit der ausführbaren Datei configurator.exe, die sich im Installationsverzeichnis (Standard C:\Programme\Barco\QAWeb) befindet, geändert werden. Wenn Sie diese Anwendung ausführen, wird die Konfigurationsphase des Installationsprogramms wiederholt. Dadurch können die folgenden Einstellungen erneut vorgenommen werden:

  • Wechsel zwischen den Betriebsmodi (z. B. vom Standalone-Modus in den Online-Modus).

  • Den Agenten bei einer neuen Organisation erneut registrieren.

  • Ändern der Einstellungen des HTTP-Proxyservers.

    ../../_images/agent_configurator_proxy_config.png

  • Die Änderung der Protokollebene ist zur Untersuchung technischer Probleme möglich.

    ../../_images/agent_configurator_logging.png

  • Standardmäßig verwendet der Agent die Sprache des Betriebssystems. Alternativ kann auch eine bestimmte Sprache eingestellt werden.

    ../../_images/agent_configurator_language.png

Der Konfigurator kann auch über folgende Befehlszeilenparameter verwendet werden:

  • --mode <mode> options: online/standalone/localserver

  • --server <hostname> The hostname of the local server (implies mode localserver)

  • --updates <yesOrNo> Periodically check for updates: yes / no (default: yes). Only applies to standalone mode.

  • --sharediagnostics <yesOrNo> Periodically check for updates: yes / no (default: no). Only applies to standalone mode.

  • --proxy <proxy> no / system / custom (default: no)

  • --proxyhost <host> Hostname of the proxy server (implies proxy custom)

  • --proxyport <port> Port number of the proxy server (implies proxy custom)

  • --proxyuser <user> the username needed for proxy authentication (if required) (implies proxy custom)

  • --proxypwd <password> the password needed for proxy authentication (if required) (implies proxy custom)

  • --regkey <key> Registration key (not applicable for mode standalone)

  • --org <organization> Organization ID (not applicable for mode standalone)

  • --sysprep Prepare the installation for ghost image creation

Upgrade und Wartung

QAWeb Enterprise Agent enthält eine Funktion, die den Benutzer benachrichtigt, wenn eine neue Version verfügbar ist. Durch Klicken auf diese Benachrichtigung wird die Aktualisierung der Anwendung gestartet.

Bemerkung

Barco empfiehlt, auf die neueste Version des Agenten zu aktualisieren, sobald diese verfügbar ist. Ein Update könnte neue Funktionen sowie Lösungen für Fehler und Sicherheitslücken enthalten. Der Barco-Support fordert, dass Sie die neueste Version verwenden, damit der entsprechende Support geleistet werden kann.

Anweisungen für „Ghosting“

Der Begriff Ghosting bezeichnet den Vorgang, ein Abbild des gesamten Betriebssystems und der installierten Software zu erstellen, das dann auf verschiedenen Workstations übernommen/wiederhergestellt wird, um den Endbenutzern eine zuverlässige und kontrollierte Umgebung zu bieten.

Bei der Erstellung eines Ghost-Images einer Workstation ist es wichtig, dass zunächst die workstation-spezifischen lokalen Daten mit dem Verfahren sysprep entfernt werden. Dadurch werden die workstation-spezifischen IDs entfernt, die beim Start des Agenten automatisch erstellt werden. Wenn das sysprep-Verfahren ausgelassen wird, verfügen alle geklonten Workstations über ungültige Bezeichner und können sich nicht ordnungsgemäß mit dem Onlinedienst/Server verbinden.

So erstellen und verteilen Sie Workstation-Ghost-Images einschließlich des QAweb Enterprise-Agenten ordnungsgemäß:

  1. Fahren Sie den Barco QAWeb Agent herunter. (Beenden Sie den Windows-Dienst.)

  2. Führen Sie configurator.exe --sysprep aus.

  3. Erstellen Sie das Ghost-Image (ohne den Agent neu zu starten).

  4. Führen Sie auf jeder geklonten Workstation nach dem Start configurator.exe aus (entweder über die grafische Benutzeroberfläche oder über Befehlszeilenargumente), um den Agenten beim Server zu registrieren.