Skip to Content

Wiki source code of XWiki Support and Maintenance

Last modified by Agnease on 2026/05/25 16:06
Show last authors
1 {{velocity}}
2 #set ($discard = $xwiki.ssx.use('PublicWebSite.WebHome'))
3 {{html clean="false"}}
4 ## PAGE HEADER
5 <section class="hero hero-centered" aria-labelledby="hero-title">
6 <div class="container hero-inner">
7 <div class="hero-kicker">
8 <i class="fa fa-life-ring" aria-hidden="true"></i>
9 XWiki maintenance and support
10 </div>
11 <h1 id="hero-title">Reliable XWiki support for production environments</h1>
12 <p class="lead">
13 Keep your XWiki instance stable, secure and maintainable with troubleshooting,
14 planned maintenance, upgrade planning and ongoing technical support.
15 </p>
16 <div class="hero-actions">
17 <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Request support</a>
18 <a class="btn btn-secondary" href="#support-process">See the support approach</a>
19 </div>
20 </div>
21 </section>
22 ## 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 }])
51 <section aria-labelledby="why-support-title">
52 <div class="container">
53 <h2 id="why-support-title">Why XWiki needs ongoing care</h2>
54 <p class="section-intro">
55 A production XWiki instance is not just a static documentation website. It may depend on extensions,
56 custom applications, authentication integrations, jobs, scripts, permissions, backups and infrastructure
57 components that need to keep working together.
58 </p>
59 <div class="pathways">
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
76 </div>
77 </div>
78 </section>
79 ## 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 }])
105 <section class="services" aria-labelledby="support-needs-title">
106 <div class="container">
107 <h2 id="support-needs-title">Common support needs</h2>
108 <p class="section-intro">
109 Support can cover urgent troubleshooting, recurring maintenance, upgrade preparation,
110 platform reviews and improvements that make XWiki easier to operate.
111 </p>
112 <div class="services-grid">
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
124 </div>
125 </div>
126 </section>
127 ## 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 }])
144 <section id="support-process" class="split-section" aria-labelledby="process-title">
145 <div class="container">
146 <div class="split-grid">
147 <div class="split-copy">
148 <h2 id="process-title">A practical support approach</h2>
149 <p>
150 The objective is to understand the real state of the XWiki instance, not only the visible symptom.
151 Many issues involve a combination of version history, extensions, configuration, authentication,
152 custom code and infrastructure.
153 </p>
154 <p>
155 Support work is handled with a maintenance mindset: fix the immediate problem, identify the underlying
156 cause where possible and leave the platform easier to operate in the future.
157 </p>
158 </div>
159 <ol class="process-list">
160 #foreach ($entry in $supportProcessItems)
161 <li>
162 <strong>$entry.title</strong>
163 $entry.content
164 </li>
165 #end
166 </ol>
167 </div>
168 </div>
169 </section>
170 ## 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 }])
188 <section aria-labelledby="support-types-title">
189 <div class="container">
190 <h2 id="support-types-title">Support can be occasional or ongoing</h2>
191 <p class="section-intro">
192 Some organizations need help with a specific incident. Others need a long-term technical partner who can
193 keep the instance current, stable and ready for future changes.
194 </p>
195 <div class="widgets">
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
205 </div>
206 </div>
207 </section>
208 ## 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 }])
220 <section class="resource-strip" aria-labelledby="related-title">
221 <div class="container">
222 <h2 id="related-title">Related XWiki services</h2>
223 <p class="section-intro">
224 Maintenance often connects naturally with upgrades, development and security review.
225 </p>
226 <div class="resource-grid">
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
234 </div>
235 </div>
236 </section>
237 ## CTA
238 <section class="cta-section" aria-labelledby="cta-title">
239 <div class="container">
240 <div class="cta-panel">
241 <h2 id="cta-title">Need reliable XWiki support?</h2>
242 <p>
243 Send a short description of your XWiki setup, current version, recent changes and the issue you are facing.
244 A few details are enough to start the conversation.
245 </p>
246 <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Request support</a>
247 </div>
248 </div>
249 </section>
250 {{/html}}
251 {{/velocity}}