TeraRecon, Inc. Real Time Visualization June-19-2001 =================================================== This document provides the information needed to install VolumePro V2.10 software on to a Solaris 2.6.x and Solaris 8 systems. You must be "root" to install the software. There are four packages for Solaris systems. S56_CC5.tar for compiled on Solaris 2.6 with WS V5.0 S56_CC6.tar for Solaris 2.6 with WS V6.0 S8_CC5.tar for Solaris 8 with WS V5.0 S8_CC6.tar for Solaris 8 with WS V6.0 Select the package that matches your operating system and compiler. SYSTEM REQUIREMENTS ==================== The following are the Solaris system minimum hardware and software requirements: * Sun Solaris workstation Ultra Sparc 30 or better. * 300 MHz Ultra Sparc II or better * Elite 3D m3, Creater 3D or better * Solaris 2.6.x or Solaris 8 systems * WS V5.0 or WS V6.0 * Minimum of 512MB RAM memory * Minimum of 10 Mb free disk space to install the VolumePro 500 software NOTE: 1) This release of the VolumePro software has only been tested on Solaris 8 64 bit systems and Solaris 2.6 systems. The 32 bit installation of Solaris 8 has not been tested. 2) The device driver under Solaris allocates kernel buffers dynamically. Hence, it is possible for the device driver to be unable to allocate a kernel buffer with other applications consuming resources. When this happens, error code 2009 is returned. To solve this problem, free up resources by closing applications and windows or increasing system memory. CHANGES IN THIS SOFTWARE ======================= 1. The library name is changed to libvli.so.2.0. 2. The driver is named with system version as vg500_56_32 for Solaris 5.6, vg500_58_64 for Solaris 5.8. 3. New settings for SW. (See SETTINGS below.) 4. Fixed bugs listed at the end of this document. INSTALLING THE VOLUMEPRO 500 BOARD =================================== Turn the system power off and install the VolumePro board directly into the PCI slot. INSTALLING VOLUMEPRO SOFTWARE ============================= 1. If an earlier version of VolumePro software is installed on your system, please remove it from the system with the following command: pkgrm VolumePro 2. Copy and unpack the distribution package into a directory with the following command: tar xvf package.tar where package is the package name for the desired operating system and C++ compiler version. 3. To install the package, enter the following command: pkgadd -d ./pkg and answer "yes" or the default response from pkgadd. After installation, the following are added to the system /usr/lib/libvli.so.2.0 /usr/lib/libvli.so (a link to libvli.so.2.0) /usr/lib/libvliopengl.a /usr/include/vli.h /usr/kernel/drv/vg500_56_32 (for Solaris 5.6) /usr/kernel/drv/sparcv9/vg500_58_64 (for Solaris 8) /usr/kernel/drv/vg500.conf /usr/bin/loadVG /usr/bin/vg500_control /usr/bin/vliaccept /usr/doc/VolumePro/*pdf /usr/doc/VolumePro/test/ {sanity.cpp,Makefile} /usr/man/man4/VLI.man 4. Load the driver by entering the following commands: /usr/bin/loadVG driver_path Where driver_path is the path to the driver location (i.e. /pkg/VolumePro/root/usr/kernel/drv) There should be a message stating the driver is loaded as: #loadVG ./pkg/VolumePro/root/usr/kernel/drv Fri Jun 15 13:52:17 EDT 2001 loading driver vg500_58_64 Driver ./pkg/VolumePro/root/usr/kernel/drv/vg500_58_64 exit status = 0 devfsadm[1002]: verbose: mknod /devices/pci@1f,0/pci@1/pci1067,1002@3:vg500 0l/3l/20666 devfsadm[1002]: verbose: symlink /dev/vg500 -> ../devices/pci@1f,0/pci@1/pci1067,1002@3:vg500 Driver (vg500_58_64) installed. Id Loadaddr Size Info Rev Module Name 179 78104000 8b246 171 1 vg500_58_64 (VG500 Device Driver 15.0.48) Driver vg500_58_64 is loaded 5. Compile and run the sanity program sanity.cpp using a sample makefile. The makefile, sanity.cpp and sample datasets are located in the directory /usr/doc/VolumePro/test. More data sets (.vox) are available on the CD-ROM. 6. On the VolumePro CD, Unix_SDK/test.tar.gz contains more test/sample code. Note: If your compiler is not installed at the default path, it is required to add the path to your environment: SUNWS_HOME= to the compiler directory SUNWS_INCLUDE= to the Include directory NOTES: 1) INSTALLING ON SYSTEMS WITHOUT A PREVIOUS VERSION OF VOLUMEPRO INSTALLED: The package installation (pkgadd command) may report that a number of directories (such as /usr, /usr/bin/, /usr/man/man5) are in use by another package and that a conflict exists. Please ignore these warnings and continue the installation. We have tested this and found no errors or problems after the installation is complete. 2) loadVG script in two locations: The installation of the package is known to install the loadVG script into two locations, /usr/bin/loadVG and /bin/loadVG. The files are identical and may be left as is without any errors or problems. REMOVING VOLUMEPRO SOFTWARE =========================== 1. To remove the package from the system, enter the following command: pkgrm VolumePro This removes the VolumePro software. 2. The command "/usr/bin/loadVG clean" is used to uninstall the VolumePro device driver. NOTE: It is known that a number of references to the VolmePro board can remain in a number of system files after uninstalling the driver. The files impacted are /etc/.obp_devices, /etc/devlink.tab and /etc/driver_aliases. This error is manifested in when upgrading or reinstalling the VolumePro software with errors of device conflicts and unable to attach. To correct this, edit these files and delete the lines referring to vg50* and reboot the computer. SETTINGS ========== 1. Change Max Angle Deviation settings in csh setenv DEFAULT_MAX_ANGLE_BEHAVIOUR 1 If the value is greater than 1, VLI will adjust the value of the angle to avoid the Max Angle Deviation. (VLI 1.2 behavior) If the value is 0, VLI will return kVLIErrMaxAngleDeviation error. 2. Set True size False = 0 (Performance get faster, VLI 1.2 behavior). setenv VLItrue_size=0 (for csh and tcsh) set VLItrue_size=0 (for sh and bash) Set true size to True(Default setting, VLI 2.0 behavior) setenv VLItrue_size=1 (for csh and tcsh) set VLItrue_size=1 (for sh and bash) LIST OF THE FIXED BUGS ======================= 1. Opacity issue Opacity correction for Super sampling is fixed. 2. Memory leak issues The Memory leaks in VLI are corrected. 3. Max Angle Behavior switch The switch to select either display next possible lender angle or return error. 4. True_size control. NEW FEATURES ============ 1. VLIThreaded control (see Threaded_Render.txt in CD\Docs or our web site). 2. 7th point feature (see 7th_point.txt in CD\Docs). KNOWN ISSUES / LIMITATIONS ======================== 1. /usr/bin/vliaccept is not optimized with this version. 2. User Guide / documentation are not updated with the latest version.