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?"

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.

  • The following versions include the new DocuWare Desktop Apps certificate;

Note: If you already have the version listed below or a newer version, you do not need to update.
7.5 -> Certificates included in all updates starting with 7.5.0.2841 on 2024-10-03
7.6 -> Certificates included in all updates starting with 7.6.0.4559 on 2024-07-02
7.7 -> Certificates included in all updates starting with 7.7.0.10452 from 2024-07-01
7.8 -> Certificates included in all updates starting with 7.8.0.13230 from 2024-06-25
7.9 -> Certificates included in all updates starting with 7.9.0.4888 from 2024-06-05
7.10 -> Certificates included in all updates starting with 7.10.0.12746 from 2024-06-05
7.11 -> included in the release

2. You need to access your DocuWare Server with a Windows user with local administrator rights.
Note: If you do not have access to the DocuWare Server, please contact your internal IT department or your organization's network administrator.

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.5
DocuWare 7.6
DocuWare 7.7
DocuWare 7.8
DocuWare 7.9
DocuWare 7.10

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)


7. Navigate to %ProgramFiles%\DocuWare\Web\Platform\ClientSetup folder and locate the  ClientSetup.Settings.xml. 
Alternatively, repeat the instructions in step 6, but right-click the Platform folder and press Explorer, then proceed to the ClientSetup folder.

8. Open the ClientSetup.Settings.xml file in a text editor. If the line <Thumbprint>cbbf55ca33c1c1322fb2ca9fe31a5147579487e5</Thumbprint> is missing from the <DigitalCertificateThumbprints> element, add it to the file.
Note: Please create a copy of this file for backup purposes before any modifications are made.

9. Once completed, save the changes. The file should be displayed as the following;

<DocuWare xmlns="http://dev.docuware.com/schema/internal/setup" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Connection Id="Standard AS" Server="" Port="0" Organization="">
        <PlatformBaseUrl></PlatformBaseUrl>
        <ClientSetupUrl></ClientSetupUrl>
        <!-- MsiUrl is a URL that points to the location of the MSIs and all available Hotfixes -->
        <MsiUrl></MsiUrl>
        <SettingsServiceURL></SettingsServiceURL>
    </Connection>
    <!-- template for standard systems-->
    <Template appliesForOrganizationType="">
        <Modules>
            <Module Id="C2Outlook">true</Module>
            <Module Id="EditSend">true</Module>
            <Module Id="Scanner">true</Module>
            <Module Id="Printer">true</Module>
            <Module Id="Import">true</Module>
            <Module Id="SmartConnect">true</Module>
            <Module Id="WEC32">true</Module>
            <Module Id="WEC64">true</Module>
            <Module Id="AdminTool">true</Module>
            <Module Id="WorkflowDesigner">true</Module>
            <Module Id="UrlCreator">true</Module>
            <Module Id="Update">true</Module>
            <Module Id="UserSynchronization">true</Module>
            <Module Id="Export">true</Module>
        </Modules>
    </Template>
    <Version> 7.5.2767.0 - Corresponding DocuWare version </Version>
    <AllowSendingFeedback>false</AllowSendingFeedback>
  <DigitalCertificateThumbprints>
    <Thumbprint>d0e26b2e5f21665cf6a3b4b1b272c5022e51e896</Thumbprint>
    <Thumbprint>b94bf176f742ee0fe2ab919e5648ed3a8fdbf52d</Thumbprint>
    <Thumbprint>cbbf55ca33c1c1322fb2ca9fe31a5147579487e5</Thumbprint>
  </DigitalCertificateThumbprints>
</DocuWare>

10. Open the command prompt or Powershell as an administrator and run the iisreset command.
Note: While the IIS is restarting, DocuWare and other services hosted by the IIS are not available
.

 

 

How to 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: Depending on the Windows version and the installed DocuWare modules, the update may require local administrator rights.

How to 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 KBA-36543

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.5 7.6 7.7 7.8 7.9 7.10 | Desktop Apps; Certificate