Clients mit MSI-Paketen installieren

Dieser Abschnitt beschreibt, wie Sie Octoplant Clients mit MSI-Paketen installieren, entweder im Hintergrund oder mit dem Standardassistenten.

Zusätzlich zu den Octoplant client und BackupClient EXE-Installationsprogrammen, octoplantClient_Setup.exe und octoplantBackupClient_Setup.exe, sind entsprechende MSI-Versionen verfügbar: octoplantClient.msi und octoplantBackupClient.msi.

Diese MSI-Pakete unterstützen die automatische Bereitstellung, die Anpassung durch Befehlszeilenparameter und die Silent-Installation.

Die MSI-Installer befinden sich in:

• dem Verzeichnis vdog client setup\bin\common in den Dateien des Octoplant Setup
• dem Verzeichnis {Serverarchiv}\vdog Client Setup\bin\common auf dem Octoplant Server
• der optionalen Netzwerkfreigabe des Servers, falls bei der Installation aktiviert

Sie können die MSI-Installer über die Befehlszeile ausführen:

• Silent (ohne Benutzereingabe)
• Mit dem Standard-Assistenten

Beide Modi unterstützen die benutzerdefinierte Konfiguration über Befehlszeilenparameter, wie unten dargestellt. Der Silent-Modus ermöglicht auch die Remote-Bereitstellung mit Standard-MSI-Tools.

Microsoft bietet hier eine vollständige Referenz der MSI-Parameter unter: https://learn.microsoft.com/en-us/windows/win32/msi/command-line-options

MSI-Argumente

Standard-Argumente

Installationsspezifische Parameter (zur Verwendung mit /i)

• APPLICATIONFOLDER

  Legt das Installationsverzeichnis fest

  Standardpfade:

  • Installation für alle Benutzer:

    • Client: %PROGRAMFILES(x86)%\AMDT\octoClient
    • BackupClient: %PROGRAMFILES(x86)%\AMDT\octoBackupClient

  • Installation für einzelne Benutzer:

    • Client: %USERPROFILE%\AppData\Local\Apps\AMDT\octoClient
    • BackupClient: nicht unterstützt

• TARGET_CLIENT_ARCHIVE

  Pfad zum Verzeichnis des Clientarchivs

  Standard: %USERPROFILE%\octoplant\ClientArchiv

• TARGET_BACKUP_ARCHIVE

  Pfad zum Archivverzeichnis des BackupClients

  Standard: C:\octoBackupArchive

• REMOVE_OLD

  Steuert das Upgrade-Verhalten.

  Wert	Verhalten
  1	Entfernt eine ältere Version desselben Produkts und führt ein Upgrade auf diese MSI-Version durch
  0 (Standard)	Behält die ältere installierte Version bei

  Wichtige Upgrade-Logik:

  • Ältere Version wurde über die alte Setup.exe installiert

    • REMOVE_OLD=0: alte Version bleibt installiert; MSI installiert parallel dazu
    • REMOVE_OLD=1: MSI installiert und entfernt dann die alte Version

  • Ältere Version, die über einen früheren MSI installiert wurde

    • Die MSI-Technologie verhindert, dass mehrere Versionen installiert werden.
    • Für ein Upgrade müssen Sie REMOVE_OLD=1 angeben.
    • REMOVE_OLD=0 verhindert die Installation.

• ALLUSERS (nur für octoplantClient.msi)

  Steuert, ob der Client für alle Windows-Benutzer oder nur für den aktuellen Benutzer installiert wird.

  Wert	Beschreibung
  1	Für alle Benutzer installieren
  " " (leer) oder weggelassen (Standard)	Nur für den aktuellen Benutzer installieren

  Anmerkungen:

  • Der BackupClient unterstützt nur die Installation für alle Benutzer.

    ALLUSERS=1 wird immer intern von octoplantBackupClient.msi gesetzt und kann nicht außer Kraft gesetzt werden.

  • ALLUSERS=0 ist für MSI-Pakete nicht gültig.

• ADDLOCAL

  Legt fest, welche Anwendungskomponenten installiert werden sollen.

  Verfügbare Werte:

  • UserClient
  • AdminClient
  • EasyClient
  • ReportClient
  • LibraryManagement
  • MSVCR71Library
  • BackupClient (nur octoplantBackupClient.msi )
  • Alle (installiert alle verfügbaren Funktionen)

  Standard: Alle Funktionen außer LibraryManagement und MSVCR71Library

• ProductLanguage

  Sprache der Benutzeroberfläche für den Installationsassistenten.

  Code	Language
  1033	Englisch
  1031	Deutsch
  3082	Spanisch

Standard: Windows-Benutzersprache oder Englisch

Installationsort während eines Upgrades ändern

Wenn Sie einen MSI erneut ausführen, um die Installation zu ändern oder Funktionen hinzuzufügen, ignoriert der Windows Installer APPLICATIONFOLDER. Windows Installer erlaubt es Ihnen nicht, den Installationsort während eines Upgrades zu ändern.

So ändern Sie das Installationsverzeichnis:

1. Deinstallieren Sie das vorhandene Produkt.
2. Installieren Sie den MSI erneut und geben Sie den neuen Wert APPLICATIONFOLDER an, entweder im Hintergrund oder über die Benutzeroberfläche.

Hinweise zur Ausführung in der PowerShell

Wenn Sie die MSI-Parameter, die Leerzeichen enthalten, in der PowerShell ausführen, verwenden Sie Backticks anstelle von doppelten Anführungszeichen.

Beispiel:

APPLICATION_FOLDER=`C:\Program Files (x86)\AMDT\octoClient`

Nicht verwenden:

APPLICATION_FOLDER=”C:\Program Files (x86)\AMDT\octoClient”

Beispiele für die Befehlszeile

Silent-Installation für den aktuellen Benutzer

Installiert alle Clientkomponenten in den Standard-Speicherort für den einzelnen Benutzer:

Die Programmdateien befinden sich in %USERPROFILE%\AppData\Local\Apps\AMDT\octoClient. Das Verzeichnis des Clientarchivs lautet %USERPROFILE%\octoplant\ClientArchive.

msiexec /i octoplantClient.msi /Qn /L*V "C:\temp\ocs.log" APPLICATIONFOLDER="%USERPROFILE%\AppData\Local\Apps\AMDT\octoClient" TARGET_CLIENT_ARCHIVE="%USERPROFILE%\octoplant\ClientArchive" REMOVE_OLD=1 ADDLOCAL=UserClient,AdminClient,EasyClient,ReportClient,LibraryManagement,MSVCR71Library

Silent-Installation

In diesem Beispiel werden die zuvor als MSI installierten Octoplant Clientanwendungen entfernt:

msiexec /x octoplantClient.msi /Qn /L*V "C:\temp\ocu.log"

Zusammenfassung der Upgrade-Szenarien

Upgrade von

Ältere Installationen mit Setup.exe (versiondog oder älteres Octoplant)

• REMOVE_OLD=1: der alte Installer wird nach der MSI-Installation entfernt
• REMOVE_OLD=0 (Standard): Alte Version bleibt installiert; MSI installiert nebenbei

Frühere MSI-basierte Octoplant-Installationen

• Muss REMOVE_OLD=1 verwenden
• MSI wird keine zweite Version installieren

Zusammenfassung des Verhaltens bei der Silent-Installation