Edgewall Software

Changes between Version 37 and Version 38 of MySqlDb


Ignore:
Timestamp:
May 11, 2009, 9:11:31 PM (15 years ago)
Author:
Christian Boos
Comment:

tone down the scary warning and remove the MariaDB advertisement

Legend:

Unmodified
Added
Removed
Modified
  • MySqlDb

    v37 v38  
    1 = MySQL/MariaDB and its MySQLdb Python bindings =
     1= MySQL and its MySQLdb Python bindings =
    22
    3  ''The primary supported backends are PostgreSQL and SQLite. MySQL/MariaDB is supported by Trac with limitations (see [#KnownIssues]). Use this only if you don't have other choice, and be warned that there can be issues unicode support and the repository cache. Some users are nevertheless using MySQL/MariaDB successfully, so it ''might'' work for you. ''
     3Trac supports the MySQL database backend, provided you comply with the basic requirements exposed below.
     4There are also a couple of [#KnownIssues] and supporting this database has proven
     5to be painful at times.
     6We recommend that you use it only if you don't have other choice.
     7Some users are nevertheless using MySQL successfully, and this backend is fully
     8integrated in our test suite, so it ''might'' work for you.''
    49
    510== Requirements ==
    6 === MySQL/MariaDB ===
     11=== MySQL ===
    712
    813 '' '''Warning:'''
    9  The following applies to Trac starting with [milestone:0.11.1]. [[br]]
    10  For earlier versions of Trac, please see MySqlDb@22#MySQL.
     14 The following guidelines applies to Trac starting with [milestone:0.11.1]. [[br]]
     15 For earlier versions of Trac, please see MySqlDb@22#MySQL. ''
    1116
    1217To avoid unicode and international characters problems in Trac (e.g., international characters turning into question marks with mysterious "Incorrect string value" errors logged), we '''''strongly''''' advise MySQL users to use only databases with the ''`utf8`'' character set and the ''`utf8_bin`'' collation type. All tables should be created as  '''InnoDB''' or '''NDB''' type tables, because Trac uses transaction mechanism that not supported by MyISAM tables (see [comment:ticket:8067:5] and [http://dev.mysql.com/tech-resources/articles/storage-engine/part_3.html MySQL docs]).
     
    4954mysql://tracuser:password@localhost/trac
    5055}}}
     56
     57Note that it seems that some users were using the [http://askmonty.org/wiki/index.php/MariaDB MariaDB] variant of MySQL with some success(?).
    5158
    5259=== MySQLdb ===