LINUX/UNIX UDF Software Installation
The following are steps that must be taken to download and install the UDF software under a LINUX or UNIX system. It is assumed that you have some experience operating under a UNIX-like system.
Note that, in general, commands to be typed will be noted in purple.
Make sure that you have the following system utilities installed:
These packages are standard on most UNIX/LINUX operating systems. The exception would be the GNU makefile utility. While the makefile utility is generally present it is sometimes not the GNU makefile and may not be compatible with it. This is particularly true on SUN systems using Solaris.
Details for checking the version numbers:
Tcl/Tk:
To check the version numbers for Tcl/Tk type the following commands:
tclsh
info tclversion
exit
The program should have the version number printed after the "info tclversion" command. If you do not have version 8.1 or higher, see your system administrator. If you are the system administrator, Tcl/Tk can be obtained from http://www.scriptics.com
gcc:
To check the version number of the gcc compiler, type the following command:
gcc -v
If your version of gcc is not version 2.7.2 or higher, gcc can be obtained from http://gcc.gnu.org.
From the UNIX UDF Software Directory download all the files below into any directory of your choosing.
The following environmental variables are necessary to install and run the UDF software:
There are basically two approaches for setting up the environmental variables. One approach assumes that a System Administrator is installing the software for multiple users. In this case, the System Administrator should guarantee that users have write access to the directory pointed to by the environmental variable UDF_DATA. Here are some suggested values for the Environmental variables that are being set up for multiple users:
If you are an individual user installing the UDF software for your own use, here are some suggested values for the Environmental variables:
The above environment variables should be set either in the system-wide login shell initialization file or one of the individual local initialization shell files. This allows the environment variables to be set at each login. The shell initialization file naming conventions vary from one system to another but generally will be one of the following:
.login, .cshrc, .profile, tcshrc, or bashrc.
The following commands need to be inserted into your .tcshrc file (for the tcsh shell) or your .cshrc file (for the C shell, or the tcsh shell if no .tcshrc file is present):
setenv UDF_HOME /usr/optsUDF/udf
setenv GPH_HOME /usr/opts/UDF/gph
setenv UDFTOOL_HOME /usr/opts/UDF/udfTools
setenv TCLTOOLS_HOME /usr/opts/UDF/tclTools
setenv UDF_DATA /udfData
setenv XLIB -lX11
setenv PATH $PATH":$UDF_HOME/bin:$UDFTOOL_HOME/bin:/$TCLTOOLS_HOME/bin"
The following commands need to be inserted into your .bashrc file (for the bash shell) or your .profile file (for the Kornshell):
export UDF_HOME=/usr/optsUDF/udf
export GPH_HOME=/usr/opts/UDF/gph
export UDFTOOL_HOME=/usr/opts/UDF/udfTools
export TCLTOOLS_HOME=/usr/opts/UDF/tclTools
export UDF_DATA=/udfData
export XLIB=-lX11
export PATH=$PATH":$UDF_HOME/bin:$UDFTOOL_HOME/bin"
NOTE: The XLIB environment variable under Solaris should be set to -lX11. Under most other systems the setting is /usrX11R6/lib/libX11.so or /usr/X11R6/lib/libX11.a
To determine where the libX11 library is on your machine you might try the following commands:
whereis libX11.so
or
whereis libX11.a
NOTE: If you do not log back into the system before continuing the install, you will need to source your initialization file before you continue. This will activate the environmental variables specified. To do this enter the following command:
For the C Shell: source ~/.cshrc
For the tcsh Shell (If the .tcshrc file is present): source ~/.tcshrc
For the tcsh Shell (If the .tcshrc file is not present): source ~/.cshrc
For the bash Shell: source ~/.bashrc
For the Kornshell: . ~/.profile
PATH NOTE: Note that in the last line in the above initialization file samples, the $UDF_HOME/bin, $UDFTOOL_HOME/bin, and $TCLTOOLS_HOME/bin directories are appended to the PATH environment variable. Both directories will contain executable programs or scripts that are frequently used within the UDF environment. While it is not necessary to add the directories to the path, it will allow you to execute these programs without having to specify the full path to them.
Please check your system's documentation for how to append directories to the PATH if you are not using one of the shells outlined above.
cd directorypath/DownloadDir
BaseInstall
The UDF programs dBAsk and CONTROL are now ready to use. If you have added the $UDFTOOL_HOME/bin directory to your PATH variable, you should just be able to use these programs by typing either dBAsk or CONTROL at the prompt from any directory.
At this point the Basic UDF software suite is fully installed. The next step is to create a local UDF-style database and populate it with UDF data. This is discussed in detail at UDF Data Information.
For questions or problems with the UDF software please contact:
email: Chris Gurgiolo
For questions or problems with the web site please contact:
email: Dennis Gallagher