ALM 23.1 to ALM 24.1 - ALM 23.1 to ALM 24.1 - Brainware - ALE Learnset Manager - Brainware/ALE-Learnset-Manager/25.1/ALE-Learnset-Manager-Installation-and-Upgrade-Guide/Upgrade-Procedure/ALM-23.1-to-ALM-24.1 - 25.1 - 25.1

ALE Learnset Manager Installation and Upgrade Guide

Platform
Brainware
Product
ALE Learnset Manager
Release
25.1
License
ft:lastPublication
2026-03-19T22:14:48.075000
ft:locale
en-US

ALM 24.1 introduces support for the HTTPS protocol by default, with an option to use HTTP if preferred, during installation. Before upgrading, ensure that your environment meets all prerequisites and is configured correctly. If HTTPS is to be used, ensure the environment is HTTPS-enabled before starting the upgrade. For more information, refer to Configuring HTTPS Support for ALM.

Locate the current installation (23.1) directory of ALM on the server. Example: ...\ALM\WEB-INF\conf. Open alm-config-db.xml and make a note of the username. This is required during the installation of ALM 24.1.

To upgrade ALM from ALM 23.1 to ALM 24.1, complete the following steps:

  1. Ensure that all the existing ALM servers are stopped. There can be multiple servers located in different machines.
  2. Uninstall ALE Learnset Manager by deleting the folder C:\Program Files\Apache Software Foundation\Tomcat<installed version>\webapps\ALM and C:\ALM.
  3. Delete the entry for C:\ALM \lib\win64 from System Path variables under the Environment Variables section.
  4. Run the ALM 24.1 installer.
  5. Select the HTTP or HTTPS preference.

    By default, the HTTPS Support check box is selected, and the Tomcat URL is set to the following format: https://<Host_Name_With_Fully_Qualified_Domain_Name>:<Port> (Example: https://<Server Name FQDN>:8443/).

    If HTTP is preferred, clear the HTTPS Support checkbox and update the Tomcat URL to the following format: http://<Host_Name_With_Fully_Qualified_Domain_Name>:<Port> (Example: http://<Server Name FQDN>:8080/)

  6. Install ALE Learnset Manager (24.1) on the same machine using the same database user credential that was used with the previous ALE Learnset Manager (23.1) installation.
    Note: Do not delete the database.
  7. Start the ALM servers.
  8. Verify if Starting: Hyland ALE Learnset Manager 24.1 is printed in the alm-ws.log.
  9. Before logging on to ALE Learnset Manager, clear your browser history and cached files.
  10. Ensure the entry <ALM data directory>\lib\win64 (e.g., C:\ALM\lib\win64) exists in the System Path variable within the Environment Variables section.
  11. Log on to ALM Web GUI and verify that projects created in ALM 24.1 are available.
    Post Installation steps:
    1. Open the configuration for each project and confirm the following:
      • The Use Classification Parameters checkbox is checked.
      • Threshold is set to 75 (default value).
      • Distance is set to 0 (default value).
    2. Open the ALM database and verify:
      • The LEARNSET_DOC table contains all documents from ALM 23.1, with timestamps in the newly added creation_date column.
      • Two new tables, TMPALMDOCUMENT and TMPALMFIELDS, are present.
    3. After upgrading it is recommended to learn the existing project(s).
    Note: During upgrade, previous user credentials get deleted and new user credentials (provided by the user during installation) are stored in the database in an encrypted format. In case the new user credentials are same as previous version's (ALM 23.1) credentials, then the user account is recreated in an encrypted format using the dynamic key generated during installation.