The Properties editor is part of the censhare standard product since version 2019.3. The Properties editor uses a third-party library that requires a valid license key. License keys expire after 12 months. To renew your license key, censhare publishes a patch annually. Apply this patch on your system, even if you do not use the Properties editor, to avoid error messages in your server logs.

Context

This patch is required for censhare 2019.3 or later. The patch installs a valid license key for the Properties editor.

Install this patch even if you do not use the Properties editor in your censhare system!

Prerequisites

None.

How to install the renewal license

There are different ways to install the renewal license. Select one of the following options and follow the instructions.

Update your system

  1. Select the release according to your running system. The following releases contain the renewal license:

    • censhare 2019.3.6 - 990eaf25

    • censhare 2020.1.5 - ce313119

    • censhare 2020.2.1 - 9a3ee878

  2. Install the correct version and restart your server.

Patch the server with a .patch file

Note: If you are not familiar with this way of patching, we strongly recommend to patch your server manually!

  1. Download the correct patch file:

    • For censhare 2019.3, censhare 2020.1 and censhare 2020.2 use 37796.patch.

    • For censhare 2020.1 WP and censhare 2020.2 WP use 37796.2.patch.

  2. Apply the patch file.

  3. Restart the censhare server.

Patch the server manually

  1. On the censhare server, open the following files in an editor:

    • censhare-Client5/web/src/ng1/client/DAM/widgets/propertiesEditor/properties-editor-widget.module.ts

    • censhare-Client5/web/src/ng1/client/DAM/widgets/propertiesEditor/properties-editor-widget.module.js

  2. In both files, search the license:

    censhare_AG_Censhare_49Devs_500Deployment_23_September_2020__MTYwMDgxNTYwMDAwMA==c81b341e22e130d5e524e02567ab3f3e


  3. In both files, replace it by the new license:

    CompanyName=censhare AG,LicensedApplication=censhare,LicenseType=SingleApplication,LicensedConcurrentDeveloperCount=46,LicensedProductionInstancesCount=500,AssetReference=AG-009618,ExpiryDate=14_September_2021_[v2]_MTYzMTU3NDAwMDAwMA==3652313acfa761883590138a07b96ac1

    Important: The license key must not contain any line breaks!

  4. Restart the server.

Patching without restarting the server

If you need to update the license on a running system without restarting the serevr, you can add the new license to the runtime of the censhare server.

To do this, replace the license in the following file:

censhare-Server/work/runtime-web/client/web/src/ng1/client/DAM/widgets/propertiesEditor/properties-editor-widget.module.js

However, your changes will be lost when you restart the server. We recommend that you also update the source files as described above, so that the new license is copied to the runtime after a restart.

Result

The Properties editor works as expected after the installation of the renewal license.