From 45c965bcf135b5b20cf905ab43191afa4d63ecaa Mon Sep 17 00:00:00 2001 From: michaelbirnstiehl Date: Thu, 21 May 2020 10:22:11 -0500 Subject: [PATCH] DOCS add version number format information --- server/sonar-docs/src/images/version.png | Bin 0 -> 3633 bytes .../sonar-docs/src/pages/setup/upgrading.md | 25 ++++++++++++++---- 2 files changed, 20 insertions(+), 5 deletions(-) create mode 100644 server/sonar-docs/src/images/version.png diff --git a/server/sonar-docs/src/images/version.png b/server/sonar-docs/src/images/version.png new file mode 100644 index 0000000000000000000000000000000000000000..6ef2d7757f70c79f7bd5e9f27e9db56bd1841363 GIT binary patch literal 3633 zcmai12{_bW+a6>avNdGOI)#u(7+Yv$RD@(KS;yEKLyX;66J^UbBg;$KD%nHXcUcSB z_bg%TLX746)%Snj|8;%e`(E#L{g(6G&wb8$&biLH&vTyX>1v$?bAv%3&{=H++yDfk zpa#kTbTq(M^2`|#;79L@FmVTgm|A|n6iMPtJOD_G)7H_Xou_7Jg_z|(BMyMzXm^yGqbttQ1q(VyFDMM);NSR77grxQM|%ex=sk0{B7ide zLEX^Szo`N^M`twX`aUx~;GzHRx$k0!^RjkBgUnq|f72QMH16n*!dL@TH&A86hgbln z`wb(l-LQ^Wdr$+H&=AH_gxyhe3nh ztoH+BXFSq|s~dW!txeu@;6d`yZWa+#e8U7$uHWxxbIONH5~yxlOGm3?;~w}rIgCW& z`VArqZ$&{Q`t|HK+@bE$Vc^z|88rVQcu59rK~Q ziygEl%1&9BM5YM7p7L^kYUx0Jqn4{@r=wING~&(dJ*<6DL`|4_aKsr#FdS;7Cm=)- zO36yk35h^7WU9d_X{d$Ru8Ok61^rEN)fS2i`tqafXQ!1we??W*^RO`Lhc(`; zW@f$F868IqN=iz-t7(|#%&QV$>W81)sKdj<&5?d5N3bcpyhEUsD5Utq2iqOp4tho~ z)g>0XndANYi*lEV(gXyj1>WACmLG3xIdF1vOwR2W@sbw(2+jC%ld!;7gg-+WJR}zn zot*t*rxBkWjWbOEcZzv?f9bk{$ffYr}%% z3}sW7L6?q$Knneg>$L}qsfwg%0q$tRti5~m@=;!;A>jX+s$ z%})>8yfW~)qjpZ6ooGF7+dxkxs&9HzEr*A`qyngRa;p0b|Mmn72oiYK?87KGl%W-n z8V$U7X}URWvya}fn?XD@4d!0sBd}kRGeghhb)lkS)A35UWxxS-{ppF)^Rt z6@DQYig%ouf3F56_VVuc=`a6yEMXl1)cV@e^5oi$1g0=o*WyTEZr{FrJ7l9B|Kjc? z{VT+{u7#Lmk+FG6RTBcb@|rq)s*&)o{X8RBWKnCAGOtKO9s9;8KRGq^X1OUkW&Sc? zf3_?0-d$lY9hDe>BDYpTX$|uqq^bCE3_7uAWo3;_PPQ&Bi2|KI5+Ew)AS8n>TQ+}daSY!)u-AC~MPM#Qb^o%VmIQVqd z%g@Il0qfURJO5;Fh@eaTamBcaf*h9iJGN+H0bR))`{?N1e)x8?qem1Q$; z)aiXg-Pj&C=}q;0PPLnGU+&Kdru!QDLMxB4=R$N%f^K9xJhI(3qKX-A%lO~4@vr!v zZdWoJ4*RFb#IXgE)v_CWo7SmV-(D3R`A)a9v$J{N|JhdNFdqU2O34`+?W~~85UZ;Z z8nc{b%PH2ENi!(D;?b2Ar@0J^MDIgse@sA)kiC-TkALKiVP^$yqA(cvzME^H+*Z*dU>^78|^ zJ~_Z}EaOc3UZLSq(R2kguD`<{rF5Q{|#&bPi%V}B8uLe zLZnk;52fd-k;SkzS+G%DT^%_7-0ROCUWtrb)IMM+`02Tr><4A#inGh zAyaVoN{jrof9U9_iRMY$oscU8K+~MhrCn0RL%~D$t8h9YH zK3N^!Mcmn2ljR7lDW#nDTjO8L9&pSySgaOF-yWVA?!K!OttJq3dVv?mge~D@+V=Sc z8ArrF;SW$)I%3A6Og>v2B|+mTN%Yms@a(4lkktIOalN&K<0yYLalX!MkV=gLWW`g7 zp^ztKJnh+M&KR-3(jbn|kR+}+#-*Qh+rigrt_fXaquca$ufS7yQJ7Y#lCLj#;)YIAui$NkyodgdY3z9 zU5%$)@D)-(-t)=O0Qq8Xn`1YaWomffE5!JXaVPkdRJv|gu$tQEj4HO}oW7}B_7`T| zRaQDNB@({ut#gXB)XprcCj5$b3x*HKazIym_BFbq_dvBn8zx4f9`F1V_m)oMvuC;D z+O}3l%l1N*8N${RqFirf2dDF*ot@7H_C3TaMCT)mgfhO!56PJD2MyJ*OxC$H97#il zUKFQsQovQ;dq2EcZ)RZ5O-mwY9zaG1r9BF?J-XuTCb8FPkIuHLu}Gat7*8^*_Q1a5bn@%di|)6w&-K9Z4)sNWmX$8kM!e+1$#TLv z;TyU_m(zF}Vd6I=7U?kvel(Y$NIaA!PJ9sV19Xl?fXX4ds(o&2kItXiCDTKkLX^Df z^GQFtF1AChw(k^Xr}UuC*Zg*w5y!cOorppr^nveCc-sjG_g)JmOZ155Z|==_S#WN0 zSl(!8-J{c3(Q|X?US1bEs&N zRh5g=^3Er#!3%fp-U*JV3I6+b@b6CO|8s#55NbT7C~lly^jZoi18znjZB1Qxp@vn+ F{{V+|wX^^L literal 0 HcmV?d00001 diff --git a/server/sonar-docs/src/pages/setup/upgrading.md b/server/sonar-docs/src/pages/setup/upgrading.md index bf622b3e89c..6027fe9cd82 100644 --- a/server/sonar-docs/src/pages/setup/upgrading.md +++ b/server/sonar-docs/src/pages/setup/upgrading.md @@ -3,16 +3,31 @@ title: Upgrade the Server url: /setup/upgrading/ --- -Upgrading across multiple non-LTS versions is handled automatically. However, if there's an LTS version in your migration path, you must first migrate to this LTS and then to your target version. +## SonarQube Version Number Format +Before upgrading, it helps to understand how SonarQube version numbers work. Version numbers have up to three digits with each digit representing part of the release cycle: + +![SonarQube version number format](/images/version.png) + +**Major version number** +The major version number represents a series of releases with high-level objectives for the release cycle. It's incremented with the release following an LTS version (for example, the release following 7.9 LTS was 8.0). + +**Minor version number** +The minor version number corresponds to incremental functional changes within a major release cycle. At the time of an LTS release, the release cycle is closed and the minor version number is frozen. + +**Patch release number** +Only on LTS versions, the patch release number represents patches to an LTS that fixed blocker or critical problems. The patch release number isn't considered in your upgrade migration path, and your migration path is the same no matter which patch number you are on. + +## Migration Path +Upgrading across multiple non-LTS versions is handled automatically. However, if there's one or multiple LTS versions in your migration path, you must first migrate to each intermediate LTS and then to your target version, as shown in **Example 3** below. [[info]] -|If you're migrating from an earlier patch version of an LTS, you can upgrade directly to the next LTS as shown in Example 3 below. You don't need to install any intermediate patch versions. +|If you're migrating from an earlier patch version of an LTS, you can upgrade directly to the next LTS. You don't need to install any intermediate patch versions. **Migration Path Examples**: -**Example 1** – From 6.1 -> 8.1, the migration path is 6.1 -> the latest 6.7 LTS patch -> the latest 7.9 LTS patch -> 8.1 -**Example 2** – From 7.2 -> 7.9 LTS, the migration path is 7.2 -> the latest 7.9 LTS patch. -**Example 3** – From 6.7.1 LTS -> 7.9 LTS, the migration path is 6.7.1 -> the latest 7.9 LTS patch. +**Example 1** – From 6.1 > 8.1, the migration path is 6.1 > the latest 6.7 LTS patch > the latest 7.9 LTS patch > 8.1 +**Example 2** – From 7.2 > 7.9 LTS, the migration path is 7.2 > the latest 7.9 LTS patch. +**Example 3** – From 5.6.3 LTS > 7.9 LTS, the migration path is 5.6.3 LTS > 6.7.7 LTS > the latest 7.9 LTS patch. ## Upgrade Guide -- 2.39.5