EPM Automate Recreate, How to recreate an EPM Cloud environment, How to change business process

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 Oracle 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.

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 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, 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, and Strategic Workforce Planning.

Required Roles

Service Administrator

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.
EPM Automate retains the current Essbase version if you do not specify this option. 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
```
  Profitability and Cost Management: You can convert your Profitability and Cost Management environment to Planning, Enterprise Planning, or an Enterprise Profitability and Cost Management environment by running the following command:
```
epmautomate recreate -f removeAll=true TempServiceType=PBCS
```
  To convert the environment back to the original Profitability and Cost Management environment, use the following command:
```
epmautomate recreate -f TempServiceType=PCMCS
```
  Note:
  Profitability and Cost Management environments cannot be converted to Account Reconciliation, Oracle Enterprise Data Management Cloud, or Narrative Reporting environments.
- 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 a 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 a Financial Consolidation and Close environment and remove the content of inbox and outbox, and existing snapshots:
epmautomate recreate -f removeAll=true