Version 197.1 by Thomas Mortagne on 2021/01/13

Hide last authors
Guillaume Fenollar 11.1 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
Vincent Massol 134.2 5 This distribution allows installing XWiki and every component needed for a production instance automatically.
Guillaume Fenollar 1.1 6
Vincent Massol 134.2 7 This method works for all Debian-based linux distribution. Feel free to use [[the User Forum>>dev:Community.Discuss]] to report issues, or discuss about it.
Guillaume Fenollar 1.1 8
Thomas Mortagne 120.1 9 = APT Configuration =
Guillaume Fenollar 1.1 10
Thomas Mortagne 196.3 11 First, you have to configure your package manager in order to use XWiki's repository. This can be done simply, using this command:
Guillaume Fenollar 1.1 12
Thomas Mortagne 18.1 13 {{code language="bash"}}
Thomas Mortagne 100.1 14 wget -q "https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
15 sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
Guillaume Fenollar 1.1 16 {{/code}}
17
Thomas Mortagne 44.1 18 {{info}}
19 Note that there is several repositories you can choose (as alternatives to the stable one you have in the previous example):
Thomas Mortagne 112.1 20
Thomas Mortagne 101.1 21 * [[https://maven.xwiki.org/releases/xwiki-releases.list]]: all released versions including milestones and release candidates (beta)
22 * [[https://maven.xwiki.org/stable/xwiki-stable.list]]: all released versions excluding milestones and release candidates (stable)
Thomas Mortagne 123.1 23 * [[https://maven.xwiki.org/lts/xwiki-lts.list]]: the current "long term support" branch versions as defined in [[Support page>>xwiki:Main.Support]]
Thomas Mortagne 44.1 24 {{/info}}
25
Guillaume Fenollar 1.1 26 Now you can update the packages database to read the data from this repository.
27
Thomas Mortagne 18.1 28 {{code language="bash"}}
29 sudo apt-get update
30 {{/code}}
31
Guillaume Fenollar 1.1 32 Now you can make a little search to see what this repo offers.
33
Thomas Mortagne 18.1 34 {{code language="bash"}}
Guillaume Fenollar 1.1 35 apt-cache search xwiki
36 {{/code}}
37
Thomas Mortagne 54.1 38 It shows the following packages (the exact list depends on the version the repository contains):
Guillaume Fenollar 2.1 39
Thomas Mortagne 111.1 40 * xwiki-common - XWiki, you can install this if you want to take care yourself of the database and application server
Thomas Mortagne 168.1 41 * xwiki-mariadb-common - XWiki MariaDB common package, you can install this if you want to take care yourself of the application server
Thomas Mortagne 103.1 42 * xwiki-mysql-common - XWiki MySQL common package, you can install this if you want to take care yourself of the application server
43 * xwiki-pgsql-common - XWiki PostgreSQL common package, you can install this if you want to take care yourself of the application server
Thomas Mortagne 109.1 44 * xwiki-tomcat8-common - XWiki Tomcat 8 common package, you can install this if you want to take care yourself of the database link
Joan 145.2 45 * xwiki-tomcat9-common - XWiki Tomcat 9 common package, you can install this if you want to take care yourself of the database link
Thomas Mortagne 168.1 46 * xwiki-tomcat8-mariadb - XWiki Tomcat 8/MariaDB based package
47 * xwiki-tomcat9-mariadb - XWiki Tomcat 9/MariaDB based package
Thomas Mortagne 110.1 48 * xwiki-tomcat8-mysql - XWiki Tomcat 8/MySQL based package
Joan 145.2 49 * xwiki-tomcat9-mysql - XWiki Tomcat 9/MySQL based package
Thomas Mortagne 110.1 50 * xwiki-tomcat8-pgsql - XWiki Tomcat 8/PostgreSQL
Joan 145.2 51 * xwiki-tomcat9-pgsql - XWiki Tomcat 9/PostgreSQL
Thomas Mortagne 181.1 52 * xwiki-solr-all - An entry point package which a dependency on all the solr core required to setup a standalone version compatible with XWiki Standard
Thomas Mortagne 174.1 53 * xwiki-solr-core - A pre configured Solr core for the XWiki search feature
54 * xwiki-solr-events - A pre configured Solr core for the XWiki events/notifications storage
55 * xwiki-solr-ratings - A pre configured Solr core for the XWiki rating storage
Thomas Mortagne 103.1 56
Thomas Mortagne 154.1 57 Plus legacy packages from older versions of XWiki like xwiki-enterprise-* packages or for unsupported versions of Tomcat.
Thomas Mortagne 103.1 58
Craig Wright 117.1 59 {{error}}
60 xwiki-enterprise-* packages were deprecated as of 9.4. Installations requiring those packages will appear to have stopped updating at version 9.4. Install the corresponding xwiki-* package to update to the latest version. (For example, if you were relying on the xwiki-enterprise-tomcat8-mysql package, you will now need to install the xwiki-tomcat8-mysql package.)
61 {{/error}}
62
Valdis Vitolins 42.1 63 {{info}}
64 According to selection, package manager will install all necessary dependencies (application server, database, Java runtime). If you haven't installed these packages before, package manager can ask additional info from you.
65 {{/info}}
Valdis Vitolins 41.1 66
Thomas Mortagne 134.1 67 {{warning}}
68 On Ubuntu you will need [[##universe## repository>>https://help.ubuntu.com/community/Repositories/CommandLine]] to install Tomcat packages. It's generally enabled by default.
69 {{/warning}}
70
Thomas Mortagne 121.1 71 = Complete Installation =
Guillaume Fenollar 1.1 72
Thomas Mortagne 64.1 73 {{warning}}
Thomas Mortagne 89.1 74 Most Debian distributions provide a Tomcat package with a pretty low Memory setting by default (128MB) and this need to be increased for XWiki to fully work. See [[Tomcat Usability section>>||anchor="HTomcatUsability"]] for more details.
Thomas Mortagne 64.1 75 {{/warning}}
76
Thomas Mortagne 190.1 77 == Using MariaDB ==
Guillaume Fenollar 1.1 78
Thomas Mortagne 188.1 79 {{warning}}
Thomas Mortagne 196.3 80 Note that XWiki require at least MariaDB 5.10. If your Debian distribution provide an older version (like Debian Stretch/9) you can use the one from the repositories provided by the MariaDB project to get a more recent version on https://downloads.mariadb.org/mariadb/repositories/.
Thomas Mortagne 188.1 81 {{/warning}}
Thomas Mortagne 185.1 82
Thomas Mortagne 196.4 83 The following will install everything you need to run XWiki with MariaDB and Tomcat 9:
Guillaume Fenollar 1.2 84
Thomas Mortagne 18.1 85 {{code language="bash"}}
Thomas Mortagne 190.1 86 sudo apt-get install xwiki-tomcat9-mariadb
Thomas Mortagne 18.1 87 {{/code}}
88
Thomas Mortagne 190.1 89 This package depends on xwiki-common, xwiki-tomcat9-common, xwiki-mariadb-common, mariadb-server and tomcat9. You might have to select a different version of Tomcat depending on what's available in your system repository.
Guillaume Fenollar 1.2 90
Thomas Mortagne 190.1 91 During the installation, you may have some questions from dbconfig, in charge of the configuration of the database. Don't confuse it with the MariaDB root password prompt, which beg you to put a password for the superuser.
92 DBconfig prompt is about the configuration of xwiki and mariadb. If you haven't any mariadb already installed and you aren't familiar with it, you should let dbconfig handle this.
Guillaume Fenollar 3.1 93
Thomas Mortagne 190.1 94 DBconfig is then asking you for the mariadb root password (you may have entered before). Then, you can choose the password for the "xwiki" mariadb user. This user will be used to connect from XWiki application. Choose it wisely, but you don't have to pay a lot of attention to it, because after that, dbconfig is configuring XWiki automatically with these credentials.
Guillaume Fenollar 1.2 95
Thomas Mortagne 149.1 96 The installation now ends, with the automatic start of tomcat daemon ("Starting Tomcat servlet engine tomcat9 [OK]").
Guillaume Fenollar 2.1 97
Guillaume Fenollar 3.1 98 {{warning}}
Thomas Mortagne 48.1 99 Note that your wiki is absolutely empty, like a WAR installation. Distribution Wizard will take care of the rest.
Guillaume Fenollar 2.1 100 {{/warning}}
Guillaume Fenollar 4.1 101
Thomas Mortagne 190.1 102 == Using MySQL ==
Thomas Mortagne 169.1 103
Thomas Mortagne 187.1 104 {{warning}}
Thomas Mortagne 190.1 105 Note that XWiki require at least MySQL 5.7. This package also works with MariaDB (in which case you need at least MariaDB 10.2).
Thomas Mortagne 187.1 106 {{/warning}}
Thomas Mortagne 186.1 107
Thomas Mortagne 196.4 108 The following will install everything you need to run XWiki with MySQL and Tomcat 9:
Thomas Mortagne 169.1 109
110 {{code language="bash"}}
Thomas Mortagne 190.1 111 sudo apt-get install xwiki-tomcat9-mysql
Thomas Mortagne 169.1 112 {{/code}}
113
Thomas Mortagne 190.1 114 This package depends on xwiki-common, xwiki-tomcat9-common, xwiki-mysql-common, mysql-server and tomcat9. You might have to select a different version of Tomcat depending on what's available in your system repository.
Thomas Mortagne 169.1 115
Thomas Mortagne 190.1 116 During the installation, you may have some questions from dbconfig, in charge of the configuration of the database. Don't confuse it with the MySQL root password prompt, which beg you to put a password for the superuser.
117 DBconfig prompt is about the configuration of xwiki and mysql. If you haven't any mysql already installed and you aren't familiar with it, you should let dbconfig handle this.
Thomas Mortagne 169.1 118
Thomas Mortagne 190.1 119 DBconfig is then asking you for the mysql root password (you may have entered before). Then, you can choose the password for the "xwiki" mysql user. This user will be used to connect from XWiki application. Choose it wisely, but you don't have to pay a lot of attention to it, because after that, dbconfig is configuring XWiki automatically with these credentials.
Thomas Mortagne 169.1 120
121 The installation now ends, with the automatic start of tomcat daemon ("Starting Tomcat servlet engine tomcat9 [OK]").
122
123 {{warning}}
124 Note that your wiki is absolutely empty, like a WAR installation. Distribution Wizard will take care of the rest.
125 {{/warning}}
126
Guillaume Fenollar 4.1 127 == Using PostgreSQL ==
128
Manuel Smeria 25.3 129 It's as simple as the MySQL installation, you only need to choose the right virtual package.
Guillaume Fenollar 4.1 130
Thomas Mortagne 18.1 131 {{code language="bash"}}
Thomas Mortagne 150.1 132 sudo apt-get install xwiki-tomcat9-pgsql
Thomas Mortagne 18.1 133 {{/code}}
134
Vincent Massol 119.3 135 After you've made sure to update the memory settings (see below), you can now point your favorite browser to the following URL to use your wiki: ##http:~/~/localhost:8080/xwiki##
Guillaume Fenollar 13.1 136
Manuel Smeria 25.3 137 PostgreSQL is slightly different than MySQL in the handling of databases and in the manual configuration, but everything should work on the first try.
Thomas Mortagne 18.1 138
Valdis Vitolins 43.1 139 == Security settings ==
140
Thomas Mortagne 45.1 141 1. (((
142 Open ##/etc/xwiki/xwiki.cfg## file and change lines:
Valdis Vitolins 43.1 143
144 {{code language="none"}}
145 ...
146 #-# Cookie encryption keys. You SHOULD replace these values with any random string,
147 #-# as long as the length is the same.
148 xwiki.authentication.validationKey=your1stkeyhere
149 xwiki.authentication.encryptionKey=your2ndkeyhere
150 ...
Thomas Mortagne 45.1 151 {{/code}}
152 )))
153 1. (((
154 If you need, add password to the built-in superadmin account, by changing line:
Valdis Vitolins 43.1 155
156 {{code language="none"}}
157 ...
158 #-# Enable to allow superadmin. It is disabled by default as this could be a
159 #-# security breach if it were set and you forgot about it. Should only be enabled
160 #-# for recovering the Wiki when the rights are completely messed.
161 xwiki.superadminpassword=yourpassword
162 ...
Thomas Mortagne 45.1 163 {{/code}}
164 )))
Valdis Vitolins 43.1 165
Guillaume Fenollar 11.1 166 == Tomcat Usability ==
167
Vincent Massol 167.2 168 You can find [[various generic advices and troubleshooting related to Tomcat>>Documentation.AdminGuide.Installation.InstallationWAR.InstallationTomcat.WebHome]].
Thomas Mortagne 142.1 169
Thomas Mortagne 78.1 170 === Java Version ===
171
Vincent Massol 105.3 172 Make sure Tomcat is executed with the right [[Java version>>platform:AdminGuide.Installation||anchor="HHardwareandSoftwarerequirements"]].
Thomas Mortagne 78.1 173
Thomas Mortagne 172.1 174 This is usually indicated in the file ##/etc/default/tomcat9## (or ##/etc/default/tomcat8## for Tomcat 8, etc).
Thomas Mortagne 78.1 175
176 === Memory ===
177
Vincent Massol 119.2 178 The default Tomcat memory setup is too low for XWiki's needs.
Guillaume Fenollar 11.1 179
Thomas Mortagne 172.1 180 You can change it in the file ##/etc/default/tomcat9## (or ##/etc/default/tomcat8## for Tomcat 8, etc).
Guillaume Fenollar 11.1 181
Thomas Mortagne 71.1 182 Modify the property ##JAVA_OPTS##. For example:
Thomas Mortagne 18.1 183
Thomas Steinbach 25.1 184 {{code language="none"}}
Thomas Mortagne 94.1 185 JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m"
Thomas Steinbach 25.1 186 {{/code}}
Thomas Mortagne 18.1 187
Thomas Mortagne 194.1 188 You should [[check the Memory settings we recommend>>Documentation.AdminGuide.Performances||anchor="HMemory"]].
Guillaume Fenollar 11.1 189
Thomas Mortagne 139.1 190 === /dev/urandom ===
191
Thomas Mortagne 144.1 192 In most Debian-based systems the default random implementation is ##/dev/random## which can be very slow. ##/dev/urandom## is much faster and it's fine for XWiki's needs so you should use it when possible:
Thomas Mortagne 139.1 193
Thomas Mortagne 172.1 194 * edit ##/etc/default/tomcat9## file and add
Thomas Mortagne 139.1 195
Thomas Mortagne 140.1 196 {{code language="bash"}}
Thomas Mortagne 143.1 197 JAVA_OPTS="${JAVA_OPTS} -Djava.security.egd=file:/dev/./urandom"
Thomas Mortagne 140.1 198 {{/code}}
199
Thomas Mortagne 50.1 200 = Concluding Step =
201
Vincent Massol 114.2 202 {{include reference="Documentation.AdminGuide.Installation.InstallationConcludingSteps.WebHome"/}}
Thomas Mortagne 50.1 203
Guillaume Fenollar 10.1 204 = Uninstallation =
Guillaume Fenollar 4.1 205
Guillaume Fenollar 10.1 206 If you want to remove XWiki from your system, you only have to uninstall the package you've installed at the beginning of this documentation. For example:
207
Thomas Mortagne 27.1 208 {{code language="bash"}}
Thomas Mortagne 103.1 209 sudo apt-get --purge remove xwiki-common
Thomas Mortagne 27.1 210 {{/code}}
211
Thomas Mortagne 95.1 212 Attention, these commands do not remove MySQL/PostgreSQL nor Tomcat from your system. To do so, if you don't use these applications for another purpose, you can make some cleaning with
Thomas Mortagne 27.1 213
Manuel Smeria 25.3 214 {{code language="bash"}}
Thomas Mortagne 96.1 215 sudo apt-get --purge autoremove
Manuel Smeria 25.3 216 {{/code}}
Guillaume Fenollar 10.1 217
Gunter Ohrner 138.2 218 = Troubleshooting =
Thomas Mortagne 77.1 219
Thomas Mortagne 162.1 220 You can find a generic Troubleshooting section on [[https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/#HTroubleshooting]].
221
Thomas Mortagne 178.1 222 == Getting "##The repository 'http:~/~/maven.xwiki.org stable/ Release' is no longer signed.##" ==
Thomas Mortagne 157.1 223
Thomas Mortagne 175.1 224 The repository is signed but the key changed on November 4th 2020 so if you registered it before that you will need to register the new one:
225
226 {{code language="bash"}}
227 wget -q "https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
228 {{/code}}
229
Thomas Mortagne 196.3 230 == No package can be found for Java
231
232 XWiki require at least Java 8 since XWiki 8.1, **OpenJDK 11** (the recommended version) will be automatically installed as dependency on recent distributions.
233
234 For some older distributions the problem is that Ubuntu and Debian did not bothered put OpenJDK 8 on older but still supported distributions default repositories (for example Ubuntu 14.04 or Debian Wheezy/Jessie). For those you will have to make sure there is some repository with it so that Java 8+ is installed as a package so that XWiki find it as dependency.
235
236 Here is a few helpers for specific distributions:
237
238 === Ubuntu 14.04 (Trusty Tahr), Debian < 9 ==
239
240 * AdoptOpenJDK provide a Debian repository to install OpenJDK, see https://adoptopenjdk.net/installation.html#linux-pkg
241
Thomas Mortagne 176.1 242 == My wiki is empty after upgrading a Tomcat9 based package ==
243
Thomas Mortagne 157.1 244 === Upgrading from another Tomcat 9 based package ===
245
Thomas Mortagne 173.1 246 This generally means that you installed a Tomcat 9 based package before one of 10.11.11, 11.3.7, 12.0-rc-1 or 11.10.3 and the data were stored in a temporary location (generally /var/cache/tomcat9/Catalina/localhost/xwiki).
Thomas Mortagne 157.1 247
248 You will need to find where was the data stored and move it to ##/var/lib/xwiki/data##.
249
250 If you don't find the previous data take a look at a previous logs (in /var/log/tomcat9/) and search for "Falling back on".
251
252 === Previous from a package based on a version of Tomcat lower than 9 ===
253
254 This is caused by the bug https://jira.xwiki.org/browse/XWIKI-16943 which is fixed in 10.11.11, 11.3.7, 12.0-rc-1 an 11.10.3.
255
256 The workaround is to execute the following commands:
257
258 * {{code language="sh"}}mkdir /etc/systemd/system/tomcat9.service.d/{{/code}}
259 * {{code language="sh"}}echo -e "[Service]\nReadWritePaths=/var/lib/xwiki/data" > /etc/systemd/system/tomcat9.service.d/override.conf{{/code}}
260 * {{code language="sh"}}systemctl daemon-reload{{/code}}
261 * {{code language="sh"}}systemctl restart tomcat9.service{{/code}}
262
Thomas Mortagne 196.3 263 == I get an error when using the chart macro ==
Thomas Mortagne 77.1 264
Thomas Mortagne 191.1 265 The chart macro doesn't appear to be working with a clean install with the openjdk 8 Debian package (openjdk 11, which is the recommended version, does not seems to be affected). It gives an error:
Thomas Mortagne 77.1 266
Thomas Mortagne 162.1 267 > Failed to execute the [chart] macro. Cause: [Could not initialize class org.jfree.chart.JFreeChart].
Thomas Mortagne 126.1 268
Thomas Mortagne 165.1 269 In some Debian/Ubuntu version a broken accessibility option is enabled by default on Java 8 and it's what is causing this error. See https://jira.xwiki.org/browse/XWIKI-16993 and https://bugs.launchpad.net/ubuntu/+source/openjdk-6/+bug/935296 for more details.
Thomas Mortagne 126.1 270
Thomas Mortagne 162.1 271 To disable it go to ##/etc/java-8-openjdk/accessibility.properties## (or another path depending on your version of Java) and comment the line:
272
273 {{code language="properties"}}
Thomas Mortagne 166.1 274 # assistive_technologies=org.GNOME.Accessibility.AtkWrapper
Thomas Mortagne 128.1 275 {{/code}}
276
Thomas Mortagne 162.1 277 == Tomcat ==
Thomas Mortagne 128.1 278
Thomas Mortagne 196.1 279 See [[Tomcat Installation>>Documentation.AdminGuide.Installation.InstallationWAR.InstallationTomcat||anchor="HTroubleshooting"]] for generic Tomcat related issues.
Thomas Mortagne 162.1 280
Thomas Mortagne 77.1 281 == MySQL ==
282
Thomas Mortagne 195.1 283 See [[MySQL Installation>>Documentation.AdminGuide.Installation.InstallationWAR.InstallationMySQL||anchor="HTroubleshooting"]] for generic MySQL related issues.
Thomas Mortagne 77.1 284
285 == PostgreSQL ==
286
Thomas Mortagne 193.1 287 See [[PostgreSQL Installation>>Documentation.AdminGuide.Installation.InstallationWAR.InstallationPostgreSQL||anchor="HTroubleshooting"]] for generic PostgreSQL related issues.
Thomas Mortagne 77.1 288
289 = Other useful info =
290
Paul Libbrecht 105.1 291 == XWiki as root webapp (short URLs) ==
Thomas Mortagne 77.1 292
293 {{warning}}
Thomas Mortagne 167.1 294 When doing it make sure to check after upgrade if all is OK in /etc/tomcat9/Catalina/localhost folder (xwiki.xml might be restored).
Thomas Mortagne 77.1 295 {{/warning}}
296
Thomas Mortagne 167.1 297 * Rename file ##/etc/tomcat9/Catalina/localhost/xwiki.xml## into ##/etc/tomcat9/Catalina/localhost/ROOT.xml##
298 * Edit file ##/etc/xwiki/xwiki-tomcat9.xml## and modify ##Context## XML element path from ##/xwiki## to ##/## as in moving from(((
Thomas Mortagne 77.1 299 {{code language="xml"}}
Thomas Mortagne 167.1 300 <Context path="/xwiki" docBase="/usr/lib/xwiki"
301 containerSciFilter="org.apache.tomcat.websocket.server.WsSci|org.apache.jasper.servlet.JasperInitializer">
Thomas Mortagne 77.1 302 {{/code}}
303
304 to
305
306 {{code language="xml"}}
Thomas Mortagne 167.1 307 <Context path="/" docBase="/usr/lib/xwiki"
308 containerSciFilter="org.apache.tomcat.websocket.server.WsSci|org.apache.jasper.servlet.JasperInitializer">
Thomas Mortagne 77.1 309 {{/code}}
310 )))
311 * Edit file ##/etc/xwiki/xwiki.cfg## and uncomment {{code language="properties"}}xwiki.webapppath={{/code}}
312
Thomas Mortagne 132.1 313 Note that this is only the part of Short URL which is specific to the Debian setup, for the rest you will have to look at [[the generic documentation>>doc:Documentation.AdminGuide.ShortURLs.WebHome]].
314
Thomas Mortagne 77.1 315 == Integrate with LibreOffice ==
316
Thomas Mortagne 97.1 317 Install libreoffice with {{code language="none"}}sudo apt-get install libreoffice{{/code}}.
Thomas Mortagne 77.1 318
319 And setup XWiki to automatically start and access libreoffice in ##/etc/xwiki/xwiki.properties##:
320
321 {{code language="properties"}}
322 openoffice.autoStart=true
323 openoffice.homePath=/usr/lib/libreoffice/
324 {{/code}}
325
326 See [[Office Importer Application>>extensions:Extension.Office Importer Application]] for more details.
327
Thomas Mortagne 159.1 328 == Standalone Solr setup ==
329
Thomas Mortagne 160.1 330 Take a look at [[Solr documentation>>https://lucene.apache.org/solr/guide/8_1/taking-solr-to-production.html#taking-solr-to-production]] to install it.
Thomas Mortagne 159.1 331
Thomas Mortagne 180.1 332 Then you will need to add the XWiki schema configuration:
Thomas Mortagne 159.1 333
Thomas Mortagne 182.1 334 * since 12.6 you should install the package ##xwiki-solr-all## to automatically register the Solr cores needed by XWiki Standard in the Solr server (provided the standard setup was used)
335 * between 12.0 and 12.5 the package ##xwiki-solr-core## will automatically register the XWiki search core in the Solr server (provided the standard setup was used)
336 * before 12.0 you can use the xwiki-solr-data Debian package and add some links to register it in your Solr server
Thomas Mortagne 180.1 337
Guillaume Fenollar 4.1 338 = Overview of the important files =
339
Manuel Smeria 25.3 340 Here is a list of a different tree. The point is to help you find useful files easily. This list is showing a few files and directories, to keep it simple and clear. The '->' is used to show a link to another file/directory.
Guillaume Fenollar 4.1 341
342 == XWiki ==
343
Thomas Mortagne 152.1 344 The configuration: **/etc/xwiki/**
Guillaume Fenollar 4.1 345
Thomas Mortagne 156.1 346 * hibernate.cfg.xml //Hibernate configuration, helping to configure the database resources//
Thomas Mortagne 152.1 347 * xwiki.cfg
Thomas Mortagne 98.1 348 * xwiki.properties
Thomas Mortagne 184.1 349 * xwiki-tomcat9-systemd.conf // Injected trough ##/etc/systemd/system/tomcat9.service.d/xwiki-tomcat-systemd.conf##// in the tomcat9 service configuration
350 * xwiki-tomcat<version> // The Tomcat integration linked from ##/etc/tomcat<version>/Catalina/localhost##//
Thomas Mortagne 98.1 351
Thomas Mortagne 153.1 352 The permanent directory: **/var/lib/xwiki/data**
Guillaume Fenollar 4.1 353
Thomas Mortagne 153.1 354 The home directory: **/usr/lib/xwiki/**
355
Thomas Mortagne 98.1 356 * META-INF
357 * resources
358 * skins
359 * templates
360 * WEB-INF
361 ** hibernate.cfg.xml -> /etc/xwiki/hibernate.cfg.xml
362 ** xwiki.cfg -> /etc/xwiki/xwiki.cfg
363 ** xwiki.properties -> /etc/xwiki/xwiki.properties
364
Guillaume Fenollar 4.1 365 == Tomcat ==
366
Thomas Mortagne 99.1 367 **/etc/tomcat##<version>##/**
Guillaume Fenollar 4.1 368
Thomas Mortagne 99.1 369 * context.xml
370 * logging.properties
371 * server.xml
372 * tomcat-users.xml
373 * web.xml
374
Guillaume Fenollar 12.1 375 **/etc/default/**
Guillaume Fenollar 4.1 376
Thomas Mortagne 99.1 377 * tomcat##<version>## //This file helps configuring the Tomcat daemon. Every change needs a restart to be effective//
378
Guillaume Fenollar 12.1 379 **/etc/init.d/**
380
Thomas Mortagne 99.1 381 * tomcat##<version>## //Daemon start/stop script//
Guillaume Fenollar 4.1 382
Thomas Mortagne 99.1 383 **/var/lib/tomcat##<version>##/**
Guillaume Fenollar 4.1 384
Thomas Mortagne 99.1 385 * common
386 * conf -> /etc/tomcat##<version>##
387 * logs -> ../../log/tomcat##<version>##
388 * server
389 * shared
390 * webapps
391
392 **/var/log/tomcat##<version>##/**
393
394 * catalina.out //First logging file. Check this one if you're experiencing troubles with Tomcat/XWiki.//
Paul Libbrecht 106.1 395 * localhost.<date>.log // "Container Log file": Start of each filter and failures thereof are listed.//
Thomas Mortagne 99.1 396
Guillaume Fenollar 4.1 397 == MySQL ==
398
399 **/etc/mysql/**
400
Thomas Mortagne 99.1 401 * debian.cnf
402 * my.cnf //Database configuration. Max_allowed_packet is the parameter you need to change to improve upload data size.// permitted.
403
Guillaume Fenollar 4.1 404 **/var/lib/mysql/**
405
Thomas Mortagne 99.1 406 * mysql
407 * xwiki //This is the xwiki database. You may want to backup this directory from time to time.//
408
Guillaume Fenollar 4.1 409 **/var/log/**
410
Thomas Mortagne 99.1 411 * syslog
412 * mysql
413 ** error.log
414
Guillaume Fenollar 4.1 415 == PostgreSQL ==
416
417 **/etc/postgresql/**
418
Thomas Mortagne 99.1 419 * ##<version>##
420 ** main
421 *** postgresql.conf
422 *** pg_hba.conf
423
424 **/var/lib/postgresql/##<version>##/main/**
425
426 * base

Get Connected