Skip to Content

Changes for page XWiki Upgrade Services

Last modified by Agnease on 2026/05/25 16:11
From version 9.4
edited by Agnease
on 2026/05/22 14:10
Change comment: There is no comment for this version
To version 2.1
edited by Agnease
on 2026/05/01 12:25
Change comment: Rollback to version 1.4

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -XWiki Upgrade Services
1 +xwiki-upgrades
Content
... ... @@ -2,288 +2,111 @@
2 2  #set ($discard = $xwiki.ssx.use('PublicWebSite.WebHome'))
3 3  {{html clean="false"}}
4 4  
5 - ## PAGE HEADER
5 + ## COMPACT HERO
6 6   <section class="hero hero-centered service-hero" aria-labelledby="hero-title">
7 7   <div class="container hero-inner">
8 - <div class="hero-kicker">
9 - <i class="fa fa-refresh" aria-hidden="true"></i>
10 - XWiki upgrade services
11 - </div>
12 -
13 - <h1 id="hero-title">Safe XWiki LTS upgrades for production environments</h1>
14 -
8 + <h1 id="hero-title">XWiki Upgrades</h1>
15 15   <p class="lead">
16 - Upgrade XWiki safely with a clear plan, compatibility checks and reduced production risk,
17 - even for instances with custom extensions, integrations and workflows.
10 + Safe, planned upgrades for production XWiki instances.
18 18   </p>
19 -
20 - <div class="hero-actions">
21 - <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Request an upgrade review</a>
22 - <a class="btn btn-secondary" href="#upgrade-process">See the upgrade approach</a>
12 + <ul class="benefits">
13 + <li>Latest LTS</li>
14 + <li>Security fixes</li>
15 + <li>Extension checks</li>
16 + <li>Minimal downtime</li>
17 + </ul>
18 + <div class="hero-cta">
19 + <a href="mailto:alex@agnease.com?subject=XWiki%20Upgrade%20Assessment">Request an upgrade assessment</a>
23 23   </div>
24 24   </div>
25 25   </section>
26 26  
27 - ## WHY UPGRADES MATTER
28 - <section aria-labelledby="why-upgrade-title">
29 - <div class="container">
30 - <h2 id="why-upgrade-title">Why regular XWiki upgrades matter</h2>
24 + ## VALUE CARDS
25 + #set ($upgradeCards = [{
26 + 'title': 'Stay secure',
27 + 'icon': 'shield',
28 + 'content': 'Reduce exposure to known vulnerabilities fixed in newer XWiki versions.'
29 + },{
30 + 'title': 'Upgrade safely',
31 + 'icon': 'refresh',
32 + 'content': 'Plan the upgrade with backups, validation, rollback options, and minimal downtime.'
33 + },{
34 + 'title': 'Avoid compatibility surprises',
35 + 'icon': 'puzzle-piece',
36 + 'content': 'Review extensions, custom code, authentication, PDF export, and infrastructure before production.'
37 + }])
31 31  
32 - <p class="section-intro">
33 - An outdated XWiki instance can become harder to maintain over time. Security fixes, browser compatibility,
34 - extension updates, platform changes and infrastructure requirements continue to evolve, while older versions
35 - become more difficult and risky to upgrade.
36 - </p>
37 -
38 - <div class="pathways">
39 - <article class="pathway-card">
40 - <div class="pathway-icon">
41 - <i class="fa fa-shield" aria-hidden="true"></i>
42 - </div>
43 - <h3>Reduce security exposure</h3>
44 - <p>
45 - Staying close to supported XWiki versions helps reduce exposure to known vulnerabilities and missing fixes.
46 - </p>
47 - <ul>
48 - <li>Review current version exposure</li>
49 - <li>Plan upgrade to a supported version</li>
50 - <li>Validate security-sensitive features</li>
51 - </ul>
52 - </article>
53 -
54 - <article class="pathway-card">
55 - <div class="pathway-icon">
56 - <i class="fa fa-cogs" aria-hidden="true"></i>
57 - </div>
58 - <h3>Preserve compatibility</h3>
59 - <p>
60 - Extensions, custom applications, authentication systems and infrastructure components need to remain compatible.
61 - </p>
62 - <ul>
63 - <li>Check installed extensions</li>
64 - <li>Review custom code and scripts</li>
65 - <li>Validate integrations after upgrade</li>
66 - </ul>
67 - </article>
68 -
69 - <article class="pathway-card">
70 - <div class="pathway-icon">
71 - <i class="fa fa-line-chart" aria-hidden="true"></i>
72 - </div>
73 - <h3>Improve maintainability</h3>
74 - <p>
75 - Smaller, regular upgrades are usually easier to control than large jumps after years of accumulated changes.
76 - </p>
77 - <ul>
78 - <li>Avoid long upgrade gaps</li>
79 - <li>Document the current platform state</li>
80 - <li>Prepare future upgrade cycles</li>
81 - </ul>
82 - </article>
39 + <section class="compact-section" aria-labelledby="why-title">
40 + <div class="container">
41 + <h2 id="why-title">Keep your XWiki platform current and reliable</h2>
42 + <div class="widgets compact-widgets">
43 + #foreach ($entry in $upgradeCards)
44 + <article class="widget">
45 + <div class="icon" aria-hidden="true">
46 + <i class="fa fa-$entry.icon"></i>
47 + <h4>$entry.title</h4>
48 + </div>
49 + <p>$entry.content</p>
50 + </article>
51 + #end
83 83   </div>
84 84   </div>
85 85   </section>
86 86  
87 - ## COMMON SITUATIONS
88 - <section class="services" aria-labelledby="situations-title">
56 + ## TWO COLUMN SUMMARY
57 + <section class="services compact-section" aria-labelledby="summary-title">
89 89   <div class="container">
90 - <h2 id="situations-title">Common situations we handle</h2>
59 + <h2 id="summary-title">Upgrade support for real XWiki environments</h2>
91 91  
92 - <p class="section-intro">
93 - XWiki upgrades are often simple in clean environments, but production instances usually include additional
94 - constraints that need to be understood before touching the live system.
95 - </p>
96 -
97 - <div class="services-grid">
61 + <div class="services-grid compact-grid">
98 98   <article class="service">
99 - <div class="service-icon" aria-hidden="true">
100 - <i class="fa fa-clock-o"></i>
63 + <div class="service-icon">
64 + <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
101 101   </div>
102 102   <div class="service-body">
103 - <h4>Old XWiki versions</h4>
104 - <p>
105 - Instances that have not been upgraded for several months or years and require a careful upgrade path.
106 - </p>
67 + <h4>When to consider an upgrade</h4>
68 + <ul>
69 + <li>Your instance is not on the latest suitable LTS version</li>
70 + <li>Your current version is more than one year old</li>
71 + <li>You use custom extensions, scripts, or workflows</li>
72 + <li>You rely on LDAP, SSO, OIDC, SAML, or MFA</li>
73 + <li>You want to reduce security and maintenance risk</li>
74 + </ul>
107 107   </div>
108 108   </article>
109 109  
110 110   <article class="service">
111 - <div class="service-icon" aria-hidden="true">
112 - <i class="fa fa-puzzle-piece"></i>
79 + <div class="service-icon">
80 + <i class="fa fa-check-square-o" aria-hidden="true"></i>
113 113   </div>
114 114   <div class="service-body">
115 - <h4>Custom extensions and scripts</h4>
116 - <p>
117 - Wikis with custom applications, Velocity scripts, macros, UI extensions, rights logic or business workflows.
118 - </p>
83 + <h4>What Agnease handles</h4>
84 + <ul>
85 + <li>Current version and environment review</li>
86 + <li>Recommended target version</li>
87 + <li>Extension and customization checks</li>
88 + <li>Backup, staging, and rollback planning</li>
89 + <li>Production upgrade and post-upgrade validation</li>
90 + </ul>
119 119   </div>
120 120   </article>
121 -
122 - <article class="service">
123 - <div class="service-icon" aria-hidden="true">
124 - <i class="fa fa-lock"></i>
125 - </div>
126 - <div class="service-body">
127 - <h4>Authentication integrations</h4>
128 - <p>
129 - LDAP, Active Directory, SSO, OIDC, SAML, MFA or custom login setups that must keep working after upgrade.
130 - </p>
131 - </div>
132 - </article>
133 -
134 - <article class="service">
135 - <div class="service-icon" aria-hidden="true">
136 - <i class="fa fa-server"></i>
137 - </div>
138 - <div class="service-body">
139 - <h4>Infrastructure changes</h4>
140 - <p>
141 - Java, Tomcat, database, Docker, filesystem, reverse proxy or hosting changes required by newer versions.
142 - </p>
143 - </div>
144 - </article>
145 -
146 - <article class="service">
147 - <div class="service-icon" aria-hidden="true">
148 - <i class="fa fa-file-pdf-o"></i>
149 - </div>
150 - <div class="service-body">
151 - <h4>Business-critical features</h4>
152 - <p>
153 - PDF exports, dashboards, structured data, templates, permissions, notifications and workflows that need validation.
154 - </p>
155 - </div>
156 - </article>
157 -
158 - <article class="service">
159 - <div class="service-icon" aria-hidden="true">
160 - <i class="fa fa-warning"></i>
161 - </div>
162 - <div class="service-body">
163 - <h4>Low-downtime rollout</h4>
164 - <p>
165 - Upgrade planning with backups, testing, rollback options and a controlled production deployment window.
166 - </p>
167 - </div>
168 - </article>
169 169   </div>
170 170   </div>
171 171   </section>
172 172  
173 - ## PROCESS
174 - <section id="upgrade-process" class="split-section" aria-labelledby="process-title">
97 + ## FINAL CTA
98 + <section class="cta-section compact-cta" aria-labelledby="assessment-title">
175 175   <div class="container">
176 - <div class="split-grid">
177 - <div class="split-copy">
178 - <h2 id="process-title">A practical upgrade approach</h2>
179 -
180 - <p>
181 - The goal is not only to install a newer version. The goal is to move your XWiki instance forward
182 - while protecting the data, configuration, customizations and business processes that already depend on it.
183 - </p>
184 -
185 - <p>
186 - The upgrade is always prepared outside production first, using a staging environment or a temporary clone
187 - of the live instance. This allows compatibility issues, extension problems, authentication changes and
188 - custom features to be validated before the controlled production rollout.
189 - </p>
190 - </div>
191 -
192 - <ol class="process-list">
193 - <li>
194 - <strong>Review the current instance</strong>
195 - Version, extensions, database, filesystem, authentication, custom code, logs and infrastructure constraints.
196 - </li>
197 - <li>
198 - <strong>Define the upgrade path</strong>
199 - Target version, intermediate steps if needed, compatibility risks, expected downtime and rollback options.
200 - </li>
201 - <li>
202 - <strong>Prepare and validate</strong>
203 - Backups, test upgrade when needed, extension checks and validation of critical XWiki features.
204 - </li>
205 - <li>
206 - <strong>Upgrade production</strong>
207 - Controlled execution, post-upgrade checks, issue resolution and confirmation that key features still work.
208 - </li>
209 - <li>
210 - <strong>Document next steps</strong>
211 - Upgrade notes, observed risks, remaining recommendations and future maintenance guidance.
212 - </li>
213 - </ol>
214 - </div>
215 - </div>
216 - </section>
217 -
218 - ## DELIVERABLES
219 - <section aria-labelledby="deliverables-title">
220 - <div class="container">
221 - <h2 id="deliverables-title">What you can expect</h2>
222 -
223 - <p class="section-intro">
224 - The exact scope depends on your XWiki version, hosting setup and customizations, but an upgrade engagement
225 - usually includes a clear technical review, a controlled upgrade plan and post-upgrade validation.
100 + <h2 id="assessment-title">Request an XWiki upgrade assessment</h2>
101 + <p class="lead">
102 + Send your current XWiki version and a short description of your setup.
103 + Agnease will recommend the target version, estimated effort, and key risks to review.
226 226   </p>
227 -
228 - <div class="widgets">
229 - <article class="widget">
230 - <div class="icon" aria-hidden="true">
231 - <i class="fa fa-search"></i>
232 - <h4>Upgrade review</h4>
233 - </div>
234 - <p>
235 - Review of the current version, installed extensions, customizations, authentication and hosting constraints.
236 - </p>
237 - </article>
238 -
239 - <article class="widget">
240 - <div class="icon" aria-hidden="true">
241 - <i class="fa fa-map"></i>
242 - <h4>Upgrade plan</h4>
243 - </div>
244 - <p>
245 - Recommended target version, risk areas, validation checklist, downtime expectations and rollback approach.
246 - </p>
247 - </article>
248 -
249 - <article class="widget">
250 - <div class="icon" aria-hidden="true">
251 - <i class="fa fa-check-circle"></i>
252 - <h4>Post-upgrade validation</h4>
253 - </div>
254 - <p>
255 - Verification of key pages, rights, authentication, extensions, jobs, PDFs, dashboards and custom applications.
256 - </p>
257 - </article>
258 -
259 - <article class="widget">
260 - <div class="icon" aria-hidden="true">
261 - <i class="fa fa-file-text-o"></i>
262 - <h4>Upgrade notes</h4>
263 - </div>
264 - <p>
265 - Practical documentation of the performed work, important decisions and recommended follow-up actions.
266 - </p>
267 - </article>
268 - </div>
105 + <p class="text-center contact-inline">
106 + <a href="mailto:alex@agnease.com?subject=XWiki%20Upgrade%20Assessment">Request an upgrade assessment</a>
107 + </p>
269 269   </div>
270 270   </section>
271 271  
272 - ## CTA
273 - <section class="cta-section" aria-labelledby="cta-title">
274 - <div class="container">
275 - <div class="cta-panel">
276 - <h2 id="cta-title">Planning an XWiki upgrade?</h2>
277 -
278 - <p>
279 - Send your current XWiki version, target version if known, hosting setup and any custom extensions or integrations
280 - that may affect the upgrade. A short description is enough to start with.
281 - </p>
282 -
283 - <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Request an upgrade review</a>
284 - </div>
285 - </div>
286 - </section>
287 -
288 288  {{/html}}
289 289  {{/velocity}}
Agnease.Code.SEODetailsClass[0]
metaDescription
... ... @@ -1,1 +1,0 @@
1 -Safe XWiki upgrade services for production instances, including LTS upgrade planning, extension compatibility, backups, rollback strategy and validation.
metaTitle
... ... @@ -1,1 +1,0 @@
1 -Safe XWiki Upgrade Services for Production Instances | Agnease