Upgrading
Most Trax upgrades are a package bump: every Trax package releases at one version, and
UsePostgres and UseSqlite apply the schema migrations at startup. The guides below cover the
releases that need more, newest first. Each names the release it applies from; before Trax 1.61.0
each package had its own version, so older guides name the package too.
Guides
| Guide | Applies from |
|---|---|
| Move to the Trax.StateMachine packages | The release after Trax 1.67.0 |
| Reach trains through your own documents | Trax 1.67.0 |
| Adapt to the machine wire changes | Trax 1.64.0 |
| Regenerate twins after the trax machine generate defaults changed | Trax 1.63.1 |
| Move off the generic state-machine mutations | Trax 1.63.1 |
| Upgrade schedulers from Trax.Effect 1.57.2 or earlier | Trax.Effect 1.57.3 |
| Migrate to qualified principal ids | Trax.Api 1.44.0 |
| Adapt to the enqueue and outcome changes | Trax.Core 1.7.2, Trax.Effect 1.54.2, Trax.Mediator 1.22.1 |
| Move trains off RunInternal and Activate | Trax.Core 1.7.2, Trax.Effect 1.54.2 |
| Upgrade to HotChocolate 16 | Trax.Api 1.41.0 |
| Migrate from Hangfire | Trax.Scheduler 1.0.0 |
Database procedures
Schema migrations lists every migration that changes something visible. Three of them can need a hand: