Importing Artifacts and Application from a Snapshot
You can import snapshots to create a clone of another environment or to migrate artifacts from another environment.
Before you can initiate such process, you must upload the backup or incremental snapshot that you want to import into the target environment. Do not run jobs in an environment while an import operation is in progress. Because the underlying data and metadata may be affected by an import operation, jobs may result in inaccurate results.
Methods to Upload Snapshots and Files
- Use Migration to download the snapshot from the source environment and then upload it to the target environment. See Downloading Files and Snapshots from an Environment and Uploading Archives to the Service .
- Use the downloadFile and uploadFile EPM Automate commands.
- Use the copySnapshotFromInstance EPM Automate command to copy a snapshot from another environment.
Key Considerations
-
Except for the exceptions listed below, Oracle Fusion Cloud Enterprise Performance Management supports import from a source snapshot to a target environment if their monthly updates are within one month of each other. For example, if the source environment is on the 24.08 update, the target environment can be on either 24.07 or 24.09 update.
Exceptions:
-
Strategic Modeling: Import is only allowed if both environments are on the exact same update. For example, if the source environment is on the 24.08 update, the target environment must also be on 24.08.
- Account Reconciliation and Oracle Fusion Cloud Enterprise Data Management: Import is allowed if the target environment is either on the same monthly update or the next update relative to the source environment. For example, if the source environment is on the 24.08 update, the target environment can be on either 24.08 or 24.09.
The import process displays the following warning if the snapshot used for the process is not compatible with the current version of the environment.
EPMLCM-26000: This snapshot is from Cloud EPMVERSION_NUMBER
that is incompatible with this update and may result in import errors.You can upgrade incompatible snapshots other than Account Reconciliation and Oracle Enterprise Data Management Cloud snapshots to make them compatible with the current version of an environment. See "Recreating an Old Cloud EPM Environment for Audits" in Working with EPM Automate.
-
-
After performing an LCM import, it’s recommended to sign off and sign back in after the LCM import completes.
-
After you initiate an import operation, Cloud EPM displays the Migration Status Report. Click Refresh periodically to update the report and monitor progress.
If an import fails for any reason, the Migration Status Report displays Failed as the status. Click the status to open the Migration Details screen, which indicates why the import failed and the corrective action to take.
-
Migration does not support the import of application audit records.
-
If you are not importing users and a user in the source snapshot does not have a predefined role on the target environment, the following error is displayed:
EPMIE-00070: Failed to find user during assigned roles import.
-
For Data Management: The import process may take longer if the snapshot contains staging data.
- For Oracle Enterprise Data Management Cloud: The system is placed in migration mode when you import artifacts and snapshots.
Considerations for Essbase Data Imports
Planning applications do not permit the incremental loading of Oracle Essbase data using Migration; you must import the full snapshot instead. If you try to import only the Essbase data, the Essbase data import is only supported during create application warning is generated.
To import Essbase data, use one of the following methods:
- Use the Outline Load Utility to load the data from an export file. For instructions, see Importing and Exporting Data in Administering Planning
- Recreate the application and import the snapshot using Migration. For instructions, see the recreate command in the Working with EPM Automate guide
Troubleshooting
See Resolving Import and Export and Backup Errors in the Operations Guide.
Importing a Backup to Create a Clone of Another Environment
You import a backup snapshot (by default, named Backup Date
) to create a clone of another environment.
Don't attempt to import a backup snapshot into an environment where an application already exists. If you want to import a backup snapshot into an environment with an existing application, first run the recreate EPM Automate command to restore your environment to a clean state, and then import the backup snapshot.
To import a backup to create a clone of another environment:
-
Access Migration. See Accessing Migration for Lifecycle Management. You can sign in as a Service Administrator, or as a user with Migrations - Administer application role.
-
Click Snapshots.
-
Click
(Actions) next to the backup snapshot that you want to import, and then select Import.
-
In Import, click OK.
The Migration Status Report, which helps you monitor the import progress opens. Refresh the report frequently to verify that the operation completes without errors.
Importing Artifacts into an Environment
You import specific artifacts from a backup snapshot or an incremental snapshot to migrate artifacts from one environment to another. For example, you can import a snapshot of tested artifacts from a test environment into a production environment. Similarly, you can import Essbase data and artifacts from an incremental snapshot created by exporting them from another environment.
The import of some artifacts is governed by the import settings specified for the environment. See Setting Import Options.
To import artifacts: