Preparing the Java Environment

Before you install the SPMS API/Apps server,

  1. Ensure the JDK is installed.

  2. Ensure that you have a tool for manipulating certificates installed.

Setting JAVA_HOME or JRE_HOME environment variable

  1. Located our Java installation directory.

  2. Press Windows logo key + R key to open the Run dialog.

  3. Type sysdm.cpl in the input field and click OK

  4. At the System Properties dialog, go to Advanced tab.

  5. Click the Environment Variables button.

  6. Under System Variables section, look for JAVA_HOME or JRE_HOME variable.

  7. If it exists, click the Edit button to open the Edit System Variable window.

  8. Otherwise click New button to open the New System Variable dialog.

  9. On the New/Edit System variable dialog, Variable name field, insert one of the following:

    • JAVA_HOME if you have the JDK (Java Development Kit) installed.

    • JRE_HOME if you have the JRE (Java Runtime Environment) installed.

    • For the Variable value click the Browse Directory and select the JDK/JRE installation folder, for example “C:\Program Files\Java\[java version]”

  10. Click OK to apply the changes.

Adding Java to System Path

  1. Click the Environment Variables button, then select Edit to edit the system environment variable.

  2. Under System Variables, located the ‘Path’ then click Edit.

  3. At the Edit environment variable window, select New.

  4. Insert %JAVA_HOME%\bin or %JRE_HOME%\bin to the path.

  5. If multiple Java directory entries is present, move this directory to the top of the list using the Move Up/Move Down button.

  6. Click OK to apply the change.

Check Java Path

To list the different Java versions and installed path, launch the Windows Command and at the prompt, enter “where java”. The first in the list will be used by the API. Move the required Java version above the other directories. See Adding Java to System Path section on how to move the directory.

Installation Process

Installation is a three-step process, where:

  • Step 1: Create a Java keystore containing certificates purchased from a reputable Certificate Authority

  • Step 2: Generate security keys for OAuth

  • Step 3: Install the software