Necessary Actions When Updating or Upgrading to 9.12

Owned by Mr. Schmittberger
Last updated: Nov 02, 2023 by Product Management
2 min read

Necessary Actions When Updating/Upgrading

This page describes the actions that you must manually execute when updating from version 9.x to a newer version. It also lists things that you must pay special attention to. An update to a new version that skips some of the previous versions is possible and does not require updating to each version in between. However, in this case, you must carry out all the actions from your previous version to the target version in the order listed here.

  • 8.16 → 9.10 or higher

    • If you use a custom client you have to migrate it as described in this article: Getting Started

  • 9.2 --> 9.4

    • The signing-service for the integration of DocuSign was added to the product. The following configuration steps need to be done:
      • Edit the file <service-manager>\config\gateway-prod.yml, add the following endpoint to the end of the 'routing.endpoints:' list:
        routing.endpoints: 
  - name: 'signing'
    url: 'http://signing/signing'
      • Edit the file <service-manager>\config\servicewatcher-sw.yml and add the following new section to the end of the file:
        - name: signingservice
          type: microservice
          profiles: prod,cloud
          instances: 0
          memory: 256M
          port: 7255
          path: "${appBase}/signingservice/signingservice-app.jar"

        (If you want to use the signing service right away, change the instances parameter from 0 to 1.)
      • Create the file <service-manager>\config\signing-prod.yml and add the following lines to it:
        docusign-config:
          pathToPrivateKey: '../../certificates/private.key'

      • Obtain your private key file from DocuSign and copy it to <service-manager>\certificates. Create the directory if it doesn't exist yet.


    • Certificate files need to be moved out of the viewer-service directory
      • If you have a self-signed gateway certificate and configured the viewer-service to accept this certificate by putting the corresponding .crt file into the directory <service-manager>\apps\viewerservice, then it needs to be moved out of this directory because during the update process this directory is deleted and recreated causing the any additional files to be lost. To do so, follow these steps:
        1. Create the directory <service-manager>\certificates
        2. Move the *.crt file from <service-manager>\apps\viewerservice to <service-manager>\certificates
        3. Edit the file <service-manager>\config\servicewatcher-sw.yml and change the certificate path in the viewer-service section to: NODE_EXTRA_CA_CERTS: ${appBase}/../certificates/yuuvis.crt
          (change 'yuuvis' to the name of your certificate file)
        4. It should now look like this:



      • Optionally you can also move the certificate of the gateway-service to this directory, so that a centralized directory for all certificates exists. After doing that, the configuration file for the gateway SSL settings (usually gateway-ssl.yml) needs to be adapted as follows:
        • server.ssl.key-store: '../../certificates/yuuvis.p12'

          (change 'yuuvis' to the name of your certificate file)