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 MS SQL Server for Crowd.
1. Configure SQL Server
Create a database user which Crowd will connect as (e.g. crowduser).
- Create a database for Crowd to store data in (e.g. crowddb).
- Ensure that the user has permission to connect to the database, and create and populate tables
Ensure that the new database was set to use Read Committed with Row Versioning as its isolation level.
You can apply the new isolation by executing the following query:ALTER DATABASE <database name> SET READ_COMMITTED_SNAPSHOT ON WITH ROLLBACK IMMEDIATE;
To verify the changes, use this query which should result in '1':
SELECT sd.is_read_committed_snapshot_on FROM sys.databases AS sd WHERE sd.[name] = '<database name>';
2. Copy the SQL Server Driver to your Application Server
Download the SQL Server JDBC driver from JTDS (recommended), or I-net software(commercial).
- Add the SQL Server JDBC driver JAR (
jtds-[version].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:
Next Steps
Complete the Crowd installation, then start Crowd and run the Setup Wizard as described in the Installation Guide.