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

You re-create the environment to complete these tasks:

Clean up an environment before importing a full snapshot.
Change the business process that can be deployed in an environment.

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 Fusion Cloud Enterprise Data Management, Narrative Reporting, Sales Planning, and Strategic Workforce Planning.

Required Roles

Service Administrator

Usage

epmautomate recreate [-f]
                [removeAll=true|false] [TempServiceType=Service_type]

where:

-f forces the re-create process to start without user confirmation. If you do not use the -f option, the command 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.
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 Cloud EPM Services in Getting Started Guide 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 a 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 Oracle Fusion Cloud Enterprise Performance Management environment to any other supported environment.
  
  EPM Enterprise Cloud Service subscriptions use a common Cloud EPM platform. Initially, you can deploy any supported Cloud EPM 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 a 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 a 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) without removing user created snapshots and contents of inbox and outbox:
epmautomate recreate -f
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 a Enterprise Data Management 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