From d886d6eb350a76b4e665008425c6e635607d7f35 Mon Sep 17 00:00:00 2001 From: Dan Moore Date: Thu, 17 Aug 2023 19:15:17 -0600 Subject: [PATCH] Mooreds/add color about downtime (#2468) * added note about downtime expectations --- site/docs/v1/tech/admin-guide/upgrade.adoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/site/docs/v1/tech/admin-guide/upgrade.adoc b/site/docs/v1/tech/admin-guide/upgrade.adoc index f7eba88e86..4ef963a480 100644 --- a/site/docs/v1/tech/admin-guide/upgrade.adoc +++ b/site/docs/v1/tech/admin-guide/upgrade.adoc @@ -353,13 +353,15 @@ include::docs/v1/tech/installation-guide/_modes.adoc[] **Q:** How often should I upgrade? + **A:** We recommend staying within the last three minor versions, but we will not force an upgrade. In addition, we typically don't backport bug fixes. If you run into an issue with a bug, you'll need to upgrade to get the fix. We recommend you set up a regular cadence of reviewing and upgrading FusionAuth that fits your business needs, the same as you would with a framework or library your application depends on. - **Q:** How can I find out about new releases? + **A:** We publish release notes for every release. You can find them here: link:/docs/v1/tech/release-notes[Release Notes]. There are a variety of ways to be link:/docs/v1/tech/admin-guide#release-notifications/releases[notified of releases], including an email list and RSS feed. **Q:** Does FusionAuth support zero-downtime upgrades? + **A:** At this time, FusionAuth does not support zero-downtime upgrades when there is a database change. While there are a variety of options that can minimize downtime, upgrades will cause downtime whenever a schema change is required. Please https://github.com/FusionAuth/fusionauth-issues/issues/1240[review and upvote this issue] if zero-downtime upgrades are important to you. +**Q:** What kind of downtime can I expect? + +**A:** This depends. Factors include the amount of data in your system, the speed of your database, the schema changes required, and your upgrade option choice. If you run multiple nodes, downtime can be minimized. For example, multi-node clusters in FusionAuth Cloud experience user-facing downtime on the order of seconds to minutes during upgrades. Testing an upgrade in a non-production environment is the surest way to understand the amount of downtime. + == Detailed Upgrade Instructions This section will guide you with detailed technical instructions on how to upgrade FusionAuth nodes on different platforms.