Hide last authors
Sorin Burjan 12.3 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
AkiBackman 1.22 4
Caleb James DeLisle 9.1 5 = Compatibility Considerations =
Sorin Burjan 12.3 6
Vincent Massol 49.2 7 See [[Database support strategy>>dev:Community.DatabaseSupportStrategy]] for the supported versions.
8
Caleb James DeLisle 9.1 9 == MyISAM storage engine ==
Sorin Burjan 12.3 10
Ricardo Rodríguez 71.1 11 MyISAM (the default storage engine for MySQL until release 5.5.5 in 2010) does not support transactions. If there is an error while data is being saved to the database, XWiki will attempt to roll back the transaction to its previous known good state. If you use MyISAM, it will do nothing, leaving the database in whatever state it was in when the error occurred.
Caleb James DeLisle 9.1 12
Ahmet Taşdöven 43.1 13 {{warning}}
Beat Burgener 72.2 14 If you use MySQL with any engine that does not support transactions, you will most likely corrupt your database.** We highly recommend using a storage engine such as InnoDB which supports transactions.**
Ahmet Taşdöven 43.1 15 {{/warning}}
16
Caleb James DeLisle 9.1 17 == MySQL versions older than 5.0 ==
Sorin Burjan 12.3 18
Ricardo Rodríguez 71.1 19 XWiki does not fully work with MySQL versions 4.x or lower, due to several limitations of the way the SQL standards are implemented in MySQL, limited support for non-latin1 encodings, the flaky integration of Hibernate and MySQL 4, and other things. Most parts of the application work fine, but there are some parts that cannot be easily fixed, so if you must use MySQL 4.x, you're doing it on your own. MySQL 4 is pretty old and buggy, so we recommend upgrading.
Caleb James DeLisle 9.1 20
Thomas Mortagne 66.1 21 == MySQL versions older than 5.7 and utf8mb4 ==
Thomas Mortagne 65.1 22
Ricardo Rodríguez 71.1 23 If you use utf8mb4 encoding, you won't be able to use a version of MySQL older than 5.7 out of the box because of a limitation in the default maximum size of the keys and the default row format.
Thomas Mortagne 65.1 24
Vincent Massol 68.1 25 == JDBC Driver Version ==
26
27 * It's recommended to use the latest version of the MySQL JDBC driver (8.x) if you're using MySQL 5.7+.
Thomas Mortagne 70.1 28 * If you're using XWiki < 13.3RC1, you should not use version 8.0.23 of the MySQL JDBC driver since it [[causes a problem with the Liquibase version used in XWiki>>https://jira.xwiki.org/browse/XWIKI-18515]].
Vincent Massol 68.1 29
Vincent Massol 7.1 30 = Installation Steps =
vmassol 1.12 31
Vincent Massol 1.11 32 Follow these instructions:
33
Thomas Mortagne 67.1 34 * Download and install [[MySQL>>http://www.mysql.com/]] 5.7 or greater.
35 * Start the MySQL server. You can do that in several ways. For example use {{code language="shell"}}mysqld --console{{/code}}
Vincent Massol 44.1 36 * Create the wiki database. You can use the name you want for the database, but you will have to set the hibernate configuration file and ##xwiki.cfg## file accordingly.(((
37 You can create the database in several ways. For example use:
38
Thomas Mortagne 67.1 39 {{code language="shell"}}
Thomas Mortagne 51.1 40 mysql -u root -e "create database xwiki default character set utf8mb4 collate utf8mb4_bin"
Vincent Massol 30.2 41 {{/code}}
42 )))
Thomas Mortagne 58.1 43 * Create the ##xwiki## user with password ##xwiki##(((
Thomas Mortagne 67.1 44 {{code language="shell"}}
Thomas Mortagne 59.1 45 mysql -u root -e "CREATE USER 'xwiki'@'localhost' IDENTIFIED BY 'xwiki'";
Thomas Mortagne 58.1 46 {{/code}}
47 )))
Thomas Mortagne 67.1 48 * Give privileges to the ##xwiki## user for accessing and creating databases (for the multi wiki support). Specifically the ##xwiki## users needs permissions to be able to execute {{code language="sql"}}CREATE DATABASE{{/code}}, {{code language="sql"}}DROP SCHEMA{{/code}}, and then all CRUD operations on tables. Note that the command below should be tuned to be more restrictive as granting all permissions is not required:(((
49 {{code language="shell"}}
Thomas Mortagne 58.1 50 mysql -u root -e "grant all privileges on *.* to xwiki@localhost"
Vincent Massol 30.2 51 {{/code}}
52 )))
Vincent Massol 44.1 53 * If the above command fails with a password-does-not-meet-requirements error, uninstall the MySQL password_validate plugin or pick a more complex password and update the password used by default in ##hibernate.cfg.xml##:(((
Thomas Mortagne 67.1 54 {{code language="shell"}}
Vincent Massol 44.1 55 mysql -u root -p -e "uninstall plugin validate_password;"
Douglas Landau 35.1 56 {{/code}}
Vincent Massol 44.1 57 )))
Vincent Massol 43.3 58 * Please make sure that the DNS-name "localhost" is defined in your hosts-file (i.e. ##/etc/hosts##)
Vincent Massol 66.5 59 * You need to have the MySQL JDBC Driver JAR (named ##mysql-connector-java*.jar##) installed in XWiki's WAR file. If this file isn't present in XWiki's ##WEB-INF/lib## directory you'll need to download it and copy it there. You can download it from the [[MySQL Connector/J Driver page>>http://www.mysql.com/downloads/connector/j/]] or directly from the [[Maven Central Repository>>https://repo1.maven.org/maven2/mysql/mysql-connector-java/]].(((
Ahmet Taşdöven 43.1 60 {{warning}}
Vincent Massol 44.1 61 You need the 5.x version or higher. The 3.x version doesn't handle Boolean data correctly and will either throw errors or will make all documents hidden by default.
Ahmet Taşdöven 43.1 62 {{/warning}}
Ahmet Taşdöven 41.1 63 )))
Vincent Massol 44.1 64 * Now you need to tell XWiki to use MySQL. To do this, edit the ##WEB-INF/hibernate.cfg.xml## file where you have expanded the XWiki WAR file and replace the matching properties with the following ones:(((
Douglas Landau 32.3 65 {{code language="xml"}}
66 <property name="connection.url">jdbc:mysql://localhost/xwiki</property>
vmassol 1.2 67 <property name="connection.username">xwiki</property>
68 <property name="connection.password">xwiki</property>
AkiBackman 1.22 69 <property name="connection.driver_class">com.mysql.jdbc.Driver</property>
Ahmet Taşdöven 43.1 70 <property name="dialect">org.hibernate.dialect.MySQL5InnoDBDialect</property>
Vincent Massol 44.1 71 <property name="connection.useUnicode">true</property>
72 <property name="connection.characterEncoding">UTF-8</property>
Douglas Landau 32.3 73 {{/code}}
Vincent Massol 30.2 74
Dmitry Bakbardin 15.1 75 {{info}}
Vincent Massol 66.4 76 * By default MySQL only accepts packets that are smaller than 1MB. If you get the "Packet for query is too large (max_allowed_packet)" error then see the [[Packet too large error page>>http://dev.mysql.com/doc/refman/5.0/en/packet-too-large.html]]. For example to increase the packet size to 32M you could start the MySQL server with {{code language='shell'}}mysqld --console --max_allowed_packet=32M{{/code}} or you can modify directly the ##my.cnf## configuration file to set this value permanently.
Vincent Massol 44.1 77 * If an empty XWiki starts with no errors, but you are unable to upload the default set of pages (XAR file) try to increase the ##max_allowed_packet## parameter as shown above.
Dmitry Bakbardin 15.1 78 {{/info}}
Ahmet Taşdöven 43.1 79 )))
80
Vincent Massol 55.1 81 = Indexes =
82
83 See [[Database Administration>>Documentation.AdminGuide.Performances.Database Administration.WebHome]].
84
Thomas Mortagne 67.1 85 {{code language="mysql"}}
Vincent Massol 55.1 86 // Required
87 create index xwl_value on xwikilargestrings (xwl_value(50));
88 create index xwd_parent on xwikidoc (xwd_parent(50));
89 create index xwd_class_xml on xwikidoc (xwd_class_xml(20));
90 create index xda_docid1 on xwikiattrecyclebin (xda_docid);
Thomas Mortagne 72.1 91 create index solr_iterate_all_documents on xwikidoc (XWD_WEB(500), XWD_NAME(253), XWD_LANGUAGE(5), XWD_VERSION(10));
Vincent Massol 55.1 92 // Only required if you use stats (feature is off by default)
93 create index xws_number on xwikistatsdoc (XWS_NUMBER);
94 create index xws_classname on xwikistatsdoc (XWS_CLASSNAME);
95 create index xwr_number on xwikistatsreferer (XWR_NUMBER);
96 create index xwr_classname on xwikistatsreferer (XWR_CLASSNAME);
97 create index xwr_referer on xwikistatsreferer (XWR_REFERER(50));
98 create index xwv_user_agent on xwikistatsvisit (XWV_USER_AGENT(255));
99 create index xwv_cookie on xwikistatsvisit (XWV_COOKIE(255));
100 create index xwv_classname on xwikistatsvisit (XWV_CLASSNAME);
101 create index xwv_number on xwikistatsvisit (XWV_NUMBER);
102 {{/code}}
103
104 {{info}}
105 Note to XWiki developers: The following indexes could be created automatically though since they're less than 255 characters and thus should be added in a future version of XWiki so that they don't need to be created manually:
106
Eduard Moraru 68.2 107 {{code language="mysql"}}
Vincent Massol 55.1 108 create index xws_number on xwikistatsdoc (XWS_NUMBER);
109 create index xws_classname on xwikistatsdoc (XWS_CLASSNAME);
110 create index xwr_number on xwikistatsreferer (XWR_NUMBER);
111 create index xwr_classname on xwikistatsreferer (XWR_CLASSNAME);
112 create index xwv_classname on xwikistatsvisit (XWV_CLASSNAME);
113 create index xwv_number on xwikistatsvisit (XWV_NUMBER);
114 create index xda_docid1 on xwikiattrecyclebin (xda_docid);
115 {{/code}}
116 {{/info}}
117
Vincent Massol 44.1 118 = Tips =
Ahmet Taşdöven 43.1 119
Vincent Massol 60.1 120 == MySQL 8 ==
121
122 * If you're using MySQL 8+ you'll need to configure MySQL with native password: ##default-authentication-plugin=mysql_native_password##.
123 * You'll also be able to switch from ##com.mysql.jdbc.Driver## to ##com.mysql.cj.jdbc.Driver## JDBC driver (since the previous driver class is now deprecated).
Vincent Massol 64.1 124 * If you get the following error then you'll need to force the timezone to use either by setting it in:(((
125 * The MySQL conf file on the server
126 * In the XWiki ##hibernate.cfg.xml## file in the ##hibernate.connection.serverTimezone## property (e.g. ##<property name="hibernate.connection.serverTimezone">Europe/Berlin</property>##).
127 * In the XWiki ##hibernate.cfg.xml## file inside the JDBC URL string as in ##jdbc:mysql:~/~/localhost:3306/myschema?serverTimezone=UTC##
128
Thomas Mortagne 67.1 129 {{code language="none"}}
Vincent Massol 63.1 130 The server timezone value 'CDT' is unrecognized or represents more than one timezone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc timezone value if you want to utilize timezone support.
131 {{/code}}
Vincent Massol 60.1 132
Vincent Massol 63.1 133 For more details see [[this explanation post>>https://stackoverflow.com/a/54256150/153102]].
134 )))
135
Thomas Mortagne 52.1 136 == Convert a database from latin1 (or collation utf8_ci) to utf8mb4/utf8mb4_bin ==
Vincent Massol 27.1 137
Thomas Mortagne 67.1 138 {{code language="shell"}}
Vincent Massol 44.1 139 #!/bin/bash
Ahmet Taşdöven 43.1 140
Vincent Massol 44.1 141 db=xwiki
Thomas Mortagne 52.1 142 to_character_set=utf8mb4
143 to_collation=utf8mb4_bin
Ahmet Taşdöven 43.1 144
Vincent Massol 44.1 145 mysql_cmd="mysql -u root"
146
Thomas Mortagne 52.1 147 $mysql_cmd -e "ALTER DATABASE $db CHARACTER SET $to_character_set COLLATE $to_collation;"
Vincent Massol 44.1 148
149 TBL_LIST=$($mysql_cmd -N -s -r -e "use $db;show tables;")
150
151 for tbl_name in $TBL_LIST;
152 do
153 $mysql_cmd -e "alter table $db.$tbl_name convert to character set $to_character_set collate $to_collation;"
154 done
155
156 echo "Here the result of the operation:"
157 $mysql_cmd -e "USE $db;SELECT TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME, COLUMN_NAME, COLLATION_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA=DATABASE();"
Ahmet Taşdöven 43.1 158 {{/code}}
159
Beat Burgener 72.2 160 (% class="box infomessage" %)
161 (((
162 In case the above script fails to convert some rows with "ERROR 1833 (HY000) at line 1: Cannot change column 'columnname': used in a foreign key constraint 'FK2bj2ghquiq79toomkvugw7iie' of table 'xwiki.tablename', you can drop the foreign keys, convert the columns and then restart xWiki. Hibernate will re-create the dropped indexes automatically.
163 )))
164
Mohamed Boussaa 72.3 165 (% class="box infomessage" %)
166 (((
167 In case the above script fails with "ERROR 1118 (42000) at line 1: Row size too large. The maximum row size for the used table type, not counting BLOBs, is 65535. This includes storage overhead, check the manual. You have to change some columns to TEXT or BLOBs
168 xwikistatsvisit", you can use the following SQL statements to change tables column types to LONGTEXT to be able to convert the tables to utf8mb4.
169 )))
170
171 {{code}}
172 ALTER TABLE activitystream_events MODIFY ase_url LONGTEXT, MODIFY ase_title LONGTEXT, MODIFY ase_body LONGTEXT, MODIFY ase_param1 LONGTEXT, MODIFY ase_param2 LONGTEXT, MODIFY ase_param3 LONGTEXT, MODIFY ase_param4 LONGTEXT, MODIFY ase_param5 LONGTEXT;
173 ALTER TABLE xwikistatsreferer MODIFY XWR_REFERER LONGTEXT;
174 ALTER TABLE xwikistatsvisit MODIFY XWV_USER_AGENT LONGTEXT, MODIFY XWV_COOKIE LONGTEXT;
175 ALTER TABLE xwikipreferences MODIFY XWP_LEFT_PANELS LONGTEXT, MODIFY XWP_RIGHT_PANELS LONGTEXT, MODIFY XWP_DOCUMENT_BUNDLES LONGTEXT;
176 {{/code}}
177
Guillaume Delhumeau 57.1 178 You can also look at [[this snippet to perform this conversion inside XWiki>>snippets:Extension.Migrate MySQL databases to utf8mb4]].
Guillaume Delhumeau 56.1 179
Vincent Massol 44.1 180 == Convert from MyISAM to InnoDB ==
Ahmet Taşdöven 43.1 181
Thomas Mortagne 67.1 182 {{code language="shell"}}
Vincent Massol 44.1 183 #!/bin/bash
184
185 MYSQL_COMMAND=mysql
186 TO_ENGINE=INNODB
187
188 DATABASES=$(mysql -N -s -r -e 'show databases'|grep -v ^information_schema$|grep -v ^mysql$)
189
190
191 for db in $DATABASES
192 do
193
194 echo "Working on database $db..."
195 echo ""
196
197 TABLES=$(mysql -N -s -r -e "show tables from $db;")
198
199 for tb in $TABLES
200 do
201
202 $MYSQL_COMMAND -e "ALTER TABLE $db.$tb ENGINE = $TO_ENGINE;"
203
204 done
205
206 $MYSQL_COMMAND -e "SELECT table_name,Engine,table_collation FROM information_schema.tables WHERE table_schema = DATABASE();"
207
208 echo ""
209 echo ""
210
211 done
Ahmet Taşdöven 43.1 212 {{/code}}
213
Vincent Massol 44.1 214 = Troubleshooting =
215
216 == Unable to login to MySQL Console ==
217
Thomas Mortagne 67.1 218 When running {{code language="shell"}}mysql -u root -e "create database xwiki default character set utf8mb4{{/code}} you may get a {{code}}ERROR 1045 (28000): Access denied for user 'xwiki'@'localhost' (using password: YES){{/code}} error.
Ahmet Taşdöven 43.1 219 This means that you have a password set for the MySQL root user, but you are not specifying it in the console command. You must also use the //-p// parameter. Using this you will be prompted to enter the password and be allowed to login to the MySQL console and create the database.
220
Vincent Massol 7.1 221 == Can't create test file ==
Vincent Massol 6.2 222
Ahmet Taşdöven 43.1 223 When running ##mysqld ~-~-console## you may get the following (especially if you're on a Mac):
Vincent Massol 1.16 224
Thomas Mortagne 67.1 225 {{code language="none"}}
Vincent Massol 1.16 226 071111 17:20:53 [Warning] Can't create test file /usr/local/mysql-5.0.45-osx10.4-i686/data/Vincent.lower-test
227 071111 17:20:53 [Warning] Can't create test file /usr/local/mysql-5.0.45-osx10.4-i686/data/Vincent.lower-test
228 mysqld: Can't change dir to '/usr/local/mysql-5.0.45-osx10.4-i686/data/' (Errcode: 13)
229 071111 17:20:53 [ERROR] Aborting
Vincent Massol 7.1 230 {{/code}}
Vincent Massol 1.16 231
Vincent Massol 44.1 232 To start MySQL run the following command instead:
Vincent Massol 1.16 233
Vincent Massol 44.1 234 {{code}}
Vincent Massol 1.16 235 sudo /usr/local/mysql/bin/mysqld_safe --user=mysql
Vincent Massol 7.1 236 {{/code}}
Vincent Massol 1.16 237
Vincent Massol 7.1 238 == Data Truncation Error ==
2smart4u 5.1 239
Ahmet Taşdöven 43.1 240 If you receive an Exception like the following while installing/upgrading XWiki, chances are that you are using an outdated version of MySQLConnectorJ.
2smart4u 5.1 241
Thomas Mortagne 67.1 242 {{code language="none"}}
2smart4u 5.1 243 Caused by: java.sql.BatchUpdateException: Data truncation: Out of
244 range value adjusted for column 'XWD_HIDDEN' at row 1
245 at com.mysql.jdbc.PreparedStatement.executeBatch(PreparedStatement.java:894)
246 at org.apache.commons.dbcp.DelegatingStatement.executeBatch(DelegatingStatement.java:294)
247 at org.apache.commons.dbcp.DelegatingStatement.executeBatch(DelegatingStatement.java:294)
248 at org.hibernate.jdbc.BatchingBatcher.doExecuteBatch(BatchingBatcher.java:48)
249 at org.hibernate.jdbc.AbstractBatcher.executeBatch(AbstractBatcher.java:246)
Vincent Massol 7.1 250 {{/code}}
2smart4u 5.1 251
Ahmet Taşdöven 43.1 252 On Linux, mysql-connector-java-3.x has proven **not** to work due to a bug in the handling of UTF-8 and lack of support for Boolean types.
2smart4u 5.1 253
Vincent Massol 7.2 254 Upgrading to the latest version of MySQLConnectorJ should solve such an error in most of the cases.
Ahmet Taşdöven 43.1 255
256 == HTTP 500 Error ==
257
Thomas Mortagne 67.1 258 {{code language="none"}}
Ahmet Taşdöven 43.1 259 HTTP Status 500 -
260
261 type Exception report
262
263 message
264
265 descriptionThe server encountered an internal error () that prevented it from fulfilling this request.
266
267 exception
268
269 javax.servlet.ServletException: com.xpn.xwiki.XWikiException: Error number 3 in 0: Could not initialize main XWiki context
270 Wrapped Exception: Error number 3001 in 3: Cannot load class com.xpn.xwiki.store.migration.hibernate.XWikiHibernateMigrationManager from param xwiki.store.migration.manager.class
271 Wrapped Exception: Error number 0 in 3: Exception while hibernate execute
272 Wrapped Exception: Could not create a DBCP pool. There is an error in the hibernate configuration file, please review it.
273
274 root cause
275
276 com.xpn.xwiki.XWikiException: Error number 3 in 0: Could not initialize main XWiki context
277 Wrapped Exception: Error number 3001 in 3: Cannot load class com.xpn.xwiki.store.migration.hibernate.XWikiHibernateMigrationManager from param xwiki.store.migration.manager.class
278 Wrapped Exception: Error number 0 in 3: Exception while hibernate execute
279 Wrapped Exception: Could not create a DBCP pool. There is an error in the hibernate configuration file, please review it.
280 {{/code}}
281
Vincent Massol 44.1 282 In this case, try to disable **skip-networking** in MySQL *.ini file. Thanks a lot //M Rawash// (see his comment below).
283
284 == Unknown database 'xwiki' ==
285
286 If you get the following error:
287
Thomas Mortagne 67.1 288 {{code language="none"}}
Vincent Massol 44.1 289 Caused by: class com.mysql.jdbc.exceptions.jdbc4.MySQLSyntaxErrorException: Unknown database 'xwiki'
290 at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
291 at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:57)
292 at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
293 at java.lang.reflect.Constructor.newInstance(Constructor.java:526)
294 at com.mysql.jdbc.Util.handleNewInstance(Util.java:408)
295 at com.mysql.jdbc.Util.getInstance(Util.java:383)
296 at com.mysql.jdbc.SQLError.createSQLException(SQLError.java:1062)
297 at com.mysql.jdbc.MysqlIO.checkErrorPacket(MysqlIO.java:4226)
298 at com.mysql.jdbc.MysqlIO.checkErrorPacket(MysqlIO.java:4158)
299 at com.mysql.jdbc.MysqlIO.sendCommand(MysqlIO.java:2615)
300 at com.mysql.jdbc.MysqlIO.sqlQueryDirect(MysqlIO.java:2776)
301 at com.mysql.jdbc.ConnectionImpl.execSQL(ConnectionImpl.java:2834)
302 at com.mysql.jdbc.ConnectionImpl.setCatalog(ConnectionImpl.java:5456)
303 at org.apache.commons.dbcp.DelegatingConnection.setCatalog(DelegatingConnection.java:374)
304 at org.apache.commons.dbcp.DelegatingConnection.setCatalog(DelegatingConnection.java:374)
305 at org.apache.commons.dbcp.PoolingDataSource$PoolGuardConnectionWrapper.setCatalog(PoolingDataSource.java:333)
306 at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
307 at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
308 at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
309 at java.lang.reflect.Method.invoke(Method.java:606)
310 at org.hibernate.jdbc.BorrowedConnectionProxy.invoke(BorrowedConnectionProxy.java:74)
311 at com.sun.proxy.$Proxy47.setCatalog(Unknown Source)
312 at com.xpn.xwiki.store.XWikiHibernateBaseStore.setDatabase(XWikiHibernateBaseStore.java:729)
313 at com.xpn.xwiki.store.XWikiHibernateBaseStore.beginTransaction(XWikiHibernateBaseStore.java:911)
314 at com.xpn.xwiki.store.XWikiHibernateBaseStore.beginTransaction(XWikiHibernateBaseStore.java:843)
315 at com.xpn.xwiki.store.XWikiHibernateStore.loadXWikiDoc(XWikiHibernateStore.java:830)
316 ...
317 {{/code}}
318
319 It means that XWiki could connect to your database but there's no ##xwiki## schema available there. This is the default name of the schema XWiki is looking for, for the main wiki database.
320
Thomas Mortagne 67.1 321 It probably means you've created a database named other than ##xwiki## (for example you might have created a database named ##abcd## and set the following connection URL in your ##hibernate.cfg## file: {{code language="none"}}<property name="connection.url">jdbc:mysql://localhost/abcd</property>{{/code}}).
Vincent Massol 44.1 322
323 If this is the case [[you need to tell XWiki that you're using a different schema by setting the ##xwiki.db## configuration property>>platform:AdminGuide.Configuration#HConfigurethenamesofdatabaseschemas]].
324
325 == MySQLSyntaxErrorException: Row size too large (> 8126) ==
326
327 if you get the following error:
328
Thomas Mortagne 67.1 329 {{code language="none"}}
Vincent Massol 44.1 330 MySQLSyntaxErrorException: Row size too large (> 8126).
331 Changing some columns to TEXT or BLOB or using ROW_FORMAT=DYNAMIC or ROW_FORMAT=COMPRESSED may help.
332 In current row format, BLOB prefix of 768 bytes is stored inline.
333 {{/code}}
334
Eduard Moraru 68.2 335 When you are using a MySQL Server 5.6.20 you can get a "row size too large error."
Vincent Massol 44.1 336 In the release notes, it is explained that a innodb_log_file_size which is too small will trigger a "Row size too large error."
337
338 You can solve the problem by changing the innodb_log_file_size in the my.ini text file.
339 Find more details in the link below.
340 http://dev.mysql.com/doc/relnotes/mysql/5.6/en/news-5-6-20.html

Get Connected