This document describes how to install NIScope 2.9.0 under OpenSuSE 10.3, base on
our experiences.  It works well for us and for our customers, but since we did not
get any directly support from NI, use the info at your own risk.
(NOTE: the same procedure also apply to NIFGen 2.4.1)

Packages required:

	NISCOPE290_SUSE100.iso (http://joule.ni.com/nidu/cds/view/p/id/927/lang/en)
	NIKAL18.iso (http://joule.ni.com/nidu/cds/view/p/id/1075/lang/en)
	kernel-source-2.6.22.19-0.1 (OpenSuSE 10.3 + latest online update 2008/11/02)

NOTE:
	You can install NIKAL18.iso first before NISCOPE290 (or NIFGen241) ... the install
	order of NI's package doesn't really matter ... the INSTALL script will bypass RPMs
	if the same or newer version already installed.

NOTE: run the installation script 'INSTALL' provided by NISCOPE290_SUSE100.iso
	did not work !! you will got error message:

	******************************** ERROR ****************************************
	* Kernel source in $headersDir does not appear to be
	* for the $kernelVersion kernel.
	* Ensure that kernel source for the $kernelVersion kernel is installed
	* and configured.  Refer to the README file for the product you are           *
	* installing for information about configuring your kernel source.            *
	******************************** ERROR ****************************************

	you should following the procedure described below:


	#
	# dealing with kernel source first, check NISCOPE290_SUSE100.iso:README.txt
	#
	> su
    > cd /usr/src/linux
    > make cloneconfig
    > make modules_prepare
    > make modules ............... optional, to remove warning message
								   this will take a while ...

	> mount -oloop NISCOPE290_SUSE100.iso /mnt
    > cd /mnt

	#
	# before running ./INSTALL, we should bypass the kernel version checking which
	# casue the above message message in NIScope's installation script.
	# 

	#
	# Since the /mnt/* is read only, we will copy /mnt/* to /tmp/NISCOPE/* first ...
	#
	> mkdir /tmp/NISCOPE
	> cp -a /mnt/* /tmp/NISCOPE
	> cd /tmp/NISCOPE

	#
	# extract /tmp/NISCOPE/NISCOPE-2.9.0f5.tar.gz
	# modify the installatoin script, we pack the tar file again.
	#
	> cd /tmp/NISCOPE
	> mkdir /tmp/NISCOPE/tmp
	> cd /tmp/NISCOPE/tmp
	> tar xvfz ../NISCOPE-2.9.0f5.tar.gz
	> vi ./bin/installerUtility.sh

		# remove or comment out these code:

		...
		# check that the headers dir that we found is for the correct version of
		# the kernel
		if [ "`grep UTS_RELEASE $headersDir/include/linux/version.h | grep -c \"$kernelVersion\"`" = "0" ]; then
			echo "******************************** ERROR ****************************************"
			echo "* Kernel source in $headersDir does not appear to be"
			echo "* for the $kernelVersion kernel."
			echo "* Ensure that kernel source for the $kernelVersion kernel is installed"
			echo "* and configured.  Refer to the README file for the product you are           *"
			echo "* installing for information about configuring your kernel source.            *"
			echo "******************************** ERROR ****************************************"
			return $statusFail
		fi
		...

	> tar cvfz ../NISCOPE-2.9.0f5.tar.gz .
	> cd /tmp/NISCOPE
	> rm -rf /tmp/NISCOPE/tmp

	#
	# Now, we bypass the kernel version check ...
	# then just run the installation script
	#
    > ./INSTALL

	#
	# That's it, however you will find NI-KAL installation will fail.
	# Don't worry, we will fix that later by upgrade NIKAL to v1.8, that will
	# solve the problem
	#
	# After ./INSTALL complete, the script will ask you to reboot your computer.
	# You don't need to do it now, you can reboot after fix the NIKAL.
	#

	#
	# Upgrade to NI-KAL 1.8.x
	#

	> mount -oloop NIKAL18.iso /mnt
	> cd /mnt
	> ./INSTALL
	> cd /
	> umount /mnt

	#
	# One more thing, the runtime library /usr/local/lib/liblvrt.so requires
	# libOSMesa.so.4 which is not part of OpenSuSE 10.3 (OpenSuSE 10.3 include
	# /usr/lib/libOSMesa.so.6).
	#
	# NOTE !! This library is not part of NIScope or NIFGen.  It's part of NI4882 2.5 !!!
	# so we may also need to install NI4882 2.5 :-(  Only this file in NI4882 is required, 
	# You should copy the library to /usr/lib or do the symbolic link as below:
	#
	> ln -s /usr/local/lib/linux/libOSMesa.so.4 /usr/lib/libOSMesa.so.4

	# This will solve NIScope applicatoin's compilter time problem.  But
	# we don't know if it will cause any runtime issue yet.  Basic on our
	# own experiences, it works fine.
	# That's it.  We can reboot the system now.

	> reboot


	# NOTE to completely remove NIScope, 4 steps required:
	#      However, if this still can't completely remove all NI's stuff.
	#      reboot and repeat again.
	#
	# UNINSTALL   ................................. NIScope
	# rpm -e labview80-rte labview-aal ............ LabVIEW runtime
	# /usr/local/vxipnp/linux/NIvisa/UNINSTALL .... NI-VISA
	# UNINSTALL ................................... NIScope again



Latest Update: 2009/05/27
LinuxDAQ Labs. Software Team. <support@LinuxDAQ-Labs.com>