Runtime configuration

To run Java API programs, make sure your execution environment includes:

  • Java Runtime Environment (JRE) 1.8.40 or later.
  • Required JAR files in the CLASSPATH environment variable or the java command -classpath command-line parameter. 
  • All the JAR files in the lib directory.
Warning

Installing Encryption Premium Security changes all active Java installations.

If you install Encryption Premium Security on a system that is running a client written using the AR System Java API and later change the Java installation (by installing a different version of the Java Runtime Environment (JRE) or Java Development Kit (JDK) or switching the system from one installed Java version to another), you must reinstall Encryption Premium Security to ensure that the new or other Java installation has the changes.

Changing the default configuration

To override the default Java API configuration, create the arsys_api.xml configuration file and make sure it is in the CLASSPATH environment variable or the java command -classpath command-line parameter. See the sample configuration file, arsys_sample.xml, in the lib directory for descriptions, valid values, and default values for the API configuration options.

Running the Java driver program

  1. Set the Java environment variable as follows:
    export PATH=/opt/jdk<JDK-Install-Dir>/bin:$path
  2. Check the Java version by running java -version. If the correct version is displayed, it means that Java is enabled.
  3. Run the following command from the AR install directory (opt/bmc/ars):
    java -classpath /opt/bmc/ars<AR Install Dir>/api/lib/javadriver.jar:./api/lib/arapi91_build010.jar:./api/lib/arlogger-9.1.11-SNAPSHOT.jar:. com.bmc.arsys.demo.javadriver.JavaDriver

Running the Windows driver program

Click driver for wind32 or driver_win64 from C:\Program Files\BMC Software\ARSystem<AR Install Dir>\Arserver\api. Then from the DOS window, run the required command.

You can also invoke Java driver in Windows from the following path:

C:\Program Files\BMC Software\ARSystem<AR Install Dir>\Arserver\api\lib\javadriver.bat

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*