Troubleshooting Common REST API

To make sure that  Common REST API (CRA) receives and displays data, confirm the Java directory configuration.

Issue

Your Tomcat job STDOUT log shows the following error message:

Probable Cause

The error message indicates that the Tomcat environment is not correctly pointing to the Java 8 31-bit for one of the following reasons:

1. You applied BP00472 and the IBM SDK Java 8.0 31-bit is not in the default /usr/lpp/java/J8.0 directory.
2. Your Tomcat server is pointing to the correct Java directory, but updates to the Java package changed the Java SDK library location in your mainframe.

Resolution

To resolve this error, if you have not yet applied PTF BP00472, apply the PTF and run the CRAUNTAR job to complete the configuration. When the job is finished, restart the Tomcat server. For more information on running the CRAUNTAR job, see your APAR documentation.

If you still see the error, your Tomcat server is probably not in the default directory. Perform the following steps:

1. Open the CRASYMLK job and update the installation path for the BMC AMI Ops UI.
   Use the absolute path to the Java 8 31-bit directory in your environment.
2. Run the CRASYMLK job and make sure it executes with return code 0.
3. Restart the Tomcat started task for the BMC AMI Ops UI.

Issue

The started task seems to be running, but the URL https://<tomcat_host>:<tomcat_port>/cra is not accessible.

Probable Cause

The cause could be one of the following:

• The communications protocol (HTTP or HTTPS) is not set up properly.
  To identify this as the cause, look for HTTP or HTTPS exceptions in the STDERR log.
• The CRAZFS job did not run properly.
  To identify this as the cause verify that the following three subdirectories are defined under <installationDirectory>/amiops.
  • config
  • tomcat
  • java 

Resolution

Use the appropriate resolution for your identified cause:

• If the problem is the communications protocol, follow the appropriate instructions in Setting-up-the-Common-REST-API.

  Note

  HTTPS is the default protocol for CRA. Using HTTPS requires a certificate.

• Run the CRAZFS job again, and make sure it finishes successfully with return code zero.
• If neither of the causes listed here applies, contact BMC support.