Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Image RemovedImage Added
Warning
  • Prior to beginning any upgrades or migration, ThreadFix strongly recommends users review the Upgrade & Migration Guidelines.

  • As of ThreadFix 3.4, ThreadFix no longer supports MySQL 5.7 and users should migrate to MySQL 8.0.

1. Upgrading an Internal DB:

  • Begin by following the standard upgrade instructions labeled as "Upgrade".

  • Please Note: You will need to deploy at least twice.

    • First Deployment: This will usually fail because of conflicts between the spring framework db entities and the MySQL upgrade. However, by the end of this first attempt, the MySQL DB container should have successfully upgraded to MySQL 8, and the appsec-migration process should be completed.

    • Second Deployment: The Threadfix 3.X deployment should start up successfully.

  • For Local Deployment on a Dev EKS Cluster: When updating local branches between versions 3.3 and 3.4/latest, execute the following command:

    Code Block
    bashCopy code
Note

rm k8s/charts/threadfix/charts/*.tgz && helm dep up k8s/charts/threadfix

2. Upgrading an External MySQL DB (5.7 to 8.0):

  • ThreadFix advises users to follow the MySQL’s INPLACE upgrade instructions when transitioning from MySQL 5.7 to MySQL 8.0.

    • Upon successful INPLACE migration, you can then upgrade ThreadFix to version 3.4 by following the provided Upgrade Guides.

  • Migration Between Servers: If you decide to move from one server to another, ensure you modify the configurations specified in the documentation for either Global or AppSec databases.

  • Encountering Errors: Should any complications arise during MySQL’s Upgrade Checker, immediately open a support ticket. Attach the results of the Upgrade Check to this ticket. This will aid the ThreadFix Support team in assisting you throughout the migration process.

Table of Contents

Table of Contents