Skip to main content

Updating the licensing agent

Marion Frei
  • Updated

This guide describes the recommended steps for updating an existing installation of the Licensing Agent.

You can download the Licensing Agent (version 2.0) here.

Updating to version 2.0.0 (from any version)

1. Stop the Windows service

Stop the Windows service axes4 Licensing Agent.

2. Back up the existing installation folder

Create a copy of the existing installation folder (default path: C:\Program Files\axes4 Licensing Agent). This copy serves as a backup and will be needed in step 4.

3. Run the installer

Run the installer to update to version 2.0.0.

4. Transfer the configuration file (appsettings.json)

Open the appsettings.json file from the installation folder (with administrator rights) side by side with the copy of that file from step 2. Transfer the existing values from the original file into the new appsettings.json.

Important: Because the schema of this file can change between versions, do not simply replace the new file with the old one. Instead, transfer only the relevant values individually.

Pay particular attention to the following sections:

  • "Agent" node: server URL, port, and UUID
  • Entire "Kestrel" node (contains the certificate settings)
    • If you are using the automatically generated agent.pfx certificate, also copy this file into the installation folder and overwrite the existing file.
  • "Proxy" node (if present): carry it over unchanged into the new appsettings.json.

Example:

{
  "Agent": {
    "Server": "https://[Host]:[Port]",
    "Uuid": "[Guid]"
  },
  "Kestrel": {
    ...
  }
}

5. Save your changes

Save the changes made to the appsettings.json file.

6. Restart the service

Restart the Windows service of the Licensing Agent.

After the update: Cleanup

First, verify that everything works as expected and that your end users can successfully activate against the updated agent. Only then:

  • Delete the copy of the installation folder created in step 2.
  • If no other applications on the system require .NET 8, you can uninstall the .NET 8 components (e.g., the Hosting Bundle).