Versionshinweise zu TeamAnalytics 2008,
Version 1.0
8. September 2008

Diese Datei enthält wichtige Informationen, die möglicherweise nicht in der Online-Hilfe enthalten sind. Wir empfehlen Ihnen, diese Datei vollständig durchzulesen.

Systemvoraussetzungen

Die folgenden Systemvoraussetzungen müssen für die Installation und Ausführung von TeamAnalytics erfüllt werden.

Bekannte Probleme

Die folgenden Probleme können in TeamAnalytics auftreten.

Temporäre Tablespace-Größen bei Erstausführungen

• Borland empfiehlt die folgenden temporären Tablespace-Mindestgrößen bei Erstausführungen für PRE-, STG- und RPT-Benutzer:

  Anzahl der Zeilen in den größten Quelltabellen	Größe der potenziellen Datenübertragungen	Empfohlene temporäre Tablespace-Mindestgröße
  Weniger als 1 Million	Klein	3 GB
  Zwischen 1 Million und 5 Millionen	Mittel	6 GB
  Mehr als 5 Millionen	Groß	12 GB

  Der Tablespace kann nach der Erstausführung neu zugewiesen, freigegeben oder gelöscht werden.

StarTeam und Caliber

• In StarTeam- und Caliber-Ladejobs werden entfernte Objekte bei Container-Artefakt- und ArtifactVersion-Beziehungen nicht erfasst.
• In Caliber-Ladejobs werden entfernte Objekte bei Baseline-Artefakt- und ArtifactVersion-Beziehungen nicht erfasst.
• Der Datenfluss DF_Caliber_Parent_Child_Requirements ist bei großen Datenmengen nicht konsistent.
• Der Löschvorgang in StarTeam kann zu einem Datenverlust führen. Führen Sie vor dem Löschen in StarTeam unbedingt zunächst einen Data Warehouse-Ladejob durch, und setzen Sie auf keinen Fall den Server zwischen diesen beiden Operationen zurück. Andernfalls kann es zu einem Datenverlust im Data Warehouse kommen.
• Wenn Sie mit dem Befehl biadmin ein Verbindungsprofil für Caliber erstellen, müssen Sie den Caliber-Port (Standardeinstellung 20000) eingeben, um die ALM-Projektberichtserstellung zu aktivieren.
  

Benutzerdefinierte Attribute (UDAs)

• Sie können keine UDAs mit identischen Namen laden, wenn diese unterschiedliche Datentypen aufweisen und von verschiedenen Instanzen stammen.

IP-Adressen in Profilen

• Verwenden Sie beim Erstellen oder Ändern von Profilen mit dem Tool biadmin immer Hostnamen statt IP-Adressen, besonders beim Erstellen von Caliber-Profilen. Daher sollten auf keinen Fall IP-Adressen als Parameter für die Optionen biadmin -H und –s angegeben werden. Im folgenden Beispiel, das einen Server mit der IP-Adresse "168.0.1.255" und dem Hostnamen usaus-cal1 voraussetzt, wird der Befehl falsch eingegeben:
  
  C:\borland\almservices\bin\biadmin –c myCaliber –R CAL –T Versant –V 7.0 –H 168.0.1.255 –P 20000 –s 168.0.1.255 –n SQMDB –u admin –p admin
  
  Der Befehl muss stattdessen wie folgt eingegeben werden:
  
  C:\borland\almservices\bin\biadmin –c myCaliber –R CAL –T Versant –V 7.0 –H usaus-cal1 –P 20000 –s usaus-cal1 –n SQMDB –u admin –p admin
  
  Wenn die IP-Adresse verwendet wird, funktioniert zwar der Befehl biadmin, jedoch schlagen die Caliber-Jobs immer fehl. Das Dienstprogramm Versant VXML, mit dem die Daten aus der Caliber-Datenbank in XML-Dateien extrahiert werden, benötigt den Hostnamen in der DBID. Wenn die IP-Adresse verwendet wird, werden nur leere VXML-Dateien erzeugt, und der Caliber-Pre-Staging-Ladejob schlägt fehl.

Verwenden von biadmin und UDA-Anwendungen mit SQL Server

• Die SQL-Browserkomponente für SQL Server muss ausgeführt werden, damit Sie biadmin und UDA-Anwendungen verwenden können.

Erste Ausführung des Aggregationsprozesses

• Bevor Sie den Aggregationsprozess (AGG) zum ersten Mal ausführen, sollten Sie die Bitmap-Indizes deaktivieren, um die Prozessleistung zu erhöhen. Führen Sie dazu die folgenden Schritte durch:
  1. Melden Sie sich in Oracle als RPT-Schemaeigentümer an.
  2. Führen Sie das folgende Skript aus:
     begin
        rpt_performance_utils.alm_alter_index(p_method => 'DISABLE',p_table => 'CHANGEREQUESTDAILYAGG_FACT');
        rpt_performance_utils.alm_alter_index(p_method => 'DISABLE',p_table => 'CHANGEREQUESTDAILY_FACT');
        rpt_performance_utils.alm_alter_index(p_method => 'DISABLE',p_table => 'REQUIREMENTDAILY_FACT');
        rpt_performance_utils.alm_alter_index(p_method => 'DISABLE',p_table => 'REQUIREMENTDAILYAGG_FACT');
        rpt_performance_utils.alm_alter_index(p_method => 'DISABLE',p_table => 'FILEAGG_FACT');
     end;
     /
  3. Führen Sie den folgenden Befehl aus:
     biadmin -r agg
  4. Führen Sie nach Abschluss der Aggregation das folgende Skript aus, um die Indizes wieder zu aktivieren:
     begin
        rpt_performance_utils.alm_alter_index(p_method => 'DISABLE',p_table => 'CHANGEREQUESTDAILYAGG_FACT');
        rpt_performance_utils.alm_alter_index(p_method => 'DISABLE',p_table => 'CHANGEREQUESTDAILY_FACT');
        rpt_performance_utils.alm_alter_index(p_method => 'DISABLE',p_table => 'REQUIREMENTDAILY_FACT');
        rpt_performance_utils.alm_alter_index(p_method => 'DISABLE',p_table => 'REQUIREMENTDAILYAGG_FACT');
        rpt_performance_utils.alm_alter_index(p_method => 'DISABLE',p_table => 'FILEAGG_FACT');
     end;
     /
     HINWEIS: Bei großen Datenmengen können die erneute Aktivierung der Indizes und die Statistikerfassung lange dauern.

Änderungen in der Dokumentation

Die Dokumentation zu TeamAnalytics enthält die folgenden Fehler.

Installation und Einrichtung, Kapitel 1: Einführung in TeamAnalytics

• Im Abschnitt "Standardberichte" kann die Tabelle mit den Berichtsnamen und Details ignoriert werden. Schlagen Sie in der Hilfe zu Borland TeamAnalytics-Berichten nach.
• Fügen Sie im Abschnitt "ETL-Jobs" die folgenden ETL-Jobs zur Tabelle hinzu:

  Jobname	Quelle	Ziel
  AFS	ALM-Framework-Dienstquelle	Staging-Datenbankschema
  BMS	BMS- oder Tempo-Datenquelle	Staging-Datenbankschema
  SC	Silk Central-Datenquelle	Staging-Datenbankschema

Installation und Einrichtung, Kapitel 4: Einrichten von TeamAnalytics

• Entfernen Sie im Abschnitt "Bearbeiten der Eigenschaftsdatei von TeamAnalytics" das Beispiel SET BIADMIN_DIR=.
• Entfernen Sie im Abschnitt "Erstellen eines StarTeam-Verbindungsprofils" bei der Option --dbversion den möglichen Wert 2006.
• Fügen Sie im Abschnitt "Manuelles Erstellen des lokalen Repository und eines Benutzerkontos" den folgenden Abschnitt aus der Einführung zu Data Integrator vor Schritt 1 ein:
  

  Oracle

  Für ein lokales oder zentrales Data Integrator-Repository müssen Sie eine dedizierte Datenbank erstellen und einen Benutzer mit Berechtigungen für folgende Aufgaben definieren:

  • Erstellen einer Tabelle

  • Starten einer Sitzung

  • Erstellen einer Sequenz

  Weisen Sie dem Benutzer die Rollen connect und resource zu. Bei Oracle 10G/R2 kann auch die Rolle create view zugewiesen werden.

  Erforderliche Daten

  Installieren Sie die Oracle-Clientsoftware, und überprüfen Sie mit SQL*Plus die Verbindung zwischen dem lokalen Computer und dem Data Integrator-Repository.

  Name des Datenbankservers:_________________________________

  Datenbankname:_______________________________________

  Windows-Authentifizierung oder Benutzername/Passwort:_____________

  Name der Datenbankverbindung:______________________________

  Benutzername/Passwort:___________________________________

  Hinweis: Wenn Sie Multi-Byte-Zeichen in einem Data Integrator-Repository in einer Oracle-Datenbank speichern möchten, müssen Sie den Zeichensatz der Oracle-Datenbank in eine Codeseite ändern, die Sprachen mit Multi-Byte-Zeichen unterstützt. Andernfalls können die Metadaten beschädigt werden. Um beispielsweise japanische Zeichen zu speichern, ändern Sie den Zeichensatz der Oracle-Datenbank in SHIFT_JIS oder UTF8. Weitere Informationen finden Sie im Referenzhandbuch zu Data Integrator im Kapitel über Gebietseinstellungen und Multi-Byte-Zeichen.

• Entfernen Sie im Abschnitt "Manuelles Erstellen der Datenbankschemata von TeamAnalytics" den Absatz "Erstellen des Reporting-Datenbankschemas" aus Schritt 5.

Installation und Einrichtung, Kapitel 6: Anzeigen von Standardberichten

• Im Abschnitt "Anzeigen eines Standardberichts" gilt Schritt 1 nicht mehr. Sie müssen die Standardberichte über die BMS-Benutzeroberfläche anzeigen.
  

Installation und Einrichtung, Anhang A: Verzeichnisstruktur und -inhalt von TeamAnalytics

• Das Verzeichnis "Report Designer" wurde entfernt.
  

Installation und Einrichtung, Anhang B: Installationsformulare

• Im Abschnitt "Formular für globale Servereigenschaften" muss der Beispielwerte in Zeile 1 mydbserver lauten.
• Im Abschnitt "Formular für Eigenschaftsdatei" sind jetzt die globalen Pfade in den Zeilen 1 und 2 in der Datei DBA_VARS.bat vordefiniert und müssen nicht vom Benutzer ausgefüllt werden.
• Im Abschnitt "Formular für Eigenschaftsdatei" müssen die Beispielwerte in den Zeilen 14, 25, 36 und 45 mydbserver lauten.
• Im Abschnitt "Formular für Eigenschaftsdatei" muss der Beispielwert in Zeile 10 (BODI-Installationsverzeichnis) angegeben werden.

Installation und Einrichtung, Anhang C: CLI-Befehle

• Im Abschnitt "Verbindungsprofil erstellen" wurden die Optionen -I, T und F für --password entfernt.
• Im Abschnitt "Parameter anzeigen" fehlt in der Syntax die Option [--propertiesx].
• Im Abschnitt "Verbindungsprofil bearbeiten" wurden die Optionen --dbtype und --dbversion entfernt.

Einschränkungen

Die folgenden Einschränkungen sind in TeamAnalytics zu beachten.

• Verfolgbarkeitsanforderungen in Caliber werden in dieser Version nicht unterstützt.
• Generische PPM-Prozesse sind in dieser Version nicht verfügbar.
• HP Quality Center™ wird in dieser Version nicht unterstützt.
• Diese Version von TeamAnalytics wird nicht Beispieldaten ausgeliefert.
• Wenn dieselben Daten von mehreren Systemen abgerufen werden, wird für jede Datenquelle eine separate Instanz erstellt.

Installationsanweisungen

Um TeamAnalytics mit Borland Management Suite (BMS) zu verwenden, führen Sie die folgenden Schritte durch:

1. Installieren und konfigurieren Sie TeamAnalytics entsprechend den Anleitungen im Handbuch TeamAnalyics 2008 – Installation und Einrichtung.
2. Erstellen Sie ggf. ein StarTeam- oder Caliber-Profil, und führen Sie den StarTeam- oder Caliber-Job aus, um die richtige Installation und Konfiguration von TeamAnalytics sicherzustellen.
3. Konfigurieren Sie BMS für die Verwendung einer Oracle- oder einer MS SQL-Datenbank. MySQL und DB2 werden nicht unterstützt.
   Weitere Informationen finden Sie im Abschnitt "Übersicht über Datenbankeinstellungen" des Installationshandbuchs zur Borland Management Suite.
4. Geben Sie in die Wertespalte der folgenden Tabelle für die BMS-Datenbankverbindung die entsprechenden Informationen ein. Die Werte müssen mit den Verbindungsinformationen für die BMS-Datenbank übereinstimmen.

   Name	biadmin-Parameter	Beschreibung	Wert
   DBMS-Typ	-T	Der Datenbanktyp	Der Wert muss entweder Oracle oder Microsoft_SQL_Server lauten.
   DBMS-Version	-V	Die Datenbankversion	Der Wert muss entweder 10g für Oracle oder 2005 für MS SQL Server lauten.
   Hostname	-H	Das System mit der BMS-Datenbankinstanz
   Port	-P	Die Portnummer für die Datenbankverbindung
   Servername	-s	Der Servername	Für Oracle muss der TNS-Name und für MS SQL Server der Servername angegeben werden.
   Datenbankname	-n	Der Datenbankname (nur MS SQL Server)
   Benutzer-ID	-u	Der Anmeldename für die BMS-Datenbank
   Passwort	-p	Das Passwort für die BMS-Datenbank

5. Wechseln Sie zum Verzeichnis c:\borland\almservices\teamanalytics\etl\data\Tempo\BMS.
   HINWEIS: Führen Sie die Skripts nur aus, wenn sich keine aktiven Benutzer im BMS-System befinden. In diesen Skripts werden die DBMS SQL-Befehlszeilenprogramme SQL*Plus (Oracle) und sqlcmd (MS SQL Server) aufgerufen. Daher müssen diese SQL-Programme auf dem betreffenden System installiert sein. Sind die Programme auf dem Server nicht vorhanden, auf dem Sie TeamAnalytics installiert haben, kopieren Sie die Skripts dorthin und führen sie dort aus.
6. Wechseln Sie in das Oracle- bzw. MSSQL-Verzeichnis.
7. Führen Sie das Skript prepBMS.cmd aus.
   • Übergeben Sie bei einer Oracle-Datenbank den Servernamen, die Benutzer-ID und das Passwort als Parameter (siehe Schritt 4).
   • Übergeben Sie bei einer MS SQL-Datenbank den Servernamen, den Datenbanknamen, die Benutzer-ID und das Passwort als Parameter (siehe Schritt 4).
8. Führen Sie die folgenden Abfragen aus, um die Konfiguration zu überprüfen:
   • select count(*) from T_Project
   • select count(*) from T_Project_Change
   Beide Abfragen müssen ohne Fehler ausgeführt werden und dasselbe Ergebnis zurückgeben.
9. Wechseln Sie im Installationsverzeichnis von TeamAnalytics (normalerweise c:\borland\almservices) zum Verzeichnis bin.
10. Bearbeiten Sie die Skriptdatei SRC_VARS.cmd so, dass die Parameter für BMS mit den Werten in Schritt 4 übereinstimmen.
11. Führen Sie das Skript createBMS.cmd aus, um das BMS-Profil in TeamAnalytics zu erstellen.
12. Führen Sie das Skript runBMS.cmd aus, um die Quelle-Staging-Extrahierung für BMS zu starten.