cloneEnvironment

現在の環境、およびオプションでアイデンティティ・ドメイン・アーティファクト(ユーザーおよびアプリケーション役割の割当て)、データ管理レコード、監査レコード、ジョブ・コンソール・レコード、アプリケーション・プロパティ、受信ボックスと送信ボックスのコンテンツおよび保存されたスナップショットをクローニングします。このコマンドは、環境のクローニング機能を使用する方法にかわるものです。

クローニングは、ソース環境およびターゲット環境のスケジュール済の日次メンテナンスの後に開始します。クローニングの進行中にソース環境の日次メンテナンスが開始された場合、クローニング・プロセスは終了します。日次メンテナンスの開始時にクローニングが進行中の場合でも、ターゲット環境のクローニング・プロセスは影響を受けません。このシナリオでは、日次メンテナンスは、クローニングが完了してから実行されます。

環境のクローニングに時間がかかる場合は、ソース環境の日次メンテナンスの開始時間を再スケジュールして、クローニング・プロセスが終了しないようにします。日次メンテナンスの開始時間をリセットする方法については、次の情報ソースを参照してください。

Note:

  • データ管理: ステージング表に非常に多数のレコードが含まれている場合は、データ管理レコードのクローニングに長時間かかることがあります。同様に、受信ボックスと送信ボックスのコンテンツや保存されたスナップショットのクローニングでは、特に大量のデータが含まれている場合は、かなりの時間を要する可能性があります。
  • Planning: カスタム期間メンバーに置き換えられ、名前が変更されたシード済期間メンバーがPlanningビジネス・プロセスに含まれると、クローニングが失敗する可能性があります。たとえば、シード済のYearTotal期間メンバーの名前をunused_YearTotalに変更し、元のシード済メンバー名(この例ではYearTotal)を使用して別タイプの期間メンバーを追加したとします。この場合、環境のクローニングは失敗する可能性があります。

これらのトピックの詳細は、移行の管理のCloud EPM環境のクローニングを参照してください。

適用対象

Planning、Planningモジュール、フリーフォーム、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およびStrategic Workforce Planning。

必要な役割

  • サービス管理者
  • 任意のアプリケーション役割および「移行 - 管理」詳細な役割

使用方法

epmAutomate cloneEnvironment TARGET_USERNAME TARGET_PASSWORD TARGET_URL [SnapshotName=NAME] [environmentBackup=NAME] [UsersAndPredefinedRoles=true|false] [DataManagement=true|false] [appAudit=true|false] [jobConsole=true|false] [storedSnapshotsAndFiles=true|false] [DailyMaintenanceStartTime=true|false] [ApplicationProperties=true|false]。ここで:

Note:

  • dataManagementパラメータは、Oracle Enterprise Data Management CloudおよびNarrative Reporting環境には適用されません。

    データ管理レコードは、ソース環境とターゲット環境の両方が同じ月次更新の場合、またはターゲット環境がソース環境よりも1つ新しい更新である場合のみクローニングします。たとえば、22.01のデータ管理レコードは、別の22.01環境または22.02環境のみにクローニングできます。

  • jobConsoleパラメータは、Planning、Planningモジュール、フリーフォーム、Financial Consolidation and Close、Tax Reporting、Enterprise Profitability and Cost Management、Sales PlanningおよびStrategic Workforce Planningにのみ適用されます。
  • appAuditパラメータは、Planning、Planningモジュール、フリーフォーム、Enterprise Profitability and Cost Management、Sales PlanningおよびStrategic Workforce Planningにのみ適用されます。

    Financial Consolidation and CloseおよびTax Reportingの監査情報は、デフォルトでスナップショットに含まれます。

  • dataManagement、jobConsoleまたはappAuditパラメータを環境に適用できない場合、指定された値は無視されます。
  • ApplicationPropertiesパラメータはAccount Reconciliationにのみ適用されます。
  • TARGET_USERNAMEは、ターゲット環境のサービス管理者のIDです。ターゲットのアイデンティティ・ドメイン・ユーザー名(SSOユーザー名ではなく)を使用する必要があります。

    Note:

    ユーザーおよび役割割当てをクローニングするには、このユーザーがサービス管理者であり、アイデンティティ・ドメイン管理者の役割に割り当てられていることが必要です。
  • TARGET_PASSWORDは、TARGET_USERNAMEで識別されるユーザーの暗号化されたパスワードまたはOAuth 2.0リフレッシュ・トークンが格納されるファイルの名前と場所です。

    Note:

    OAuth 2.0はよりセキュアであるため、Basic認証ではなくOAuth 2.0を使用して認証することをお薦めします。

  • TARGET_URLは、クローニングされる環境となる環境のCLOUD-EPM_BASE_URLです。
  • SnapshotNameはオプションで、メンテナンス・スナップショットの名前です。このスナップショットはソース環境に存在する必要があります。restoreBackupコマンドを使用して、アーカイブされたスナップショットをコピーします。この値またはEnvironmentBackupの値を指定し、両方は指定しないでください。

    Note:

    listBackupsコマンドを使用して、環境で使用可能なバックアップ・スナップショットおよび環境バックアップのリストを表示します。
  • EnvironmentBackupはオプションで、Oracle Object Storageに存在する環境バックアップの名前です。この値またはArtifact Snapshotの値を指定し、両方は指定しないでください。

    Note:

    SnapshotNameまたはEnvironmentBackupの値が指定されていない場合、コマンドは最後のメンテナンス・スナップショットを使用して環境をクローニングします。
  • UsersAndPredefinedRolesはオプションで、ユーザーおよびそのアプリケーション役割割当てをクローニングするかどうかを識別します(詳細な役割割当ては常にクローニングされます)。デフォルトはfalseです。

    このオプションが機能するためには、TARGET_USER_NAMEで識別されるユーザーに、ターゲット環境のアイデンティティ・ドメイン管理者の役割が必要です。

    アイデンティティ・ドメイン管理者ではないユーザーが、このチェック・ボックスを選択した後で環境をクローニングすると、ユーザーおよびそのアプリケーション役割のインポートが失敗します。次のエラーが移行ステータス・レポートに記録されます: 外部ディレクトリ・アーティファクト<artifact_name>のインポートに失敗しました。ユーザー<user_name>には、この操作を実行する権限はありません。この操作を実行するには、ユーザーにアイデンティティ・ドメイン管理者役割が必要です。
    • ユーザーをインポートせず、ソース・スナップショット内のユーザーがターゲット環境のアプリケーション役割に割り当てられていない場合は、エラー(EPMIE-00070: 割り当てられた役割のインポート中にユーザーが見つかりませんでした)が表示されます。
    • アイデンティティ・ドメイン管理者の役割の割当てはクローニングされません。アイデンティティ・ドメイン管理者の役割のみが割り当てられているユーザーは、ターゲット環境にクローニングされません。

      ソース環境でアイデンティティ・ドメイン管理者役割およびアプリケーション役割の組合せに割り当てられたユーザーはクローニングされますが、ターゲット環境ではそれぞれのアプリケーション役割にのみ割り当てられます。これらのユーザーは、ターゲット環境のアイデンティティ・ドメイン管理者の役割を持ちません。

    • ユーザーのアプリケーション役割に対する変更は、ソース・スナップショットで割り当てられている役割に基づいて更新されます。ただし、ソース・スナップショットの割当てと一致させるためにターゲットの役割の割当てが削除されることはありません。たとえば、jdoeがターゲット環境ではパワー・ユーザーというアプリケーション役割に割り当てられているが、ソース・スナップショットではユーザー役割のみを持っているとします。この状況では、このコマンドによって、ターゲット環境でjdoeがユーザー役割に割り当てられますが、パワー・ユーザーの役割の割当ては削除されません。
    • このコマンドでは、ターゲット環境に存在するユーザーは、ソース・スナップショットに存在しなくても削除されません。たとえば、jdoeにはターゲット環境にアカウントがありますが、ソース・スナップショットにはこのアカウントが存在しないとします。この状況では、ターゲット環境のjdoeのアカウントは削除されません。
    • このコマンドでは、ターゲット環境に存在しないユーザーは追加されます。ターゲット環境の現在のユーザー・プロパティは、ソース・スナップショットと異なる場合でも更新されません。たとえば、ソース・スナップショットのjdoeの姓のスペルがターゲット環境で異なる場合、ターゲット環境では変更は加えられません。ターゲット環境の新しいユーザーにはランダムなパスワードが割り当てられます。新しいユーザーは、パスワードの変更を求めるアカウントのアクティブ化の電子メールを受信します。
    • このコマンドでは、ターゲット環境の既存のユーザーのパスワードがソース・スナップショットと異なる場合でも変更されません。
  • dataManagement=true|falseはオプションで、ソース環境のデータ管理レコードをターゲット環境にクローニングします。デフォルトはtrueで、データ管理レコードをクローニングします。データ管理レコードをクローニングしない場合は、この値をfalseに設定します。
  • appAudit=true|falseはオプションで、ソース環境の監査レコードをターゲット環境にクローニングします。デフォルトはtrueで、アプリケーション監査データをクローニングします。アプリケーション監査データをターゲット環境にクローニングしない場合は、この値をfalseに設定します。
  • jobConsole=true|falseはオプションで、ソース環境のジョブ・コンソール・レコードをターゲット環境にクローニングします。デフォルトはtrueです。ジョブ・コンソール・レコードをクローニングしない場合は、この値をfalseに設定します。
  • storedSnapshotsAndFilesはオプションで、受信ボックスと送信ボックスのコンテンツおよび保存されたスナップショットをクローニングするかどうかを識別します。デフォルトはfalseです。

    Note:

    受信ボックスおよび送信ボックスの最上位フォルダのみがクローニングされ、サブフォルダはクローニングされません。サブフォルダの内容を保持する必要がある場合は、サブフォルダの内容をローカル・コンピュータにバックアップしてから、ターゲット環境にアップロードします。
  • DailyMaintenanceStartTimeはオプションで、クローニングされたターゲット環境のメンテナンス開始時間をソース環境のメンテナンス開始時間にリセットします。デフォルトはtrueです。ターゲット環境の現在のメンテナンス開始時間を維持するには、この値をfalseに設定します。
  • ApplicationPropertiesはオプションで、Account Reconciliationアプリケーション設定(電子メール通知のオン/オフ設定、レッドウッド・エクスペリエンス、テーマ、ビジネス・プロセス名、ロゴ・イメージおよび背景イメージ)をクローニングします。デフォルトはtrueです。

    ターゲット環境で現在のアプリケーション設定を維持するには、この値をfalseに設定します。

例

  • 環境バックアップを使用して、環境、ユーザーおよびアプリケーション役割の割当て、監査データ、ジョブ・コンソール・レコードおよびデータ管理レコードをクローニングします。また、ターゲット環境のメンテナンス開始時間もソース環境のメンテナンス開始時間に変更します:

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com environmentBackup=2026-03-11T16:30:37/Environment_Backup UsersAndPredefinedRoles=true

  • 特定のバックアップ・スナップショットを使用して、環境、ユーザーおよびアプリケーション役割の割当て、監査データ、ジョブ・コンソール・レコードおよびデータ管理レコードをクローニングします。また、ターゲット環境のメンテナンス開始時間もソース環境のメンテナンス開始時間に変更します:

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com SnapshotName=2026-03-11T16:34:52/Artifact_Snapshot UsersAndPreDefinedRoles=true

  • アーティファクト・スナップショットを使用して、受信ボックスと送信ボックスのコンテンツ、保存されたスナップショットを対象に含め、ユーザーおよびアプリケーション役割の割当て、データ管理レコード、監査データおよびジョブ・コンソール・レコードは対象から除外し、ターゲット環境のメンテナンス開始時間を変更せずに環境をクローニングします:

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

  • カスタム・スナップショットを使用して、環境全体(ユーザーおよびアプリケーション役割の割当て、監査データ、ジョブ・コンソール・レコード、受信ボックスと送信ボックスのコンテンツ、保存されたスナップショットおよびデータ管理レコード)をクローニングします。また、ターゲット環境のメンテナンス開始時間もソース環境のメンテナンス開始時間に変更します:

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

  • Account Reconciliationのみ: 環境、ユーザーおよびアプリケーション役割割当て、およびデータ管理レコードをクローニングしますが、ターゲット環境のアプリケーション設定は維持します:

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudarcs.arcs.epm.us.oraclecloud.com UsersAndPreDefinedRoles=true ApplicationProperties=false