Views:
Question:
How do I install the DocuWare Desktop Apps using the silent setup?
 
Answer:
DocuWare.Setup.Client.Cmd.exe is a command line tool that allows to install, uninstall and update the DocuWare Client Modules silently. 
Additionally, you can use the Silent Setup with added steps to manage the Desktop Apps from within a Software Deployment.
For additional information on Desktop App installation via Software Deployment, see KBA-36732

Important information regarding DocuWare Cloud Organizations:
By product design, only the latest version of DocuWare 7 install may be used for Silent Setup.

Location and information regarding DocuWare.Setup.Client.Cmd.exe:
You can find the DocuWare.Setup.Client.Cmd.exe on the (web) server in the following path:
C:\Program Files\DocuWare\Web\ClientSetupData\ClientSetupCmd\

We suggest downloading and supplying the .zip also present in this folder, as the .config is needed for the generation of logs.

To install DocuWare Client Modules only the DocuWare.Setup.Client.Cmd.exe is required. This application can be copied directly to the client or shared on the server and started from the client. The DocuWare.Setup.Client.Cmd.exe is also located on clients which the DocuWare Client Modules were installed with the GUI based setup. There the application can be found as following: “%ProgramFiles(86)%\DocuWare\Client Setup\DocuWare.Setup.Client.Cmd.exe” (on 64 bit systems) or “%ProgramFiles%\DocuWare\Client Setup\DocuWare.Setup.Client.Cmd.exe” (on 32 Bit systems).

Commands:

  • install
    • --modules
      • C2Outlook
      • IndexCleaner
      • UrlCreator
      • EditSend
      • AdminTool
      • Scanner
      • Import
      • Printer
      • SmartConnect
      • WEC
      • WorkflowDesigner
      • LocalDataConnector
      • Update (Not installed automatically)
      • UserSynchronization
    • --auto
      • All available apps will be installed. This can be configured in the file "...\DocuWare\Web\Platform\ClientSetup\ClientSetup.Settings.xml"
    • --server
      • Enter the base address to the Web Client here, e.g. --server=http://server01
    • --orgId
      • Enter the organizations ID here, e.g. --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
      • You can find the OrgId in the DocuWare Administration > Organization > General
    • --logDebug
      • activates the detailed logging
        The logging file can be found under "C:\Programdata\DocuWare\ClientSetup".
  • uninstall
    • --all
    • --logDebug
      • activates the detailed logging
  • upgrade
    • --all
      • All available apps will be upgraded
    • --server
      • Enter the base address to the Web Client here, e.g. --server=http://server01
    • --orgId
      • Enter the organizations ID here, e.g. --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
      • This parameter is case sensitive. It must be "orgId"
      • You can find the OrgId in the DocuWare Administration > Organization > General
    • --logDebug
    • activates the detailed logging
  • help
    • Displays help for the commands
  • version
    • Returns the version of the „DocuWare.Setup.Client.Cmd.exe“.

Examples:

Install Desktop Apps:

  • DocuWare.Setup.Client.Cmd.exe install --auto --server=http://server01 --orgId=1
    All available apps will be installed. This can be configured in the file "...\DocuWare\Web\Platform\ClientSetup\ClientSetup.Settings.xml"

     
  • DocuWare.Setup.Client.Cmd.exe install --modules="Printer" --server=http://server01 --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
    DocuWare Printer and all necessary modules (Desktop, CommonOCR) will be installed. 

     
  • DocuWare.Setup.Client.Cmd.exe install --modules="Printer Scanner EditSend" --server=http://server01 --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
    DocuWare Printer, Scan, Edit&Send and all necessary modules (Desktop, CommonOCR) will be installed. 

Uninstall Desktop Apps:

  • DocuWare.Setup.Client.Cmd.exe uninstall --all
    All apps will be uninstalled 

Upgrade Desktop Apps:

  • 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://<Your-DocuWare-Cloud-URL> 
    --orgId=24750358-8e9c-4e5c-be1d-3d781846c471
    All apps will be upgraded 

Notes:

  • To get help for the commands install/uninstall/upgrade use help. For example: DocuWare.Setup.Client.Cmd.exe help install
  • DocuWare.Setup.Client.Cmd.exe works exactly like the DocuWare Desktop Apps Setup but without any GUI.
  • The MSI files and all prerequisites except .NET Framework will be downloaded from the Server and installed automatically. Therefore .NET Framework 4.7.2 or higher must be preinstalled. 
    • It is not required to publish the MSI files in a network share separately.
    • Therefore the installation of Visual C++ Redistributable Packages is not necessary.

Return Values:

  • 0 - Success
  • 1 - Logout required
  • 2 - Restart required
  • 4 - Error
  • 5 - Restart required & Error
    Error could occur if you install e.g Windows Explorer Client which needs a restart/logout to complete the installation. Other modules which are not installed yet throws an error because of the mentioned behavior. You'll find more information in the log files.
  • 6 - Restart required & Error
    Same error like described in return value 5

KBA is applicable for both Cloud and On-premise Organizations.

Comments (1)
  • Is this valid for 7.4?