Migrationsdefinitionen erstellen
Die zu migrierenden Artefakte müssen in einer Migrationsdefinition definiert werden. Beachten Sie Folgendes zu Migrationsdefinitionen:
In Oracle Hyperion Shared Services Console wird eine Migrationsdefinition erstellt, wenn Sie einen Export- oder Importvorgang durchführen.
Wenn Sie Artefakte exportieren, erstellt Oracle Hyperion Enterprise Performance Management System Lifecycle Management zwei XML-Dateien: eine für den Export und eine für den Import. Diese XML-Dateien können für die Migrationsdefinitionsdatei im Lifecycle Management-Utility verwendet werden.
Wenn Sie einen Exportvorgang durchführen, wird die MDF-Datei für diesen Export sowie für den entsprechenden Import automatisch im Dateisystemordner unter dem Root-Ordner erstellt.
XML-Schema für Migrationsdefinitionsdatei
Bei der folgenden Abbildung handelt es sich um eine XML-Schema-Modellstruktur der Migrationsdefinitionsdatei.
Abbildung 7-2 XML-Schema-Modellstruktur der Migrationsdefinitionsdatei
Elemente einer Migrationsdefinitionsdatei
In diesem Abschnitt werden die Elemente und Attribute beschrieben, die im XML-Schema für Migrationsdefinitionsdateien verwendet werden.
Gebietsschema
Definiert das Gebietsschema des Servers zum Zeitpunkt, wenn die Migrationsdefinitionsdatei erstellt wird. Dieses Gebietsschema umfasst alle Fehlermeldungen und Konsolenmeldungen.
Benutzer und Kennwort
Definiert den Benutzernamen und das verschlüsselte Kennwort des Benutzers, der die Migrationsdefinitionsdatei ausführen wird.
Aufgabe
Definiert die Aufgaben, die während der Migration ausgeführt werden müssen. Eine in der Migrationsdefinitionsdatei definierten Aufgabe hängt von der Quelle, dem Ziel und den zu migrierenden Artefakten ab. Jede Aufgabe enthält mindestens Quell-, Ziel- und Artefakt-Tags.
Bei mehreren Quellen und Zielen müssen Sie mindestens eine Aufgabe für jede Kombination aus Quelle und Ziel definieren. Das Extrahieren von Artefakten aus dem Dateisystem können Sie z.B. als Aufgabe 1 definieren, und das Laden der Artefakte aus dem Dateisystem in eine Anwendung als Aufgabe 2.
Hinweis:
Das Utility fährt nach einer nicht erfolgreichen Aufgabe standardmäßig mit der nächsten Aufgabe fort. Die Validierung der Quell- und Zielverbindungen einer Task wird nicht durchgeführt, bevor die Aufgabenausführung gestartet wird, sondern erst, wenn die Task ausgeführt wird.
Die Aufgabe enthält diese Elemente:
Quelle
Definiert die Quelle für die Migration. Sie müssen eine Quelle und ein Ziel pro Aufgabe definieren.
Tabelle 7-1 Quellenattribute
Attribut | Beschreibung |
---|---|
application |
Name, mit dem die Anwendung registriert wird. Der Anwendungsname wird in Shared Services Console angezeigt.
Beispiel: |
filePath |
Verzeichnis, in dem Artefakte im Dateisystem gespeichert werden.
Beispiel: Hinweis: Wenn eine MDF-Datei in der Benutzerschnittstelle generiert wird, ist der Pfad ein relativer Pfad zum Arbeitsordner. Wenn die MDF-Datei nicht im Arbeitsordner vorhanden ist, verwenden Sie das Befehlszeilenargument |
product |
Produktcode für die Anwendung, die in Shared Services registriert ist.
Beispiele:
|
project |
Name der Shared Services-Anwendungsgruppe, zu der die Anwendung gehört. Der Projektname wird in Shared Services Console angezeigt.
Beispiel: |
type |
Verbindungstypen:
|
Ziel
Definiert das Ziel für die Migration. Sie müssen ein Ziel pro Aufgabe definieren.
Tabelle 7-2 Zielattribute
Attribut | Beschreibung |
---|---|
application |
Name, mit dem die Anwendung registriert wird. Der Anwendungsname wird in Shared Services Console angezeigt.
Beispiel: |
filePath |
Verzeichnis, in dem Artefakte im Dateisystem gespeichert werden.
Beispiel: Hinweis: Wenn eine MDF-Datei in der Benutzerschnittstelle generiert wird, ist der Pfad ein relativer Pfad zum Arbeitsordner. Wenn die MDF-Datei nicht im Arbeitsordner vorhanden ist, verwenden Sie das Befehlszeilenargument |
product |
Produktcode für die Anwendung, die in Shared Services registriert ist.
Beispiele:
|
project |
Name der Shared Services-Anwendungsgruppe, zu der die Anwendung gehört. Der Projektname wird in Shared Services Console angezeigt.
Beispiel: |
Artefakt
Für die aktuelle Migration verwendeter Filter.
Tabelle 7-3 Artefaktattribute
Attribut | Beschreibung |
---|---|
parentPath |
Verzeichnis der obersten Ebene, in dem Artefakte oder Daten für die Migration gespeichert werden. Weitere Informationen zu Produktverzeichnisstrukturen finden Sie in den Anhängen am Ende dieser Dokumentation.
Beispiel: Achtung: Wenn das übergeordnete Pfadverzeichnis ein Et-Zeichen (&) enthält, müssen Sie dieses in der Migrationsdefinitionsdatei durch Hinweise: Falls Das Attribut |
pattern |
Artefaktauswahlkriterien
Geben Sie den Namen eines zu importierenden Artefakts an, oder verwenden Sie * (Sternchen), um alle Artefakte zu importieren, die mit den Filterbedingungen übereinstimmen. Beispiel: * Hinweis: Das Attribut |
recursive |
Gibt an, ob die Migration für Artefakte, die in Unterverzeichnissen gespeichert sind, durchgeführt werden muss.
Beispiel: Hinweis: Das Attribut |
Optionen
Optionen sind produktspezifisch. Informationen dazu, welche Import- und Exportoptionen Sie festlegen können, finden Sie in den Anhängen am Ende dieser Dokumentation. Die Quelle bzw. das Ziel interpretiert die Optionen, um zu ermitteln, welche Artefakte migriert werden.
Wenn keine Optionen festgelegt werden, werden die in der Oracle Hyperion Shared Services Registry festgelegten Standardoptionen verwendet.
Tabelle 7-4 Optionsattribute
Attribut | Beschreibung |
---|---|
option |
Name, mit dem der in der Shared Services-Registry definierte Optionsname überschrieben wird.
Beispiel: |
value |
Wert, mit dem der in der Shared Services-Registry definierte Optionswert überschrieben wird.
Beispiel: |
Beispiel für Migrationsdefinitionsdatei
Im Folgenden finden Sie ein Beispiel für eine Migrationsdefinitionsdatei. Jede Änderung an der Struktur oder Syntax führt zu Fehlern während der Migration.
<?xml version="1.0" encoding="UTF-8"?> <Package> <LOCALE>en_US</LOCALE> <User name="admin" password=""/> <Task> <Source type="Application" product="HUB" project="Foundation" application="Shared Services"/> <Target type="FileSystem" filePath="/folder/HUB.Shared Services" /> <Options option="GroupFilter" Value= "*" /> <Artifact recursive="true" parentPath="/Native Directory" pattern="*"/> <Artifact recursive="true" parentPath="/Taskflows" pattern="*"/> </Task> <Task> <Source type="FileSystem" filePath="/folder/HUB.Shared Services" /> <Target type="Application" product="HUB" project="Foundation" application="Shared Services" /> <Artifact recursive="true" parentPath="/Native Directory" pattern="*"/> <Artifact recursive="true" parentPath="/Taskflows" pattern="*"/> </Task> </Package>