Importing Artifacts and Application from a Snapshot

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

Use Migration to download the snapshot from the source environment and then upload it to the target environment. Alternatively, you may use the copySnapshotFromInstance EPM Automate command to copy the snapshot into the target environment. You may also use the downloadFile and uploadFile commands to copy a snapshot into the target environment. See these information sources:

Note:

  • Excepting Strategic Modeling and Account Reconciliation, Oracle Enterprise Performance Management Cloud supports snapshot compatibility for one monthly cycle only; you can migrate maintenance snapshots from the test environment to the production environment and vice versa.

    Strategic Modeling and Account Reconciliation snapshots are not backward compatible.

    The import process displays the following warning if the snapshot used for the process is not compatible with the current version of the environment. Previously, an INCIDENT error was reported instead of this warning.

    EPMLCM-26000: Warning - Imported snapshot was created in an incompatible version

    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 EPM Cloud Environment for Audits" in Working with EPM Automate for Oracle Enterprise Performance Management Cloud.

  • After you initiate an import operation, EPM Cloud 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.

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 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:

  1. Access Migration. See Accessing Migration for Lifecycle Management.

  2. Click Snapshots.

  3. Click Actions button on the Snapshots tab (Actions) next to the backup snapshot that you want to import, and then select Import.

  4. 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:

  1. Access Migration. See Accessing Migration for Lifecycle Management.
  2. Click Snapshots.
  3. Expand the snapshot containing the artifacts that you want to import.
  4. Select artifacts to import.
    • To import all artifacts of a specific component:

      1. Expand the snapshot, and then click a component name; for example HP–Vision, to access a list of artifacts of the Vision sample application included in the snapshot.

      2. Click Select All.
      3. Click Import.

    • To import specific artifacts of a component:

      1. Expand the snapshot, and then click a component name; for example HP–Vision to access a list of artifacts of the Vision sample application included in the snapshot.

      2. In Artifact List, expand the list of available artifacts and then select the artifacts that you want to import.

      3. Optional: Click Selected Artifacts button (Selected Artifacts), and then verify the list of artifacts selected for import.
      4. Click Import.
  5. Click OK to confirm that you want to initiate the import operation.
    The Migration Status Report opens. Use this report to monitor the progress of the operation.