Befolgen Sie diesen Schritten, um CrowdID mit einem MS SQL Server zu verbinden.

1. Konfiguration des SQL Servers

1. Erstellen Sie einen Datenbankbenutzer, mit dem sich CrowdID verbinden wird (z. B. crowduser).

   Im SQL Server sollte der Datenbankbenutzer (wie im Beispiel oben crowduser) nicht der Datenbankbesitzer sein, aber in der Rolle db_owner sein.

2. Erstellen Sie eine Datenbank, der CrowdID Daten speichert wird (z. B. crowdiddb).
   Es muss eine andere Datenbank sein als die, die von Crowd verwendet wird.
3. Stellen Sie sicher, dass der Benutzer die Berechtigungen hat eine Verbindung zu der Datenbank herzustellen und Tabellen zu erstellen und zu pflegen.

2. Kopieren Sie den SQL Server Treiber in Ihren Applikationsserver

1. Laden Sie den SQL Server JDBC Treiber von JTDS (laut Beschreibung unten empfohlen) oder I-net Software (kommerziell) herunter.

   Microsoft hat einen eigenen JDBC Treiber, jedoch raten wir von dessen Benutzung ab, weil Jira-Kunden über verschiedene Verbindungsfehler (JRA-5760, [JRA-6872|http://jira.atlassian.com/browse/JRA-6872), Workflow-Probleme (JRA-8443), und Probleme mit Chinesischen Zeichen (JRA-5054) berichteten.

2. Fügen Sie die SQL Server JDBC Treiber JAR-Datei (jtds- [version].jar) zum folgenden Verzeichnis hinzu:
   
   • Bei der Crowd Distribution:
     • Crowd 2.0.2 oder neuer: {CROWD_INSTALL}/apache-tomcat/lib/.
     • Crowd 2.0.1 oder älter: {CROWD_INSTALL}/apache-tomcat/common/lib/.
   • Bei der Crowd WAR Distribution kopieren Sie die Treiber JAR-Datei in Ihren Applikationsserver. Zum Beispiel bei Tomcat:
     • Tomcat 5.5.x: common/lib/.
     • Tomcat 6.x: lib/.

3. Konfigurieren Sie Ihren Applikationsserver für die Verbindung zum SQL Server

1. Editieren Sie die conf/Catalina/localhost/openidserver.xml Datei und passen Sie username, password, driverClassName und urlparameters für die Datenquelle an.

   <Context path="/openidserver" docBase="../../crowd-openidserver-webapp" debug="0">
   
   <Resource name="jdbc/CrowdIDDS" auth="Container" type="javax.sql.DataSource"
   username="[enter db username here]"
   password="[enter db password here]"
   driverClassName="net.sourceforge.jtds.jdbc.Driver"
   url="jdbc:jtds:sqlserver://localhost:1433/crowdiddb"
   [ delete the minEvictableIdleTimeMillis, timeBetweenEvictionRunsMillis and maxActive params here ]
   />
   
   <Manager className="org.apache.catalina.session.PersistentManager" saveOnRestart="false"/>
   
   </Context>

2. Löschen Sie die Attribute minEvictableldleTimeMillis, timeBetweenEvictionRunsMillis und maxActive (diese werden nur für HSQL benötigt und würden nur die Performance verschlechtern).

4. Konfigurieren Sie CrowdID für die Verwendung des MS SQL Servers

1. Editieren Sie die build.properties Datei (liegt im Root der Crowd Distribution, nicht Crowd EAR-War) und passen Sie hibernate.dialect wie folgt an:

   hibernate.dialect=org.hibernate.dialect.SQLServerDialect

2. Führen Sie nun ./build.sh oder build.bat aus. Dies konfiguriert CrowdID für die Verwendung des MS SQL Server Dialekts.

Wenn Sie nicht diese Datei editieren und das Build-Skript ausführen möchten, können Sie direkt die jdbc.properties Datei (welche das obige Skript modifiziert) bearbeiten. Die jdbc.properties Datei liegt hier: crowd-openidserver-webapp\WEB-INF\classes\jdbc.properties. Modifizieren Sie die Datei wie folgt:

# - Crowd Configuration Options

hibernate.connection.datasource=java\:comp/env/jdbc/CrowdIDDS
hibernate.dialect=org.hibernate.dialect.SQLServerDialect
hibernate.transaction.factory_class=org.hibernate.transaction.JDBCTransactionFactory

...

Nächste Schritte

Sie sollten nun einen Applikationsserver für die Verbindung zu einer Datenbank und CrowdID für die Benutzung der korrekten Datenbank konfiguriert haben. Starten Sie nun CrowdID und beobachten Sie die Logs für jegliche Fehlermeldungen.