Transition of Codeks program to .NET 8.0

As of January 2025, the Codeks program is transitioning to a newer version of the .NET platform, more precisely version 8.0, offering improved performance, enhanced security, and support for newer technologies. To ensure a smooth upgrade process, we have prepared detailed instructions on how to properly upgrade Codeks from older versions.

All users MUST FIRST upgrade their version to 10.2404.8.23089 before upgrading the program to 10.2501.6.22956 or newer!

Upgrading directly from versions older than 10.2404.8.23089 to newer versions is NOT RECOMMENDED, as it may result in data loss!

 

Instructions with steps for upgrading from the version 10.2404.8.23089 to the version 10.2501.6.22956 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 8.0 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 8.0 in .NET Desktop Runtime 8.0) 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