Sakai 2.9 release notes database support

The Sakai CLE supports the following production-grade databases:

Database	Driver	Notes
MySQL 5.5.x	MySQL Connector/J 5.1.13+	Sakai requires transaction support. In the case of MySQL you must implement the `InnoDB` storage engine to ensure proper transaction handling.
MySQL 5.1.x	MySQL Connector/J 5.1.13+	Sakai requires transaction support. In the case of MySQL you must implement the `InnoDB` storage engine to ensure proper transaction handling.
Oracle 11g	OJDBC	Oracle recommends using the latest 11g driver if you are using Java 6 with either 10g or 11g; with Java 6 in combination with the 11g driver, it's recommended that you use kernel-1.2.1+ (2.8), kernel-1.1.11+ (2.7) or kernel-1.0.x (r87324+) in order to include the fix for KNL-637. Recommend but not required - convert longs to clobs - SAK-7977 - Getting issue details... STATUS Only tested on Oracle 11.2.0.3 - https://github.com/daveadams/sakai-tools/blob/master/convert-longs-to-lobs.sql . By default it will scan your tables for LONG and LONG RAW fields but it won't change anything. Add "CONVERT" to the command line to actually perform the conversion and rebuild the indexes in the involved tables. Please be sure you understand what the script will be doing before you run it, and always always test thoroughly on a non-production environment before you attempt to run this on your production system.
Oracle 10g	OJDBC	Both Oracle 10g AND 9i users must use the 10g driver; the latest 10g "Release 2" (10.2.x) or higher is recommended. Oracle recommends using the latest 11g driver if you are using Java 6 with either 10g or 11g; with Java 6 in combination with the 11g driver, it's recommended that you use kernel-1.2.1+ (2.8), kernel-1.1.11+ (2.7) or kernel-1.0.x (r87324+) in order to include the fix for KNL-637.
DB2		Deprecated

Choose the appropriate MySQL or Oracle JDBC driver (or connector) for your installation. For MySQL, download the *zip/*tar.gz archive, extract its contents and copy the mysql-connector-java-<version>-bin.jar to $CATALINA_HOME/common/lib. For Oracle download the ojdbc14.jar file and copy it to $CATALINA_HOME/common/lib.

You will not need to create Sakai database objects (tables, indices, etc) when setting up your database. Sakai generates its own database schema automatically during the Tomcat setup process via the autoDDL setting in sakai.properties.

In actuality, Sakai is not limited to these database choices and integration with other RDBMS systems is not difficult. In the past at least one installation used Microsoft SQL Server while requests for PostgreSQL integration are occasionally raised on the Sakai developers list. However, to date no one in the Sakai Community has stepped forward to support alternatives to either Oracle or MySQL, a prerequisite for adding additional database options to the release.

1.0 Configure the database

2.0 Set the database username and password

3.0 Set the database connection

4.0 Set `auto.ddl=true`

5.0 Install MySQL 5.5 / 5.1

5.1 Set MySQL environment variables

5.2 Create a `my.cnf/my.ini` configuration file

5.3 Create a "sakai" database and user account

Unable to render {include} The included page could not be found.