Wiki source code of Performances
Version 14.5 by Vincent Massol on 2008/04/11
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | #startfloatingbox() | ||
| 2 | *Contents* | ||
| 3 | #toc ("2" "3" "") | ||
| 4 | #endfloatingbox() | ||
| 5 | |||
| 6 | 1 Performances | ||
| 7 | |||
| 8 | Here are some tips to increase XWiki's performances. | ||
| 9 | |||
| 10 | 1.1 Gzip compression and caching of static pages | ||
| 11 | |||
| 12 | We're working on making these features part of the XWiki core (see [XWIKI-2022>http://jira.xwiki.org/jira/browse/XWIKI-2022]). While waiting for this to be natively implemented, the recommended solution is to set up an Apache Web Server in front of your servlet container and install/configure the following modules: | ||
| 13 | * [mod-deflate>http://httpd.apache.org/docs/2.0/mod/mod_deflate.html] | ||
| 14 | * [mod-expire>http://httpd.apache.org/docs/2.0/mod/mod_expires.html] | ||
| 15 | * [mod-proxy-ajp>http://httpd.apache.org/docs/2.2/mod/mod_proxy_ajp.html] (note that this depends on [mod-proxy>http://httpd.apache.org/docs/2.2/mod/mod_proxy.html] that you also need to install) | ||
| 16 | |||
| 17 | Modify your Apache configuration file to load the different modules: | ||
| 18 | |||
| 19 | {code:none} | ||
| 20 | LoadModule expires_module /usr/lib/apache2/modules/mod_expires.so | ||
| 21 | LoadModule deflate_module /usr/lib/apache2/modules/mod_deflate.so | ||
| 22 | LoadModule proxy_module /usr/lib/apache2/modules/mod_proxy.so | ||
| 23 | # Depends: proxy | ||
| 24 | LoadModule proxy_ajp_module /usr/lib/apache2/modules/mod_proxy_ajp.so | ||
| 25 | {code} | ||
| 26 | |||
| 27 | And configure your different modules as described below. | ||
| 28 | |||
| 29 | 1.1.1 Mod Deflate Configuration | ||
| 30 | |||
| 31 | {code:none} | ||
| 32 | vwwwpro-1:~# cat /etc/apache2/conf.d/deflate | ||
| 33 | <Location /> | ||
| 34 | # Insert filter | ||
| 35 | SetOutputFilter DEFLATE | ||
| 36 | |||
| 37 | # Netscape 4.x has some problems... | ||
| 38 | BrowserMatch ^Mozilla/4 gzip-only-text/html | ||
| 39 | |||
| 40 | # Netscape 4.06-4.08 have some more problems | ||
| 41 | BrowserMatch ^Mozilla/4\.0[678] no-gzip | ||
| 42 | |||
| 43 | # MSIE masquerades as Netscape, but it is fine | ||
| 44 | # BrowserMatch \bMSIE !no-gzip !gzip-only-text/html | ||
| 45 | |||
| 46 | # NOTE: Due to a bug in mod_setenvif up to Apache 2.0.48 | ||
| 47 | # the above regex won't work. You can use the following | ||
| 48 | # workaround to get the desired effect: | ||
| 49 | BrowserMatch \bMSI[E] !no-gzip !gzip-only-text/html | ||
| 50 | |||
| 51 | # Don't compress images | ||
| 52 | SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip dont-vary | ||
| 53 | |||
| 54 | # Make sure proxies don't deliver the wrong content | ||
| 55 | #Header append Vary User-Agent env=!dont-vary | ||
| 56 | </Location> | ||
| 57 | {code} | ||
| 58 | |||
| 59 | 1.1.1 Mod Expire Configuration | ||
| 60 | |||
| 61 | {code:none} | ||
| 62 | vwwwpro-1:~# cat /etc/apache2/conf.d/expires | ||
| 63 | <Location /xwiki/skins/> | ||
| 64 | ExpiresActive on | ||
| 65 | ExpiresDefault "access plus 1 day" | ||
| 66 | </Location> | ||
| 67 | |||
| 68 | <Location /xwiki/bin/skin/> | ||
| 69 | ExpiresActive on | ||
| 70 | ExpiresDefault "access plus 1 day" | ||
| 71 | </Location> | ||
| 72 | {code} | ||
| 73 | |||
| 74 | 1.1.1 Mod Proxy AJP Configuration | ||
| 75 | |||
| 76 | {code:none} | ||
| 77 | ProxyRequests Off | ||
| 78 | <Proxy *> | ||
| 79 | Order deny,allow | ||
| 80 | Allow from all | ||
| 81 | </Proxy> | ||
| 82 | ProxyPreserveHost On | ||
| 83 | ProxyPass /xwiki ajp://192.168.1.181:8009/xwiki | ||
| 84 | {code} | ||
| 85 | |||
| 86 | where <tt>ajp://192.168.1.181:8009/xwiki</tt> is the internal address of your Servlet container where XWiki is running. | ||
| 87 | |||
| 88 | 1.1 Memory | ||
| 89 | |||
| 90 | You need to configure your Servlet container so that XWiki has enough memory. You'll need to tune the value to your need. You should check the logs and see if there are any out of memory errors. A good default value is 384MB (-Xmx384m). | ||
| 91 | |||
| 92 | Here are the values used for xwiki.org's web site: | ||
| 93 | {code:none} | ||
| 94 | CATALINA_OPTS="-server -Xms128m -Xmx1024m -XX:MaxPermSize=128m -Dfile.encoding=utf-8 -Djava.awt.headless=true -XX:+UseParallelGC -XX:MaxGCPauseMillis=100" | ||
| 95 | {code} | ||
| 96 | |||
| 97 | 1.1 Database Indexes | ||
| 98 | |||
| 99 | Make sure you've set [Database indexes>Database Administration>]. This is especially important when you start having lots of documents. | ||
| 100 | |||
| 101 | 1.1 Panels | ||
| 102 | |||
| 103 | Some Panels take more resources than others. For example the Navigation panel should NOT be used for wikis with a lot of documents since it displays all documents in the wiki. In the future that Panel should be improve for performances but that's not the case right. Originally this Panel was only meant as a starting point. A better approach is to use a Quick Links Panel as we've now set up in the default XWiki Enterprise wiki version 1.1 (we've removed the default usage of the Navigation Panel in that version). | ||
| 104 | |||
| 105 | 1.1 Statistics | ||
| 106 | |||
| 107 | The statistics module is off by default since it's quite Database intensive. If you don't need it you should turn it off. | ||
| 108 | |||
| 109 | 1.1 Monitoring | ||
| 110 | |||
| 111 | More a developer-oriented feature, XWiki can monitor its own code, reporting the time spent for each sub-component activated during a request. While the monitoring code isn't time consuming, it increases the memory consumption a bit, and the create/start/stop/log/destroy calls are spread all around the code, so you will save a lot of method calls by disabling this. You can do that by setting the following line in <tt>xwiki.cfg</tt>: | ||
| 112 | {code:null} | ||
| 113 | xwiki.monitor=0 | ||
| 114 | {code} | ||
| 115 | |||
| 116 | 1.1 Cache sizes | ||
| 117 | |||
| 118 | Tune the document cache in <tt>xwiki.cfg</tt>. The value depends on how much memory you have. The higher the better. A good reasonable value is 1000. | ||
| 119 | |||
| 120 | {code:none} | ||
| 121 | xwiki.store.cache.capacity=1000 | ||
| 122 | {code} | ||
| 123 | |||
| 124 | 1.1 Rendering cache | ||
| 125 | |||
| 126 | Some pages are complex to render (they may aggregate outside data for example or do complex and slow queries). For these pages you can add the following to their content to cache them after they are rendered. For example to cache the rendered content for 60 seconds you would add: | ||
| 127 | |||
| 128 | {code:none} | ||
| 129 | $context.setCacheDuration(60) | ||
| 130 | {code} | ||
| 131 | |||
| 132 | 1.1 Merge the CSS files | ||
| 133 | |||
| 134 | In order to reduce the number of requests and files that are downloaded from the browser or client, it could help to merge all XWiki CSS files into a single one. See the [Merge CSS Snippet>code:Snippets.MergeCSSSnippet] | ||
| 135 | |||
| 136 | 1.1 Backlinks | ||
| 137 | |||
| 138 | While a pretty neat feature, keeping track of the backlinks has a medium impact on the document saving time and a minor impact on the document loading time. If you feel that your wiki does not need backlinks, you can safely disable them with the following line in <tt>xwiki.cfg</tt>: | ||
| 139 | {code:none} | ||
| 140 | xwiki.backlinks=0 | ||
| 141 | {code} | ||
| 142 | |||
| 143 | 1.1 Versioning | ||
| 144 | |||
| 145 | One of the key features of any wiki system, versioning greatly affects the database size and the document update time. If you are sure your wiki does not need to keep track of all the changes and you will never need to revert documents to a previous version, then you can add the following line in <tt>xwiki.cfg</tt> | ||
| 146 | {code:none} | ||
| 147 | xwiki.store.versioning=0 | ||
| 148 | {code} | ||
| 149 | |||
| 150 | 1.1 Wiki syntax features | ||
| 151 | |||
| 152 | If you don't plan to use all of the wiki features, like the --strikethrough-- filter, the automatic http links filter, the SVG, Laszlo or style macros, you can disable them in <tt>xwiki-core-\*.jar/META-INF/services/com.xpn.xwiki.render.\*</tt>. The wiki rendering is the most costly operation in the rendering process, so any disabled feature counts. |
