Open Closed

8.3.0 upgrade to 9.2.0 - Host and Tenant Migrations #9447


User avatar
0
luciana created

Hi,

Can you provide us a with a single migration that needs to be applied for both the host and tenant when upgrading from 8.3.0 to 9.2.0? Here is the solution configuration:

  • Template: app
  • Created ABP Studio Version: 0.8.2
  • Current ABP Studio Version: 0.9.26
  • Tiered: Yes
  • UI Framework: angular
  • Theme: leptonx
  • Theme Style: system
  • Progressive Web App: Yes
  • Database Provider: ef
  • Database Management System: mysql
  • Separate Tenant Schema: Yes
  • Mobile Framework: none
  • Public Website: No
  • Optional Modules:
    • LanguageManagement
    • AuditLogging
    • SaaS
    • OpenIddictAdmin

7 Answer(s)
  • User Avatar
    0
    AI-Bot created
    Support Team AI Bot

    To upgrade your ABP solution from 8.3.0 to 9.2.0, you need to follow the migration steps for each major version increment. The ABP migration process does not provide a single SQL migration file that covers both host and tenant databases for all scenarios, especially when using separate schemas for tenants. Instead, you should:

    1. Review and apply the breaking changes and migration steps in the official migration guides for each version jump (8.x to 9.0, then 9.0 to 9.2).
    2. Update your Entity Framework Core migrations in your solution to reflect any changes in the ABP modules and your own entities.
    3. Run the generated migrations for both the host and all tenant schemas.

    Recommended Steps:

    1. Read and follow the official migration guide for ABP 9.0:

    2. After updating your codebase and dependencies, use the standard EF Core migration workflow:

      • Run Add-Migration (or dotnet ef migrations add) to generate a migration that includes all changes from 8.3.0 to 9.2.0.
      • Apply the migration to the host database.
      • Apply the same migration to each tenant schema (since you use separate schemas).
    3. If you use ABP's SaaS module with separate schemas, ensure your migration logic iterates over all tenant schemas and applies the migration to each.

    Note: There is no official, pre-generated "single migration file" provided by ABP for all host and tenant upgrades. The migration is generated based on your current database state and code changes.

    Summary:

    • Update your solution and dependencies as per the migration guide.
    • Generate a new EF Core migration after all code changes.
    • Apply the migration to both host and tenant schemas.

    Sources:


    This response was generated by AI. If it didn’t solve your problem, feel free to post a new answer — our support team will jump in to help you soon.

  • User Avatar
    0
    luciana created

    Hi,

    To avoid mistakes, is it possible to get the migrations needed? This is an upgrade from the previous major version, so I would expect that many ABP developers are facing the same problem and supplying it, would make it easier.

  • User Avatar
    0
    maliming created
    Support Team Fullstack Developer

    hi

    You need to run dotnet ef migrations command to add new EF Core migrations.

    Migration files are generated and maintained by EF Core tool (https://learn.microsoft.com/en-us/ef/core/cli/dotnet)

    Thanks.

  • User Avatar
    0
    luciana created

    Hi,

    The migration guides refer to PR's in order to determine what has changed. My request is that instead of me going through the PR's to make sense of the changes but then also to collate them based on the exact ABP solution (template and configuration, included in this ticket) that we are using manually, given the ABP solution that we are using, can you provide me with the exact migration changes that I need to apply to upgrade from 8.3 to 9.2? In other words, can you provide me with a up and down method for the host migration and then similarly a up and down method for the tenant migration?

    Additionally there is no migration guide or release notes on the abp.io website for 9.2?

  • User Avatar
    0
    maliming created
    Support Team Fullstack Developer

    hi

    can you provide me with a up and down method for the host migration and then similarly a up and down method for the tenant migration?

    You can generate it by dotnet ef migrations command, then you can revert the changes in your git.

    https://abp.io/docs/9.2/release-info/migration-guides/abp-9-2 https://abp.io/docs/9.2/release-info/migration-guides

    Thanks.

  • User Avatar
    0
    luciana created

    Hi,

    Thank you. I did not know that migrations would be generated automatically. It works.

  • User Avatar
    0
    maliming created
    Support Team Fullstack Developer

    : )

Boost Your Development
ABP Live Training
Packages
See Trainings
Mastering ABP Framework Book
The Official Guide
Mastering
ABP Framework
Learn More
Mastering ABP Framework Book
Made with ❤️ on ABP v9.3.0-preview. Updated on June 13, 2025, 11:37