Exit Codes

The EPM Automate Utility returns an exit code and message to indicate the status of the operation. Exit codes are grouped under five code numbers; each code may indicate many error conditions. Review the accompanying message to identify the specific condition that caused the error. Additionally, the utility creates a log file (COMMANDNAME_TIMESTAMP.log, for example, uploadfile_16_11_2016_11_27_10.log) for each failed command execution. Log files are created on the computer from which you run the utility.

Exit Code 1 Errors

Command failed to execute The utility uses this exit code to display messages related to HTTP status code 200 and 400. These codes are returned by the REST APIs that the utility uses.

Insufficient privileges to perform the operation This error is displayed if the user whose credentials are used to sign into the service does not have sufficient privileges to perform the operation you attempted.

Sign in with an account that has sufficient privileges to perform the operation. Generally, only Service Administrators are allowed to perform operations in the service.

Resource does not exist This error is displayed if the file or snapshot that you want to delete or download does not exist in the service.

Use the listfiles command to verify the file name and its location.

Invalid snapshot SNAPSHOT This error is displayed when the service is unable to validate the snapshot that you specified for the export or import operation.

Verify that you are using a valid snapshot.

Internal server error. Unable to delete file: FILE_NAME Please issue "Provide Feedback" with details This error is displayed if the file or snapshot could not be deleted from the service due to a server error.

Report this issue to Oracle using the Feedback command or the Provide Feedback feature.

Invalid file: FILE_NAME This error is displayed if the file or snapshot that you want to delete or download does not exist in the service or if the file name is not in the required format.

Use the listfiles command to verify the file name and its location.

Recreate is running for a long time. Please contact support This error is displayed if the recreate operation that you initiated is not completed within one hour.

Report this issue to Oracle using the Feedback command or the Provide Feedback feature.

Reset service is running for a long time. Please contact support This error is displayed if the reset service operation that you initiated is not completed within one hour.

Report this issue to Oracle using the Feedback command or the Provide Feedback feature.

Cannot perform operation. Another instance is in progress. Please try after some time This error is displayed if you try to execute the copysnapshotfrominstance command when another instance of the command is active.

Wait for the copysnapshotfrominstance command to finish before attempting to run the command again.

Cannot perform operation. Another maintenance script is in progress. Please try after some time This error is displayed if you attempt to execute the copysnapshotfrominstance, recreate or resetservice command when daily maintenance or service reset process is running.

Rerun the operation after the maintenance or reset process finishes.

Login to source instance failed: SOURCE_URL This error is displayed if the utility is unable to sign in to the source environment to initiate the copysnapshotfrominstance command

Verify that the credentials, identity domain and URL that is used to access the source environment are valid.

Internal server error. Copy snapshot from source instance failed. Please issue "Provide Feedback" with details This error is displayed when the utility encounters an unexpected while running the copysnapshotfrominstance process.

Report this issue to Oracle using the Feedback command or the Provide Feedback feature.

Internal server error. Please issue "Provide Feedback" with details This error is displayed to indicate many internal server conditions that require corrective actions by Oracle.

Report this issue to Oracle using the Feedback command or the Provide Feedback feature.

Snapshot SNAPSHOT_NAME already exists. Please delete the snapshot and rerun the command This error is displayed when you download or upload a snapshot into a location where another snapshot with identical name is present.

Delete or remove the existing snapshot and then retry the command.

Error in extracting the snapshot. Please retry with a proper snapshot This error is displayed if the utility is unable to extract snapshot contents when running the importsnapshot command.

Verify that the snapshot is valid.

Internal server error. Unable to open file for write. Please issue "Provide Feedback" with details This error is displayed if errors cause the creating or updating of CSV files, for example while generating the Audit Report.

Report this issue to Oracle using the Feedback command or the Provide Feedback feature.

No matching records found, please select a different date range This error is displayed if you run the userauditreport command to generate the Audit Report for a date range for which audit data is not available.

Specify a valid date range and then rerun the userauditreport command. Note that the service maintains audit history for the last 120 days only.

File with same name exists: FILE_NAME, please choose a different filename This error is displayed if a report with the Audit Report name you specified exists in the service.

Delete the existing file from the service or specify a different file name and then rerun the userauditreport command.

Operation failed with status $1. Please issue "Provide Feedback" This message indicates an internal server error that cause the reset service or recreate service process to fail.

Report this issue to Oracle using the Feedback command or the Provide Feedback feature.

Exit Code 6 Errors

Service Unavailable Service is not available because of HTTP Error 404.

Verify service availability by accessing the service from a browser on the computer from which you are running the utility. If the service is down for any reason, wait a while and try again or contact Oracle support.

Read/Write timeout This error is displayed if the client socket times out (socket time out is 15 minutes) during any read/write operation due to slow network or firewall issues.

Rerun the failed command when network through put is high. If the failure is due to firewall settings, contact your Network Administrator.

Exit Code 7 Errors

The utility displays this error if it is unable to execute a command. The error message; for example, Invalid command, specifies why the error occurred.

EPM Automate doesn't support proxies which require authentication The proxy settings on your computer is configured to authenticate with a proxy server before your browser can access the internet.

Specify a proxy server user name, domain, and password (or use an encrypted password file containing the proxy server password) in the login command to authenticate with the proxy server.

Unable to open password file FILE_NAME Invalid encrypted password file, for example, PASSWORD_FILE.EPW. The utility did not find the file in the location that you specified or the file is not in the required format.

Verify the file name and path. If the file cannot be parsed because of invalid format, use the encrypt command to recreate the file.

Unable to parse password file FILE_NAME The utility was unable to parse the encrypted password file because of invalid format or because it has been corrupted.

Use the encrypt command to recreate the file.

Unable to connect to URL. Root cause MESSAGE This error is displayed if a connection cannot be established because of a bad URL. The message that is displayed as the root cause details the underlying failure resulting from using an incorrect URL.

  • Verify that you are using a valid URL

  • If your proxy setting requires you to authentication with the proxy server to connect to the internet, specify a proxy server user name, domain, and password (or use an encrypted password file containing the proxy server password) to sign in. Contact your Network Administrator if you need assistance.

Unable to connect to URL Unsupported Protocol The login command failed because the URL specified uses an unsupported protocol. Accompanying error message identifies the unsupported protocol.

Ensure that the URL that you are using with the login command uses the secure protocol (HTTPS).

Session is not authenticated. Please execute the “login” command before executing any other command You attempted to run a command before establishing a session using the login command.

Run the login command to establish a secure connection to an environment before attempting to execute other commands.

Invalid parameter This message indicates a usage error in a command caused by Incorrect sequence of command parameters or the absence of some required command parameter values.

Review and correct command parameters and the sequence in which they are specified.

COMMAND_NAME command is not supported by SERVICE_TYPE The utility was not able to run the command against the service to which you are connected because the service does not support the command.

See Command Reference for lists of commands that are supported by each service type.

File does not exist in location: PATH The utility was unable to find the file that you want to process, for example, using the upload or replay command.

Ensure that the file name and path are accurate.

Unable to open file for read: PATH The utility was unable to read from the specified file.

Ensure that the file is in the required format. Verify that the user running the utility has read access to the file.

Unable to open file for write: PATH The utility was unable to write to the specified file.

Ensure that the file is not locked by another process. Verify that the user running the utility has write access to the file.

Invalid command The utility encountered an unsupported command.

Verify that the utility supports the command; also ensure that the command name is spelled correctly.

Invalid date format An utility encountered an invalid date format.

Specify the report generation dates in a supported date format.

FROMDATE DATE cannot be greater than TODATE DATE The utility encountered a to date that is earlier than the from date.

Ensure that the to date in a specified date range is a later date than the from date.

Exceeded maximum number of feedbacks (6) for a day This error is displayed when you exceed the number of feedback that you can submit using the feedback command.

File with the same name already exists in the download path PATH. Please delete the file and rerun the command This error is displayed when you attempt to download a file into a location that already has a file that matches the name of the file being downloaded.

Delete, rename or move the existing file and then rerun the command.

File is empty: PATH This error is displayed if the replay file does not have any content.

Make sure that the replay file (CSV file) lists the credentials (user name and password) and the name of the HAR files that are to be used to run the replay command.

Unable to encrypt the password as localhost cannot be resolved. Ensure that hostnames are mapped properly to IP addresses This error is displayed if the utility is unable to resolve the localhost definition to a MAC address because the hosts file on your computer contains a server name instead of localhost for the address 127.0.0.1.

Ensure that the hosts file specify localhost as the server name for 127.0.0.1

Exit Code 9 Errors

Invalid credentials This error is displayed when the user name or password used with the login command is incorrect.

Specify valid credentials for the environment to which you are attempting to connect.

Authentication failed while executing command. Please retry This error is displayed when basic authentication fails during execution of a command other than login. This error may also occur for HTTP calls when a command execution is retried (up to three times).

Exit Code 11 Errors

Internal server error MESSAGE This error is displayed if the utility encounters unknown exceptions that are not related to HTTP connections. Includes server errors 503 and 500.

Unable to connect to URL: MESSAGE This error is displayed when the server is unavailable. Error message indicates the exception that caused the command to fail.

If the server is unavailable, contact Oracle Support. If the message indicates issues with the URL, verify that the URL that you are using is valid.