Crowd Dokumentation - Oracle für CrowdID

Befolgen Sie diese Schritte, um CrowdID mit Oracle zu verbinden.

1. Konfiguration von Oracle

1. Erstellen Sie einen Datenbankbenutzer, mit dem CrowdID sich verbinden wird (z. B. crowduser).
2. Erstellen Sie eine Datenbank für CrowdID, in der die Daten gespeichert werden (z. B. crowdiddb).
   Diese Datenbank muss eine andere sein als die, die von Crowd verwendet wird.
3. Stellen Sie sicher, dass der Benutzer die Berechtigungen hat sich mit der Datenbank zu verbinden und Tabellen zu erstellen und zu pflegen.

2. Kopieren Sie den Oracle Treiber in Ihren Applikationsserver

1. Laden Sie den Oracle JDBC Treiber herunter.
2. Fügen Sie die Oracle JDBC Treiber JAR-Datei in das folgende 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 mit Oracle

1. Editieren Sie die apache-tomcat-X.X.XX/conf/Catalina/localhost/openidserver.xml Datei und passen Sie die Parameter username, password, driverClassName und url 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="oracle.jdbc.driver.OracleDriver"
   url="jdbc:oracle:thin:@localhost:1521: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 bloß die Performance verschlechtern).

4. Konfigurieren Sie CrowdID für die Verwendung von Oracle

1. Editieren Sie die build.properties Datei (diese liegt im Root des Crowd Releases, nicht Crowd EAR-WAR) und passen Sie hibernate.dialect folgendermaßen an:

   hibernate.dialect=org.hibernate.dialect.Oracle10gDialect

2. Führen Sie dann ./build.sh oder build.bat aus. Dies konfiguriert CrowdID für die Verwendung des Oracle Dialekts.
   Es gibt ein Problem mit build.bat in der Crowd-Version 1.2.0. Um dieses Problem zu beheben, wenden Sie bitte den Patch, der in CWD-638 beschrieben ist, an.

Wenn Sie nicht diese Datei bearbeiten und das Build-Skript ausführen möchten, können Sie direkt die jdbc.properties Datei (diese wird vom obigen Skript modifiziert). 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.OracleDialect
hibernate.transaction.factory_class=org.hibernate.transaction.JDBCTransactionFactory

...

Nächste Schritte

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