cloneEnvironment

複製目前環境和 (選擇性) 識別網域物件 (使用者和預先定義的角色指派)、資料管理記錄、稽核記錄、工作主控台記錄、收件匣/寄件匣的內容以及儲存的快照。要使用移轉中的「複製環境」功能，也可以使用這個命令。

Note:

  • Account Reconciliation：複製之後，目標 Account Reconciliation 應用程式設定值將會重設為其預設值。如果您想要保留目標應用程式設定值，請使用 exportARApplicationProperties 命令，從來源環境中匯出這些設定值。然後，在複製完成之後，使用 importARApplicationProperties 命令，將應用程式特性匯入至目標環境。
  • 資料管理：如果臨時資料表包含大量記錄，則複製資料管理記錄可能需要很長時間。同樣，複製收件匣和寄件匣的內容以及儲存的快照可能需要相當長的時間，尤其是當它們包含大量的資料。
  • 舊版環境：複製會依下列案例中討論的方式維護目前的 Oracle Essbase 版本：
    • 案例 1：複製來源的舊版環境使用不支援 Hybrid 立方體的 Essbase 版本，但複製目標的舊版環境則使用支援 Hybrid 立方體的 Essbase 版本。在此案例中，會將目標環境的 Essbase 版本降級為來源環境的版本。
    • 案例 2：複製來源的舊版環境使用支援 Hybrid 立方體的 Essbase 版本，但複製目標的舊版環境則使用不支援 Hybrid 立方體的 Essbase 版本。在此案例中，會將目標環境的 Essbase 版本升級為來源環境的版本。
    • 案例 3：複製來源的舊版環境使用不支援 Hybrid 立方體的 Essbase 版本，但複製目標為 EPM Standard Cloud Service 或 EPM Enterprise Cloud Service 環境，且預設使用支援 Hybrid 立方體的 Essbase 版本。在此案例中，不會將目標環境的 Essbase 版本降級為來源環境的版本。
  • Planning：如果 Planning 商業程序包含已重新命名並被自訂期間成員取代的內建期間成員，則複製可能會失敗。例如，您將內建的 YearTotal 期間成員重新命名為 unused_YearTotal，然後新增具有原始內建成員名稱 (在此範例中為 YearTotal) 的替代類型期間成員。在此情況下，複製環境時可能會失敗。
  • 執行此命令的時機：請在來源與目標環境的排定每日維護之後執行此命令。

    複製程序正在執行中時，無法啟動來源和目標環境的每日維護。每日維護會在複製程序結束或終止後 36 個小時之後的下次排定時間執行。

如果在產生來源環境快照時 (例如，每日維護期間) 執行此命令，您將會收到找不到檔案錯誤。

如需有關這些主題的詳細資訊，請參閱管理 Oracle Enterprise Performance Management Cloud 移轉 中的複製 EPM Cloud 環境。

適用於

Planning、Planning 模組、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 及 Strategic Workforce Planning。

必要角色

服務管理員

必須具備識別網域管理員角色才能複製使用者與預先定義角色。

用法

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]，其中：

Note:

  • dataManagement 參數不適用於 Oracle Enterprise Data Management Cloud 和 Narrative Reporting 環境。

    只有當來源環境和目標環境都在同一個月度更新或目標環境比來源環境更早進行一次更新，才會複製「資料管理」記錄。例如，您可以將 22.01「資料管理」記錄複製到另一個 22.01 環境或僅複製到 22.02 環境。

  • jobConsole 參數僅適用於 Planning、Planning 模組、FreeForm、Financial Consolidation and Close、Tax Reporting、Enterprise Profitability and Cost Management、Sales Planning 和 Strategic Workforce Planning。
  • appAudit 參數僅適用於 Planning、Planning 模組、FreeForm、Enterprise Profitability and Cost Management、Sales Planning 和 Strategic Workforce Planning。

    Financial Consolidation and Close 和 Tax Reporting 的稽核資訊是預設包含在快照中。

  • 如果 dataManagement、jobConsole 或 appAudit 參數不適用於某個環境，則 EPM Automate 會忽略您指定的值。
  • TARGET_USERNAME 是目標環境服務管理員的 ID。您必須使用目標身分識別網域使用者名稱 (而非 SSO 使用者名稱)。如果您計劃複製目標環境中的使用者和角色指派，此使用者也必須擁有識別網域管理員角色。
  • TARGET_PASSWORD 是 TARGET_USERNAME 所識別之使用者的加密密碼檔案位置。
  • TARGET_URL 是指要複製的環境，其 URL 為何。
  • SnapshotName (選擇性) 是指系統會複製的快照，其名稱為何。來源環境中一定要有這個快照。預設值為 Artifact Snapshot，它使用上次維護快照來複製環境。
  • 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。

範例

  • 複製環境、使用者和預先定義的角色指派、稽核資料、工作主控台記錄和資料管理記錄。另請將目標環境的維護開始時間變更為來源環境的維護開始時間：

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com 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