Installation & Verification - C++ - Linux

Root privileges

Verify adequate disk space

Select an installation directory

Load Open Inventor from your installation media

Set up the License Key

Set the environment variables

Check the installation

Documentation installation

Generate sample makefile

Un-installing Open Inventor


Root privileges

In order to install Open Inventor, you must be allowed to write into the installation directory. If the location you have chosen (e.g., /usr/local) requires root privileges, then you must have root privileges to do the installation (and subsequent upgrades or uninstallation).

Verify adequate disk space

See the System Requirements Overview topic for disk space requirements.

Select an installation directory

You can install the Open Inventor SDK anywhere on your system. It is highly recommended that you use an empty directory for your new Open Inventor installation. The directory may have any name you like. We suggest you choose the name "OpenInventor" with the current version number appended. For example, "OpenInventor900".

The default installation directory is /usr/local. To install in this directory, you will need root privileges.

Load Open Inventor from your installation media

The Open Inventor Toolkit is distributed as a compressed archive.

The toolkit package name is:

OpenInventorC++-<product release>-Linux-<compiler release>-<architecture>.tar.gz

Product release is 910.
Compiler release may be gcc41, gcc44.
Architecture may be 32 for i386(P4) or 64 for x86_64(AMD64 and Xeon64).

Uncompress and untar the package in the destination directory.

Set up the License key

Your Open Inventor software is computer ID locked. Please read the Licensing section for more details.

Set the environment variables

Open Inventor environment variables

To use Open Inventor, all users must initialize Open Inventor environment variables. Set the following environment variable to compile, link, and run programs:

  • OIVHOME to <path_to_your_Open_Inventor_installation>
    For example,
    setenv OIVHOME /usr/local/OpenInventor
  • OIVARCH to <architecture directory>
    For example,
    setenv OIVARCH arch-Linux-x86_64-gcc41-release

OIVARCH is useful to switch between Release and Debug libraries.

Other optional environment variables specific to Open Inventor and its extensions can be set. Please refer to SoPreferences in the Reference Manual for more information.

System environment variables

  • The shared library path (LD_LIBRARY_PATH) must be specified. The library path contains the list of directories to search for the shared libraries.
    • For example, to set the library path:
      setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${OIVHOME}/${OIVARCH}/lib
  • MOTIFHOME should be set to specify where to find the Motif directory (contains include and lib directories for Motif).
    • For example:
      setenv MOTIFHOME /usr
  • OGLHOME should be set to specify where to find the OpenGL directory (contains include and lib directories for OpenGL).
    • For example:
      setenv OGLHOME /usr/local/OpenGL
  • XAPPLRESDIR must be set to $OIVHOME/app-defaults to use the localized resource files (see the X11 documentation). To use a specific language, you will need to create a link to the desired localized file (English is the default). For example,
    1. cd $OIVHOME/app-defaults
    2. rm Inventor
    3. ln -s Inventor.french Inventor

    NOTE: If you see that "Iv" is prepended to the labels and menu items in your Open Inventor viewer, it most likely means that you did not set XAPPLRESDIR.

Check the installation

The $OIVHOME/$OIVARCH/bin directory contains a test program. To check that the installation is correct, do the following:

  1. cd $OIVHOME/$OIVARCH/bin
  2. ./IvTuneViewer

The program opens a window and displays a scene graph.

NOTE: We assume here that all the required environment variables are set correctly.

Documentation installation

The offline documentation is distributed in a separate package named IOIVC-<product release>-DOC.tar.gz. The archive  contains a set of HTML pages extracted from the Open Inventor Developer Zone that can be used without Internet access. However, some features of this documentation require to access this Developer Zone such as searching for names and for bugs.

To install the documentation uncompress the archive in the installation directory of Open Inventor.

Using sample programs

The Open Inventor toolkit comes with hundreds of sample programs showing how to use the various features. The source code of these programs is located in the $(OIVHOME)/src directory.
All sample programs are already built and ready to be run after installation as soon as the environment variables are set.
The Samples Browser program ($OIVHOME/$OIVARCH/bin/ivBrowser) can be used to browse these sample programs, to run them and to read their documentation it it exists.

Generate sample makefile

Binaries of Open Inventor samples are provided in the package, but if you wish rebuild your own binaries you have to generate makefiles from provided cmakefile .

Please read the Build samples instructions section for more details.

Un-installing Open Inventor

To uninstall Open Inventor, remove the installation folder.