Copies the current snapshot from a source environment to the environment (target) from which you run this command.

This command is primarily used as the first step in migrating an environment by copying the current snapshot from another environment; for example from a test environment to a production environment. You use the importSnapshot command to complete the migration process.

Before running this command, start an EPM Automate session and sign into the target environment.

If this command is executed to copy the current snapshot while the snapshot of the source environment is being generated; for example, during the daily maintenance, you will receive the File not found error.

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

Required Roles

  • Service Administrator
  • Power User and the Migrations - Administer application role (Oracle Enterprise Data Management Cloud and Profitability and Cost Management)


epmautomate copySnapshotFromInstance SNAPSHOT_NAME USERNAME PASSWORD_FILE URL where:

  • SNAPSHOT_NAME is the name of an existing snapshot in the source environment.

  • USERNAME is the user name of a Service Administrator of the source environment.

  • PASSWORD_FILE is the name and location of the file containing the encrypted password of the Service Administrator of the source environment.
  • URL is the URL of the source environment.


epmautomate copySnapshotFromInstance "Artifact Snapshot" serviceAdmin C:\mySecuredir\password.epw