Views:

This article details how the DocuWare Desktop Apps Certificates can be updated without updating the server components of DocuWare. Nonetheless, DocuWare Support recommends updating server components as well and following our regular update instructions for each version.
If you are installing the latest minor update, you can skip to "How do I apply the update to (each) client computer?".

For DocuWare systems prior to 7.0, the installation requires a major update. Please see the DocuWare Update path before proceeding.

What is required to perform the update?

1. Locate the version of DocuWare you are currently utilizing:  How to find out which DocuWare Version is installed.

2. If you are already using the latest minor version of DocuWare, you can skip directly to the section: How to update the Desktop Apps certificates.

Latest minor versions:

7.1.0.15796
7.2.0.11594
7.3.0.56259
7.4.0.52734

How do I apply the update to the DocuWare Server?

1. Log on to the server on which you have installed DocuWare.
Note: For scaled DocuWare systems with multiple servers, please perform the following steps on all DocuWare Servers on which the Frontend server role is installed. 

2. Download the latest DocuWare Server Setup for your version of DocuWare:

DocuWare 7.1
DocuWare 7.2
DocuWare 7.3
DocuWare 7.4

3 . When you have finished downloading the ZIP file, ensure it is not blocked via the file properties. Please reference KBA-36834 for further details on how to view file properties and unblock the ZIP file.
Once completed, extract the downloaded ZIP file.

4. Open the folder with extracted files and navigate to DW7.X_XXXX-XX-XX\DocuWare Version 7.X Minor Update XXXXXXXX\DocuWare and Modules\ClientSetup
Note: Sections of the folder name may vary depending on the installed DocuWare version. 

5. Open the folder %ProgramFiles%\DocuWare\Web\ClientSetupData in a new File Explorer window.
If the folder does not exist or is empty, this indicates the installation is in a custom location. Press Windows + R and type "inetmgr" then click OK to locate the folder.



Open IIS, navigate to Sites > Default Web Site ("or the Site where DocuWare is installed") > DocuWare. From here, right-click ClientSetupData and press Explore.

6. Copy the following files and folder from the ClientSetup folder (previously extracted folder) and replace them in the ClientSetupData folder.

  • DocuWare.ClientSetup.msi
     
  • DocuWare.Desktop.msi
     
  • DocuWare.Desktop.msi.xml
     
  • ClientSetupCmd (folder)

How do I apply the update on (each) client computer?
Once the files have been replaced on the DocuWare Server(s), the Desktop Apps must be updated on all client machines to install the new certificates. The user is automatically prompted to update the Desktop Apps approximately 3 hours after the files have been updated or after the PC has been restarted.

If you want to manually trigger the update of the Desktop Apps, users can right-click on the DocuWare icon in the taskbar and select the "Check for updates" option.
Note: Local administrator rights are required to update the Desktop Apps.

How do I automate DocuWare Desktop Update on Client Computers via software deployment?
If you have deployed the Desktop Apps using the DocuWare Silent Setup and a software deployment solution, you can also apply the update automatically on the Client computers.  Please ensure that you are using the new version of the DocuWare Silent Setup to apply this update. Either use the Silent Setup from the %ProgramFiles%\DocuWare\Web\ClientSetupData\ClientSetupCmd\ClientSetupCmd.zip file or use the steps outlined in KBA-36732. 

You can update the Desktop Apps via the Silent Setup by using the command upgrade --all as outlined in the following articles;

DocuWare 7.1 Silent Installation/Upgrade
KBA-35551

DocuWare 7.2 Silent Installation/Upgrade
KBA-36246

DocuWare 7.3 Silent Installation/Upgrade
KBA-36355

DocuWare 7.4 Silent Installation/Upgrade
KBA-36543
 

How do I update the Desktop App certificates?

Download of Desktop Certificate Update Tool
Download the Desktop Certificate Update Tool from here.

General information

  • The tool must be executed on all client computers where the Desktop Apps are installed.
  • The tool must be executed by a user with local administrator rights.
  • The tool will stop all instances of the Desktop Apps as well as the Desktop Service.
  • The user must manually restart the Desktop Apps or the computer. The Desktop Service is automatically restarted.
     

How do I run the Desktop Certificate Update Tool manually?

1. To start the tool, right-click the DesktopUpdate.exe and select "Run as administrator"

2. After a few seconds, the tool should update the certificates, and you can close the window.
 

How do I run the Desktop Certificate Update Tool via software deployment?
The tool can be run in a software deployment scenario using the /s command line switch to suppress any user interaction.
Example:
DesktopUpdate.exe /s
 

How do I get help if needed?

  • If you have purchased DocuWare directly at DocuWare:
  • If you have purchased DocuWare through an Authorized DocuWare Partner:
    • Please get in touch with your DocuWare Partner Contact.
       
  • If you are an Authorized DocuWare Partner:

KBA is applicable to On-premises Organizations ONLY

This article is valid for DocuWare versions: 7 7.1 7.2 7.3 7.4 | Desktop Apps; Certificates