6 Troubleshooting Oracle Application Container Cloud Service

This section describes common problems that you might encounter when using Oracle Application Container Cloud Service and explains how to solve them.

Topics

• My application doesn’t deploy

• My application failed to deploy.

• My application deploys but doesn't run.

• My clustered application deploys but doesn't connect.

• My REST request fails with a 403 error.

My application doesn’t deploy

Your application is of a type that requires a requires a launch command. You upload your application archive in the Create Application dialog but nothing happens. The following error message flashes on the screen:

Unsuccessful upload, because the manifest file named manifest.json could not be found.

Here are some common causes of this problem:

• The manifest.json file is actually missing. It wasn’t at the root of the archive or specified during deployment.

• There is a typo in the name of the manifest.json file.

• The manifest.json file isn’t located in the root directory of the archive. This is the most common reason for this problem.

  Typically, when you zip something to share, you put all the files in a subdirectory and then zip the subdirectory. However, this results in a root directory that contains the subdirectory. Oracle Application Container Cloud Service won’t be able to find the manifest file and therefore will be unable to deploy your application. See Create the Deployment-Ready Archive.

My application failed to deploy.

You upload your application file to Oracle Application Container Cloud Service and it starts to deploy then it shows the “Application failed to deploy” message.

You application failed to deploy. To find out why, do the following:

1. Go to the Applications page. See Using the Applications Page in Using Oracle Application Container Cloud Service.

2. Click the application name.

3. Click the Administration tab then click Logs.

4. Expand Log Capture History to view the log history.

Here are the most common causes of this problem:

• Your launch command is incorrect, possibly due to a typo. See Select the Launch Command.

• Your application archive is missing a dependent library. Make sure your application can launch stand-alone, separate from your build environment. See Make a Standalone Application.

You can redeploy your application. See Redeploying an Application in Using Oracle Application Container Cloud Service.

My application deploys but doesn't run.

Your application runs locally and has deployed successfully, but when you try to test it in Oracle Application Container Cloud Service, you get no response.

The most common cause of this problem is that your application is of a type that is required to read the PORT environment variable provided by the Oracle Application Container Cloud Service container but doesn’t read them. This results in your application listening on the wrong port, unavailable for testing. Oracle Application Container Cloud Service typically listens on SSL port 443 (HTTPS). See Make the Application Configurable at Runtime.

My clustered application deploys but doesn't connect.

Your clustered application deploys successfully, but it can't connect to other cluster-enabled applications.

When you look at the log, you may see a java.net.UnknownHostException error.

The most common cause of this problem is that your application doesn’t have isClustered set to true in the manifest.json file. The isClustered parameter cannot be reset once an application is deployed, so you must delete the application, set the isClustered parameter in the manifest.json file to true, and deploy the application as if it were new.

For descriptions of all the parameters in the manifest.json file, see Create Metadata Files.

My REST request fails with a 403 error.

You submit an Oracle Application Container Cloud Service REST API request and get a 403 Forbidden response.

The most common cause of this error is forgetting to include the user name and password in the request. In a cURL command, you specify these using the -u or --user option. See the Use cURL section in REST API for Managing Applications.