Skip to main content

Documentation Portal

Upgrade TrendMiner

Important

During the upgrade from 2023.R3.0 to 2024.R1.0 a database migration will run. As a result this upgrade might take longer as usual. As long as there are "Pending" or "Running" tasks after starting the upgrade there is no reason to assume the upgrade failed. Please wait until all tasks are on "Success" or "Failed" before contacting support.

It is difficult to give an exact indication on the time needed to complete the upgrade as this depends on the disk performance, database size and type of data stored in the database. A standard upgrade takes about 1 hour. This upgrade might take a few hours.

  1. Log in to Edge Manager by browsing to ‘http://<trendminer_address>/edge’. Make sure all the Application Services are in healthy status.

    2024_R1_0_services_light.png

  2. First navigate to the ‘Backup and restore’ menu item in the 'Management' section and click on the ‘+Create backup’ to create TrendMiner backup. Click on the ‘Yes, create’ to proceed with backup creation.

  3. A popup message will appear indicating backup process has been started. Wait until the ‘create-backup’ task under RECENT ACTIONS panel changed into ‘success’.

    2023.R4.0 - create backup started feedback message

  4. Once the task in the RECENT ACTIONS panel changed into ‘success’, refresh the browser to see new backup line item.

  5. Save a copy of the backup by clicking ‘Options’ and then ‘Download backup’. Store the backup outside of TrendMiner. Doing so guarantees that no user data can be lost in case of issues during the upgrade.

  6. Download the TrendMiner installation file from the TrendMiner download site. The installation file is the trendminer-<version>.tar.gz file.

  7. Navigate to the ‘TrendMiner upgrade’ menu in the 'Management' section and click ‘Browse file'.

    edge manager trendminer upgrade 2023.R4.0

  8. Select the trendminer-202X.RX.X-XX.tar.gz installation file and click ‘Open’.

  9. Click the 'Upgrade system’' button.

  10. Click ‘Yes, perform upgrade’.

  11. Wait until file gets uploaded into the TrendMiner server. Once the file is uploaded, the list of 'Recent Actions' in the right panel of the screen will show the update progress. Wait until every ‘PENDING’ task changes into the ‘SUCCESS’ status.

    Notice

    During the upgrade services will be restarted, including ConfigHub and Edge Manager. This will result in users (including admins following up on the upgrade in ConfigHub/Edge Manager) being disconnected and error pages being shown when refreshing the pages. This is expected behaviour during the upgrade process.

    Only if Edge Manager does not come back online after about 10 minutes TrendMiner Support should be contacted.

  12. When all tasks finished successfully make sure all services listed below are shown and healthy. In case of missing services or if the status is not green, please contact TrendMiner Support.

    Without MLHub:

    2024_R1_0_services_light.png

    With MLHub:

    2024_R1_0_services_full.png

  13. Log into TrendMiner to validate the update.

    login screen

  14. In this 2024.R1.0 release Edge Manager and ConfigHub access have been split up and a new admin role is introduced. As a result ConfigHub will no longer be accessible with the same password you use to log in in Edge Manager.

    To learn more about the different admin roles: Admin roles compared

    To regain access to ConfigHub: How to restore your ConfigHub access after the 2024.R1.0 upgrade?

In this section: