Skip to Content

Wiki source code of xwiki-maintenance-support

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