cloneEnvironment

克隆当前环境和（可选）身份域对象（用户和预定义角色分配）、数据管理记录、审核记录、作业控制台记录、收件箱和发件箱的内容以及存储的快照。此命令可以替代迁移中的克隆环境功能。

Note:

  • Account Reconciliation：克隆后，目标 Account Reconciliation 应用程序设置将重置为默认值。如果您希望保留目标应用程序设置，请使用 exportARApplicationProperties 命令将这些设置从源环境中导出。然后，在克隆完成后，使用 importARApplicationProperties 命令将这些应用程序属性导入目标环境。
  • 数据管理： 如果临时表包含大量记录，克隆数据管理记录可能需要很长时间。类似地，克隆收件箱和发件箱的内容以及存储的快照可能需要大量时间，尤其当它们包含大量数据时更是如此。
  • 旧环境：克隆将保持当前 Oracle Essbase 版本，如以下场景中所述：
    • 场景 1：您克隆的源旧环境使用的 Essbase 版本不支持混合多维数据集，目标旧环境使用的 Essbase 版本支持混合多维数据集。在此场景中，目标环境中的 Essbase 将降级，以匹配源环境中的版本。
    • 场景 2：您克隆的源旧环境使用的 Essbase 版本支持混合多维数据集，目标旧环境使用的 Essbase 版本不支持混合多维数据集。在此场景中，目标环境中的 Essbase 将升级，以匹配源环境中的版本。
    • 场景 3：您克隆的源旧环境使用的 Essbase 版本不支持混合多维数据集，目标 EPM Standard Cloud Service 或 EPM Enterprise Cloud Service 环境默认使用的 Essbase 版本支持混合多维数据集。在此场景中，目标环境中的 Essbase 不会降级，即不会匹配源环境中的版本。
  • Planning：如果 Planning 业务流程包含重命名的植入期间成员而原始成员已被自定义期间成员取代，克隆可能会失败。例如，您将植入的 YearTotal 期间成员重命名为 unused_YearTotal 后，添加了使用原始植入成员名称（在此示例中为 YearTotal）的备用类型期间成员。在这种情况下，环境克隆可能会失败。
  • 何时运行此命令：在为源和目标环境调度的日常维护之后运行此命令。

    克隆过程正在运行时，无法开始源和目标环境的日常维护。日常维护在克隆过程结束或 36 小时后终止后的下一个调度的时间运行。

如果在生成源环境的快照时执行此命令（例如，在日常维护期间），您会收到 File not found（找不到文件）错误。

有关这些主题的详细信息，请参阅《管理 Oracle Enterprise Performance Management 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、销售规划和战略性人员规划。

所需角色

服务管理员

身份域管理员角色是克隆用户和预定义角色所必需的。

用法

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 模块、自由形式、Financial Consolidation and Close、Tax Reporting、Enterprise Profitability and Cost Management、销售规划和战略性人员规划。
  • appAudit 参数仅适用于 Planning、Planning 模块、自由形式、Enterprise Profitability and Cost Management、销售规划和战略性人员规划。

    默认情况下，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: Failed to find user during assigned roles import)。
    • 不会克隆身份域管理员角色分配。仅分配了身份域管理员角色的用户不会克隆到目标环境。

      将克隆在源环境中分配了身份域管理员角色和预定义角色的用户，但在目标环境中仅为这些用户分配各自的预定义角色。这些用户在目标环境中将没有身份域管理员角色。

    • 对用户预定义角色的更改将根据源快照中分配的角色进行更新。但是，不会为了匹配源快照中的角色分配而删除目标中的角色分配。例如，假设 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