How to execute EPM Automate and list of Exit Codes


Windows-

Before running the EPM Automate Utility, ensure that you can access Oracle Planning and Budgeting Cloud from the computer from which you are running the utility.

To run the EPM Automate Utility on a Windows client:

  1. Click Start, then All Programs, then EPM Automate, and then Launch EPM Automate. The Launch EPM Automate command prompt is displayed.
  2. Optional: Navigate to the directory from which you want to perform operations using the EPM Automate Utility.
  3. Optional: Generate a password encryption file. You use the password encryption file to pass encrypted password to initiate a session.
    epmautomate encrypt P@ssword1 myKey C:/mySecuredir/password.epw
    
  4. Start a session as a Service Administrator. Use a command such as the following:
    • Using an unencrypted password:
      epmautomate login serviceAdmin P@ssword1 
      https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain
      
    • Using an encrypted password:
      epmautomate login serviceAdmin C:\mySecuredir\password.epw 
      https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain
      
  5. Enter commands to execute the tasks you want to complete.

    See Exit Codes below.

  6. Sign out of the service instance. Use the following command:
    epmautomate logout
    
    

Linux-

To run the EPM Automate Utility on a Linux client:

  1. Open a terminal window and navigate to the directory where you installed the EPM Automate Utility.
  2. Optional: Generate a password encryption file. You use the password encryption file to pass an encrypted password instead of an unencrypted password to initiate a session.
    epmautomate encrypt P@ssword1 myKey ../misc/encrypt/password.epw
    
  3. Start a session as a Service Administrator. Use a command such as the following:
    • Using an unencrypted password:
      ./bin/epmautomate.sh login serviceAdmin P@ssword1 
      https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain
      
    • Using an encrypted password:
      ./bin/epmautomate.sh login serviceAdmin ../misc/encrypt/password.epw 
      https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain
      
  4. Enter commands to execute the tasks you want to complete.

    See Exit Codes below.

  5. Sign out of the service instance. Use the following command:
    ./bin/epmautomate.sh logout

 

Exit Codes –

The EPM Automate Utility returns an exit code to indicate the status of the operation. Additionally, the utility creates a log file (COMMANDNAME_TIMESTAMP.log, for example,uploadfile_16_08_2016_11_27_10.log) for each failed command execution.

Table 2-1 EPM Automate Utility Exit Codes

Status Code Description
0 Operation completed without errors.
1 Command failed to execute because of a functional error.A message, which identifies the functional error that caused command execution failure, is displayed.
6 Service is not available.Similar to HTTP Error 404, this code indicates that the server could not find what was requested by the utility. This is not a functional error.
7 Invalid command.The command you attempted to execute is not supported by the utility or the command usage is incorrect. All client-side processing issues are reported using this code.
9 Invalid credentials or the credentials you used do not have sufficient privileges to complete the current operation.Similar to HTTP Error 401. Verify that the user name, password, and identity domain that you specified are valid.
11 Internal server error. This code indicates all internal errors excluding those that are not handled by other exit codes.Similar to HTTP Error 500. If the problem persists, contact Oracle.
Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s