UltraScan II/III Installation:

The installation instructions vary for different platforms:

Microsoft Windows: Download the installation file and execute it on your computer. When prompted for an installation directory, please choose C:\Program Files\UltraScan, this is the expected path. If your international version of Windows has a different path, please create this subdirectory first before installation. On Windows 7, also install in C:\Program Files\UltraScan, not in C:\Program Files (x86)\UltraScan. You may have to run the program as Administrator.

Mac OS-X: Download the installation image. Double-click the dmg.zip file to decompress to a dmg file. Double-click the dmg file to open a disk image. The image contains two files.

For Ultrascan II, the files are: the UltraScan application and the UltraScan launcher. The UltraScan application file needs to be dropped into the /Applications folder, and the UltraScan launcher can be copied anywhere, for example, onto the Desktop
For Ultrascan III, the files are: an installation instruction details text (.rtf) Read Me First file and the UltraScanIII installation file. Double-click the install file to start a standard Mac OS installation and follow the instructions. The instruction text file should be double-clicked so it can be read with TextEdit. As explained in that text, for a first-time install, you may need to copy the contents of the ultrascan3/lib/Frameworks folder to the system's /Library/Frameworks folder.

Next, you will have to change the default shared memory resources. This is done in the /etc/sysctl.conf file, and requires root access. It is not that unusual that the /etc/sysctl.conf file does not already exist. You will just need to create one and fill it with the proper settings. Open a terminal window on your Mac. If you are familiar with the vi editor, you can type into the terminal:

       sudo vi /etc/sysctl.conf

       sudo open -a TextEdit /etc/sysctl.conf

Open/create the /etc/sysctl.conf file:

sudo vi /etc/sysctl.conf

kern.sysv.shmmax=16777216
kern.sysv.shmmin=1
kern.sysv.shmmni=128
kern.sysv.shmseg=32
kern.sysv.shmall=4096

Linux, Unix/X11: To install the tar.gz(bz2) package for any distribution, please follow these steps:
1. After downloading the tar.gz package, you need to uncompress and extract it in a location of your choice, for example, /usr/lib or /usr/local or /usr/local/lib. For the purpose of this document, it is assumed you are going to install UltraScan in /usr/lib and /path is the path to your downloaded file.
```
cd /usr/lib
gzip -d /path/ultrascan-version.tar.gz

For bzip2 compressed binaries, use:
bzip2 -d /path/ultrascan-version.tar.bz2

tar -xvf /path/ultrascan-version.tar
```
2. Next, you need to set the following environment variables, either in the private login script file, or in a global login script file, or alternatively as shown in option (5):
  For sh, bash:
```
export ULTRASCAN=/usr/local/ultrascan3
export PATH=$PATH:$ULTRASCAN/bin
```
  For csh, tcsh:
```
setenv ULTRASCAN /usr/local/ultrascan
setenv PATH ${PATH}:${ULTRASCAN}/bin"
```
  If your Unix system supports dynamic link path configuration using /etc/ld.so.conf, this can be accomplished by adding /usr/local/ultrascan3/lib to the /etc/ld.so.conf file and running ldconfig.
3. If your Unix system does not support /etc/ld.so.conf dynamic link configurations, you will need to modify the "LD_LIBRARY_PATH" environment variable and add the UltraScan library directory to it:
  For sh, bash:
```
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/ultrascan3/lib
```
  For csh, tcsh:
```
setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:/usr/llocal/ultrascan3/lib"
```
4. Next, you will have to add the UltraScan library directory to your dynamically
5. If your distribution supports /etc/profile.d/ script parsing (most Linux versions do), you can also add these files to /etc/profile.d:
  - us.sh (for sh, bash, etc...)
  - us.csh (for csh, tcsh, etc...)
  Don't forget to make the scripts executable:
```
chmod 755 /etc/profile.d/us.*
```
6. If your Unix version does not support /etc/profile.d/* script parsing, you will have to modify your environment
7. To verify that the environment variables are correctly installed, use the "echo" command:
```
echo $VARIABLE
```