Skip to main content

Documentation Portal

Prerequisites

Before starting the upgrade, please use the checklist below to verify all prerequisites are met:

  • My current installed TrendMiner version is 2023.R4.0 or higher.

    In case you are running on version 2023.R3.0 or older, please upgrade first to version 2023.R4.0.

  • I have VM console access.

    In case issues occur during an upgrade TrendMiner support might request console access to efficiently resolve these issues. In case console access is restricted by the company it is advised to prepare for a temporary access permission for efficient troubleshooting.

  • I have a recent VM snapshot.

    Taking a VM snapshot before an upgrade is considered mandatory. Read here why.

  • I have a recent database backup.

    Read here why this is important and check here how to take a backup before an upgrade.

    Danger

    The upgrade from 2023.R4.0 to 2024.R1.0 contains an important database migration. We therefore explicitly want to emphasize again the importance of taking a database backup before triggering the upgrade.

  • I have updated the CentOS 7 default repository references.

    Notice

    This prerequisite only applies to single node deployments running on CentOS 7. If in doubt about your TrendMiner deployment mode you can check if you are running TrendMiner as a virtual appliance or a single node as documented here: How to check if TrendMiner is deployed as a virtual appliance?

    If you are using CentOS 7, you will have to update the default repository references. The following commands have to be executed as the root user:

    sed -i 's/^mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*.repo
sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*.repo

  • The upgrade from 2023.R4.0 to 2024.R1.0 contains an important database migration. This migration will need additional free disk space compared to regular upgrades. If there is not enough free disk space the upgrade will not start!

    Required free disk space for this upgrade: 25GB + 30 x the size of a compressed database backup.

    How to check:

    1. Create a new backup in ConfigHub or Edge Manager.

    2. When finished, download the newly created backup.

    3. Check the size of the backup (the tar.gz file).

    Example: downloaded backup = 5GB => required free disk space = 25GB + 30 x 5GB = 175GB.

    The available disk space can be checked in Edge Manager -> Diagnostics. In case there is insufficient free disk space the disk needs to be extended before upgrading TrendMiner. Note that once the disk is extended the extended disk space cannot be reclaimed anymore (it is not possible to shrink the disk space after the upgrade).

  • My system meets the minimum system requirements as listed below.

    Resource

    Minimum

    Minimum with Embedded Notebooks & Machine Learning Model functionality

    Recommended

    vCPU

    8

    16

    16

    RAM

    32GB

    64GB

    64GB

    Disk space

    SSD, 200GB, 250MB/s

    SSD, 500GB, 250MB/s

    SSD, 500GB, 250MB/s

  • I have read and understood the changes related to the ConfigHub access after the upgrade as documented here: How to restore your ConfigHub access after the 2024.R1.0 upgrade?

In this section: