SQL-Server-Datenbank konfigurieren

Konfigurieren Sie eine SQL-Server-Datenbank für die Verwendung mit Jazz Team Server, Change and Configuration Management und Quality Management.

Für diese Prozedur müssen die folgenden Vorbedingungen für SQL Server erfüllt sein:

Datenbank konfigurieren

Konfigurieren Sie die SQL-Server-Datenbank mithilfe des Befehlszeilentools sqlcmd, das mit der Installation von SQL Server bereitgestellt wird.
sqlcmd für Microsoft SQL Server 2008 Express Edition aktivieren:
  1. Suchen Sie im Startmenü den Eintrag für Microsoft SQL Server 2008 und klicken Sie auf Konfigurationstools > SQL-Server-Konfigurations-Manager.
  2. Klicken Sie im linken Bereich des Fensters 'SQL-Server-Konfigurations-Manager' auf SQL-Server-Netzwerkkonfiguration > Protokolle für SQLEXPRESS.
  3. Klicken Sie doppelt auf das Protokoll Named Pipes.
  4. Wählen Sie im Dialogfenster 'Eigenschaften für Named Pipes' für das Feld Aktiviert die Option Ja aus.
  5. Setzen Sie das Feld Pipename auf folgenden Wert: \\.\pipe\sql\query.
  6. Klicken Sie auf Anwenden. Führen Sie dann einen Neustart der SQL-Server-Dienste durch.
Sie können auch ein grafisch orientiertes Tool nutzen, z. B. SQL Server Studio Management, das für die Express-Version auch als SQL Server Studio Management Express verfügbar ist. Weitere Informationen hierzu finden Sie in der Dokumentation zu SQL Server oder erhalten Sie von einem SQL-Server-Datenbankadministrator (DBA).
Wichtig: Falls Sie Jazz Team Server mit der Anwendung Change and Configuration Management oder Quality Management auf demselben Computer oder auf verteilten Plattformen installieren, muss eine separate Datenbank erstellt und dieser ein Datenbankbenutzer zugewiesen werden.
  1. Erstellen sie für jede Instanz von Change and Configuration Management, Quality Management, Jazz Team Server und Data Warehouse eine Datenbank. Verwenden Sie das folgende Beispiel. Ersetzen Sie dabei jts durch Ihren Datenbanknamen:
    Anmerkung: Die Anwendung Requirements Management verwendet dieselbe Datenbank wie Jazz Team Server.
    CREATE DATABASE jts 
    GO 
  2. Erstellen Sie einen Benutzer und ein Kennwort und ändern Sie das Eigentumsrecht für die Datenbank. Führen Sie dazu die folgenden Befehle aus:
    CREATE LOGIN jtsDBuser
    WITH PASSWORD = 'jtsDBpswd';
    USE jts;
    exec sp_changedbowner 'jtsDBuser'
    GO 
  3. Ändern Sie die Sortierung der Datenbank von Jazz Team Server. Geben Sie im Befehlszeilentool Folgendes ein:
    ALTER DATABASE jts COLLATE SQL_Latin1_General_CP437_CS_AS 
    GO
  4. Ändern Sie das Zeilenversionssystem für die Datenbank. Führen Sie mit dem Befehlszeilentool den folgenden Befehl aus:
    Anmerkung: Stellen Sie vor dem Ausführen des Befehls sicher, dass die Verbindung zur Datenbank offen ist.
    ALTER DATABASE jts SET READ_COMMITTED_SNAPSHOT ON
    GO
  5. Ändern Sie die Sortierung der Data-Warehouse-Datenbank. Geben Sie Folgendes in der Befehlszeile ein:
    ALTER DATABASE dw COLLATE SQL_Latin1_General_CP1_CS_AS
    GO
  6. Erstellen Sie eine Umgebungsvariable mit dem Namen SQLSERVER_JDBC_DRIVER_FILE, die auf den JDBC-Treiber sqljdbc4.jar zeigt. Die Position des Treibers ist je nach Installation verschieden.
    For Windows operating system
    1. Klicken Sie auf Start > Systemsteuerung > System.
    2. Klicken Sie auf das Register Erweitert und dann auf Umgebungsvariablen.
    3. Klicken Sie in der Liste Systemvariablen auf Neu.
    4. Geben Sie im Feld Name der Variablen SQLSERVER_JDBC_DRIVER_FILE ein und im Feld Wert der Variablen C:\Pfad_zum_JDBC-Treiber\sqljdbc4.jar.

    For Unix operating systems
    1. Fügen Sie auf UNIX-Systemen die folgende Umgebungsvariablendeklaration hinzu:
      SQLSERVER_JDBC_DRIVER_FILE =.;Pfad_zum_JDBC-Treiber/sqljdbc4.jar
    Anmerkung: Die Rational-Lösung für CLM 4.0 bietet keine Unterstützung mehr für JRE 5.0. Unterstützt werden die Versionen JRE 6.0 und 7.0. Die Klassenbibliothek sqljdbc.jar erfordert JRE 5.0 und die Klassenbibliothek sqljdbc4.jar erfordert JRE 6.0 oder eine aktuellere JRE. Sie müssen sqljdbc4.jar verwenden.

    Wenn Sie WebSphere Application Server verwenden, müssen Sie außerdem eine angepasste Eigenschaft hinzufügen, die auf den JDBC-Treiber sqljdbc4.jar zeigt. Weitere Informationen finden Sie im Artikel WebSphere Application Server konfigurieren.

  7. Führen Sie einen der folgenden Schritte aus, um Ihre Datenbankverbindungen zu konfigurieren und Datenbanktabellen zu erstellen:
    1. Wenn Sie den Tomcat-Server verwenden, starten Sie ihn und fahren Sie mit den Informationen im Artikel Setup-Assistenten ausführen (angepasstes Setup) fort.
    2. Falls Sie WebSphere Application Server implementieren, lesen Sie den Artikel WebSphere Application Server implementieren und starten. Fahren Sie dann mit den Informationen im Artikel Setup-Assistenten ausführen (angepasstes Setup) fort.
    3. Wenn Sie Datei teamserver.properties lieber manuell für die Datenbankverbindung modifizieren und die Datenbanktabellen mit den repotools-Befehlen erstellen möchten, lesen Sie den Artikel SQL-Server-Datenbank manuell konfigurieren.
    4. Falls Sie ein Upgrade für eine Vorversion durchführen, verwenden Sie weiter die entsprechenden Upgrade-Scripts, um Ihre vorhandenen Datenbankverbindungen zu migrieren. Die Daten für die Verbindung zwischen dem Data Warehouse und der Datenbank können Sie modifizieren, während Sie den Server nach dem Upgrade konfigurieren.

Fehlerbehebung

Wenn der repotools-Befehl nicht funktioniert, überprüfen Sie die entsprechenden Protokolldateien im Verzeichnis Jazz-Installationsverzeichnis/server.

Überprüfen Sie außerdem, ob folgende Bedingungen erfüllt sind:

Anmerkung: Der Datenbankcode für Jazz Team Server ist generisch und als Standardcode konzipiert, sodass er auf mehreren Datenbankplattformen ausgeführt werden kann. Bei den Unternehmensdatenbanken gibt es jedoch Unterschiede hinsichtlich Syntax, Optimierungsstrategien und Sperrensemantik. Der Server wurde mit einer Kombination aus automatisierten Tests, Simulationen einer normalen Auslastung und Belastungstests für SQL Server getestet. Bei der Simulationen einer normalen Auslastung wurde eine akzeptable Leistung erzielt. In einigen Fällen wurden bei automatisierten Tests Datenbank-Deadlocks festgestellt, die auf anderer Serverhardware jedoch nicht konsistent reproduziert werden konnten.

Der Server ist für die Handhabung einer großen Anzahl simultaner Anforderungen ausgelegt. In Ausnahmefällen können Deadlocks in der Repository-Datenbank auftreten, wenn ähnliche oder gleiche Objekte gleichzeitig in Transaktionen, die den Anforderungen zugeordnet sind, aktualisiert werden. Hierbei handelt es sich um seltene, aber normale Ereignisse. Das System ist so konzipiert, dass Deadlocks aufgefangen werden können und die Datenintegrität erhalten bleibt. Es kommt somit nicht zu einem Datenverlust. Gelegentlich werden Deadlocks durch Aufgaben wie die Ausführung einer Build-Steuerkomponente protokolliert. Normalerweise wird die Bedingung festgestellt und die Ausführung der Aufgabe erneut versucht. Ein Deadlock kann das Fehlschlagen des Builds zur Folge haben. In sehr seltenen Fällen kann eine Benutzeraktion gestoppt werden, z. B. die Arbeit mit Arbeitselementen oder Quellcode, um ein Deadlock zu beseitigen. In einem solchen Fall schlägt die Benutzeraktion fehl und eine Fehlernachricht mit den Details zum Deadlock wird angezeigt. Der Benutzer kann die Aktion dann wiederholen.

Alle Deadlocks werden auf dem Server protokolliert, um Informationen über die Ereignisse vor dem Auftreten des Deadlocks bereitzustellen. Der Text eines Protokolleintrags sieht ungefähr wie folgt aus: com.ibm.team.repository.common.RetryableDatabaseException: Serialization failure.

Wenn auf Ihrem System Deadlocks auftreten, überprüfen Sie das Fehlerprotokoll, das unter https://servername:9443/jts/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog zur Verfügung steht.

Sollte es häufiger zu Deadlocks kommen, setzen Sie sich mit Ihrer Produktunterstützung in Verbindung oder sehen Sie sich die neuesten Informationen, Updates oder Migrationsverfahren in den Foren von 'jazz.net' an.


Feedback