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

This command is primarily used for migrating (cloning) an environment by copying the current snapshot from another environment; for example from a test environment to a production environment. 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, Oracle Strategic Workforce Planning Cloud, and Oracle Sales Planning Cloud.

Required Roles

Service Administrator


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