Hide last authors
Manuel Smeria 27.2 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
Ludovic Dubost 1.1 4
Ecaterina Moraru (Valica) 37.4 5 XWiki uses by default a database to store its data. You will find on this page tips and tricks to administer and tune your database setup. For Installation please check the [[Installation guide>>Documentation.AdminGuide.InstallationWAR||anchor="HInstallandconfigureaRelationalDatabase"]] which contains information on how to setup XWiki for multiple databases.
Ludovic Dubost 1.1 6
Silvia Macovei 19.2 7 = Indexes =
Jean-Vincent Drean 7.1 8
Vincent Massol 40.1 9 Even though we've configured XWiki to let Hibernate create indexes by default, there can be some limitations on some databases. For example on MySQL, indexes cannot be created automatically for string columns longer than 255 chars ([[MySQL has a limit of 255 characters>>http://dev.mysql.com/doc/refman/5.7/en/column-indexes.html]] - See also [[InnoDB limits>>http://dev.mysql.com/doc/refman/5.7/en/innodb-restrictions.html]]).
Ludovic Dubost 1.1 10
Vincent Massol 40.1 11 Instructions depending on the database you use:
12 * [[MySQL>>Documentation.AdminGuide.Installation.InstallationWAR.InstallationMySQL.WebHome||anchor="HIndexes"]]
13 * [[Oracle>>Documentation.AdminGuide.Installation.InstallationWAR.InstallationOracle.WebHome||anchor="HIndexes"]]
Vincent Massol 29.1 14
Silvia Macovei 19.2 15 = Sanity Checks =
Ludovic Dubost 1.1 16
jeanvivienmaurice 1.6 17 To verify the consistency of your XWiki database you can run the sanity check script. The script will select rows that are inconsistent with the logics of XWiki. If no rows are selected, it means the script itself can not detect any error.
jeanvivienmaurice 1.7 18
Manuel Smeria 27.2 19 * If you use **MySQL** as your database:
20 ** The following [[sanity check script>>attach:sanitycheck.sql]] has been tested for **MySQL 5.0** (also been reported to work with MS-SQL)
21 ** Another [[script>>attach:sanitycheckMySQL4.sql]] is a variant of the previous script for **MySQL 4.x** replacing some syntax with more ancient one (still reports errors in one command)
22 * If you use **postgresql** as your database:
Silvia Macovei 19.1 23 ** Here is a [[modified version of the sanity check script>>attach:sanitycheck_postgresql.sql]], to be run in the "query" tool of pgAdmin. It is the same as the script for MySQL, except that the syntax for SQL comments is different.
Vincent Massol 22.2 24 ** pgAdmin is the GUI tool provided with postgresql to access the database. Run pgAdmin, select the ##xwiki## database, and choose the "Query" option in the "Tools" menu. Then just open the script and click on the play icon ("Execute query").
Jean-Vincent Drean 7.1 25
Silvia Macovei 19.2 26 = Database browsing =
Jean-Vincent Drean 7.1 27
Silvia Macovei 19.2 28 == DbVisualizer ==
Jean-Vincent Drean 7.1 29
Manuel Smeria 27.2 30 [[DbVisualizer>>http://www.dbvis.com/download/]] natively supports these DBs:
Jean-Vincent Drean 7.1 31
32 * DB2 for Windows/Linux
33 * JavaDB/Derby
34 * MySQL
35 * PostgreSQL
Manuel Smeria 27.2 36 * [[and more>>http://www.dbvis.com/features/tour/supported-databases/]]
Jean-Vincent Drean 7.2 37
Manuel Smeria 27.2 38 Any DB using the corresponding JDBC driver:
Jean-Vincent Drean 7.2 39
Manuel Smeria 27.2 40 * Example: HSQLDB by using the driver bundled with XWiki

Get Connected