superset-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [incubator-superset] branch master updated: [docs] improve upgrading instructions (#6766)
Date Tue, 29 Jan 2019 06:14:13 GMT
This is an automated email from the ASF dual-hosted git repository.

maximebeauchemin pushed a commit to branch master
in repository

The following commit(s) were added to refs/heads/master by this push:
     new 7c02587  [docs] improve upgrading instructions (#6766)
7c02587 is described below

commit 7c02587924a1c05d8591aa54c316c9c59b18214b
Author: Maxime Beauchemin <>
AuthorDate: Mon Jan 28 22:14:02 2019 -0800

    [docs] improve upgrading instructions (#6766)
 docs/installation.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/installation.rst b/docs/installation.rst
index f1a6d76..ecce52f 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -616,6 +616,18 @@ Upgrading should be as straightforward as running::
     superset db upgrade
     superset init
+We recommend to follow standard best practices when upgrading Superset, such
+as taking a database backup prior to the upgrade, upgrading a staging
+environment prior to upgrading production, and upgrading production while less
+users are active on the platform.
+.. note ::
+   Some upgrades may contain backward-incompatible changes, or require
+   scheduling downtime, when that is the case, contributors attach notes in
+   ```` in the repository. It's recommended to review this
+   file prior to running an upgrade.
 Celery Tasks
 On large analytic databases, it's common to run background jobs, reports

View raw message