Prepare Release 10.2.3

[popescu-v]

Description

• Preparation

  • [x] Create a prepare-release-10.2.3 branch, based on the dev-v10 branch; check out the prepare-release-10.2.3 branch
  • [x] Update the README.txt and WHATSNEW.txt in the packaging/common/khiops directory
  • [x] Update the [PDF documentation][pdf-docs]
  • [x] Update the technical repo [khiops-win-install-assets][win-install-assets]
  • Update the versions of all assets that require an update, namely:
    • Khiops Visualization
    • Khiops Covisualization
    • Khiops PDF Docs
    • Java JRE installer
    • MS MPI installer
  • [x] Update Khiops version to 10.2.3-rc.1 in the src/Learning/KWUtils/KWKhiopsVersion.h header file
  • [x] Create PR on the prepare-release-10.2.3 branch and have it reviewed
  • [x] Once the PR is approved, merge it into the dev-v10 branch
  • [x] Create the 10.2.3-rc.1 pre-release tag on the dev-v10 branch

• Full Test Loop

  • [x] Push the 10.2.3-rc.1 pre-release tag
  • This will create a pre-release entry in the [release section][khiops-releases] with all the the CICD generated packages
  • [x] Execute the end-to-end tests (aka. LearningTest) in all supported environments
  • If there are major issues, fix them (making issues, PRs) and go back to "Create pre-release tag..."
  • [x] Execute the [manual tests for the GUI packages][manual-tests]

• Finalize the Release

  • [x] Update src/Learning/KWUtils/KWKhiopsVersion.h to the final release tag 10.2.3
  • [x] Merge dev-v10 into main (via PR)
  • [x] Create the final release tag (see also [Versioning][versioning]):
    • Tag the main branch (git tag 10.2.3 then git push --tags)
  • [x] Copy and paste the release notes from packaging/common/khiops/WHATSNEW.txt to in the new [github release entry][khiops-releases]
  • [x] Remove any packages that haven't been deemed to release
  • We create more packages than we release for testing purposes (viz. kni-transfer)
  • [x] Manually launch the conda.yml workflow on the 10.2.3 tag, while selecting khiops as release channel
  • [x] Sign the Windows package and replace it in the release
  • [x] Set release as "latest"; unset its "pre-release" status
  • [x] Release enabler: khiops-python,
  • [ ] Release enabler: khiops-notebook.
  • At this point the update of the website is unblocked

• Final Git Manipulations

  • Update the main branch
  • [x] Make the dev-v10 branch point to main
  • Locally execute git fetch, then git switch main, git switch dev-v10 and git reset --hard main
  • In the repo's [branch protecting settings][branch-settings] remove temporarily "Require a pull request before merging"
  • Locally execute git push
  • Restore in the [branch protecting settings][branch-settings] "Require a pull request before merging"

Context

• Khiops version: 10.2.3
• Log file (use khiops -e log.txt): N/A
• Scenario file (use khiops -o scenario._kh): Any
• OS description (use khiops -s): All supported

[popescu-v]

Manual testing report on Linux OSes:

• Khiops packages: pre-release 10.2.3-rc.2: https://github.com/KhiopsML/khiops/releases/tag/10.2.3-rc.2
• OS matrix:
  • Ubuntu 20.04, 22.04, 24.04
  • Rocky 8, 9
  • Debian 10, 11, 12
• Configurations, for each OS:
  • Docker containers without display
  • Docker containers with display

Procedure, according to https://github.com/KhiopsML/khiops/wiki/Release-Process#linux :

• [x] Install with the proper method in each OS => OK for all OSes
• [x] Check output of khiops_env via khiops_env --env => OK for all OSes
• [x] Launch the Khiops applications
  • [ ] ~From the start menu~
  • [ ] ~From the desktop icon (?)~
  • [x] From a shell session (in Docker containers), via the khiops and khiops_coclustering commands => OK for all OSes
• [x] Check in the application:
  • [x] That the menu "Open Dictionary File..." opens ~in /usr/bin~ (or in the current directory where the khiops / khiops_coclustering command was launched) => OK for all OSes
  • [x] That Adult supervised analysis works fine in khiops => OK for all OSes
  • [x] That the resulting AllReports.khj work fine with the Khiops Visualization, launched on the host machine if tests are done in Docker containers => OK for all OSes
  • [x] That khiops -v, khiops -s work (idem for khiops_coclustering), when launched from a shell => OK for all OSes
  • [x] That, when launched without arguments, or with any argument except for -b, -s or -v, in a shell in a Docker without display enabled, khiops and khiops_coclustering output GUI is not available, please use the '-b' flag is generated; if a non-existing argument is passed alongside with -b, then the command's help is displayed. => OK for all OSes
• [x] Uninstall the application => OK for all OSes
• [x] Check that:
  • [x] norm.jar, khiops.jar from /usr/share/khiops, are removed, along with this directory as well, when the khiops package is removed => OK for all OSes
  • [x] calling the khiops command after khiops package removal results in a GUI is not available, please either use the '-b' flag, or install the 'khiops' native package for your host operating system. message => On Ubuntu 22.04, 24.04 and Debian 12, this is displayed, but is followed by the message Failed to execute child process “dbus-launch” (No such file or directory) ! => On Ubuntu 20.04, this is displayed, but is followed by the message GDBus.Error:org.freedesktop.DBus.Error.ServiceUnknown: The name org.freedesktop.Notifications was not provided by any .service files ! => OK for all the other OSes
  • [x] MODL* khiops and khiops_env khiops-coclustering are removed from /usr/bin, when khiops-core[-openmpi] is removed. => OK for all OSes