recreate

Restores an environment to a clean state by re-creating the deployment.

You re-create the deployment to complete these tasks:

  • Clean up an environment before importing a full snapshot.
  • Change the business process that can be deployed in an environment.
  • Change the Essbase version in use in Oracle Enterprise Performance Management Cloud environments other than Narrative Reporting, Oracle Enterprise Data Management Cloud, and Account Reconciliation, which do not use Essbase.

    By default, EPM Standard Cloud Service and EPM Enterprise Cloud Service environments are deployed with Hybrid-enabled Essbase, while legacy environments are deployed with Non-Hybrid Essbase. Downgrading the deployment of Hybrid-enabled Essbase in EPM Standard Cloud Service and EPM Enterprise Cloud Service environments is required, if you are importing a snapshot from an environment that has a Non-Hybrid Essbase version. Upgrading the deployment of Non-Hybrid Essbase in legacy environments is required to:

    • Support the extended dimensionality in existing legacy Financial Consolidation and Close environments
    • Enable hybrid block storage (BSO) applications in legacy Enterprise Planning and Planning Modules environments

    Downgrading the deployment of Hybrid-enabled Essbase in EPM Standard Cloud Service and EPM Enterprise Cloud Service environments is required if you are importing a snapshot from an environment that has Non-Hybrid Essbase.

    For detailed information about Hybrid Essbase and the considerations for upgrading to Hybrid Essbase, see About Essbase in EPM Cloud in Getting Started with Oracle Enterprise Performance Management Cloud for Administrators .

Caution:

  • This command deletes the existing application and, optionally, all user defined artifacts from the environment. Additionally, it re-creates the database and removes all existing data. After recreating the service, you can create a new business process or import one using Migration or EPM Automate.
  • This command deletes migration history. As a result, the Migration Status Report available in Migration will not contain historic information.
  • Before using this command, perform a complete backup of the environment. You can create a backup snapshot by executing the runDailyMaintenance command.

Applies to

Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Oracle Enterprise Data Management Cloud, Narrative Reporting, Oracle Sales Planning Cloud, and Oracle Strategic Workforce Planning Cloud.

Usage

epmautomate recreate [-f] [removeAll=true|false] [EssbaseChange=Upgrade|Downgrade] [TempServiceType=Service_type] where:
  • -f forces the re-create process to start without user confirmation. If you do not use the -f option, EPM Automate prompts you to confirm your action.
  • removeAll, optionally, removes all snapshots and the content of the inbox (uploaded files) and outbox (files exported from the environment). Default is false, which retains the snapshots and the content of inbox and outbox.
  • EssbaseChange, optionally, upgrades or downgrades the current Essbase version. Permissible values are:
    • upgrade to change from Non-Hybrid Essbase to Hybrid Essbase
    • downgrade to change from Hybrid Essbase to Non-Hybrid Essbase.

      Caution:

      Before using this option, read and understand the information available in " About Essbase in EPM Cloud " in Getting Started with Oracle Enterprise Performance Management Cloud for Administrators .
  • TempServiceType, optionally, converts an environment to a different service environment.

    The business processes that you can deploy in an environment is governed by the type of subscription that you have. For example, if you have an EPM Standard Cloud Service subscription, you cannot create a Free Form application after converting the environment from Account Reconciliation to Planning. If you have an EPM Enterprise Cloud Service subscription, you can create any business process in your environment after changing the service type appropriately. See " About the New EPM Cloud Services " in Getting Started with Oracle Enterprise Performance Management Cloud for Administrators

    The behavior of this parameter is dependent on your subscription.

    • Subscriptions other than EPM Standard Cloud Service and EPM Enterprise Cloud Service:

      You can use the TempServiceType option to temporarily convert a Planning, Enterprise Planning, Tax Reporting, or Financial Consolidation and Close environment to an Account Reconciliation, Oracle Enterprise Data Management Cloud, or Profitability and Cost Management environment. For example, If you purchased a Planning environment, you can convert it to an Account Reconciliation environment by running the following command:

      epmautomate recreate -f removeAll=true TempServiceType=ARCS

      After converting the environment to Account Reconciliation, you can convert it to an Oracle Enterprise Data Management Cloud or Profitability and Cost Management environment by using the appropriate TempServiceType value. For example, to convert it to a Profitability and Cost Management environment, execute the following command:

      epmautomate recreate -f removeAll=true TempServiceType=PCMCS.

      To convert the environment back to the original service type, run the following command:

      epmautomate recreate -f
    • EPM Standard Cloud Service and EPM Enterprise Cloud Service subscriptions:

      You can use the TempServiceType option to convert an EPM Cloud environment to any other supported environment.

      EPM Enterprise Cloud Service subscriptions use a common EPM Cloud platform. Initially, you can deploy any supported EPM Cloud business process.

      To switch from a deployed business process to another, you re-create the environment by specifying the new service type for the environment. For example, if you created an Account Reconciliation business process but now want to create an Oracle Enterprise Data Management Cloud environment, you run the re-create command as follows.

      epmautomate recreate -f removeAll=true TempServiceType=EDMCS

      To convert a business process (for example, Account Reconciliation) to Planning, Tax Reporting, or Financial Consolidation and Close, do not specify a TempServiceType value. For example, if you created an Account Reconciliation business process but now want to create a Planning Modules environment, you run the recreate command as follows.

      epmautomate recreate -f removeAll=true

    Acceptable TempServiceType values:

    • ARCS to convert an environment to an Account Reconciliation environment
    • EDMCS to convert an environment to an Oracle Enterprise Data Management Cloud environment
    • EPRCS to convert an environment to a Narrative Reporting environment
    • PCMCS to convert an environment to an Profitability and Cost Management environment

Examples

  • Re-create the current environment, restore it to the original service type (if a recreate had been issued before with a TempServiceType parameter), and upgrade to Hybrid-enabled Essbase without removing user created snapshots and contents of inbox and outbox:

    epmautomate recreate -f EssbaseChange=upgrade
  • Re-create the current environment and restore it to the original service type (if a recreate had been issued before with a TempServiceType parameter),, remove snapshots and the contents of inbox and outbox:

    epmautomate recreate -f removeAll=true

  • Re-create the current environment as an Oracle Enterprise Data Management Cloud environment and remove the content of inbox and outbox, and existing snapshots:

    epmautomate recreate -f removeAll=true TempServiceType=EDMCS

  • Re-create the current EPM Enterprise Cloud Service Account Reconciliation environment to an Financial Consolidation and Close environment and remove the content of inbox and outbox, and existing snapshots:

    epmautomate recreate -f removeAll=true TempServiceType=FCCS