Troubleshooting

Common cause: Several resources use the same path with different PATH parameters, and you try to switch between them. ReadyAPI uses path values to determine the resource and cannot see the difference between them.

Suggested solution: Use the provided resource name. The requests will run as expected.

Common cause: The name of the project, test suite, test case, or load test for which you are trying to create a report contains special symbols including but not limited to &, -, /, (, or ).

Suggested solution: Remove all the special symbols from the name.

Common cause: Some macOS users experience problems with ReadyAPI hanging and becoming unresponsive.

Suggested solution: Some users who experienced hanging on macOS have resolved their issues by disabling the internal browser.

• Add the following line to the Applications/<Ready-API-Version>.app/Contents/vmoptions.txt file:

  -Dsoapui.browser.disabled=true

• Restart ReadyAPI.

Common cause: Java 7 or later does not trust the web site that does not have a signed certificate, so ReadyAPI cannot retrieve the definition.

Suggested solution: Add the website that holds your service definition to the Java Exceptions List. This list is stored in the (<System>\Sun\Java\Deployment\Security\exception.sites) file. Java does not check certificates for files on this list. For detailed instructions on modifying the exceptions list, see the Java documentation.

Common cause: ReadyAPI may stop responding when running a large number of test suites and test cases in parallel.

Suggested solution: Each test step you run in parallel consumes threads available to ReadyAPI. Once it runs out of threads, ReadyAPI can no longer respond to your actions or continue the test run.

Modify your test to use fewer test cases and test suites or run some test cases or test suites in sequence.

Common cause: ReadyAPI may stop responding when working with Groovy code.

Suggested solution: ReadyAPI uses the Jshint command-line process to automatically validate the Groovy syntax. This may cause ReadyAPI to hang.

A possible workaround is to disable syntax checking. To do this:

• Add the following line to the vmoptions file:

  -Dgroovy.disable.syntax.checking=false

• Restart ReadyAPI.

Common causes:

• There is not enough RAM to start the Java virtual machine.

• The Java virtual machine tried to use Java options that cannot be used to run ReadyAPI.

Suggested solutions:

• Make sure you run ReadyAPI on a computer that meets the minimum system requirements.

• Remove the JAVA_TOOL_OPTIONS and _JAVA_OPTIONS OS environment variables.

Common cause: Antimalware software does not allow JxBrowser to write information to the AppData folder.

Suggested solution: Configure JxBrowser to write information to another folder that is accessible without admin permissions. To do that, add the following line to the vmoptions file: -Djxbrowser.chromium.dir=<NEW_PATH>, where <NEW_PATH> is the path to the folder that JxBrowser should write information to.

Common cause: You imported a large OpenAPI\Swagger definition.

Suggested solution: Disable the creation of request samples. To do this, add the following JVM options:

To learn how to do it, see Modifying JVM Settings.

Common cause: the first request may have some delay caused by the Apache HttpClient library used by ReadyAPI. This is a known limitation.