Changes for page Why You Should Upgrade XWiki Regularly for Security and Stability
Last modified by Agnease on 2026/05/26 10:58
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Objects (0 modified, 0 added, 1 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,0 @@ 1 -Why You Should Upgrade XWiki Regularly for Security and Stability - Content
-
... ... @@ -32,7 +32,6 @@ 32 32 <li><a href="#safe-process">Safe process</a></li> 33 33 <li><a href="#common-mistakes">Common mistakes</a></li> 34 34 <li><a href="#upgrade-rhythm">Upgrade rhythm</a></li> 35 - <li><a href="#upgrade-faq">FAQ</a></li> 36 36 </ul> 37 37 </aside> 38 38 ... ... @@ -52,22 +52,6 @@ 52 52 53 53 <div class="resource-note"> 54 54 <p> 55 - <strong>In practice:</strong> an XWiki upgrade should review the current version, target version, 56 - required intermediate steps, installed extensions, custom code, authentication setup, infrastructure, 57 - backups, rollback expectations and the business-critical features that must be validated before 58 - production is touched. 59 - </p> 60 - </div> 61 - 62 - <p> 63 - An XWiki upgrade is the process of moving an existing instance to a newer XWiki version while preserving 64 - content, configuration, extensions, customizations, access rights and business-critical behavior. A safe 65 - upgrade is not only a software installation task. It is a controlled maintenance process with preparation, 66 - staging validation, production rollout and follow-up notes. 67 - </p> 68 - 69 - <div class="resource-note"> 70 - <p> 71 71 <strong>The main point:</strong> regular upgrades are not only about new features. They reduce security 72 72 exposure, compatibility risk and long-term maintenance cost. 73 73 </p> ... ... @@ -87,11 +87,6 @@ 87 87 public or private. But staying close to supported versions makes security maintenance more manageable. 88 88 </p> 89 89 90 - <p> 91 - For a broader view of security-related checks, see 92 - <a href="$xwiki.getURL('resources.xwiki-security-review')">what an XWiki security review should actually include</a>. 93 - </p> 94 - 95 95 <h3>2. Large upgrade gaps are harder to control</h3> 96 96 <p> 97 97 A small, regular upgrade is usually easier to validate than a large jump after several years. Large gaps ... ... @@ -106,11 +106,6 @@ 106 106 planning an upgrade. 107 107 </p> 108 108 109 - <p> 110 - For more details on organizing custom work, see 111 - <a href="$xwiki.getURL('resources.xwiki-custom-development')">how to keep XWiki custom development maintainable across upgrades</a>. 112 - </p> 113 - 114 114 <h3>4. Infrastructure requirements evolve</h3> 115 115 <p> 116 116 XWiki upgrades can involve more than the application itself. Java, Tomcat, the database, Docker images, ... ... @@ -124,13 +124,8 @@ 124 124 should be part of the validation plan. 125 125 </p> 126 126 127 - <h2 id="upgrade-checklist"> XWikiupgrade planningchecklist</h2>100 + <h2 id="upgrade-checklist">Practical checklist before planning an upgrade</h2> 128 128 129 - <p> 130 - A practical XWiki upgrade plan should cover both the application and the environment around it. 131 - The following checklist can be used as a starting point before upgrading a production instance. 132 - </p> 133 - 134 134 <ul class="resource-checklist"> 135 135 <li>Identify the current XWiki version and the target version.</li> 136 136 <li>Check whether intermediate upgrade steps are needed.</li> ... ... @@ -182,51 +182,6 @@ 182 182 review, staging validation, production rollout, documentation and follow-up. 183 183 </p> 184 184 185 - <h2 id="upgrade-faq">XWiki upgrade FAQ</h2> 186 - 187 - <h3>Why should XWiki be upgraded regularly?</h3> 188 - <p> 189 - XWiki should be upgraded regularly to reduce security exposure, keep extensions compatible, avoid large 190 - upgrade gaps and make long-term maintenance easier. Regular upgrades are easier to plan and validate than 191 - major jumps after several years. 192 - </p> 193 - 194 - <h3>Is a working XWiki instance safe to leave unchanged?</h3> 195 - <p> 196 - Not necessarily. An XWiki instance can continue to work from a user perspective while becoming outdated, 197 - harder to upgrade and exposed to avoidable risks. Visible functionality is not the same as long-term 198 - maintainability. 199 - </p> 200 - 201 - <h3>What should be checked before upgrading XWiki?</h3> 202 - <p> 203 - Before upgrading XWiki, review the current version, target version, intermediate upgrade steps, installed 204 - extensions, custom code, authentication setup, infrastructure, backups, rollback expectations and 205 - business-critical features. 206 - </p> 207 - 208 - <h3>Should an XWiki upgrade be tested outside production?</h3> 209 - <p> 210 - Yes. The safest approach is to rehearse the upgrade on a staging environment or temporary clone, fix 211 - compatibility issues there, then perform the production upgrade with a clear plan and rollback expectations. 212 - </p> 213 - 214 - <h3>What makes an XWiki upgrade difficult?</h3> 215 - <p> 216 - XWiki upgrades become more difficult when the version gap is large, extensions are outdated, custom code is 217 - undocumented, authentication is complex, infrastructure dependencies changed or critical workflows were not 218 - included in the validation plan. 219 - </p> 220 - 221 - <div class="resource-note"> 222 - <p> 223 - Related resources: 224 - <a href="$xwiki.getURL('resources.xwiki-security-review')">what an XWiki security review should actually include</a> 225 - and 226 - <a href="$xwiki.getURL('resources.xwiki-custom-development')">how to keep XWiki custom development maintainable across upgrades</a>. 227 - </p> 228 - </div> 229 - 230 230 <div class="resource-cta"> 231 231 <h3>Need help planning an XWiki upgrade?</h3> 232 232 <p> ... ... @@ -240,55 +240,5 @@ 240 240 </div> 241 241 </div> 242 242 </section> 243 - 244 - <script type="application/ld+json"> 245 - { 246 - "@context": "https://schema.org", 247 - "@type": "FAQPage", 248 - "mainEntity": [ 249 - { 250 - "@type": "Question", 251 - "name": "Why should XWiki be upgraded regularly?", 252 - "acceptedAnswer": { 253 - "@type": "Answer", 254 - "text": "XWiki should be upgraded regularly to reduce security exposure, keep extensions compatible, avoid large upgrade gaps and make long-term maintenance easier. Regular upgrades are easier to plan and validate than major jumps after several years." 255 - } 256 - }, 257 - { 258 - "@type": "Question", 259 - "name": "Is a working XWiki instance safe to leave unchanged?", 260 - "acceptedAnswer": { 261 - "@type": "Answer", 262 - "text": "Not necessarily. An XWiki instance can continue to work from a user perspective while becoming outdated, harder to upgrade and exposed to avoidable risks. Visible functionality is not the same as long-term maintainability." 263 - } 264 - }, 265 - { 266 - "@type": "Question", 267 - "name": "What should be checked before upgrading XWiki?", 268 - "acceptedAnswer": { 269 - "@type": "Answer", 270 - "text": "Before upgrading XWiki, review the current version, target version, intermediate upgrade steps, installed extensions, custom code, authentication setup, infrastructure, backups, rollback expectations and business-critical features." 271 - } 272 - }, 273 - { 274 - "@type": "Question", 275 - "name": "Should an XWiki upgrade be tested outside production?", 276 - "acceptedAnswer": { 277 - "@type": "Answer", 278 - "text": "Yes. The safest approach is to rehearse the upgrade on a staging environment or temporary clone, fix compatibility issues there, then perform the production upgrade with a clear plan and rollback expectations." 279 - } 280 - }, 281 - { 282 - "@type": "Question", 283 - "name": "What makes an XWiki upgrade difficult?", 284 - "acceptedAnswer": { 285 - "@type": "Answer", 286 - "text": "XWiki upgrades become more difficult when the version gap is large, extensions are outdated, custom code is undocumented, authentication is complex, infrastructure dependencies changed or critical workflows were not included in the validation plan." 287 - } 288 - } 289 - ] 290 - } 291 - </script> 292 - 293 293 {{/html}} 294 294 {{/velocity}}
- Agnease.Code.SEODetailsClass[0]
-
- metaDescription
-
... ... @@ -1,1 +1,0 @@ 1 -Learn why regular XWiki upgrades matter for security, stability, extension compatibility and long-term maintenance, especially for production XWiki instances. - metaTitle
-
... ... @@ -1,1 +1,0 @@ 1 -Why You Should Upgrade XWiki Regularly for Security and Stability | Agnease