Skip to Content
Last modified by Agnease on 2026/05/25 16:06
From version 8.2
edited by Agnease
on 2026/05/22 14:18
Change comment: There is no comment for this version
To version 8.3
edited by Agnease
on 2026/05/25 16:06
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,22 +1,18 @@
1 1  {{velocity}}
2 2  #set ($discard = $xwiki.ssx.use('PublicWebSite.WebHome'))
3 3  {{html clean="false"}}
4 -
5 5   ## PAGE HEADER
6 - <section class="hero hero-centered service-hero" aria-labelledby="hero-title">
5 + <section class="hero hero-centered" aria-labelledby="hero-title">
7 7   <div class="container hero-inner">
8 8   <div class="hero-kicker">
9 9   <i class="fa fa-life-ring" aria-hidden="true"></i>
10 10   XWiki maintenance and support
11 11   </div>
12 -
13 13   <h1 id="hero-title">Reliable XWiki support for production environments</h1>
14 -
15 15   <p class="lead">
16 16   Keep your XWiki instance stable, secure and maintainable with troubleshooting,
17 17   planned maintenance, upgrade planning and ongoing technical support.
18 18   </p>
19 -
20 20   <div class="hero-actions">
21 21   <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Request support</a>
22 22   <a class="btn btn-secondary" href="#support-process">See the support approach</a>
... ... @@ -23,299 +23,233 @@
23 23   </div>
24 24   </div>
25 25   </section>
26 -
27 27   ## WHY SUPPORT MATTERS
23 + #set ($supportReasonItems = [{
24 + 'title': 'Keep the platform healthy',
25 + 'icon': 'heartbeat',
26 + 'content': 'Regular maintenance helps identify issues before they become disruptive incidents.',
27 + 'items': [
28 + 'Version and extension checks',
29 + 'Log and error review',
30 + 'Configuration improvements'
31 + ]
32 + },{
33 + 'title': 'Reduce operational risk',
34 + 'icon': 'shield',
35 + 'content': 'Support is not only about fixing problems. It is also about making sure the instance can be recovered, upgraded and maintained safely.',
36 + 'items': [
37 + 'Backup and restore awareness',
38 + 'Upgrade readiness',
39 + 'Security-aware maintenance'
40 + ]
41 + },{
42 + 'title': 'Support business users',
43 + 'icon': 'users',
44 + 'content': 'When XWiki is used for documentation, workflows or internal operations, technical issues quickly become productivity issues.',
45 + 'items': [
46 + 'Authentication problems',
47 + 'Permission issues',
48 + 'Broken pages, macros or exports'
49 + ]
50 + }])
28 28   <section aria-labelledby="why-support-title">
29 29   <div class="container">
30 30   <h2 id="why-support-title">Why XWiki needs ongoing care</h2>
31 -
32 32   <p class="section-intro">
33 33   A production XWiki instance is not just a static documentation website. It may depend on extensions,
34 34   custom applications, authentication integrations, jobs, scripts, permissions, backups and infrastructure
35 35   components that need to keep working together.
36 36   </p>
37 -
38 38   <div class="pathways">
39 - <article class="pathway-card">
40 - <div class="pathway-icon">
41 - <i class="fa fa-heartbeat" aria-hidden="true"></i>
42 - </div>
43 - <h3>Keep the platform healthy</h3>
44 - <p>
45 - Regular maintenance helps identify issues before they become disruptive incidents.
46 - </p>
47 - <ul>
48 - <li>Version and extension checks</li>
49 - <li>Log and error review</li>
50 - <li>Configuration improvements</li>
51 - </ul>
52 - </article>
53 -
54 - <article class="pathway-card">
55 - <div class="pathway-icon">
56 - <i class="fa fa-shield" aria-hidden="true"></i>
57 - </div>
58 - <h3>Reduce operational risk</h3>
59 - <p>
60 - Support is not only about fixing problems. It is also about making sure the instance can be recovered,
61 - upgraded and maintained safely.
62 - </p>
63 - <ul>
64 - <li>Backup and restore awareness</li>
65 - <li>Upgrade readiness</li>
66 - <li>Security-aware maintenance</li>
67 - </ul>
68 - </article>
69 -
70 - <article class="pathway-card">
71 - <div class="pathway-icon">
72 - <i class="fa fa-users" aria-hidden="true"></i>
73 - </div>
74 - <h3>Support business users</h3>
75 - <p>
76 - When XWiki is used for documentation, workflows or internal operations, technical issues quickly become
77 - productivity issues.
78 - </p>
79 - <ul>
80 - <li>Authentication problems</li>
81 - <li>Permission issues</li>
82 - <li>Broken pages, macros or exports</li>
83 - </ul>
84 - </article>
60 + #foreach ($entry in $supportReasonItems)
61 + <article class="pathway-card">
62 + <div class="card-heading">
63 + <div class="pathway-icon">
64 + <i class="fa fa-$entry.icon" aria-hidden="true"></i>
65 + </div>
66 + <h3>$entry.title</h3>
67 + </div>
68 + <p>$entry.content</p>
69 + <ul>
70 + #foreach ($item in $entry.items)
71 + <li>$item</li>
72 + #end
73 + </ul>
74 + </article>
75 + #end
85 85   </div>
86 86   </div>
87 87   </section>
88 -
89 89   ## COMMON SUPPORT NEEDS
80 + #set ($supportNeedItems = [{
81 + 'title': 'Troubleshooting and diagnosis',
82 + 'icon': 'search',
83 + 'content': 'Investigation of errors, failed jobs, broken pages, extension issues, slow requests or unexpected behavior.'
84 + },{
85 + 'title': 'Maintenance planning',
86 + 'icon': 'refresh',
87 + 'content': 'Review of versions, extensions, configuration, upgrade readiness and recommended maintenance actions.'
88 + },{
89 + 'title': 'Performance review',
90 + 'icon': 'tachometer',
91 + 'content': 'Analysis of slow pages, Solr usage, database behavior, jobs, logs and configuration bottlenecks.'
92 + },{
93 + 'title': 'Authentication and access issues',
94 + 'icon': 'lock',
95 + 'content': 'Support for LDAP, Active Directory, SSO, OIDC, MFA, user synchronization and permission-related problems.'
96 + },{
97 + 'title': 'Backup and recovery awareness',
98 + 'icon': 'database',
99 + 'content': 'Review of backup assumptions, restore expectations and operational risks around data and attachments.'
100 + },{
101 + 'title': 'Custom code and extensions',
102 + 'icon': 'puzzle-piece',
103 + 'content': 'Support for custom applications, scripts, macros, UI extensions, dashboards and business-specific features.'
104 + }])
90 90   <section class="services" aria-labelledby="support-needs-title">
91 91   <div class="container">
92 92   <h2 id="support-needs-title">Common support needs</h2>
93 -
94 94   <p class="section-intro">
95 95   Support can cover urgent troubleshooting, recurring maintenance, upgrade preparation,
96 96   platform reviews and improvements that make XWiki easier to operate.
97 97   </p>
98 -
99 99   <div class="services-grid">
100 - <article class="service">
101 - <div class="service-icon" aria-hidden="true">
102 - <i class="fa fa-search"></i>
103 - </div>
104 - <div class="service-body">
105 - <h4>Troubleshooting and diagnosis</h4>
106 - <p>
107 - Investigation of errors, failed jobs, broken pages, extension issues, slow requests or unexpected behavior.
108 - </p>
109 - </div>
110 - </article>
111 -
112 - <article class="service">
113 - <div class="service-icon" aria-hidden="true">
114 - <i class="fa fa-refresh"></i>
115 - </div>
116 - <div class="service-body">
117 - <h4>Maintenance planning</h4>
118 - <p>
119 - Review of versions, extensions, configuration, upgrade readiness and recommended maintenance actions.
120 - </p>
121 - </div>
122 - </article>
123 -
124 - <article class="service">
125 - <div class="service-icon" aria-hidden="true">
126 - <i class="fa fa-tachometer"></i>
127 - </div>
128 - <div class="service-body">
129 - <h4>Performance review</h4>
130 - <p>
131 - Analysis of slow pages, Solr usage, database behavior, jobs, logs and configuration bottlenecks.
132 - </p>
133 - </div>
134 - </article>
135 -
136 - <article class="service">
137 - <div class="service-icon" aria-hidden="true">
138 - <i class="fa fa-lock"></i>
139 - </div>
140 - <div class="service-body">
141 - <h4>Authentication and access issues</h4>
142 - <p>
143 - Support for LDAP, Active Directory, SSO, OIDC, MFA, user synchronization and permission-related problems.
144 - </p>
145 - </div>
146 - </article>
147 -
148 - <article class="service">
149 - <div class="service-icon" aria-hidden="true">
150 - <i class="fa fa-database"></i>
151 - </div>
152 - <div class="service-body">
153 - <h4>Backup and recovery awareness</h4>
154 - <p>
155 - Review of backup assumptions, restore expectations and operational risks around data and attachments.
156 - </p>
157 - </div>
158 - </article>
159 -
160 - <article class="service">
161 - <div class="service-icon" aria-hidden="true">
162 - <i class="fa fa-puzzle-piece"></i>
163 - </div>
164 - <div class="service-body">
165 - <h4>Custom code and extensions</h4>
166 - <p>
167 - Support for custom applications, scripts, macros, UI extensions, dashboards and business-specific features.
168 - </p>
169 - </div>
170 - </article>
113 + #foreach ($entry in $supportNeedItems)
114 + <article class="service">
115 + <div class="service-icon" aria-hidden="true">
116 + <i class="fa fa-$entry.icon"></i>
117 + </div>
118 + <div class="service-body">
119 + <h4>$entry.title</h4>
120 + <p>$entry.content</p>
121 + </div>
122 + </article>
123 + #end
171 171   </div>
172 172   </div>
173 173   </section>
174 -
175 175   ## SUPPORT APPROACH
128 + #set ($supportProcessItems = [{
129 + 'title': 'Understand the issue',
130 + 'content': 'Review symptoms, logs, recent changes, affected users, business impact and the current XWiki environment.'
131 + },{
132 + 'title': 'Identify the likely cause',
133 + 'content': 'Analyze configuration, extensions, custom code, authentication, jobs, performance indicators or infrastructure.'
134 + },{
135 + 'title': 'Apply a controlled fix',
136 + 'content': 'Implement the agreed correction with care for production stability and expected side effects.'
137 + },{
138 + 'title': 'Validate the result',
139 + 'content': 'Confirm that the affected feature works again and that no related functionality was broken.'
140 + },{
141 + 'title': 'Recommend next steps',
142 + 'content': 'Provide maintenance notes, upgrade recommendations, risk areas or follow-up improvements when relevant.'
143 + }])
176 176   <section id="support-process" class="split-section" aria-labelledby="process-title">
177 177   <div class="container">
178 178   <div class="split-grid">
179 179   <div class="split-copy">
180 180   <h2 id="process-title">A practical support approach</h2>
181 -
182 182   <p>
183 183   The objective is to understand the real state of the XWiki instance, not only the visible symptom.
184 184   Many issues involve a combination of version history, extensions, configuration, authentication,
185 185   custom code and infrastructure.
186 186   </p>
187 -
188 188   <p>
189 189   Support work is handled with a maintenance mindset: fix the immediate problem, identify the underlying
190 190   cause where possible and leave the platform easier to operate in the future.
191 191   </p>
192 192   </div>
193 -
194 194   <ol class="process-list">
195 - <li>
196 - <strong>Understand the issue</strong>
197 - Review symptoms, logs, recent changes, affected users, business impact and the current XWiki environment.
198 - </li>
199 - <li>
200 - <strong>Identify the likely cause</strong>
201 - Analyze configuration, extensions, custom code, authentication, jobs, performance indicators or infrastructure.
202 - </li>
203 - <li>
204 - <strong>Apply a controlled fix</strong>
205 - Implement the agreed correction with care for production stability and expected side effects.
206 - </li>
207 - <li>
208 - <strong>Validate the result</strong>
209 - Confirm that the affected feature works again and that no related functionality was broken.
210 - </li>
211 - <li>
212 - <strong>Recommend next steps</strong>
213 - Provide maintenance notes, upgrade recommendations, risk areas or follow-up improvements when relevant.
214 - </li>
160 + #foreach ($entry in $supportProcessItems)
161 + <li>
162 + <strong>$entry.title</strong>
163 + $entry.content
164 + </li>
165 + #end
215 215   </ol>
216 216   </div>
217 217   </div>
218 218   </section>
219 -
220 220   ## TYPES OF SUPPORT
171 + #set ($supportTypeItems = [{
172 + 'title': 'One-time troubleshooting',
173 + 'icon': 'wrench',
174 + 'content': 'Focused support for a specific issue, such as a broken feature, failed upgrade, authentication problem or unexpected error.'
175 + },{
176 + 'title': 'Planned maintenance',
177 + 'icon': 'calendar-check-o',
178 + 'content': 'Periodic reviews, upgrade planning, extension checks and technical recommendations for production stability.'
179 + },{
180 + 'title': 'Security-aware support',
181 + 'icon': 'shield',
182 + 'content': 'Version awareness, upgrade recommendations and review of areas that commonly affect platform security.'
183 + },{
184 + 'title': 'Custom feature maintenance',
185 + 'icon': 'code',
186 + 'content': 'Support for custom XWiki applications, scripts, macros, workflows, PDF exports and integrations.'
187 + }])
221 221   <section aria-labelledby="support-types-title">
222 222   <div class="container">
223 223   <h2 id="support-types-title">Support can be occasional or ongoing</h2>
224 -
225 225   <p class="section-intro">
226 226   Some organizations need help with a specific incident. Others need a long-term technical partner who can
227 227   keep the instance current, stable and ready for future changes.
228 228   </p>
229 -
230 230   <div class="widgets">
231 - <article class="widget">
232 - <div class="icon" aria-hidden="true">
233 - <i class="fa fa-wrench"></i>
234 - <h4>One-time troubleshooting</h4>
235 - </div>
236 - <p>
237 - Focused support for a specific issue, such as a broken feature, failed upgrade, authentication problem
238 - or unexpected error.
239 - </p>
240 - </article>
241 -
242 - <article class="widget">
243 - <div class="icon" aria-hidden="true">
244 - <i class="fa fa-calendar-check-o"></i>
245 - <h4>Planned maintenance</h4>
246 - </div>
247 - <p>
248 - Periodic reviews, upgrade planning, extension checks and technical recommendations for production stability.
249 - </p>
250 - </article>
251 -
252 - <article class="widget">
253 - <div class="icon" aria-hidden="true">
254 - <i class="fa fa-shield"></i>
255 - <h4>Security-aware support</h4>
256 - </div>
257 - <p>
258 - Version awareness, upgrade recommendations and review of areas that commonly affect platform security.
259 - </p>
260 - </article>
261 -
262 - <article class="widget">
263 - <div class="icon" aria-hidden="true">
264 - <i class="fa fa-code"></i>
265 - <h4>Custom feature maintenance</h4>
266 - </div>
267 - <p>
268 - Support for custom XWiki applications, scripts, macros, workflows, PDF exports and integrations.
269 - </p>
270 - </article>
196 + #foreach ($entry in $supportTypeItems)
197 + <article class="widget">
198 + <div class="icon" aria-hidden="true">
199 + <i class="fa fa-$entry.icon"></i>
200 + <h4>$entry.title</h4>
201 + </div>
202 + <p>$entry.content</p>
203 + </article>
204 + #end
271 271   </div>
272 272   </div>
273 273   </section>
274 -
275 275   ## RELATED SERVICES
209 + #set ($relatedSupportServiceItems = [{
210 + 'title': 'XWiki Upgrade Services',
211 + 'url': 'services.xwiki-upgrades',
212 + 'content': 'Safe LTS upgrades for production instances with staging validation, compatibility checks and rollback planning.',
213 + 'linkLabel': 'View upgrade services'
214 + },{
215 + 'title': 'XWiki Development & Integrations',
216 + 'url': 'services.xwiki-development-integrations',
217 + 'content': 'Custom applications, workflows, dashboards, automation and integrations built around your business processes.',
218 + 'linkLabel': 'View development services'
219 + }])
276 276   <section class="resource-strip" aria-labelledby="related-title">
277 277   <div class="container">
278 278   <h2 id="related-title">Related XWiki services</h2>
279 -
280 280   <p class="section-intro">
281 281   Maintenance often connects naturally with upgrades, development and security review.
282 282   </p>
283 -
284 284   <div class="resource-grid">
285 - <article class="resource-card">
286 - <h4>XWiki Upgrade Services</h4>
287 - <p>
288 - Safe LTS upgrades for production instances with staging validation, compatibility checks and rollback planning.
289 - </p>
290 - <a href="$xwiki.getURL('services.xwiki-upgrades')">View upgrade services</a>
291 - </article>
292 -
293 - <article class="resource-card">
294 - <h4>XWiki Development &amp; Integrations</h4>
295 - <p>
296 - Custom applications, workflows, dashboards, automation and integrations built around your business processes.
297 - </p>
298 - <a href="$xwiki.getURL('services.xwiki-development-integrations')">View development services</a>
299 - </article>
227 + #foreach ($entry in $relatedSupportServiceItems)
228 + <article class="resource-card">
229 + <h4>$entry.title</h4>
230 + <p>$entry.content</p>
231 + <a href="$xwiki.getURL($entry.url)">$entry.linkLabel</a>
232 + </article>
233 + #end
300 300   </div>
301 301   </div>
302 302   </section>
303 -
304 304   ## CTA
305 305   <section class="cta-section" aria-labelledby="cta-title">
306 306   <div class="container">
307 307   <div class="cta-panel">
308 308   <h2 id="cta-title">Need reliable XWiki support?</h2>
309 -
310 310   <p>
311 311   Send a short description of your XWiki setup, current version, recent changes and the issue you are facing.
312 312   A few details are enough to start the conversation.
313 313   </p>
314 -
315 315   <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Request support</a>
316 316   </div>
317 317   </div>
318 318   </section>
319 -
320 320  {{/html}}
321 321  {{/velocity}}