How do I install the DocuWare Desktop Apps using the silent setup?
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
Note: Please ensure you check the zip file is not blocked. To do so, right click on the file then select Properties. Then select the Unblock button and click Apply.
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
AdminTool
C2Outlook
EditSend
Export
Import
LocalDataConnector
Printer
Scanner
SmartConnect
Update (Not installed automatically)
UrlCreator
UserSynchronization
WEC
WorkflowDesigner
--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=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
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=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
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“.
Install Desktop Apps:
DocuWare.Setup.Client.Cmd.exe install --auto --server=https://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=https://server01 --orgId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
DocuWare Printer and all necessary modules (Desktop, CommonOCR) will be installed.
DocuWare.Setup.Client.Cmd.exe install --modules="Printer Scanner EditSend" --server=https://server01 --orgId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
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=https://server01 --orgId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Cloud: DocuWare.Setup.Client.Cmd.exe upgrade --all --server=https://<Your-DocuWare-Cloud-URL> --orgId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
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 - Logout 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.
