RepreZen API Studio requires 64-bit Java 8 or higher. You may see an error message if you try to install or run API Studio without a compatible Java installation.

Verifying Java Version and Bitness

To verify the version and bitness of your Java installation, you can run java -version from the command line. You should see output like this:

C:\TOOLS>%java_home%\bin\java -version
java version "1.8.0_91"
Java(TM) SE Runtime Environment (build 1.8.0_91-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.91-b14, mixed mode)

Note that the last line specifies "64-bit".  If you see a message that does not specify bitness, this indicates that you are running 32-bit Java. 

Installation Error: "No suitable JDK or JRE found on this system"

Attempting to install API Studio Desktop without a compatible release of API Studio will show an error dialog like this one:

No suitable JDK or JRE found on this system. RepreZen APIStudio requires a 64-bit Java Development Kit (JDK) or Java Runtime Environment (JRE), including versions from 1.8 through 11. No suitable JDK or JRE could be found on this system. Please download and install a suitable JDK, or JRE, before running this installer again.

To resolve this issue: 

  1. Review the Java compatibility guidelines and technical notes for RepreZen API Studio.
  2. Download and install a compatible Java release.
  3. Run the RepreZen API Studio automated installer.

Launch Error: "An error has occurred. See the log file..."

Attempting to run API Studio Desktop with an incompatible release of Java may show an error message like this: 

RepreZen - An error has occurred. See the log file C:\Users\Ted\RepreZen\workspace\.metadata\.log

Usually, this error occurs when you try to launch RepreZen API Studio with a 32-bit JVM.  To resolve this issue:

  1. Review the Java compatibility guidelines and technical notes for RepreZen API Studio.
  2. Verify that you have a compatible 64-bit installation of Java, following the directions in "Verifying Java Version and Bitness" above. 
  3. If you have a compatible Java installation, you can configure API Studio to run with this version. 
  4. Otherwise, download and install a compatible Java release, then run the RepreZen API Studio automated installer.

Launch Error: "No Java virtual machine was found..."

Once API Studio is installed and configured with a specific Java release, if you remove or relocate that Java release and try to start API Studio, you'll see an error message like this:

RepreZen - A Java Runtime environment (JRE) or Java Development Kit (JDK) must be available in order to run RepreZen. No Java virtual machine was found after searching the following locations: C:\Program Files\Java\jre-10.0.2\bin\server\jvm.dll

To resolve this issue: 

  1. Review the Java compatibility guidelines and technical notes for RepreZen API Studio.
  2. Verify that you have a compatible 64-bit installation of Java, following the directions in "Verifying Java Version and Bitness" above. 
  3. If you have a compatible Java installation, you can configure API Studio to run with this version. 
  4. Otherwise, download and install a compatible Java release, then run the RepreZen API Studio automated installer.

Reinstalling API Studio with a 64-bit JDK

If you are still seeing an error message from API Studio on startup, please try the following troubleshooting steps:

  1. Uninstall RepreZen API Studio using the automated uninstall utility.    
    • In Windows:  Control Panel / Programs / Programs and Features / RepreZen API Studio
    • In Mac OS:  there is no automated uninstall.  Proceed to the next step. 
  2. Make sure the RepreZen API Studio directory is removed completely.    
    • In Windows:  By default, this will be the RepreZen/API_Studio directory under your home directory.
    • In Mac OS:  This is the ~/RepreZen directory created during installation. 
  3. Reinstall the JDK.  
    • It is important to install the 64-bit JDK with 64-bit operating systems. A 32-bit JDK will not work correctly. 
  4. Reinstall RepreZen API Studio, using the automated installer.