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 you 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

Note: Since DocuWare 7.5, the Update module is able to update Desktop Apps without administrative rights. We recommend installing the Update module on all systems to decrease administrative needs.
On Terminal server environments, the administrative prompt is still in place to circumvent unwanted downtimes for all users.

Important information regarding DocuWare Cloud Organizations:
If you are using a DocuWare Cloud version, the recommended installation files are not yet available on your system.
You can find and download the DocuWare.Setup.Client.Cmd.exe for DocuWare Cloud using the following URL:
https://<Your-DocuWare-Cloud-URL>/DocuWare/Platform/ClientSetup/ClientSetupCmd.zip

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\

Please download and supply the .zip present in this folder, as all files are needed.

DocuWare.Setup.Client.Cmd.exe.zip 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 follows: “%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
      • Export
      • 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=46405714-8e9c-4e5c-be1d-3443efa81ebc
      • 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=46405714-8e9c-4e5c-be1d-3443efa81ebc
      • 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=46405714-8e9c-4e5c-be1d-3443efa81ebc
    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=46405714-8e9c-4e5c-be1d-3443efa81ebc
    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=46405714-8e9c-4e5c-be1d-3443efa81ebc
  • Cloud: DocuWare.Setup.Client.Cmd.exe upgrade --all --server=https://<Your-DocuWare-Cloud-URL> 
    --orgId=46405714-8e9c-4e5c-be1d-3443efa81ebc
    All apps will be upgraded 

Notes:

  • To get help for the commands to 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.

This article is valid for DocuWare versions: 7.4 7.5 7.6 7.7 7.8 7.9 7.10 | client installation silent installation silent setup
Comments (0)