cloneEnvironment

Klont die aktuelle Umgebung und (optional) Artefakte der Identitätsdomain (Benutzer und vordefinierte Rollenzuweisungen), Datensätze des Datenmanagement, Auditdatensätze, Jobkonsolendatensätze, Inhalte von Inbox und Outbox sowie gespeicherte Snapshots. Dieser Befehl stellt eine Alternative zur Verwendung der Funktion "Umgebung klonen" in Migration dar.

Note:

  • Account Reconciliation: Nach dem Klonen werden die Zielanwendungseinstellungen für Account Reconciliation auf die Standardwerte zurückgesetzt. Wenn Sie die Zielanwendungseinstellungen beibehalten möchten, exportieren Sie sie mit dem Befehl exportARApplicationProperties aus der Quellumgebung. Importieren Sie die Anwendungseigenschaften dann nach Abschluss des Klonverfahrens mit dem Befehl importARApplicationProperties in die Zielumgebung.
  • Datenmanagement: Das Klonen von Datensätzen der Komponente Datenmanagement kann sehr lange dauern, wenn die Staging-Tabellen sehr viele Datensätze enthalten. Auch das Klonen der Inhalte von Inbox und Outbox sowie von gespeicherten Snapshots kann beträchtliche Zeit in Anspruch nehmen, insbesondere wenn große Datenmengen enthalten sind.
  • Legacy-Umgebungen: Beim Klonen wird die Oracle Essbase-Version wie in den folgenden Szenarios beschrieben beibehalten:
    • Szenario 1: Sie klonen eine Legacy-Quellumgebung, die eine Essbase-Version verwendet, die keine Hybrid-Cubes unterstützt, in eine Legacy-Zielumgebung, die eine Essbase-Version verwendet, die Hybrid-Cubes unterstützt. In diesem Szenario wird für die Essbase-Version in der Zielumgebung ein Downgrade durchgeführt, sodass sie mit der Version in der Quellumgebung übereinstimmt.
    • Szenario 2: Sie klonen eine Legacy-Quellumgebung, die eine Essbase-Version verwendet, die Hybrid-Cubes unterstützt, in eine Legacy-Zielumgebung, die eine Essbase-Version verwendet, die keine Hybrid-Cubes unterstützt. In diesem Szenario wird für die Essbase-Version in der Zielumgebung ein Upgrade durchgeführt, sodass sie mit der Version in der Quellumgebung übereinstimmt.
    • Szenario 3: Sie klonen eine Legacy-Quellumgebung, die eine Essbase-Version verwendet, die keine Hybrid-Cubes unterstützt, in eine EPM Standard Cloud Service- oder EPM Enterprise Cloud Service-Zielumgebung, die standardmäßig eine Essbase-Version verwendet, die Hybrid-Cubes unterstützt. In diesem Szenario wird für die Essbase-Version in der Zielumgebung kein Downgrade durchgeführt, sodass sie mit der Version in der Quellumgebung übereinstimmt.
  • Planning: Das Klonen kann unter Umständen nicht erfolgreich verlaufen, wenn der Planning-Geschäftsprozess ein umbenanntes vordefiniertes Periodenelement enthält, das durch ein benutzerdefiniertes Periodenelement ersetzt wurde. Beispiel: Sie haben das vordefinierte Periodenelement YearTotal in unused_YearTotal umbenannt und dann ein Periodenelement mit einem anderen Typ mit dem ursprünglichen vordefinierten Elementnamen (in diesem Beispiel YearTotal) hinzugefügt. In diesem Szenario kann es vorkommen, dass das Klonen der Umgebung nicht erfolgreich ist.
  • Zeitpunkt zum Ausführen dieses Befehls: Führen Sie diesen Befehl nach der geplanten täglichen Wartung der Quell- und der Zielumgebung aus.

    Die tägliche Wartung kann während des Klonprozesses weder für die Quell- noch für die Zielumgebung gestartet werden. Sie wird zur nächsten geplanten Zeit nach dem Ende des Klonprozesses oder der automatischen Beendigung nach 36 Stunden ausgeführt.

Wenn dieser Befehl ausgeführt wird, während der Snapshot der Quellumgebung generiert wird (z.B. während der täglichen Wartung), tritt der Fehler Datei nicht gefunden auf.

Ausführliche Informationen zu diesen Themen finden Sie unter EPM Cloud-Umgebungen klonen in der Dokumentation Migration für Oracle Enterprise Performance Management Cloud verwalten.

Gilt für

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management, Oracle Enterprise Data Management Cloud, Narrative Reporting, Sales Planning und Strategische Personalplanung.

Erforderliche Rollen

Serviceadministrator

Die Rolle Identitätsdomainadministrator ist zum Klonen von Benutzern und vordefinierten Rollen erforderlich.

Verwendung

epmAutomate cloneEnvironment TARGET_USERNAME TARGET_PASSWORD TARGET_URL [SnapshotName=NAME] [UsersAndPreDefinedRoles=true|false] [DataManagement=true|false] [appAudit=true|false] [jobConsole=true|false] [storedSnapshotsAndFiles=true|false] [DailyMaintenanceStartTime=true|false], wobei Folgendes gilt:

Note:

  • Der Parameter dataManagement gilt nicht für Oracle Enterprise Data Management Cloud- und Narrative Reporting-Umgebungen.

    Klonen Sie Datenmanagement-Datensätze nur, wenn für die Quell- und Zielumgebung dieselbe monatliche Aktualisierung gilt oder wenn die Zielumgebung genau eine neuere Aktualisierung aufweist als die Quellumgebung. Beispiel: Sie können die Datenmanagement-Datensätze für 22.01 nur in eine andere 22.01-Umgebung oder in eine 22.02-Umgebung klonen.

  • Der Parameter jobConsole gilt nur für Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Enterprise Profitability and Cost Management, Sales Planning und Strategic Workforce Planning.
  • Der Parameter appAudit gilt nur für Planning, Planning Modules, FreeForm, Enterprise Profitability and Cost Management, Sales Planning und Strategic Workforce Planning.

    Auditinformationen für Financial Consolidation and Close und Tax Reporting sind standardmäßig im Snapshot enthalten.

  • Wenn der Parameter dataManagement, jobConsole oder appAudit für eine Umgebung nicht anwendbar ist, ignoriert EPM Automate den angegebenen Wert.
  • TARGET_USERNAME entspricht der ID eines Serviceadministrators in der Zielumgebung. Sie müssen den Zielbenutzernamen der Identitätsdomain verwenden (nicht den SSO-Benutzernamen). Wenn Sie planen, Benutzer- und Rollenzuweisungen in der Zielumgebung zu klonen, muss dieser Benutzer auch über die Rolle Identitätsdomainadministrator verfügen.
  • TARGET_PASSWORD ist der Speicherort der verschlüsselten Kennwortdatei des Benutzers, der durch TARGET_USERNAME identifiziert wird.
  • TARGET_URL ist die URL der Umgebung, die zur geklonten Umgebung wird.
  • SnapshotName entspricht optional dem Namen eines Snapshots, der für das Klonen verwendet werden muss. Dieser Snapshot muss in der Quellumgebung vorhanden sein. Die Standardeinstellung lautet Artifact Snapshot. Dabei wird der letzte Wartungs-Snapshot zum Klonen der Umgebung verwendet.
  • UsersAndPreDefinedRoles (optional) gibt an, ob Benutzer und ihre vordefinierten Rollenzuweisungen geklont werden sollen (Gruppen für die Zugriffskontrolle werden immer geklont). Der Standardwert ist false.

    Damit diese Option funktioniert, muss der Benutzer, der durch TARGET_USER_NAME identifiziert wird, die Rolle Identitätsdomainadministrator in der Zielumgebung aufweisen.

    Der Import von Benutzern und ihren vordefinierten Rollen verläuft nicht erfolgreich, wenn ein Benutzer, der kein Identitätsdomainadministrator ist, dieses Kontrollkästchen aktiviert und anschließend eine Umgebung klont. Ein Fehler wie der Folgende wird im Migrationsstatusbericht aufgezeichnet: Externes Verzeichnisartefakt <artifact_name> konnte nicht exportiert werden. Benutzer <user_name> ist nicht zur Ausführung dieses Vorgangs autorisiert. Der Benutzer muss über die Rolle "Identitätsdomainadministrator" verfügen, um diesen Vorgang auszuführen.
    • Wenn Sie keine Benutzer importieren, und ein Benutzer im Quell-Snapshot nicht zu einer vordefinierten Rolle in der Zielumgebung zugewiesen ist, wird ein Fehler (EPMIE-00070: Benutzer konnte beim Import von zugewiesenen Rollen nicht gefunden werden) angezeigt.
    • Die Rollenzuweisung Identitätsdomainadministrator wird nicht geklont. Benutzer, denen nur die Rolle Identitätsdomainadministrator zugewiesen ist, werden nicht in die Zielumgebung geklont.

      Benutzer, die einer Kombination aus der Rolle Identitätsdomainadministrator und vordefinierten Rollen in der Quellumgebung zugewiesen sind, werden geklont, aber nur den entsprechenden vordefinierten Rollen in der Zielumgebung zugewiesen. Diese Benutzer erhalten in der Zielumgebung nicht die Rolle Identitätsdomainadministrator.

    • Änderungen an den vordefinierten Rollen des Benutzers werden basierend auf den im Quell-Snapshot zugewiesenen Rollen aktualisiert. Rollenzuweisungen im Ziel werden jedoch nicht entfernt, damit sie denen im Quell-Snapshot entsprechen. Beispiel: jdoe ist der vordefinierten Rolle Poweruser in der Zielumgebung zugewiesen, hat aber nur die Rolle Benutzer im Quell-Snapshot. In dieser Situation weist dieser Befehl jdoe der Rolle Benutzer zu und entfernt nicht die Zuweisung der Rolle Poweruser in der Zielumgebung.
    • Mit diesem Befehl werden Benutzer, die nicht im Quell-Snapshot vorhanden sind, nicht aus der Zielumgebung gelöscht. Beispiel: jdoe hat einen Account in der Zielumgebung, der aber nicht im Quell-Snapshot vorhanden ist. In dieser Situation wird der Account von jdoe nicht aus der Zielumgebung gelöscht.
    • Mit diesem Befehl werden Benutzer hinzugefügt, die nicht in der Zielumgebung vorhanden sind. Aktuelle Benutzereigenschaften werden nicht in der Zielumgebung aktualisiert, selbst wenn sie sich von denen im Quell-Snapshot unterscheiden. Beispiel: Der Nachname von jdoe ist im Quell-Snapshot anders geschrieben als in der Zielumgebung. Diese Änderung wird nicht in der Zielumgebung vorgenommen. Neuen Benutzern in der Zielumgebung wird ein Zufallskennwort zugewiesen. Die neuen Benutzer erhalten E-Mails zur Accountaktivierung, in denen sie aufgefordert werden, das Kennwort zu ändern.
    • Mit diesem Befehl werden Benutzerkennwörter in der Zielumgebung nicht geändert, selbst wenn sie im Quell-Snapshot anders lauten.
  • dataManagement=true|false (optional) klont Datenmanagement-Datensätze von der Quellumgebung in die Zielumgebung. Die Standardeinstellung lautet true. Dabei werden Datenmanagement-Datensätze geklont. Setzen Sie diesen Wert auf false, wenn Sie keine Datenmanagement-Datensätze klonen möchten.
  • appAudit=true|false (optional) klont die Auditdatensätze von der Quellumgebung in die Zielumgebung. Die Standardeinstellung lautet true. Dabei werden Auditdaten der Anwendung geklont. Setzen Sie diesen Wert auf false, wenn Sie keine Auditdaten der Anwendung in die Zielumgebung klonen möchten.
  • jobConsole=true|false (optional) klont die Jobkonsolendatensätze von der Quellumgebung in die Zielumgebung. Der Standardwert ist true. Setzen Sie diesen Wert auf false, wenn Sie keine Jobkonsolendatensätze klonen möchten.
  • storedSnapshotsAndFiles (optional) gibt an, ob der Befehl die Inhalte von Inbox und Outbox sowie gespeicherte Snapshots klonen soll. Der Standardwert ist false.

    Note:

    Nur die Ordner der obersten Ebene der Inbox und Outbox werden geklont, Unterordner werden nicht geklont. Wenn Sie die Inhalte der Unterordner behalten möchten, sichern Sie diese auf einem lokalen Computer, und laden Sie sie in die Zielumgebung hoch.
  • DailyMaintenanceStartTime (optional) setzt die Startzeit der Wartung der geklonten Zielumgebung auf die Startzeit der Quellumgebung zurück. Der Standardwert ist true. Um die aktuelle Startzeit der Wartung der Zielumgebung beizubehalten, setzen Sie diesen Wert auf false.

Beispiele

  • Klonen Sie die Umgebung, Benutzer und vordefinierte Rollenzuweisungen, Auditdaten, Jobkonsolendatensätze und Datenmanagement-Datensätze. Ändern Sie zudem die Startzeit der Wartung der Zielumgebung in die Startzeit der Quellumgebung:

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com UsersAndPreDefinedRoles=true

  • Klonen Sie die Umgebung, einschließlich der Inhalte von Inbox und Outbox sowie gespeicherter Snapshots, jedoch nicht die Benutzer und vordefinierten Rollenzuweisungen, Datenmanagement-Datensätze, Auditdaten und Jobkonsolendatensätze, ohne die Startzeit der Wartung der Zielumgebung zu ändern:

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com DataManagement=false appAudit=false jobConsole=false storedSnapshotsAndFiles=true DailyMaintenanceStartTime=false

  • Klonen Sie die gesamte Umgebung (Benutzer und vordefinierte Rollenzuweisungen, Auditdaten, Jobkonsolendatensätze, Inhalte von Inbox und Outbox, gespeicherte Snapshots und Datenmanagement-Datensätze) mit einem benutzerdefinierten Snapshot. Ändern Sie zudem die Startzeit der Wartung der Zielumgebung in die Startzeit der Quellumgebung:

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com UsersAndPreDefinedRoles=true storedSnapshotsAndFiles=true SnapshotName=SampleSnapshot