MySQL
Supported Versions
Crowd supports the versions of MySQL listed on the Supported Platforms page.
When you run the Crowd Setup Wizard, you will be asked to choose a database and provide configuration settings for that database. It will make things easier if you have created the database and deployed the database driver before you start the Setup Wizard.
Follow the instructions below to set up MySQL for Crowd.
1. Configure MySQL
- Create a database user which Crowd will connect as (e.g. crowduser).
Create a database for Crowd to store data in (e.g. crowd). For a UTF-8 encoded database:
create database crowd character set utf8 collate utf8_bin;Ensure that the user has permission to connect to the database, and create and populate tables:
GRANT ALL PRIVILEGES ON crowd.* TO 'crowduser'@'localhost' IDENTIFIED BY 'crowdpass';Edit the
my.cnffile (often namedmy.inion Windows operating systems) in your MySQL server. Locate the[mysqld]section in the file, and add or modify the following parameters (Refer to MySQL Option Files for detailed instructions on editing my.cnf and my.ini.):Specify the default character set to be UTF-8:
[mysqld] ... character-set-server=utf8 collation-server=utf8_bin ...Set the default storage engine to InnoDB:
[mysqld] ... default-storage-engine=INNODB ...set to transaction-isolation
= READ-COMMITTED.[mysqld] ... transaction-isolation = READ-COMMITTED ...
Notes:
- The above configuration will prevent errors when you import directory information into Crowd. See CWD-1505.
- Restart your MySQL server for the configuration change to take effect.
2. Copy the MySQL Driver to your Application Server
- Download the MySQL Connector/J 5.1 JDBC driver.
- Add the MySQL JDBC driver jar (
mysql-connector-java-5.x.x-bin.jar) to the following directory:- For Crowd distribution:
- Crowd 2.0.2 or later: {
CROWD_INSTALL}/apache-tomcat/lib/. - Crowd 2.0.1 or earlier: {
CROWD_INSTALL}/apache-tomcat/common/lib/.
- Crowd 2.0.2 or later: {
- For Crowd WAR distribution, copy the driver JAR to your application server. For example, on Tomcat:
- Tomcat 5.5.x:
common/lib/. - Tomcat 6.x:
lib/.
- Tomcat 5.5.x:
- For Crowd distribution:
Do not place Debug Driver on CLASSPATH
Do not place the Debug Driver (mysql-connector-java-5.x.x-bin-g.jar) on the CLASSPATH as this can cause issues. See (JRA-8674).
Next Steps
Complete the Crowd installation, then start Crowd and run the Setup Wizard as described in the Installation Guide.