Skip to Content

Wiki source code of XWiki Support and Maintenance

Version 8.2 by Agnease on 2026/05/22 14:18
Hide last authors
Agnease 1.1 1 {{velocity}}
2 #set ($discard = $xwiki.ssx.use('PublicWebSite.WebHome'))
3 {{html clean="false"}}
4
5 ## PAGE HEADER
6 <section class="hero hero-centered service-hero" aria-labelledby="hero-title">
7 <div class="container hero-inner">
8 <div class="hero-kicker">
9 <i class="fa fa-life-ring" aria-hidden="true"></i>
10 XWiki maintenance and support
11 </div>
12
13 <h1 id="hero-title">Reliable XWiki support for production environments</h1>
14
15 <p class="lead">
Agnease 8.2 16 Keep your XWiki instance stable, secure and maintainable with troubleshooting,
17 planned maintenance, upgrade planning and ongoing technical support.
Agnease 1.1 18 </p>
19
20 <div class="hero-actions">
21 <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Request support</a>
22 <a class="btn btn-secondary" href="#support-process">See the support approach</a>
23 </div>
24 </div>
25 </section>
26
27 ## WHY SUPPORT MATTERS
28 <section aria-labelledby="why-support-title">
29 <div class="container">
30 <h2 id="why-support-title">Why XWiki needs ongoing care</h2>
31
32 <p class="section-intro">
33 A production XWiki instance is not just a static documentation website. It may depend on extensions,
34 custom applications, authentication integrations, jobs, scripts, permissions, backups and infrastructure
35 components that need to keep working together.
36 </p>
37
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>
85 </div>
86 </div>
87 </section>
88
89 ## COMMON SUPPORT NEEDS
90 <section class="services" aria-labelledby="support-needs-title">
91 <div class="container">
92 <h2 id="support-needs-title">Common support needs</h2>
93
94 <p class="section-intro">
95 Support can cover urgent troubleshooting, recurring maintenance, upgrade preparation,
96 platform reviews and improvements that make XWiki easier to operate.
97 </p>
98
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>
171 </div>
172 </div>
173 </section>
174
175 ## SUPPORT APPROACH
176 <section id="support-process" class="split-section" aria-labelledby="process-title">
177 <div class="container">
178 <div class="split-grid">
179 <div class="split-copy">
180 <h2 id="process-title">A practical support approach</h2>
181
182 <p>
183 The objective is to understand the real state of the XWiki instance, not only the visible symptom.
184 Many issues involve a combination of version history, extensions, configuration, authentication,
185 custom code and infrastructure.
186 </p>
187
188 <p>
189 Support work is handled with a maintenance mindset: fix the immediate problem, identify the underlying
190 cause where possible and leave the platform easier to operate in the future.
191 </p>
192 </div>
193
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>
215 </ol>
216 </div>
217 </div>
218 </section>
219
220 ## TYPES OF SUPPORT
221 <section aria-labelledby="support-types-title">
222 <div class="container">
223 <h2 id="support-types-title">Support can be occasional or ongoing</h2>
224
225 <p class="section-intro">
226 Some organizations need help with a specific incident. Others need a long-term technical partner who can
227 keep the instance current, stable and ready for future changes.
228 </p>
229
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>
271 </div>
272 </div>
273 </section>
274
275 ## RELATED SERVICES
276 <section class="resource-strip" aria-labelledby="related-title">
277 <div class="container">
278 <h2 id="related-title">Related XWiki services</h2>
279
280 <p class="section-intro">
281 Maintenance often connects naturally with upgrades, development and security review.
282 </p>
283
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>
300 </div>
301 </div>
302 </section>
303
304 ## CTA
305 <section class="cta-section" aria-labelledby="cta-title">
306 <div class="container">
307 <div class="cta-panel">
308 <h2 id="cta-title">Need reliable XWiki support?</h2>
309
310 <p>
311 Send a short description of your XWiki setup, current version, recent changes and the issue you are facing.
312 A few details are enough to start the conversation.
313 </p>
314
315 <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Request support</a>
316 </div>
317 </div>
318 </section>
319
320 {{/html}}
321 {{/velocity}}