Windows

Wenn Sie eine bestehende VC Publisher-Installation auf Ihrem System haben, sichern Sie bitte zunächst Ihre VC Publisher-Daten, wie im Kapitel Datensicherung angegeben. Die Installation sollte erst nach Abschluss der Datensicherung beginnen.

Systemvoraussetzungen

Der VC Publisher erfordert mindestens Windows 10 oder Windows Server 2016.

Stellen Sie sicher, dass die folgenden Bibliotheken auf dem System installiert sind, bevor Sie mit der Erstinstallation oder einem Update des VC Publishers beginnen:

Microsoft Visual C++ Bibliotheken

Aktualisierung

Überspringen Sie diesen Schritt, wenn Sie den VC Publisher zum ersten Mal installieren!

Dieser Abschnitt richtet sich an Benutzer, die eine bestehende 5.3-Installation des VC Publishers auf Version 6 aktualisieren möchten.

  • Öffnen Sie das alte VC Publisher-Administrationspanel und navigieren Sie zu Konfiguration. Überprüfen Sie die aktuell verwendeten Einstellungen für PUBLIC_DATA_PATH (Pfad zum öffentlichen Datenordner), PRIVATE_DATA_PATH (Pfad zum privaten Datenordner) und den Cross-Origin-Header. Notieren Sie sich diese Werte zur Verwendung bei der neuen Installation.

  • Erstellen Sie ein Backup Ihrer Daten!: Sichern Sie die Datenbank und andere relevante Dateien, siehe Kapitel Datensicherung weiter unten.

  • Aktualisierung: Wenn Sie von einer Version älter als v5.3 aktualisieren möchten, kontaktieren Sie bitte <support@vc.systems>. Für alle Aktualisierungspfade erstellen Sie zuerst ein Backup Ihrer Daten und installieren Sie dann den neueren VC Publisher:

  1. Entpacken Sie die heruntergeladene ZIP-Datei von der Download-Seite.

  2. Stoppen Sie die VCPublisher-Dienste mit dem PowerShell-Skript .\stopServices.ps1 (PowerShell benötigt Administratorrechte).

  3. Löschen Sie die Ordner app, tools, jobs und docs im VCPublisher-Installationsordner. Beim Aktualisieren eines VC Publisher 6.0.x löschen Sie zusätzlich die Ordner internalPlugins und ui.

  4. Archivieren Sie, falls gewünscht, die alten Log-Dateien und leeren Sie den Ordner logs.

    VC Publisher Version 6 verwendet eine andere Log-Struktur als Vorgängerversionen, daher werden die alten Log-Dateien in der neuen Installation nicht weitergeführt.

  5. Kopieren Sie den Inhalt des Ordners vcPUBLISHER in den Installationsordner.

  6. Aktualisieren Sie vcPUBLISHER.env, um alle erforderlichen Umgebungsvariablen einzuschließen. Überprüfen Sie insbesondere die Variablen PUBLIC_DATA_PATH und PRIVATE_DATA_PATH, die mit Version 6 hinzugefügt wurden.

  7. Öffnen Sie eine PowerShell mit Administratorrechten im Installationsordner, um die Windows-Dienste einzurichten und zu starten.

    1. Führen Sie .\removeServices.ps1 aus, um die vorhandenen Dienste vcPUBLISHER und vcPUBLISHERMONGODB zu entfernen. Dies ist erforderlich, da VC Publisher 6 eine andere Handhabung der Umgebungsvariablen als Vorgängerversionen verwendet.

      .\removeServices.ps1

    2. Führen Sie .\setupServices.ps1 aus, um die Dienste vcPUBLISHER und vcPUBLISHERMONGODB zu erstellen.

      Möglicherweise müssen Sie die Ausführungsrichtlinieneinschränkung für PowerShell-Skripte entfernen oder umgehen. Dies kann durch Ausführen von Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process in der PowerShell vor dem Ausführen des Setup-Skripts erfolgen. Weitere Details finden Sie in der Microsoft-Hilfe.

      		 
      .\setupServices.ps1

    3. Die Dienste können mit dem Skript .\startServices.ps1 gestartet werden.

      .\startServices.ps1

Der VC Publisher ist nun auf dem konfigurierten HOST und PORT erreichbar (Standard: http://localhost:3003).

Wenn der VC Publisher nach der Installation und dem Einrichten der Windows-Dienste nicht verfügbar zu sein scheint, lesen Sie bitte das Kapitel Fehlerbehebung am Ende dieser Anleitung.

Installation

  1. Entpacken Sie die heruntergeladene ZIP-Datei von der Download-Seite.

  2. Kopieren Sie den mitgelieferten Ordner vcPUBLISHER in den gewünschten Installationsordner (z. B. C:\Program Files\vcs\vcPUBLISHER).

  3. Erstellen Sie eine vcPUBLISHER.env-Datei (Sie können die bereitgestellte vcPUBLISHERdummy.env als Vorlage verwenden) im Installationsordner mit den erforderlichen Umgebungsvariablen.

  4. Erstellen Sie ein Verzeichnis logs im Installationsordner, in dem MongoDB-, stdout- und stderr-Log-Dateien gespeichert werden. Wenn Sie LOG_DIR in den Umgebungsvariablen hinzugefügt haben, stellen Sie sicher, dass dieser Ordner ebenfalls erstellt wird. Stellen Sie sicher, dass der Benutzer Lese- und Schreibberechtigungen für diese Ordner hat.

  5. Erstellen Sie Datenordner für die öffentlichen und privaten Daten (siehe Umgebungsvariablen PUBLIC_DATA_PATH und PRIVATE_DATA_PATH) sowie einen für Datenbankdaten (z. B. C:\publisher-mongodb) und stellen Sie sicher, dass der Benutzer Lese- und Schreibberechtigungen für diese Ordner hat.

    Wenn sich Ihre Datenordner auf einem Netzlaufwerk befinden, stellen Sie bitte sicher, dass die Zugriffsberechtigungen wie im Kapitel Netzlaufwerke verbinden beschrieben eingerichtet werden.

  6. Erstellen Sie eine vcPUBLISHERMONGODB.env-Datei (Sie können die bereitgestellte vcPUBLISHERMONGODBdummy.env als Vorlage verwenden) im Installationsordner mit dem oben angegebenen Datenbankdatenpfad.

  7. Öffnen Sie eine PowerShell mit Administratorrechten im Installationsordner, um die Windows-Dienste einzurichten und zu starten.

    1. Führen Sie .\setupServices.ps1 aus, um die Dienste vcPUBLISHER und vcPUBLISHERMONGODB zu erstellen.

      Möglicherweise müssen Sie die Ausführungsrichtlinieneinschränkung für PowerShell-Skripte entfernen oder umgehen. Dies kann durch Ausführen von Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process in der PowerShell vor dem Ausführen des Setup-Skripts erfolgen. Weitere Details finden Sie in der Microsoft-Hilfe.

      		 
      .\setupServices.ps1

    2. Die Dienste können mit dem Skript .\startServices.ps1 gestartet werden.

      .\startServices.ps1

Der VC Publisher ist nun auf dem konfigurierten HOST und PORT erreichbar (Standard: http://localhost:3003).

Wenn der VC Publisher nach der Installation und dem Einrichten der Windows-Dienste nicht verfügbar zu sein scheint, lesen Sie bitte das Kapitel Fehlerbehebung am Ende dieser Anleitung.

Netzlaufwerke verbinden

Standardmäßig wird der VC Publisher mit dem lokalen Benutzer ausgeführt. Für Netzlaufwerke sind die Rechte der lokalen Benutzerrolle jedoch unzureichend, sodass der Publisher keine Lese- und Schreibberechtigungen für externe Pfade hat.

Um diese Einschränkung für Netzlaufwerke aufzuheben, kann der VC Publisher mit einem Benutzer gestartet werden, der Zugriff auf das Netzlaufwerk hat. Derselbe Benutzer benötigt außerdem Leseberechtigung für den Installationsordner sowie Schreibberechtigung für den Logs-Ordner und die konfigurierten public und private Ordner. Bitten Sie bei Bedarf Ihren Systemadministrator, einen Benutzer mit Zugriffsrechten auf die gewünschten Ordner einzurichten.

Mit dem Tool nssm kann der Benutzer für den Programmstart geändert werden:

  1. Öffnen Sie die Windows-eigene Eingabeaufforderung (cmd) als Administrator.

  2. Wechseln Sie in der Eingabeaufforderung in den Installationsordner und dann in den Pfad .\tools\nssm.

  3. Führen Sie nssm edit vcPUBLISHER aus.

  4. Der NSSM-Diensteditor wird geöffnet. Gehen Sie zum Reiter "Log on" und fügen Sie unter diesem Konto einen neuen Benutzer hinzu.

Der VC Publisher wird nun mit dem konfigurierten Benutzer ausgeführt und hat auch dessen erweiterte Zugriffsberechtigungen auf das Netzlaufwerk.

Datensicherung

  1. Sichern Sie die Datenbank mit den MongoDB-Tools mithilfe des Tools mongodump.exe.

    1. Sie können das Tool hier herunterladen.

    2. Führen Sie das DB-Backup mit Ihrer konfigurierten MONGO_URL durch, z. B.:

      mongodump --uri=mongodb://localhost:27017/publisher /o c:\temp\publisherbackup

  2. Wenn Sie ein vollständiges Backup der VC Publisher-Daten wünschen, empfiehlt es sich, eine Sicherungskopie sowohl des public als auch des private Ordners anzulegen (siehe Umgebungsvariablen PRIVATE_DATA_PATH und PUBLIC_DATA_PATH).

Je nach Streaming-Daten können die Datensätze in den Projekten sehr groß sein (bis zu mehreren hundert Gigabyte).

Deinstallation

Um den VC Publisher von einem Windows-System zu deinstallieren, führen Sie bitte die folgenden Schritte aus:

  1. Öffnen Sie eine PowerShell mit Administratorrechten im Installationsverzeichnis des VC Publishers.

  2. Führen Sie das PowerShell-Skript .\stopServices.ps1 aus, um die Dienste zu stoppen.

    .\stopServices.ps1

  3. Führen Sie das PowerShell-Skript .\removeServices.ps1 aus, um die installierten Dienste zu entfernen.

    .\removeServices.ps1

  4. Anschließend kann das VC Publisher-Installationsverzeichnis gelöscht werden (z. B. C:\Program Files\vcs\vcPUBLISHER).

Es wird nur die VC Publisher-Software selbst entfernt. Die public und private Datenordner sowie der MongoDB-Datenordner werden bei diesem Vorgang nicht gelöscht. Diese Ordner können bei einer neuen VC Publisher-Installation wiederverwendet werden.