Installation & Verification - Java - Linux

General installation information

Toolkit installation

Environment variables

Install as Java extension (optional)

Documentation installation (optional)


General installation information

In order to install Open Inventor Java, see the requirements on page System Requirements. The Java™ Runtime Environment (JRE) 1.6, 1.7 or 1.8 or Java™ Development Toolkit (JDK) is required for building and running examples.

This page describes how to install Open Inventor Java on Linux platform. The Java classes are cross-platform but the native runtimes must be installed for each platform.

The URL links to download Open Inventor installers are delivred by the upgrade e-mail. If you select the link: "Download Open Inventor Java", a download page is opend and you can select the desiderd package "for Red Hat Enterprise Linux" platform: .TAR.GZ for 64-bit.

Toolkit installation

The Open Inventor Toolkit for Linux is distributed as a compressed archive TAR archive (.tar.gz.). The toolkit package name is:

OpenInventorJava<product release>-Linux-<architecture>.tar.gz

This package contains the include JAR files, native shared libraries, example programs, data files, and Java reference manual.

The Open Inventor Java Toolkit requires a license. Please read the Licensing page for details.

To install Open Inventor Java, copy the file to your Open Inventor home folder, then uncompress the package. For instance from the Terminal, type:

cd /usr/local/<JavaHome> 
tar -xzvf OpenInventorJava950-Linux-x86_64.tar.gz

The installed package contains a folder $OIVJHOME/demos for the Java examples. It contains many examples to show how to use Open Inventor features using the Java API.

You can run the Open Inventor Java examples, by opening a terminal and typing following commands:

cd ${OIVJHOME}/demos
java inventor.mentor.examiner.Main 

or by using the delivered JAR files:

cd ${OIVJHOME}/demos/inventor/mentor/examiner
java -jar Main.jar

A browser of all examples "Demos launcher" is delivered in the package. To run it type:

cd ${OIVJHOME}/demos
java -jar Main.jar

See below a screenshot of the application:

Demos Launcher java

To run an example, double-click the item or select the auto-launch feature.

If you are not able to run the examples, please check if the Java Runtime Environment is installed (i.e. type java -version in Terminal) and if the version is compatible with the Open Inventor packages selected. If Java is not available, download the right version from the official site, install it, then re-run the Open Inventor examples.

Check the license using the property (or environment variable) OIV_LICENSE_DEBUG. If OIV_LICENSE_DEBUG is equal to 1, when starting any Java application that needs Open Inventor for Java, licensing details are printed (if OIV_LICENSE_DEBUG is equal to <Log filename> the messages will be printed in the log file). 

Otherwise check the System requirements page for more details.

Environment variables

  • OIVJHOME must be set to the Open Inventor Java home installation directory,
  • The library path LD_LIBRARY_PATH must contain the path to the native libraries of Open Inventor Java:
    • Linux 32-bit: ${OIVJHOME}/jre/lib/i386
    • Linux 64-bit: ${OIVJHOME}/jre/lib/amd64
  • OIV_LICENSE_FILE: this is necessary if the default license file ${OIVJHOME}/license/password.dat is not used. This variable must contain the absolute path to the license file password.dat. Please read the Licensing page for details.

If Open Inventor Java is not installed as Java extension, your CLASSPATH and library path must be set:

  • CLASSPATH must contain the path to the following JAR files: 


and when using MeshViz XLM extension: 

  • CLASSPATH can also contain the Open Inventor Java resource file.

This file is delivered in the toolkit package and it is located in the folder ${OIVJHOME}/properties. The name of the resource file is and it can be used to override environment variables. The file contains some comments explaining how to do this. 

Each property defined in this file overrides the environment variable of the same name during the execution of your program. For instance, if a property OIVJHOME is defined, it overrides the environment variable $OIVJHOME.

Installation as Java Extension (optional)

Open Inventor Java can be installed as a Java extension: the Open Inventor runtime files (JAR files and native shared libraries) should be copied into the JRE or JDK.

Installing the runtime files inside Java causes Open Inventor Java to be considered a standard Java extension, with the following benefits:

  • Open Inventor Java has privileged permission (despite Open Inventor JAR files not being signed),
  • Open Inventor JAR files are automatically found by the JVM, so you do not need to add them to the CLASSPATH environment variable,
  • the shared libraries lib*.so are automatically found by the JVM, so you do not need to add them to the library path LD_LIBRARY_PATH.

See the Java Extension Mechanism or the Java Tutorial for additional information about Java extensions.

Documentation installation (optional)

The Open Inventor Developer Zone contains the complete Open Inventor documentation. If no internet access is available, the offline documentation can be used. It is distributed in a separate package:

OpenInventorJava<product release>-Documentation.tar.gz
The archive contains a set of HTML pages extracted from the Open Inventor Developer Zone. Note that in the offline version, some features, like searching and the list of fixed bugs per version, are not available. 
To install the documentation uncompress the archive in the installation directory of Open Inventor Java:


tar -xzvf <path>/OpenInventorJava950-Documentation.tar.gz