Transition of Codeks program to .NET 10

With the release of version 10.2603.0, the Codeks application is being migrated to the .NET 10 platform, the latest version of Microsoft’s development platform. This migration brings long-term support, security updates, improved performance, and a solid foundation for further development and the introduction of new functionalities.

Before upgrading Codeks to version 10.2603.0, .NET 10 must be installed.

 

Are you using version 10.2404.12.23746 or higher (10.2501.x and later)?

If so, please follow the instructions below before upgrading to version 10.2603.0 or later.

WARNING! Before starting the upgrade, make sure to create a backup of your data or at least the following:

  • Database
  • CodeksCommunicationCryptoKey.txt
  • Database.config
  • logging.config
 

For proper functionality, you also need to install two Microsoft packages, which can be downloaded from the official Microsoft website:

 

After successfully installing the required Microsoft packages, you can upgrade Codeks to version 10.2603.0 or later.

   

Are you using a version EARLIER than 10.2404.12.23746?

Before upgrading to version 10.2603.0 or later, all users running a version lower than 10.2404.12.23746 MUST first upgrade to version 10.2404.12.23746.

Direct upgrades from versions earlier than 10.2404.12.23746 to newer versions are NOT RECOMMENDED, as they may result in data loss.

If you need the installation file for version 10.2404.12.23746, please contact our support team.

 

IMPORTANT before upgrading!

Before upgrading to the latest official 10.2404.12 version, it is ESSENTIAL to check whether you have configured the HTTPS protocol or changed the port (default is 9090). When upgrading from version 10.2404.x.x to 10.2603. or later, these settings are reset to their default values (HTTP and port 9090), so you will need to reconfigure them after the upgrade.

PROTOCOL: If, after upgrading to the latest official version, the protocol differs from your previous settings, stop the Codeks Service Manager by clicking the Stop button and then click the SSL certificates button. In the new window, select the correct SSL certificate you had configured previously, and under the Protocol mode tab at the bottom, select HTTPS.

PORT: If you were using a port other than the default 9090 before the upgrade, re-enter that port and click Change port to confirm.

 

Instructions with steps for upgrading from the version 10.2404.12.23746 to the version 10.2603. or newer

WARNING! Before starting the upgrade, make sure to create a backup of your data or at least the following:

  • Database
  • CodeksCommunicationCryptoKey.txt
  • Database.config
  • logging.config

For proper functionality, you also need to install two Microsoft packages, which can be downloaded from the official Microsoft website:

 

Below is a description of how the new .NET 10 installers function when Codeks is already installed (not a fresh installation – in most cases, this involves upgrading to a new version).

1. When you start the installation process, the program first checks if any other Codeks product is already installed on your computer. If a product is detected that differs from the one you want to install, a warning will appear (e.g., the Codeks product on your computer is TA-KIT, but you want to install Codeks TA). This notification informs you that you must first uninstall the existing Codeks product before proceeding with the installation of the new one. The installation process will stop at this warning until the existing program is removed.

 

2. If the check for another Codeks product is successful (no other Codeks product is installed on the computer), the system proceeds to verify whether the following two packages are installed on the computer.

If one or both packages are not installed, you will receive a notification indicating which package is missing, along with links to the official Microsoft website where you can download the appropriate installers:

Before you can proceed with the installation of Codeks, you must manually install the missing packages. Once the packages are installed, restart the Codeks installation process.

 

3. Once all the required Microsoft runtime packages (ASP.NET Core Runtime 10 in .NET Desktop Runtime 10) are installed, the installation process continues by comparing the version of the currently installed Codeks with the version you want to install.

  • If the version of Codeks you want to install is newer than the currently installed version, the installation proceeds.
  • If the version of Codeks you want to install is the same as or older than the currently installed version, the installation will be aborted.

To install an older version of Codeks, you must first manually uninstall the currently installed version. After the uninstallation, you can restart the installer for the older version. This ensures that only newer versions are installed unless you consciously choose to install an older version by manually removing the existing one.

 

4. Once the system successfully verifies the Codeks version, it proceeds to check the validity of the updates license. The system verifies whether the user has a valid upgrade license for Codeks.

  • If the user has a valid upgrade license, the installation process continues.
  • If the user does not have a valid license, the warning is displayed and the installation process is terminated.

This warning informes you that the upgrade license has expired and that you will need to obtain a valid license in order to continue with the Codeks upgrade. (Obtaining a new license for software updates).

 

5. If you have a valid upgrade license and an older version of the same Codeks product is already installed, the process will be recognized as an upgrade. In this case, you will receive a notification stating that the currently installed (older) version of Codeks must be removed before proceeding.

  • Confirmation for Removal: The user can click the “Yes” button, which will automatically trigger the process to remove the older version of Codeks (manual uninstallation is not required). Once the removal is complete, the installation of the new version will continue automatically.
  • Cancellation: Clicking “No” cancels the installation, and the older version remains installed.

When the uninstallation of the older version begins, the uninstaller automatically retains certain files and folders from the installation directory that are necessary for proper operation after the upgrade. These include:

  • CodeksCommunicationCryptoKey.txt (cryptographic key)
  • Database.config (database configuration)
  • logging.config (logging configuration)
  • Mape:
    • /Logs (logs)
    • /Assets/WorkplanTemplates (work plan templates)
    • /Webroot/assets (web content)
    • /data (database data, in the case of SQLite)

If the user wants to completely remove all Codeks files from the system, they will need to manually delete these files and folders, as the uninstaller does not remove them automatically.

Back to all news