Schemata und XEngines migrieren

Während eines Tricentis Tosca-Versionswechsels gibt es zwei Arten von Migrationen:

  • Eine Schema-Migration aktualisiert Ihr Repository-Datenbankschema auf die neueste Version.

  • Eine XEngine-Migration aktualisiert bestehende Module der Standard-Untermenge und ihre verbundenen Testfälle auf die neueste Version.

Möglicherweise benötigen Sie nicht jedes Mal, wenn Sie einen Versionswechsel von Tricentis Tosca durchführen, beide Arten der Migration.

Bevor Sie beginnen

Sie können Migrationen manuell oder, wenn Sie die Tosca Administration Console verwenden, direkt in der Konsole durchführen.

Die Tosca Administration Console ist jedoch Teil des Tosca Server. Wenn Sie über die Konsole migrieren möchten, müssen Sie zunächst einige Vorbereitungsschritte durchführen:

Weitere Punkte, die Sie beachten müssen:

  • Migrationen werden auf der Repository-Version aller Objekte ausgeführt. Stellen Sie sicher, dass alle Benutzer ihre lokalen Änderungen eingecheckt haben, bevor Sie migrieren. Wenn Sie Objekte migrieren, die von anderen Benutzern ausgecheckt wurden, gehen alle lokalen Änderungen verloren.

  • Migrierte Schemata, Module und Testfälle sind nicht abwärtskompatibel. Sie können eine Migration nicht rückgängig machen. Wenn Sie migrieren und plötzlich feststellen, dass Sie zu Ihrem früheren Schema zurückkehren müssen, müssen Sie Ihre Sicherung wiederherstellen.

Schema-Migrationen durchführen

Tosca speichert Projektdaten in einer Datenbank, die als Ihr Repository dient. Diese Datenbank hat eine bestimmte Datenstruktur oder ein bestimmtes „Schema“. Wenn sich das Schema zwischen Tosca-Versionen ändert, müssen Sie migrieren.

Finden Sie heraus, ob Sie eine Migration benötigen

In einer Singleuser-Umgebung müssen Sie keine Schema-Migrationen durchführen. Tosca migriert automatisch, wenn Sie den Arbeitsbereich nach dem Versionswechsel zum ersten Mal öffnen.

In einer Multiuser-Umgebung müssen Sie möglicherweise Schema-Migrationen durchführen. So finden Sie heraus, ob dies der Fall ist:

  • Wenn Sie die Tosca Administration Console verwenden, überprüfen Sie die Version des Projekts in der Projects Overview. Wenn Sie ein sehen, hat das Projekt ein veraltetes Schema. Die Schema version in der Kopfzeile zeigt das Schema der neuesten Tosca-Version, die Sie installiert haben. Das ist das Schema, zu dem Sie migrieren müssen.

  • Wenn Sie die Tosca Administration Console nicht verwenden, überprüfen Sie die Schemaversionstabelle. Vergleichen Sie das Schema Ihrer vorherigen Tosca-Version mit der Version, auf die Sie umsteigen. Wenn es einen Unterschied gibt, müssen Sie migrieren.

Schema-Migration auslösen

Wie Sie die Schema-Migration auslösen, hängt davon ab, ob Sie die Tosca Administration Console verwenden oder nicht.

Wenn Sie die Konsole verwenden, können Sie die Schema-Migration direkt in der Konsole auslösen. Detaillierte Anweisungen dazu finden Sie hier: "Projekte mit der Tosca Administration Console migrieren".

Wenn Sie die Konsole nicht verwenden, müssen Sie Ihr Schema manuell migrieren.

Bevor Sie beginnen, berücksichtigen Sie Folgendes:

  • Stellen Sie sicher, dass Sie über einen Datenbankbenutzer mit allen erforderlichen Rechten verfügen. Um zu migrieren, benötigen Sie eine Verbindungszeichenfolge zu Ihrer Repository-Datenbank. Der Benutzer in dieser Verbindungszeichenfolge muss über ALTER-, CREATE- und DELETE-Rechte verfügen, um Tabellen zu erstellen, Indizes zu löschen und neue Indizes zu erstellen.

  • Stellen Sie sicher, dass Sie die Datenbankmigration zuerst mit einer Testdatenbank testen. Migrieren Sie Ihre produktive Datenbank nur, wenn Sie Ihre Testdatenbank erfolgreich migriert haben. Wir empfehlen Ihnen, eine Testumgebung zu erstellen und Probedurchläufe Ihrer wichtigsten Testfälle durchzuführen, um sicherzustellen, dass die Testmigration erfolgreich war.

Um ein Schema zu migrieren, führen Sie diese Schritte aus:

  1. Erstellen Sie eine Sicherung Ihrer Datenbank. Wenn die Migration fehlschlägt, müssen Sie die Sicherung laden, bevor Sie einen weiteren Migrationsversuch durchführen können.

  2. Gehen Sie zu %COMMANDER_HOME%.

  3. Öffnen Sie das Fenster der Eingabeaufforderung und führen Sie den folgenden Befehl aus:

    DbRepositorySchemaMigrator.exe "<Datenbanktyp>" "[Schemaname]" "[Tablespace-Name]" "<Verbindungszeichenfolge>"

    • Ersetzen Sie <Datenbanktyp> durch den Datenbanktyp Ihres Repository: Oracle, MS SQL Server, DB2 oder SQLite.

    • Ersetzen Sie wahlweise [Schemaname] durch den Namen des Datenbankschemas.

    • Ersetzen Sie wahlweise [Tablespace-Name] durch den Tablespace-Namen Ihrer Datenbank. Die Bezeichnung des Tablespace hängt davon ab, welche Datenbank Sie verwenden: Tablespace (DB2), Userspace (Oracle), FileGroup (MS SQL).

    • Ersetzen Sie <Verbindungszeichenfolge> durch eine Verbindungszeichenfolge, mit der eine Verbindung zu Ihrer Repository-Datenbank hergestellt wird. Geben Sie für SQLite-Repositorys den absoluten Pfad zur Datei CommonRepository.db ein.

    • Fügen Sie wahlweise -s am Ende Ihres Befehls hinzu. Dies ermöglicht es Ihnen, die Migration im Silent-Modus ohne Benutzerinteraktion durchzuführen.

Hier sind zwei Beispiele für Migrationsbefehle.

  • Dieser Befehl migriert das Schema Ihrer SQLite-Repository-Datenbank:

    DbRepositorySchemaMigrator.exe "SQLite" "C:\Tosca_Projects\Tosca_CommonRepositories\GUItests\CommonRepository\CommonRepository.db"

  • Dieser Befehl migriert das Schema Ihrer DB2-Datenbank im Silent-Modus. Der Schemaname lautet my_common_schema:

    DbRepositorySchemaMigrator.exe "DB2" "my_common_schema" "Server=111.111.111.111:5050;Database=myDataBase;UID=myUsername;PWD=myPassword;" -s

Sobald dies abgeschlossen ist, zeigt DbRepositorySchemaMigrator.exe eine Nachricht an, die angibt, ob die Migration erfolgreich war oder nicht. Detaillierte Migrationsergebnisse finden Sie in der Log-Datei SchemaMigration_<Dateiname>.txt, die sich unter %APPDATA%\TRICENTIS\TOSCA TestSuite\7.0.0\Temp\TCTempLog befindet.

Sie können jetzt in Tosca Ihre Multiuser-Arbeitsbereiche öffnen. Tosca migriert Arbeitsbereiche, wenn Sie sie zum ersten Mal nach der Schema-Migration öffnen.

XEngine-Migrationen durchführen

Eine XEngine-Migration aktualisiert bestehende Module der Standard-Untermenge und ihre verbundenen Testfälle auf die neueste von Ihnen installierte Version von Tosca.

Beachten Sie Folgendes:

  • Eine Tosca-Version hat möglicherweise geänderte Module, benötigt aber trotzdem keine Migration. Nicht jede Änderung an einem Modul in der Standard-Untermenge erfordert eine XEngine-Migration.

  • Eine Migration importiert nicht automatisch neue Module, die wir der Standard-Untermenge der neuen Version hinzugefügt haben. Um Zugriff auf diese neuen Module zu erhalten, müssen Sie die neue Standard-Untermenge importieren.

Finden Sie heraus, ob Sie eine Migration benötigen

Die Tabelle in diesem Abschnitt zeigt Ihnen, welche Versionen von Tosca Änderungen enthalten, die eine Migration erfordern.

Selbst wenn eine Version diese Änderungen aufweist, müssen Sie möglicherweise trotzdem keine XEngine-Migration durchführen,

Tosca-Version

Änderungen, die eine XEngine-Migration erfordern

2023.2 LTS

Keine.

2023.1 LTS

Keine.

16.0 LTS

Keine.

15.2 LTS

Keine.

15.1 STS

Keine.

15.0 LTS

Keine.

14.3 STS

  • Excel 1:1 File Compare-Modul: Wert von Modulattribut Include Sheets auf Zeichenfolge geändert.

14.2 LTS

Keine.

14.0

Keine.

13.4

Keine.

13.3

13.2

13.1

Beachten Sie, dass neue Versionen von Tosca alle Änderungen gegenüber früheren Versionen enthalten. Nehmen wir an, Sie aktualisieren von Tosca 14.2 auf 16.0. 16.0 enthält zwar keine Änderungen, die eine XEngine-Migration erfordern, aber 14.3 enthält welche. Diese Änderungen sind auch in 16.0 enthalten. Wenn Sie das Modul 1:1 File Compare in Ihren Tests ausgiebig verwenden, müssen Sie daher eine Migration durchführen.

XEngine-Migration auslösen

Wie Sie die XEngine-Migration auslösen, hängt davon ab, ob Sie die Tosca Administration Console verwenden oder nicht.

Wenn Sie die Konsole verwenden, können Sie die XEngine-Migration direkt in der Konsole auslösen. Detaillierte Anweisungen dazu finden Sie hier: "Projekte mit der Tosca Administration Console migrieren".

Wenn Sie die Konsole nicht verwenden, müssen Sie manuell migrieren:

  1. Öffnen Sie einen beliebigen Arbeitsbereich, der mit dem Common Repository verbunden ist.

  2. Wenn Sie sich in einer Multiuser-Umgebung befinden, müssen Sie nun das Projektwurzelelement auschecken.

  3. Klicken Sie mit der rechten Maustaste auf das Projektwurzelelement und wählen Sie XEngines Migration->Update project to current version aus dem Kontextmenü.

  4. Wählen Sie im Dialog Backup aus, ob eine Sicherung erstellt werden soll. Wir empfehlen Ihnen, dies zu tun, um ganz sicher zu gehen. Tosca erstellt in diesem Fall eines der folgenden Objekte in %TRICENTIS_ALLUSERS_APPDATA%\Automation\MigrationBackup:

    • Eine .tde-Sicherung für Multiuser-Repositorys.

    • Eine .tsu-Sicherung für Singleuser-Repositorys.

Sobald die Migration abgeschlossen ist, zeigt Tosca einen Migrationsreport an, der angibt, ob die Migration erfolgreich war oder nicht. Wenn Sie den Report versehentlich schließen, finden Sie ihn wieder unter %APPDATA%\Tricentis\TOSCA TestSuite\7.0.0\Logs\Automation\ToscaDIMigration.