Desktop Apps Silent Installation/Upgrade (7.3)

Frage:
Wie installiert man die DocuWare Destop Apps mit dem Silent Setup?

Antwort:
DocuWare.Setup.Client.Cmd.exe ist ein Befehlszeilenprogramm, welches erlaubt Desktop Apps über Kommandos zu installieren, deinstallieren und zu aktualisieren. Das SilentSetup kann mit zusätzlichen Schritten genutzt werden, um die Desktop Apps über eine Softwareverteilung zu verwalten.
Weitere Informationen hierzu sind in KBA-36732 verfügbar.

Wichtig falls Sie eine DocuWare Cloud Version verwenden:
Aufgrund des Produktdesigns kann nur die neueste Version von DocuWare 7 install für Silent Setup verwendet werden.

Speicherort und Informationen zu ClientSetupCmd.exe:
Sie finden die DocuWare.Setup.Client.Cmd.exe auf dem (Web-) Server unter folgenden Pfad:
"...\DocuWare\Web\ClientSetupData\ClientSetupCmd\"

Wir empfehlen den Download und die Verteilung der im Ordner vorhandenen .zip-Datei. Die dort enthaltene .config wird für das Logging benötigt.

Zur Installation wird lediglich DocuWare.Setup.Client.Cmd.exe benötigt.
Sie können die Applikation entweder auf den Client kopieren oder auf dem Server freigeben und vom Client aus aufrufen. Die DocuWare.Setup.Client.Cmd.exe befindet auch auf jedem Client, auf dem die DocuWare Apps über die Benutzeroberfläche installiert wurden. Dort befindet sie sich unter:
„%ProgramFiles(86)%\DocuWare\Client Setup\ DocuWare.Setup.Client.Cmd.exe“ (bei 64 Bit Systemen) oder unter „%ProgramFiles%\DocuWare\Client Setup\ DocuWare.Setup.Client.Cmd.exe“ (bei 32 Bit Systemen).

Befehle:

• install
  • --modules
    • C2Outlook
    • IndexCleaner
    • UrlCreator
    • EditSend
    • AdminTool
    • Scanner
    • Import
    • Printer
    • SmartConnect
    • WEC
    • WorkflowDesigner
    • LocalDataConnector
    • Update (wird standardmäßig nicht installiert)
    • UserSynchronization
  • --auto
    • Es werden alle Apps installiert, die verfügbar sind. Dies kann über die Datei  "...\DocuWare\Web\Platform\ClientSetup\ClientSetup.Settings.xml" gesteuert werden
    • --server
      • Geben Sie hier die Basisadresse zum Web Client mit,
        z.B. --server=http://server01
    • --orgId
      • Geben Sie hier Ihre Org. ID mit, z.B. --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
        Sie finden die Org. ID in der DocuWare Administration > Organisation > Allgemein
    • --logDebug
      • Aktiviert das erweiterte Logging
        Die Logging Datei finden Sie unter "C:\Programdata\DocuWare\ClientSetup"
• uninstall
  • --all
  • --logDebug
    • Aktiviert das erweiterte Logging
• upgrade
  • --all
    • Alle vorhandenen Apps werden aktualisiert
  • --server
    • Geben Sie hier die Basisadresse zum Web Client mit, z.B.
      --server=http://server01
  • --orgId
    • Geben Sie hier Ihre Org. ID mit, z.B. --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
      Sie finden die Org. ID in der DocuWare Administration > Organisation > Allgemein
  • --logDebug
    • aktiviert das erweiterte Logging 
• help
  • Gibt eine Hilfe zu den einzelnen Kommandos aus
• version
  • Gibt die Version der „DocuWare.Setup.Client.Cmd.exe“ aus

• DocuWare.Setup.Client.Cmd.exe install --auto --server=http://server01 --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
  Es werden alle Apps installiert, die verfügbar sind. Dies kann über die Datei  "...\DocuWare\Web\Platform\ClientSetup\ClientSetup.Settings.xml" gesteuert werden
• DocuWare.Setup.Client.Cmd.exe install --modules="Printer" --server=http://server01 --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
  Es wird der DocuWare Printer inkl. allen notwendigen Modulen (Desktop, CommonOCR) installiert.
• DocuWare.Setup.Client.Cmd.exe install --modules="Printer Scanner EditSend“--server=http://server01 --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
  Es wird DocuWare Printer, Scan, Edit&Send inkl. allen notwendigen Modulen (Desktop, CommonOCR) installiert.

• DocuWare.Setup.Client.Cmd.exe uninstall --all
  Es werden alle Apps deinstalliert.

• On-Premises: DocuWare.Setup.Client.Cmd.exe upgrade --all --server=http://server01 --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
• Cloud: DocuWare.Setup.Client.Cmd.exe upgrade --all --server=https://<Ihre-DocuWare-Cloud-URL> --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
  Es werden alle Apps aktualisiert.

• Um Hilfe zu den einzelnen Befehlen zu erhalten, geben Sie vor install/uninstall/upgrade help an.
  um Beispiel: DocuWare.Setup.Client.Cmd.exe help install
• DocuWare.Setup.Client.Cmd.exe arbeitet exakt wie das DocuWare Desktop Apps Setup, lediglich ohne Benutzeroberfläche.
• Die MSI Dateien und alle Voraussetzungen bis auf .NET Framework werden vom Server geladen. Daher muss .NET Framework 4.7.2 oder höher vorinstalliert sein. 
  • Es ist daher nicht mehr erforderlich die MSI Dateien über eine Freigabe zur Verfügung zu stellen.
  • Es ist daher nicht mehr erforderlich die Visual C++ Redistributable Packages manuell zu installieren

• 0 Erfolgreich
• 1 Abmelden erforderlich
• 2 Neustart erforderlich
• 4 Fehler
• 5 Abmelden erforderlich & Fehler
  Fehler kann auftreten, falls z.B. der Windows Explorer Client installiert wird und dieser ein Neustart erfordert. Die weitere Installation bricht auf Grund dessen mit Fehler ab. Nähere Details finden sich auch im Logging.
• 6 Neustart erforderlich & Fehler
  Selber Fehlerfall wie in Rückgabewert 5.

KBA ist sowohl für Cloud- als auch für On-Premise-Organisationen geeignet.