{"id":84,"date":"2023-02-17T10:45:34","date_gmt":"2023-02-17T10:45:34","guid":{"rendered":"https:\/\/oiv10wp.athena-dev.net\/?page_id=84"},"modified":"2023-02-17T10:55:38","modified_gmt":"2023-02-17T10:55:38","slug":"installation-and-verification","status":"publish","type":"page","link":"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/installation-and-verification\/","title":{"rendered":"Installation and Verification"},"content":{"rendered":"\t\t\t\t\t\t\t<h3 style=\"margin-bottom:20px ;display:block;width:100%;margin-top:10px\">Installation and Verification <\/h3>\r\n\t\t\t\t\t\t\t\t<style>\r\n\t\t\t\t\r\n\t\t\t\t\t#tab_container_83 {\r\n\toverflow:hidden;\r\n\tdisplay:block;\r\n\twidth:100%;\r\n\tborder:0px solid #ddd;\r\n\tmargin-bottom:30px;\r\n\t}\r\n\r\n#tab_container_83 .tab-content{\r\n\tpadding:20px;\r\n\tborder: 1px solid #e6e6e6 !important;\r\n\tmargin-top: 0px;\r\n\tbackground-color:#ffffff !important;\r\n\tcolor: #000000 !important;\r\n\tfont-size:16px !important;\r\n\tfont-family: Open Sans !important;\r\n\t\r\n\t\tborder: 1px solid #e6e6e6 !important;\r\n\t}\r\n#tab_container_83 .wpsm_nav-tabs {\r\n    border-bottom: 0px solid #ddd;\r\n}\r\n#tab_container_83 .wpsm_nav-tabs > li.active > a, #tab_container_83 .wpsm_nav-tabs > li.active > a:hover, #tab_container_83 .wpsm_nav-tabs > li.active > a:focus {\r\n\tcolor: #000000 !important;\r\n\tcursor: default;\r\n\tbackground-color: #ffffff !important;\r\n\tborder: 1px solid #e6e6e6 !important;\r\n}\r\n\r\n#tab_container_83 .wpsm_nav-tabs > li > a {\r\n    margin-right: 0px !important; \r\n    line-height: 1.42857143 !important;\r\n    border: 1px solid #d5d5d5 !important;\r\n    border-radius: 0px 0px 0 0 !important; \r\n\tbackground-color: #e8e8e8 !important;\r\n\tcolor: #000000 !important;\r\n\tpadding: 15px 18px 15px 18px !important;\r\n\ttext-decoration: none !important;\r\n\tfont-size: 14px !important;\r\n\ttext-align:center !important;\r\n\tfont-family: Open Sans !important;\r\n}\r\n#tab_container_83 .wpsm_nav-tabs > li > a:focus {\r\noutline: 0px !important;\r\n}\r\n\r\n#tab_container_83 .wpsm_nav-tabs > li > a:before {\r\n\tdisplay:none !important;\r\n}\r\n#tab_container_83 .wpsm_nav-tabs > li > a:after {\r\n\tdisplay:none !important ;\r\n}\r\n#tab_container_83 .wpsm_nav-tabs > li{\r\npadding:0px !important ;\r\nmargin:0px;\r\n}\r\n\r\n#tab_container_83 .wpsm_nav-tabs > li > a:hover , #tab_container_83 .wpsm_nav-tabs > li > a:focus {\r\n    color: #000000 !important;\r\n    background-color: #e8e8e8 !important;\r\n\tborder: 1px solid #d5d5d5 !important;\r\n\t\r\n}\r\n#tab_container_83 .wpsm_nav-tabs > li > a .fa{\r\n\r\nmargin-right:5px !important;\r\n\r\nmargin-left:5px !important;\r\n\r\n\r\n}\r\n\r\n\t\t#tab_container_83 .wpsm_nav-tabs a{\r\n\t\t\tbackground-image: none;\r\n\t\t\tbackground-position: 0 0;\r\n\t\t\tbackground-repeat: repeat-x;\r\n\t\t}\r\n\t\t\t\r\n\r\n\r\n#tab_container_83 .wpsm_nav-tabs > li {\r\n    float: left;\r\n    margin-bottom: -1px !important;\r\n\tmargin-right:0px !important; \r\n}\r\n\r\n\r\n#tab_container_83 .tab-content{\r\noverflow:hidden !important;\r\n}\r\n\r\n\r\n@media (min-width: 769px) {\r\n\r\n\t#tab_container_83 .wpsm_nav-tabs > li{\r\n\t\tfloat:left !important ;\r\n\t\t\t\tmargin-right:-1px !important;\r\n\t\t\t\t\t}\r\n\t#tab_container_83 .wpsm_nav-tabs{\r\n\t\tfloat:none !important;\r\n\t\tmargin:0px !important;\r\n\t}\r\n\r\n\t#tab_container_83 .wpsm_nav-tabs > li {\r\n\t\t\t\t\r\n\t}\r\n\t#tab_container_83 .wpsm_nav{\r\n\t\t\t}\r\n\r\n}\r\n\r\n\r\n\r\n@media (max-width: 768px) {\r\n\t#tab_container_83 .wpsm_nav-tabs > li {\r\n\t\t\t\t\r\n\t}\r\n\t#tab_container_83 .wpsm_nav{\r\n\t\t\t}\r\n}\r\n\r\n\r\n\t.wpsm_nav-tabs li:before{\r\n\t\tdisplay:none !important;\r\n\t}\r\n\r\n\t@media (max-width: 768px) {\r\n\t\t\t\t\r\n\t\t\t\t.wpsm_nav-tabs{\r\n\t\t\tmargin-left:0px !important;\r\n\t\t\tmargin-right:0px !important; \r\n\t\t\t\r\n\t\t}\r\n\t\t\t\t#tab_container_83 .wpsm_nav-tabs > li{\r\n\t\t\tfloat:none !important;\r\n\t\t}\r\n\t\t\t\r\n\t}\t\t\t\t<\/style>\r\n\t\t\t\t<div id=\"tab_container_83\" >\r\n\t \r\n\t\t\t\t\t<ul class=\"wpsm_nav wpsm_nav-tabs\" role=\"tablist\" id=\"myTab_83\">\r\n\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t<li role=\"presentation\"  class=\"active\"  onclick=\"do_resize()\">\r\n\t\t\t\t\t\t\t\t<a href=\"#tabs_desc_83_1\" aria-controls=\"tabs_desc_83_1\" role=\"tab\" data-toggle=\"tab\">\r\n\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<i class=\"fa fa-laptop\"><\/i> \t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t<span>C++<\/span>\r\n\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t<\/a>\r\n\t\t\t\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t<li role=\"presentation\"  onclick=\"do_resize()\">\r\n\t\t\t\t\t\t\t\t<a href=\"#tabs_desc_83_2\" aria-controls=\"tabs_desc_83_2\" role=\"tab\" data-toggle=\"tab\">\r\n\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<i class=\"fa fa-laptop\"><\/i> \t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t<span>Java<\/span>\r\n\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t<\/a>\r\n\t\t\t\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t<li role=\"presentation\"  onclick=\"do_resize()\">\r\n\t\t\t\t\t\t\t\t<a href=\"#tabs_desc_83_3\" aria-controls=\"tabs_desc_83_3\" role=\"tab\" data-toggle=\"tab\">\r\n\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<i class=\"fa fa-laptop\"><\/i> \t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t<span>.Net<\/span>\r\n\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t\t\r\n\t\t\t\t\t\t\t\t<\/a>\r\n\t\t\t\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t\t\t\t\t <\/ul>\r\n\r\n\t\t\t\t\t  <!-- Tab panes -->\r\n\t\t\t\t\t  <div class=\"tab-content\" id=\"tab-content_83\">\r\n\t\t\t\t\t\t\t\t\t\t\t\t <div role=\"tabpanel\" class=\"tab-pane  in active \" id=\"tabs_desc_83_1\">\r\n\t\t\t\t\t\t\t\t<div id=\"installation-procedure-tab-0\" class=\"rtbs_content active\"><p><a href=\"#win\">Windows<\/a> - <a href=\"#linux\">Linux<\/a> - <a href=\"#linuxheadless\">Linux Headless<\/a><\/p>\r\n<hr>\r\n<h5><a name=\"win\"><\/a>Windows<\/h5>\r\n<ul>\r\n<li><a href=\"#Administrator privileges\">Administrator privileges<\/a><\/li>\r\n<li><a href=\"#MSVerify\">Verify adequate disk space<\/a><\/li>\r\n<li><a href=\"#MSInstallers\">Details on installers<\/a><\/li>\r\n<li><a href=\"#MSInstallProc\">Toolkit installation process<\/a><\/li>\r\n<li><a href=\"#UsingSamplePrograms\">Using example programs<\/a><\/li>\r\n<li><a href=\"#MSEssentialVC\">Essential MSVC++ settings<\/a><\/li>\r\n<li><a href=\"#MSConfigMSVC\">Configuring MSVC++<\/a><\/li>\r\n<li><a href=\"#MSUn-Installing\">Uninstalling Open Inventor<\/a><\/li>\r\n<\/ul>\r\n<p><a name=\"Administrator privileges\"><\/a><strong>Administrator privileges <\/strong>Administrator privileges are required to install Open Inventor. If you do not have Administrator privileges on the machine where you are installing, Setup will not be able to create the Open Inventor program group or set up the Open Inventor environment variables at the System (all users) level. User privileges are modified using the <strong>User Accounts<\/strong>.<\/p>\r\n<p><strong><a name=\"MSVerify\"><\/a>Verify adequate disk space<\/strong> See the <a href=\"https:\/\/developer.openinventor.com\/index.php\/syst-req\/open-inventor-10\/\">System Requirements<\/a>.<\/p>\r\n<p><strong>Overview<\/strong> topic for disk space requirements. <strong><a name=\"MSInstallers\"><\/a>Details on installers<\/strong> <strong>Open Inventor Toolkit <\/strong>The package contains the include files, libraries, utilities, example programs, data files, and C++ reference manual in Windows help format. Example: OpenInventorC++1000-Windows-Visual2012-x86_64.exe <strong><a name=\"MSInstallProc\"><\/a>Toolkit installation process<\/strong><\/p>\r\n<ol>\r\n<li><strong>Welcome dialog <\/strong><\/li>\r\n<li><strong>License Agreement dialog <\/strong><\/li>\r\n<li><strong>Components selection dialog<\/strong> You can choose to install or not the SDK, the runtime environment (debug or PDB files, release is mandatory), example programs (source code or binaries), and reference manual.<\/li>\r\n<li><strong>Installation location dialog<\/strong> Setup will suggest a default location for the installation, e.g., <strong>C:&#92;OpenInventor&#92;10.0.0 C++ Visual2012 x64,<\/strong>\u00a0and allows you to select a different location if desired. We recommend using a directory name that includes the version number. Avoid using the Windows operating systems <strong>C:&#92;Program Files<\/strong> directory because it protects its content and you will not be able to edit and build example programs.<\/li>\r\n<li><strong>Start Menu Folder dialog<\/strong> You can choose the Windows Start Menu folder. The default is to use the same name as for the installation folder.<\/li>\r\n<li><strong>Install<\/strong> All Open Inventor files will be installed into the selected installation directory. With one exception (see MSVC++ below), the installer does not put any files in system directories, only in the selected installation directory.<\/li>\r\n<li><strong>Copy License dialog<\/strong> At this step, the installer asks to locate the file containing the license strings necessary to unlock the product that you should have received from our licensing team. The environment variable OIV_LICENSE_FILE is set to the path of this file in the user's environment.<\/li>\r\n<li><strong>Environment Variables<\/strong> Setup will set the following environment variables for all users (added to the System environment variables): <strong>OIVHOME<\/strong>, <strong>OIVARCH<\/strong>, <strong>OIV_LICENSE_FILE and\u00a0<\/strong><strong>QT_QPA_PLATFORM_PLUGIN_PATH<\/strong>\u00a0. Installer will also add to the <strong>PATH <\/strong>variable the path to the Open Inventor DLLs.\u00a0<strong>If you downloaded the zip archive<\/strong>: please be sure to set these variables manually in you environment. <strong>OIVHOME<\/strong> must be set to the path to your Open Inventor installation and <strong>OIVARCH<\/strong> to the (something like <strong>arch-Windows-x86_64-msvc12-release<\/strong>). Then in your <strong>PATH<\/strong> variable add the %OIVHOME%\/%OIVARCH%\/bin directory. <strong>OIV_LICENSE_FILE<\/strong> must, of course, point to the <strong>complete path<\/strong> of valid license file.NOTE: Environment variable changes do not affect running programs. To ensure that changes are applied, you may need to: \u2022 Log out and log in again, -OR- \u2022 Open the Control Panel, open the System applet, click on <strong>Advanced<\/strong>, click on <strong>Environment Variables,<\/strong> and click on <strong>OK<\/strong>.<\/li>\r\n<li><strong>Program Group <\/strong> Setup will create the following icons in the Open Inventor group.\r\n<ul>\r\n<li>IvTune viewer: an application for viewing Open Inventor files.<\/li>\r\n<li>Online documentation: a link to the Open Inventor Developer Zone containing the full documentation.<\/li>\r\n<li>Samples browser: a program to browse and run the Open Inventor example programs.<\/li>\r\n<\/ul>\r\n<p>For a complete list of installed files, see <a href=\"http:\/\/bod-rd-docserv1\/node\/18339\" target=\"_parent\">Open Inventor files.<\/a><\/p><\/li>\r\n<li><strong>Completing the installation: <\/strong>The last installation dialog allows you to launch the Open Inventor <strong>Samples browser<\/strong>, to read the Readme file, and to access the online documentation. To validate the installation, run the <strong>Samples browser<\/strong> and try to run some demonstration programs. See the <a href=\"#UsingSamplePrograms\">Using example programs<\/a> chapter for validation of the development environment.<\/li>\r\n<\/ol>\r\n<p><strong><a name=\"UsingSamplePrograms\"><\/a>Using example programs<\/strong><\/p>\r\n<p>The Open Inventor toolkit comes with hundreds of example programs showing how to use the various features. The source code of these programs is located in the <strong>%OIVHOME%\/examples\/source<\/strong> directory. All example programs are already built and ready to be run after installation as soon as the environment variables are set. The Samples Browser program can be used to browse these example programs, to run them, and to read their documentation (if it is available) and to access the source code directory. Visual Studio projects are also available in each subdirectory for building and testing them. Each project can be reused or modified freely for experimenting. If you wish to generate your own Makefiles or project using <strong>CMake<\/strong>, please read the <a href=\"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/howto-building-examples\/\" target=\"_blank\">Build Examples section<\/a> for more details.<\/p>\r\n<p><strong><a name=\"MSEssentialVC\"><\/a>Essential MSVC++ settings for an Open Inventor project <\/strong>There are numerous ways to create an Open Inventor project in Visual C++. You can also modify one of the provided Open Inventor make files or project files for your own project. You can also create simple projects from scratch or add Open Inventor support to an existing project.<\/p>\r\n<p>Here are some guidelines for Open Inventor projects.<\/p>\r\n<ul>\r\n<li><strong>Run-Time Library <\/strong>Open Inventor is compiled with (and absolutely requires) the runtime library option <strong>Multithreaded DLL<\/strong> (or <strong>Debug Multithreaded DLL<\/strong>).<strong>Visual Studio<\/strong>\r\n<ol>\r\n<li>In the <strong>Project<\/strong> menu, select <strong>Properties<\/strong>.<\/li>\r\n<li>In the left pane of the <strong>Property Pages<\/strong> dialog, open the <strong>C\/C++<\/strong> folder.<\/li>\r\n<li>In the left pane, click on <strong>Code Generation<\/strong>.<\/li>\r\n<li>In the right pane, click on <strong>Runtime Library<\/strong>, and from the list box, select <strong>Multi-threaded DLL <\/strong>(or <strong>Multi-threaded Debug DLL<\/strong> for the debug target).<\/li>\r\n<\/ol>\r\n<\/li>\r\n<li><strong>Open Inventor Libraries <\/strong>The Open Inventor header files contain<strong> #pragma<\/strong> statements that automatically request the linker to search the necessary libraries.<strong>One exception is \"UNIX style\" programs<\/strong> (i.e., programs that have a <strong>main<\/strong> function), that are Windows applications, not console applications. These applications must include InventorU(D).LIB in the link string because they require a WinMain function, which is supplied by the InventorU library. Generally we recommend using a console application for this type of project.NOTE: For UNIX style programs that <strong>do<\/strong> have a main and that <strong>are<\/strong> Windows apps, we now recommend using <strong>SoWinApp.h<\/strong> in your application to simplify some of the housekeeping details.\r\n<p>It has pragma statements to include the current version of InventorU.LIB and InventorUD.LIB. It also has the following statements so you no longer need to insert them directly in your code:<\/p>\r\n<pre>#ifdef _WIN32\r\n\t#  define main ivMain\r\n#endif<\/pre>\r\n<\/li>\r\n<\/ul>\r\n<p><strong><a name=\"MSConfigMSVC\"><\/a>Configuring MSVC++ for use with Open Inventor <\/strong><br>\r\nYou can use property sheets to create project configurations that can be applied to multiple projects since project settings that are defined in <strong>.props<\/strong> files are inheritable, unlike project settings defined in Project Files (.vcxproj files). Therefore, a project configuration defined in a <strong>.vcxproj<\/strong> file can inherit project settings from one or more property sheets (.props files). For more information, see MSDN. In this file you can specify include path for Open Inventor include directory (e.g.,%OIVHOME%&#92;include) and library path for libraries directories (e.g., %OIVHOME%&#92;arch-...-release&#92;lib and %OIVHOME%&#92;arch-...-debug&#92;lib).<\/p>\r\n<p><strong><a name=\"MSUn-Installing\"><\/a>Uninstalling Open Inventor<\/strong><br>\r\nAccording to Operating System you have different procedure to uninstall Open Inventor. For example for Windows 7, it can be removed with the <strong>Programs<\/strong>\u00a0<strong>and Features<\/strong>\u00a0in the <strong>Control Panel.\u00a0<\/strong>Select <strong>Open Inventor C++ 10.0.0 Visual2012 x64\u00a0<\/strong>from the list and\u00a0uninstall it.<\/p>\r\n<hr>\r\n<h5><a name=\"linux\"><\/a>Linux<\/h5>\r\n<ul>\r\n<li><a href=\"#LinuxRoot\">Root privileges<\/a><\/li>\r\n<li><a href=\"#LinuxVerify\">Verify adequate disk space<\/a><\/li>\r\n<li><a href=\"#LinuxSelectDir\">Select an installation directory<\/a><\/li>\r\n<li><a href=\"#LinuxPassword\">Set up the License Key<\/a><\/li>\r\n<li><a href=\"#LinuxEnvVar\">Set the environment variables<\/a><\/li>\r\n<li><a href=\"#LinuxDemos\">Using sample programs<\/a><\/li>\r\n<li><a href=\"#GenerateMakefile\">Generate sample makefile<\/a><\/li>\r\n<li><a href=\"#LinuxUninstalling\">Un-installing Open Inventor<\/a><\/li>\r\n<\/ul>\r\n<p><a name=\"LinuxRoot\"><\/a><strong>Root privileges<\/strong><br>\r\nIn 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).<\/p>\r\n<p><strong><a name=\"LinuxVerify\"><\/a>Verify adequate disk space <\/strong><br>\r\nSee the <a href=\"https:\/\/developer.openinventor.com\/index.php\/syst-req\/open-inventor-10\/\">System Requirements<\/a>.<\/p>\r\n<p><strong><a name=\"LinuxSelectDir\"><\/a>Select an installation directory<\/strong><br>\r\nYou 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, \"OpenInventor1000\". The default installation directory is \/usr\/local\/OpenInventorCpp. To install in this directory, you will need root privileges. <\/p>\r\n<p><strong>Installation Instructions<\/strong><\/p>\r\n<ul>\r\n<li>RPM package (for RPM-based Linux Platforms)\r\n<ol>\r\n<li>Become root by running su and entering the super-user password.<\/li>\r\n<li>Download and install the cmake RPM package (required).<\/li>\r\n<li>Install Extra Packages for Enterprise Linux (EPEL) to satisfy the CMake (cmake3) dependency.<\/li>\r\n<li>Install the Open Inventor RPM package:\r\n<pre>yum install epel-release<\/pre>\r\n<pre>yum localinstall [PACKAGE_NAME]<\/pre>\r\n<p>This command will install Open Inventor C++ package and all dependencies (except for cmake):<\/p>\r\n<pre>rpm -ivh --prefix [PACKAGE_NAME]<\/pre>\r\n<\/li>\r\n<\/ol>\r\n<\/li>\r\n<li>DEB package (for Ubuntu and DEB-based Linux Platforms)\r\n<ol>\r\n<li>Become administrator by running su and entering the administrator password<\/li>\r\n<li>sudo dpkg -i [PACKAGE_NAME] and follow instructions<br>\r\nPlease note that some dependancies may have to be installed manually during the process (dpkg will display needed information).<\/li>\r\n<\/ol>\r\n<\/li>\r\n<li>Compressed archive (for Linux Platforms)\r\n<ol>\r\n<li>Copy the archive in the folder where you want to install it<\/li>\r\n<li>Uncompress the Open Inventor package in the destination directory\r\n<pre>  cd \/usr\/local\/  \r\n  tar -xzvf [PACKAGE_NAME]<\/pre>\r\n<\/li>\r\n<\/ol>\r\n<\/li>\r\n<\/ul>\r\n<p><strong><a name=\"LinuxPassword\"><\/a>Set up the License key <\/strong><br>\r\nPlease read the <a href=\"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/licensing-mechanism\/\">Licensing<\/a> section for more details. <\/p>\r\n<p><strong><a name=\"LinuxEnvVar\"><\/a>Set the environment variables<\/strong><br>\r\nTo use Open Inventor, all users must initialize Open Inventor environment variables. Set the following environment variable to compile, link and run programs:<\/p>\r\n<ul>\r\n<li><strong>OIVHOME<\/strong> to the folder where is installed Open Inventor. For example <code>setenv OIVHOME \/usr\/local\/OpenInventor<\/code><\/li>\r\n<li><strong>OIVARCH<\/strong> to define Release or Debug. For example, <code>setenv OIVARCH arch-Linux-x86_64-gcc44-release<\/code><\/li>\r\n<\/ul>\r\n<p>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 <strong>SoPreferences<\/strong> in the Reference Manual for more information. Some System environment variables must also be set or updated<\/p>\r\n<ul>\r\n<li>The shared library path (<strong>LD_LIBRARY_PATH<\/strong>) must be specified. The library path contains the list of directories to search for the shared libraries. For example, to set the library path: <code>setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${OIVHOME}\/${OIVARCH}\/lib<\/code><\/li>\r\n<li><strong>MOTIFHOME <\/strong>should be set to specify where to find the Motif directory (contains include and lib directories for Motif). For example: <code>setenv MOTIFHOME \/usr <\/code><\/li>\r\n<li><strong>OGLHOME <\/strong>should be set to specify where to find the OpenGL directory (contains include and lib directories for OpenGL). For example: <code>setenv OGLHOME \/usr\/local\/OpenGL <\/code><\/li>\r\n<li><strong>XAPPLRESDIR <\/strong>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,\r\n<ol>\r\n<li>cd $OIVHOME\/app-defaults<\/li>\r\n<li>rm Inventor<\/li>\r\n<li>ln -s Inventor.french Inventor<\/li>\r\n<\/ol>\r\n<p>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.<\/p><\/li>\r\n<\/ul>\r\n<p><strong><a name=\"LinuxDemos\"><\/a>Using sample programs <\/strong><br>\r\nThe 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 <em>($OIVHOME\/$OIVARCH\/bin\/ivBrowser)<\/em> can be used to browse these sample programs, to run them and to read their documentation it it exists. Generate\u00a0sample makefile Binaries of\u00a0Open 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 <a href=\"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/howto-building-examples\/\" target=\"_blank\">Build samples instructions<\/a> section for more details. <\/p>\r\n<p><strong><a name=\"LinuxUninstalling\"><\/a>Un-installing Open Inventor<\/strong><\/p>\r\n<ul>\r\n<li>RPM package (for RPM-based Linux Platforms)\r\n<ul>\r\n<li>To uninstall Open Inventor, use the RPM manager:\r\n<pre class=\"rteindent2\">rpm -e OpenInventorC++<\/pre>\r\n<\/li>\r\n<li>To find the version number of the installed package you can type:\r\n<pre>yum list | grep OpenInventor<\/pre>\r\n<\/li>\r\n<\/ul>\r\n<\/li>\r\n<li>DEB package (for DEB-based Linux Platforms)\r\n<ul>\r\n<li>To uninstall Open Inventor, use the DEB\u00a0manager:\r\n<pre>dpkg --remove OpenInventorC++<\/pre>\r\n<\/li>\r\n<li>To find the version number of the installed package you can type:\r\n<pre>dpkg -l | grep OpenInventor<\/pre>\r\n<\/li>\r\n<\/ul>\r\n<\/li>\r\n<li>Compressed archive (for Linux Platforms)\r\n<ul>\r\n<li>To uninstall Open Inventor, remove the installation folder:\r\n<pre>rm -rf \/usr\/local\/OpenInventor<\/pre>\r\n<\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<hr>\r\n<h5><a name=\"linuxheadless\"><\/a>Linux Headless<\/h5>\r\n<ul>\r\n<li><a href=\"#LinuxHRoot\">Root privileges<\/a><\/li>\r\n<li><a href=\"#LinuxHVerify\">Verify adequate disk space<\/a><\/li>\r\n<li><a href=\"#LinuxHSelectDir\">Select an installation directory<\/a><\/li>\r\n<li><a href=\"#LinuxHLoad\">Install Open Inventor<\/a><\/li>\r\n<li><a href=\"#LinuxHPassword\">Set up the License Key<\/a><\/li>\r\n<li><a href=\"#LinuxHEnvVar\">Set the environment variables<\/a><\/li>\r\n<li><a href=\"#LinuxHUninstalling\">Un-installing Open Inventor<\/a><\/li>\r\n<\/ul>\r\n<p><a name=\"LinuxHRoot\"><\/a><strong>Root privileges<\/strong><br>\r\nIn 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).<\/p>\r\n<p><strong><a name=\"LinuxVerify\"><\/a>Verify adequate disk space<\/strong><br>\r\nSee the <a href=\"https:\/\/developer.openinventor.com\/index.php\/syst-req\/open-inventor-10\/\">System Requirements<\/a><\/p>\r\n<p><strong><a name=\"LinuxSelectDir\"><\/a>Select an installation directory<\/strong><br>\r\nYou 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, \"OpenInventor1000\". The default installation directory is \/usr\/local\/OpenInventorCpp. To install in this directory, you will need root privileges.<\/p>\r\n<p><strong><a name=\"LinuxHLoadTgz\"><\/a>Install Open Inventor Headless from compressed archive<\/strong><\/p>\r\n<ol>\r\n<li>Copy the archive to your Open Inventor home folder<\/li>\r\n<li>Uncompress the Open Inventor package in the destination directory\r\n<pre>  cd \/usr\/local\/  \r\n  tar -xzvf [PACKAGE_NAME]<\/pre>\r\n<\/li>\r\n<\/ol>\r\n<p><strong><a name=\"LinuxHLoadDeb\"><\/a>Install Open Inventor from .DEB package<\/strong><\/p>\r\n<ol>\r\n<li>Become administrator by running su and entering the administrator password<\/li>\r\n<li>Enter following command\r\n<pre>sudo dpkg -i [PACKAGE_NAME]<\/pre>\r\n<p>and follow instructions<\/p><\/li>\r\n<\/ol>\r\n<p>Please note that some dependancies may have to be installed manually during the process (dpkg will display needed information).<\/p>\r\n<p><strong><a name=\"LinuxPassword\"><\/a>Set up the License key <\/strong><br>\r\nPlease read the <a href=\"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/licensing-mechanism\/\">Licensing<\/a> section for more details.<\/p>\r\n<p><strong><a name=\"LinuxEnvVar\">Set the environment variables<\/a><\/strong><br>\r\nTo use Open Inventor, all users must initialize Open Inventor environment variables. Set the following environment variable to compile, link, and run programs:<\/p>\r\n<ul>\r\n<li><strong>OIVHOME<\/strong> to where is installed Open Inventor Headless. For example, <code>setenv OIVHOME \/usr\/local\/OpenInventor<\/code><\/li>\r\n<li><strong>OIVARCH<\/strong> to select Release or Debug libs. For example, <code>setenv OIVARCH arch-Linux-x86_64-gcc44-release<\/code><\/li>\r\n<\/ul>\r\n<p>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 <strong>SoPreferences<\/strong> in the Reference Manual for more information. Set or update also following system variables<\/p>\r\n<ul>\r\n<li>The shared library path (<strong>LD_LIBRARY_PATH<\/strong>) must be specified. The library path contains the list of directories to search for the shared libraries. For example, to set the library path: <code>setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${OIVHOME}\/${OIVARCH}\/lib<\/code><\/li>\r\n<li><strong>MOTIFHOME <\/strong>should be set to specify where to find the Motif directory (contains include and lib directories for Motif). For example: <code>setenv MOTIFHOME \/usr <\/code><\/li>\r\n<li><strong>OGLHOME <\/strong>should be set to specify where to find the OpenGL directory (contains include and lib directories for OpenGL). For example: <code>setenv OGLHOME \/usr\/local\/OpenGL <\/code><\/li>\r\n<li><strong>XAPPLRESDIR <\/strong>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,\r\n<ol>\r\n<li>cd $OIVHOME\/app-defaults<\/li>\r\n<li>rm Inventor<\/li>\r\n<li>ln -s Inventor.french Inventor<\/li>\r\n<\/ol>\r\n<p>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.<\/p><\/li>\r\n<\/ul>\r\n<p><strong><a name=\"LinuxUninstalling\"><\/a>Un-installing Open Inventor<\/strong><br>\r\nTo uninstall Open Inventor remove the installation folder if installed from tar.gz package<\/p>\r\n<pre>rm -rf \/usr\/local\/OpenInventor<\/pre>\r\n<p>or use the DEB manager if installed from .DEB package<\/p>\r\n<pre>dpkg --remove OpenInventorC++<\/pre>\r\n<div style=\"margin-top:30px;clear:both\"><\/div><\/div>\t\t\t\t\t\t <\/div>\r\n\t\t\t\t\t\t\t\t\t\t\t\t <div role=\"tabpanel\" class=\"tab-pane \" id=\"tabs_desc_83_2\">\r\n\t\t\t\t\t\t\t\t<div id=\"installation-procedure-tab-1\" class=\"rtbs_content\"><p><a href=\"#javawin\">Windows<\/a> - <a href=\"#javalin\">Linux<\/a><\/p>\r\n<hr>\r\n<h5><a name=\"javawin\"><\/a>Windows<\/h5>\r\n<p><a href=\"#InstallationInformation\">General installation information<\/a><br>\r\n<a href=\"#ToolkitInstallation\">Toolkit installation<\/a><br>\r\n<a href=\"#EnvVar\">Environment variables<\/a><br>\r\n<a href=\"#LaunchExamples\">Run Examples<\/a><br>\r\n<a href=\"#InstallAsJavaExt\">Install as Java extension (optional)<\/a><\/p>\r\n<p><a name=\"InstallationInformation\"><\/a><strong>General installation information<\/strong><\/p>\r\n<p style=\"text-align: justify\">In order to install Open Inventor Java see requirements on page&nbsp;<a href=\"https:\/\/developer.openinventor.com\/index.php\/syst-req\/open-inventor-10\/\">System Requirements<\/a>.<\/p>\r\n<p style=\"text-align: justify\">This page describes how to install Open Inventor Java on Windows platform. The Java classes are cross-platform but the native runtimes must be installed for each platform.<\/p>\r\n<p style=\"text-align: justify\">The URL links to download Open Inventor installers are delivred by the upgrade e-mail. If you select the link: \"<strong>Download Open Inventor Java<\/strong>\", a download page is opened and you can select the desired package \"<strong>for Windows\"<\/strong>&nbsp;platform: executable (.exe) or compressed (.zip) version for 64-bit.<\/p>\r\n<p style=\"text-align: justify\">Administrator&nbsp;privileges are required to install the executable package Open Inventor. If you do not have administrator&nbsp;privileges on the machine, please use the compressed version (.zp) and set the Open Inventor environment variables, see&nbsp;<a href=\"#EnvVar\">Environment variables<\/a>&nbsp;for details.<\/p>\r\n<p><strong><a name=\"ToolkitInstallation\"><\/a>Toolkit installation<\/strong><\/p>\r\n<p>Open Inventor toolkit package is available as executable installer (.exe) or compressed zip file (.zip):<\/p>\r\n<p class=\"rteindent1\" style=\"padding-left: 40px\">OpenInventorJava-Windows.exe\/.zip<\/p>\r\n<p>This package contains&nbsp;JAR files, native shared libraries, example programs, data files&nbsp;and Java reference manual.<\/p>\r\n<p>For compressed package .zip, create your own home directoty and unzip the folder. For instance open Command Prompt (note that unzip.exe should be installed) and type:<\/p>\r\n<pre class=\"rteindent1\">mkdir JavaHome\r\ncd JavaHome\r\nunzip &#92;OpenInventorJava1000-Windowsx86_64.zip\r\n<\/pre>\r\n<p>Then the environment should be set: see&nbsp;<a href=\"#EnvVar\">Environment variables<\/a>&nbsp;section for more details.<\/p>\r\n<p>For the executable installer .exe, see below the steps of the installation procedure:<\/p>\r\n<ol>\r\n<li><strong>Welcome dialog<\/strong><\/li>\r\n<li><strong>License Agreement dialog<\/strong><\/li>\r\n<\/ol>\r\n<p class=\"rteindent1\">Your Open Inventor Java requires a license. Please read the <a href=\"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/licensing-mechanism\/\">Licensing<\/a>&nbsp;page for details.<\/p>\r\n<ol>\r\n<li style=\"list-style-type: none\">\r\n<ol>\r\n<li><strong>Components selection dialog<\/strong><br>\r\nYou can select to install or not&nbsp;the example programs or reference manual.<\/li>\r\n<li><strong>Installation location dialog<\/strong><br>\r\nSetup will suggest a default location for the installation, e.g., <strong>C:&#92;OpenInventor&#92;10.0.0 Java x64,<\/strong>&nbsp;and allows you to select a different location if desired. We recommend using a directory name that includes the version number.<br>\r\nAvoid using the Windows operating systems <strong>C:&#92;Program Files<\/strong>&nbsp;directory because it protects its contents and you will not be able to edit and build example programs.<\/li>\r\n<li><strong>Start Menu Folder dialog<\/strong><br>\r\nYou can choose the Windows Start Menu folder. The default is to use the same name as for the installation folder.<\/li>\r\n<li><strong>Install<\/strong><br>\r\nAll Open Inventor files will be installed into the selected directory. The installation procedure sets all necessary environment variable. See <a href=\"#EnvVar\">Environment variables<\/a>&nbsp;for more details.<\/li>\r\n<li><strong>Copy License dialog<\/strong><br>\r\nAt this step, the installer asks you to locate the file containing the license strings necessary to unlock the product. You should have received this file from our licensing team. Please refer to the <a href=\"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/licensing-mechanism\/\">Licensing<\/a>&nbsp;page for details. The environment variable OIV_LICENSE_FILE is set to the path of this file in the user's environment. The file name is usually password.dat.<\/li>\r\n<li><strong>Complete installation dialog<\/strong>: it is possible to select to run \"Open inventor samples browser\".<\/li>\r\n<\/ol>\r\n<\/li>\r\n<\/ol>\r\n<p><strong><a name=\"EnvVar\"><\/a>Environment variables<br>\r\n<\/strong>Once the installation is done, you may need to define some environment variables. Note that the installation package configures the environment itself, so you only need to define following variables <strong>if you used the compressed archive of Open Inventor Java<\/strong>:<\/p>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li><strong>OIVJHOME:&nbsp;<\/strong>the Open Inventor Java home installation directory.<strong>&nbsp;<\/strong><\/li>\r\n<li>The library path&nbsp;<strong>PATH:<\/strong>&nbsp;it must contain the path to the native libraries of Open Inventor Java: %OIVJHOME%&#92;jre&#92;bin.<\/li>\r\n<li><strong>OIV_LICENSE_FILE<\/strong>:&nbsp;this is necessary if&nbsp;the default&nbsp;license file %<em>OIVJHOME%&#92;license&#92;password.dat<\/em>&nbsp;is not used.&nbsp;This variable must&nbsp;contain the absolute path to the license file password.dat. Please read the&nbsp;<a href=\"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/licensing-mechanism\/\">Licensing<\/a>&nbsp;page for details.<\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p><a id=\"LaunchExamples\" name=\"LaunchExamples\"><\/a><strong>Run examples<br>\r\n<\/strong>Each demo can be executed by using the delivered JAR files:<\/p>\r\n<pre class=\"rteindent1\">cd %OIVJHOME%&#92;examples&#92;inventor&#92;mentor&#92;examiner\r\njava -jar Main.jar\r\n<\/pre>\r\n<p>A browser of all demos, called <strong>Demos launcher<\/strong> is delivered in the package. To run it, type:<\/p>\r\n<pre class=\"rteindent1\">cd %OIVJHOME%&#92;examples&#92;launcher\r\njava -jar Main.jar<\/pre>\r\n<p>Or you can use the <em>DemosLauncher.bat<\/em>&nbsp;script available in %OIVJHOME%<\/p>\r\n<p>See below a screenshot of the application:<\/p>\r\n<p class=\"rtecenter\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-422\" src=\"https:\/\/web.archive.org\/web\/20220523120110im_\/https:\/\/developer.openinventor.com\/wp-content\/uploads\/2019\/08\/JavaDemosLauncher.png\" alt=\"\" width=\"890\" height=\"587\"><\/p>\r\n<p>To run a demo, double-click the item or select te auto-launch feature.<\/p>\r\n<p>If you are not able to run demos, please check if Java Runtime Environment is installed (i.e. type java -version in Command Prompt) and if the version is compatible with the Open Inventor packages selected.<\/p>\r\n<p>If Java is not available, you will have to download and install the Java JDK RPM package (required):&nbsp;<a href=\"http:\/\/www.oracle.com\/technetwork\/java\/javase\/downloads\/index.html\" target=\"_blank\" rel=\"noopener\">Oracle Jdk<\/a> if Open Inventor <strong>10.8<\/strong> or less, Open JDK if Open Inventor <strong>10.9<\/strong> or more<\/p>\r\n<p>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 , the messages will be printed in the log file).<\/p>\r\n<p>Otherwise check the&nbsp;<a href=\"https:\/\/developer.openinventor.com\/index.php\/syst-req\/open-inventor-10\/\">System requirements<\/a>&nbsp;page for more details.<\/p>\r\n<p><a name=\"InstallAsJavaExt\"><\/a><strong>Installation as Java Extension (optional)<\/strong><\/p>\r\n<p>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:<\/p>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li>Open Inventor Java has privileged permission (despite Open Inventor JAR files not being signed),<\/li>\r\n<li>Open Inventor JAR files are automatically found by the JVM, so you do not need to add them to the CLASSPATH environment variable,<\/li>\r\n<li>the shared libraries *.dll are automatically found by the JVM, so you do not need to add them to the library path PATH.<\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p>See <a href=\"http:\/\/docs.oracle.com\/javase\/tutorial\/ext\/index.html\">the Java Extension Mechanism<\/a>&nbsp;or the <a href=\"http:\/\/docs.oracle.com\/javase\/tutorial\/ext\/basics\/index.html\">Java Tutorials<\/a> for additional information about Java extensions.<\/p>\r\n<hr>\r\n<h5><a name=\"javalin\"><\/a>Linux<\/h5>\r\n<p><a name=\"javalin\"><\/a><br>\r\n<a href=\"#GeneralInformation\">General installation information<\/a><br>\r\n<a href=\"#toolkitInstallation\">Toolkit installation<\/a><br>\r\n<a href=\"#EnvVar\">Environment variables<\/a><br>\r\n<a href=\"#InstallAsJavaExt\">Install as Java extension (optional)<\/a><br>\r\n<a href=\"#LinuxUninstalling\">Un-installing Open Inventor<\/a><\/p>\r\n<p style=\"text-align: justify\"><a name=\"GeneralInformation\"><\/a><strong>General&nbsp;installation information<br>\r\n<\/strong>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.<\/p>\r\n<p style=\"text-align: justify\">The URL links to download Open Inventor installers are delivred by the upgrade e-mail. If you select the link: \"<strong>Download Open Inventor Java<\/strong>\", a download page is opened and you can select the desidered package \"<strong>for Red Hat Enterprise Linux\"<\/strong>&nbsp;platform: .RPM for 64-bit or .TAR.GZ for 64-bit, or for \"<strong>for Ubuntu 18.04<\/strong>\" platform : .DEB for 64-bit or .TAR.GZ 64-bit.<\/p>\r\n<p><strong><a name=\"toolkitInstallation\"><\/a>Toolkit installation<br>\r\n<\/strong>The Open Inventor Toolkit for Linux is distributed as a RPM package and a compressed archive. The default installation directory is \/usr\/local. To install in this directory, you will need root privileges.<\/p>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li><strong>RPM package (for RPM-based Linux Platforms)<\/strong><\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p class=\"rteindent1\" style=\"padding-left: 40px\">The toolkit package name is: <em>OpenInventorJava-Linux-.rpm<\/em><\/p>\r\n<p class=\"rteindent1\" style=\"padding-left: 40px\"><strong>Installation Instructions <\/strong><\/p>\r\n<p class=\"rteindent1\" style=\"padding-left: 80px\">1. Become root by running su and entering the super-user password.<\/p>\r\n<p class=\"rteindent1\" style=\"padding-left: 80px\">2. Download and install the Java JDK RPM package (required):&nbsp;<a href=\"http:\/\/www.oracle.com\/technetwork\/java\/javase\/downloads\/index.html\" target=\"_blank\" rel=\"noopener\">Oracle Jdk<\/a> if Open Inventor <strong>10.8<\/strong> or less, Open JDK if Open Inventor <strong>10.9<\/strong> or more<\/p>\r\n<p class=\"rteindent1\" style=\"padding-left: 80px\">3. Install the Open Inventor RPM package<\/p>\r\n<pre class=\"rteindent1\" style=\"padding-left: 80px\"><em>  yum localinstall OpenInventorJava--Linux--.rpm <\/em><\/pre>\r\n<p class=\"rteindent1\" style=\"padding-left: 80px\">&nbsp;&nbsp;&nbsp; This command will install Open Inventor Java package and all dependencies (except for Java JDK).<\/p>\r\n<p class=\"rteindent1\" style=\"padding-left: 80px\">You can change the default installation directory by using the following command:<\/p>\r\n<pre class=\"rteindent1\" style=\"padding-left: 80px\"><em>   rpm -ivh --prefix  <em>OpenInventorJava--Linux--.rpm <\/em><\/em><\/pre>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li><strong>DEB package (for DEB-based Linux Platforms)<\/strong><\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p class=\"rteindent1\" style=\"padding-left: 40px\">The toolkit package name is: <em>openinventorjava__amd64.deb<\/em><\/p>\r\n<p class=\"rteindent1\" style=\"padding-left: 40px\"><strong>Installation Instructions<\/strong><\/p>\r\n<ol>\r\n<li style=\"list-style-type: none\">\r\n<ol>\r\n<li style=\"list-style-type: none\">\r\n<ol>\r\n<li style=\"list-style-type: none\">\r\n<ol class=\"rteindent1\">\r\n<li>Become administrator&nbsp;by running su and entering the super-user password.<\/li>\r\n<li>Download and install the Java JDK RPM package (required): <a href=\"http:\/\/www.oracle.com\/technetwork\/java\/javase\/downloads\/index.html\" target=\"_blank\" rel=\"noopener\">Oracle Jdk<\/a> if Open Inventor <strong>10.8<\/strong> or less, Open JDK if Open Inventor <strong>10.9<\/strong> or more<\/li>\r\n<li>Install the Open Inventor DEB package<\/li>\r\n<\/ol>\r\n<\/li>\r\n<\/ol>\r\n<\/li>\r\n<\/ol>\r\n<\/li>\r\n<\/ol>\r\n<p class=\"rteindent2\" style=\"padding-left: 120px\">dpkg -i <em>openinventorjava__amd64.deb<\/em> and follow instructions<em>&nbsp;<\/em><\/p>\r\n<p class=\"rteindent2\" style=\"padding-left: 40px\">Please note that some dependancies may have to be installed manually during the process (dpkg will display needed information).<\/p>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li><strong>Compressed archive (for Linux Platforms)<\/strong><\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p class=\"rteindent1\">The toolkit package name is: <em>OpenInventorJava-Linux-.tar.gz<\/em><\/p>\r\n<p class=\"rteindent1\"><strong>Installation Instructions <\/strong><\/p>\r\n<ol class=\"rteindent1\">\r\n<li>Copy the archive to your Open Inventor home folder<\/li>\r\n<li>Uncompress the Open Inventor package in the destination directory<\/li>\r\n<\/ol>\r\n<pre class=\"rteindent1\">   cd \/usr\/local\/  \r\n   tar -xzvf <em>OpenInventorJava-Linux-.tar.gz<\/em><\/pre>\r\n<hr>\r\n<p>The Open Inventor package contains the include JAR files, native shared libraries, example programs, data files, and Java reference manual.<\/p>\r\n<p>The Open Inventor Java Toolkit requires a license. Please read the&nbsp;<a href=\"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/licensing-mechanism\/\">Licensing<\/a>&nbsp;page for details.<\/p>\r\n<p>The installed package contains a folder <em>$OIVJHOME\/demos<\/em>&nbsp;for the Java examples. It contains many examples to show how to use Open Inventor features using the Java API.<\/p>\r\n<p>You can run the Open Inventor Java examples by using the delivered JAR files:<\/p>\r\n<pre class=\"rteindent1\">cd ${OIVJHOME}\/<em>examples<\/em>\/inventor\/mentor\/examiner\r\njava -jar Main.jar\r\n<\/pre>\r\n<p>A browser of all demos, called <strong>Demos launcher<\/strong> is delivered in the package. To run it, type:<\/p>\r\n<pre class=\"rteindent1\">cd ${OIVJHOME}<em>\/examples\/launcher<\/em>\r\njava -jar Main.jar<\/pre>\r\n<p>Or you can use the <em>DemosLauncher.sh<\/em>&nbsp;script available in %OIVJHOME%<\/p>\r\n<p>See below a screenshot of the application:<\/p>\r\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-422\" src=\"https:\/\/web.archive.org\/web\/20220523120110im_\/https:\/\/developer.openinventor.com\/wp-content\/uploads\/2019\/08\/JavaDemosLauncher.png\" alt=\"\" width=\"890\" height=\"587\"><\/p>\r\n<p style=\"text-align: justify\">To run an example, double-click the item or select the auto-launch feature.<\/p>\r\n<p style=\"text-align: justify\">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.<\/p>\r\n<p style=\"text-align: justify\">If Java is not available, download :<\/p>\r\n<ul>\r\n<li>Oracle Jdk if you're using Open Inventor&nbsp;<strong>v10.8<\/strong>&nbsp;or less<\/li>\r\n<li>Open Jdk if you're using Open Inventor&nbsp;<strong>v10.9<\/strong>&nbsp;or more<\/li>\r\n<\/ul>\r\n<p style=\"text-align: justify\">Then install it and re-run the Open Inventor examples.<\/p>\r\n<p style=\"text-align: justify\">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 the messages will be printed in the log file).<\/p>\r\n<p style=\"text-align: justify\">Otherwise check the&nbsp;<a href=\"https:\/\/developer.openinventor.com\/index.php\/syst-req\/open-inventor-10\/\">System requirements<\/a>&nbsp;page for more details.<\/p>\r\n<p><a name=\"EnvVar\"><\/a><strong>Environment variables<\/strong><\/p>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li><strong>OIVJHOME&nbsp;<\/strong>must be set to the Open Inventor Java home installation directory,<\/li>\r\n<li>The library path&nbsp;<strong>LD_LIBRARY_PATH&nbsp;<\/strong>must contain the path to the native libraries of Open Inventor Java:\r\n<ul>\r\n<li>Linux 64-bit: ${OIVJHOME}\/jre\/lib\/amd64<\/li>\r\n<\/ul>\r\n<\/li>\r\n<li><strong>OIV_LICENSE_FILE<\/strong>:&nbsp;this is necessary if&nbsp;the default&nbsp;license file&nbsp;<em>${OIVJHOME}\/license\/password.dat<\/em>&nbsp;is not used.&nbsp;This variable must&nbsp;contain the absolute path to the license file password.dat. Please read the&nbsp;<a href=\"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/licensing-mechanism\/\">Licensing<\/a>&nbsp;page for details.<\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p style=\"text-align: justify\"><a name=\"InstallAsJavaExt\"><\/a><strong>Installation as Java Extension (optional)<br>\r\n<\/strong>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.<\/p>\r\n<p>Installing the runtime files inside Java causes Open Inventor Java to be considered a standard Java extension, with the following benefits:<\/p>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li>Open Inventor Java has privileged permission (despite Open Inventor JAR files not being signed),<\/li>\r\n<li>Open Inventor JAR files are automatically found by the JVM, so you do not need to add them to the CLASSPATH environment variable,<\/li>\r\n<li>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.<\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p>See&nbsp;the <a href=\"http:\/\/docs.oracle.com\/javase\/tutorial\/ext\/index.html\">Java Extension Mechanism&nbsp;<\/a>or the <a href=\"http:\/\/docs.oracle.com\/javase\/tutorial\/ext\/basics\/index.html\">Java Tutorial<\/a> for additional information about Java extensions.<\/p>\r\n<p><a name=\"LinuxUninstalling\"><\/a><strong> Un-installing Open Inventor<\/strong><\/p>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li>RPM package (for RPM-based Linux Platforms)<\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p class=\"rteindent1\">To uninstall Open Inventor, use the RPM manager:<\/p>\r\n<pre class=\"rteindent2\">rpm -e OpenInventorJava\r\n<\/pre>\r\n<p class=\"rteindent1\">To find the version number of the installed package you can type:<\/p>\r\n<pre class=\"rteindent2\">yum list | grep OpenInventor\r\n<\/pre>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li><strong>DEB package (for DEB-based Linux Platforms)<\/strong><\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p class=\"rteindent1\">To uninstall Open Inventor, use the DEB manager:<\/p>\r\n<pre class=\"rteindent2\">dpkg --remove OpenInventorJava\r\n<\/pre>\r\n<p class=\"rteindent1\">To find the version number of the installed package you can type:<\/p>\r\n<pre class=\"rteindent2\">dpkg -l | grep OpenInventor<\/pre>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li><strong>Compressed archive (for Linux Platforms)<\/strong><\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p class=\"rteindent1\">To uninstall Open Inventor, remove the installation folder.<\/p>\r\n<pre class=\"rteindent2\">rm -rf \/usr\/local\/OpenInventor\r\n<\/pre>\r\n<div style=\"margin-top:30px;clear:both\"><\/div><\/div>\t\t\t\t\t\t <\/div>\r\n\t\t\t\t\t\t\t\t\t\t\t\t <div role=\"tabpanel\" class=\"tab-pane \" id=\"tabs_desc_83_3\">\r\n\t\t\t\t\t\t\t\t<div id=\"installation-procedure-tab-2\" class=\"rtbs_content\"><h5>Windows<\/h5>\r\n<p>This page describes how to install Open Inventor .NET on the supported platforms. The current version of Open Inventor .NET is available for the following platforms:<\/p>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li>Windows 7 (32-bit or 64-bit)<\/li>\r\n<li>Windows 10 (32-bit or 64-bit)<\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<p>Use the installer provided with the product to automatically install Open Inventor .NET. Be sure to install the version of Open Inventor .NET that is appropriate for your platform (32-bit or 64-bit).<\/p>\r\n<hr>\r\n<p><a href=\"#WindowsInstaller\">Toolkit installation process<\/a><br><a href=\"#License\">Setup the license key<\/a><br><a href=\"#GenerateProject\">Generate projects of demonstration programs <\/a><\/p>\r\n<p><strong><a name=\"WindowsInstaller\"><\/a>Toolkit installation process<\/strong><\/p>\r\n<p>Open Inventor .NET is provided on Windows with an InstallShield\u2122 installer. below the main steps:<\/p>\r\n<ol>\r\n<li style=\"list-style-type: none\">\r\n<ol>\r\n<li><strong>Information dialog<\/strong><\/li>\r\n<li><strong>License Agreement dialog<\/strong><\/li>\r\n<li><strong>Components selection dialog<\/strong><br>You can choose to install or not the SDK, the runtime environment (debug or PDB files, the release is mandatory), examples programs (source code or binaries) and reference manual.<\/li>\r\n<li><strong>Installation location dialog<\/strong><br>Setup will suggest a default location for the installation, e.g.,&nbsp;<strong>C:&#92;OpenInventor&#92;9.4.0 .NET Visual2012 x64,<\/strong>&nbsp;and allows you to select a different location if desired. We recommend using a directory name that includes the version number.<br>Avoid using the Windows operating systems&nbsp;<strong>C:&#92;Program Files<\/strong>&nbsp;directory because it protects its content and you will not be able to edit and build example programs.<\/li>\r\n<li><strong>Start Menu Folder dialog<\/strong><br>You can choose the Windows Start Menu folder. The default is to use the same name as for the installation folder.<\/li>\r\n<li><strong>Install process<\/strong><br>All Open Inventor files will be installed into the selected installation directory.<\/li>\r\n<li><strong>Copy License dialog<\/strong><br>At this step, the installer asks to locate the file containing the license strings necessary to unlock the product that you should have received from our licensing team. The environment variable OIV_LICENSE_FILE is set to the path of this file in the user's environment.<\/li>\r\n<li><strong>Environment variables<\/strong><br>Setup will set the following environment variables for all users (added to the System environment variables):&nbsp;<strong>OIVNETHOME<\/strong>,&nbsp;<strong>OIVARCH<\/strong>,&nbsp;<strong>OIV_LICENSE_FILE<\/strong>.<strong>&nbsp;<\/strong>Note OIVARCH is necessary only to run the delivered example programs.<\/li>\r\n<li><strong>Completing the installation<\/strong><br>The last installation dialog allows access to the online documentation.<\/li>\r\n<\/ol>\r\n<\/li>\r\n<\/ol>\r\n<p><a name=\"License\"><\/a><strong>Setup the license key<br><\/strong>Your Open Inventor .NET software requires a license key. Please read the <a href=\"https:\/\/developer.openinventor.com\/index.php\/general-documentation\/licensing-mechanism\/\" target=\"_blank\" rel=\"noopener\">License<\/a> section for more details.<\/p>\r\n<p><a name=\"GenerateProject\"><\/a><strong>Generate projects of demonstration programsT<\/strong>the <strong>Premake<\/strong> tool can be used to generate the Visual Studio projects of the Open Inventor example programs. It uses one <strong>premake5.lua<\/strong> file for each example program.<\/p>\r\n<p><span style=\"font-family: courier new,dejavu sans mono,monospace;font-size: 1.1em\"><em><strong>premake5<\/strong><\/em> vs2017|<\/span><span style=\"font-family: courier new,dejavu sans mono,monospace;font-size: 18px\">vs2015<\/span><\/p>\r\n<p>The premake5 executable is available in the %OIVNETHOME%&#92;tools directory.<\/p>\r\n<p>See&nbsp;<a href=\"https:\/\/premake.github.io\/\">https:\/\/premake.github.io\/<\/a>&nbsp;for details about the&nbsp;<strong>Premake<\/strong> tool.<\/p>\r\n<p><strong>Example 1<\/strong>: rebuild one demonstration project<\/p>\r\n<ol>\r\n<li style=\"list-style-type: none\">\r\n<ol>\r\n<li>cd %OIVNETHOME%&#92;src&#92;Inventor&#92;examples&#92;Mentor&#92;CSharp&#92;_02_1_HelloCone<\/li>\r\n<li><em><strong>premake5<\/strong> <\/em>vs2012<\/li>\r\n<\/ol>\r\n<\/li>\r\n<\/ol>\r\n<p>Build or rebuild _02_1_HelloCone.csproj and _02_1_HelloCone.sln for Visual Studio 2012.<\/p>\r\n<p><strong>Example 2<\/strong>: rebuild several demonstration projects at once, and one solution for all of them<\/p>\r\n<ol>\r\n<li style=\"list-style-type: none\">\r\n<ol>\r\n<li>cd %OIVNETHOME%&#92;src&#92;Inventor&#92;examples&#92;Mentor&#92;CSharp<\/li>\r\n<li><em><strong>premake5<\/strong><\/em> vs2012<\/li>\r\n<\/ol>\r\n<\/li>\r\n<\/ol>\r\n<p>Build or rebuild a list of csproj and one InventorMentor.sln solution for Visual Studio 2012.<\/p>\r\n<p>Note: All of these projects are created by referencing to Open Inventor assemblies using <strong>OIVNETHOME<\/strong> and <strong>OIVARCH<\/strong> environment variables in the HintPath. For instance, OIV.Inventor assembly is defined by the following line in the generated project:<\/p>\r\n<pre> $(OIVNETHOME)&#92;assemblies&#92;$(OIVARCH)&#92;OIV.Inventor.dll   \r\n<\/pre>\r\n<p>If you prefer to generate csproj files that do not use HintPath you can use the --ignoreHintPath option:<\/p>\r\n<pre>   <em><strong>premake5<\/strong><\/em> --ignoreHintPath vs2015|vs2013|vs2012 \r\n<\/pre>\r\n<p>General help is available using the following command:<\/p>\r\n<pre>   <em><strong>premake5<\/strong><\/em> --help<\/pre>\r\n<p>In any case, please note that it's recommended to use the option&nbsp;--platform=x64 (or x86) to be compatible with the OIV assemblies you are using.<\/p>\r\n<p>Examples:<\/p>\r\n<ul>\r\n<li style=\"list-style-type: none\">\r\n<ul>\r\n<li><em><strong>premake5<\/strong><\/em> --platform=x64 vs2012 (for 64 bits version of Visual Studio 2012)<\/li>\r\n<li><em><strong>premake5<\/strong><\/em> --platform=x86 vs2012 (for 32 bits version of Visual Studio 2012)<\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ul>\r\n<div style=\"margin-top:30px;clear:both\"><\/div><\/div>\t\t\t\t\t\t <\/div>\r\n\t\t\t\t\t\t\t\r\n\t\t\t\t\t <\/div>\r\n\t\t\t\t\t \r\n\t\t\t\t <\/div>\r\n <script>\r\n\t\tjQuery(function () {\r\n\t\t\tjQuery('#myTab_83 a:first').tab('show')\r\n\t\t});\r\n\t\t\r\n\t\t\t\tjQuery(function(){\r\n\t\t\tvar b=\"fadeIn\";\r\n\t\t\tvar c;\r\n\t\t\tvar a;\r\n\t\t\td(jQuery(\"#myTab_83 a\"),jQuery(\"#tab-content_83\"));function d(e,f,g){\r\n\t\t\t\te.click(function(i){\r\n\t\t\t\t\ti.preventDefault();\r\n\t\t\t\t\tjQuery(this).tab(\"show\");\r\n\t\t\t\t\tvar h=jQuery(this).data(\"easein\");\r\n\t\t\t\t\tif(c){c.removeClass(a);}\r\n\t\t\t\t\tif(h){f.find(\"div.active\").addClass(\"animated \"+h);a=h;}\r\n\t\t\t\t\telse{if(g){f.find(\"div.active\").addClass(\"animated \"+g);a=g;}else{f.find(\"div.active\").addClass(\"animated \"+b);a=b;}}c=f.find(\"div.active\");\r\n\t\t\t\t});\r\n\t\t\t}\r\n\t\t});\r\n\t\t\r\n\r\n\t\tfunction do_resize(){\r\n\r\n\t\t\tvar width=jQuery( '.tab-content .tab-pane iframe' ).width();\r\n\t\t\tvar height=jQuery( '.tab-content .tab-pane iframe' ).height();\r\n\r\n\t\t\tvar toggleSize = true;\r\n\t\t\tjQuery('iframe').animate({\r\n\t\t\t    width: toggleSize ? width : 640,\r\n\t\t\t    height: toggleSize ? height : 360\r\n\t\t\t  }, 250);\r\n\r\n\t\t\t  toggleSize = !toggleSize;\r\n\t\t}\r\n\r\n\r\n\t<\/script>\r\n\t\t\t\t\r\n\t\t\t\n","protected":false},"excerpt":{"rendered":"","protected":false},"author":3,"featured_media":0,"parent":63,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-84","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/developer.openinventor.com\/index.php\/wp-json\/wp\/v2\/pages\/84","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.openinventor.com\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/developer.openinventor.com\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/developer.openinventor.com\/index.php\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.openinventor.com\/index.php\/wp-json\/wp\/v2\/comments?post=84"}],"version-history":[{"count":2,"href":"https:\/\/developer.openinventor.com\/index.php\/wp-json\/wp\/v2\/pages\/84\/revisions"}],"predecessor-version":[{"id":86,"href":"https:\/\/developer.openinventor.com\/index.php\/wp-json\/wp\/v2\/pages\/84\/revisions\/86"}],"up":[{"embeddable":true,"href":"https:\/\/developer.openinventor.com\/index.php\/wp-json\/wp\/v2\/pages\/63"}],"wp:attachment":[{"href":"https:\/\/developer.openinventor.com\/index.php\/wp-json\/wp\/v2\/media?parent=84"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}