[GitHub] [trafficcontrol] dangogh commented on a change in pull request #3524: Collapse database migrations

[GitBox <gi...@apache.org>]

dangogh commented on a change in pull request #3524: Collapse database migrations
URL: https://github.com/apache/trafficcontrol/pull/3524#discussion_r279054358
 
 

 ##########
 File path: docs/source/admin/traffic_ops/installation.rst
 ##########
 @@ -218,6 +218,8 @@ Upgrading Traffic Ops
 =====================
 To upgrade from older Traffic Ops versions, stop the service, use :manpage:`yum(8)` to upgrade to the latest available Traffic Ops package, and use the ``admin`` tool to perform the database upgrade.
 
+.. tip:: In order to upgrade to the latest version of Traffic Ops, please be sure that you have first upgraded to the latest available minor or patch version of your current release. For example, if your current Traffic Ops version is 3.0.0 and version 3.1.0 is available, you must first upgrade to 3.1.0 before proceeding to upgrade to 4.0.0. (Specifically, this means running all migrations, :file:`traffic_ops/app/db/seeds.sql`, and :file:`traffic_ops/app/db/patches.sql` for the latest of your current major version - which should be handled by the :program:`app/db/admin` tool).
 
 Review comment:
   you might want to mention the migration id that's the latest prior to the collapse.  This could help ensure they really have upgraded appropriately.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services