Installer Help

Windows (7, Vista, XP):System Requirements Installing and upgrading Installed Files Uninstalling
Mac OS X (10.5+):System Requirements Installing and upgrading Installed Files Uninstalling
Linux (tested on Ubuntu):System Requirements Installing and upgrading Installed Files Uninstalling
Tracker Starter (all platforms)

Windows (7, Vista, XP)

System requirements: Windows

You must run Tracker in a 32-bit Java VM (version 1.5+) even on a 64-bit Windows OS. To see which Java VM you are running in, choose the Tracker Help|About Java menu. The first line shows the Java version and bitness. If the bitness is 64 then do this:

Confirm that a 32-bit Java is installed (on Windows 7, the likely path to the 32-bit java executable is C:\Program Files (x86)\Java\jre6\bin\java). If it is not, go to http://www.oracle.com/technetwork/java/javase/downloads, click on the button "Download JRE", and select the "Windows" (not "Windows x64") platform.
Add or edit the "jre" entry in .tracker_starter.prefs to point to the 32-bit java executable (see Tracker Starter section below).

Installing and upgrading: Windows

Download the installer file Tracker-4.xx-windows-installer.exe. Double-click the file to run the installer.
Initial installation: install the Tracker application and options desired. We recommend you: (a) install the optional Xuggle video engine for maximum functionality and (b) accept the default installation paths for reliable upgrading and uninstallation.
Upgrade: choose the upgrade option offered by the installer. Note: if the installer cannot find the Tracker home directory, it will not offer an upgrade option even if you have previously installed Tracker. If this happens, you can overwrite the previous installation or uninstall the existing installation and reinstall from scratch.
Launch: choose the Tracker item in the Start Menu.

Installed files: Windows

In the Tracker home directory (Program Files\Tracker or Program Files(x86)\Tracker by default):
- Tracker.exe
- tracker.jar
- tracker-4.xx.jar
- tracker.ico
- tracker_icon.png
- tracker_install.log
- Tracker_README.txt
- uninstall_Tracker.exe
- uninstall_Tracker.dat
- .tracker.prefs
- .tracker_starter.prefs
- xuggle-xuggler.jar
- logback-core.jar
- logback-classic.jar
- slf4j-api.jar

In the user home directory:
- .tracker.prefs
- .tracker_starter.prefs

In the Xuggle home directory (Program Files\Xuggle or Program Files(x86)\Xuggle by default):
- bin subdirectory
- include subdirectory
- lib subdirectory
- share subdirectory

In the videos and experiments directory (My Documents\Tracker by default):
- experiments subdirectory
- videos subdirectory

In the Java runtime external library directory (lib\ext):
- xuggle-xuggler.jar
- logback-core.jar
- logback-classic.jar
- slf4j-api.jar

In the Start Menu Tracker directory:
- Tracker shortcut
- Uninstall Tracker shortcut

Environment variables set or modified:
- TRACKER_HOME (path to Tracker home folder)
- XUGGLE_HOME (path to Xuggle home folder)

Uninstalling: Windows

The uninstaller file "uninstall_Tracker.exe" is in the Tracker home directory (see Installed files). To run the uninstaller, double-click it. You can also run this uninstaller from the Add/Remove Programs control panel or by choosing the Uninstall Tracker menu item in the Start Menu.

If there is no uninstaller, you may uninstall the Tracker home directory, Xuggle home directory and other installed files by hand. However, this will not remove the environment variables TRACKER_HOME and XUGGLE_HOME nor the Windows registry entries.

Mac OS X (10.5+)

System requirements: OS X

You must run Tracker in a 64-bit Java 1.6 VM to use the Xuggle video engine. You may run Tracker in a 32-bit Java 1.5+ VM if you wish to use the QuickTime video engine. To see which Java VM you are running in, choose the Tracker Help|About Java menu. The first line shows the Java version and bitness. If the Java version is not 1.6 then (assuming you wish to use Xuggle) do this:

Double-click Java Preferences in the Applications/Utilities folder. In the General tab, drag Java SE 6 to the top position in the list and be sure it is checked ("On"). You may have to restart or log out and in for your changes to take effect.
If step 1 doesn't work, add a "jre" entry in .tracker_starter.prefs to point to the version 1.6 java executable (see Tracker Starter section below). The default path to the version 1.6 executable is /System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home/bin/java

Installing and upgrading: OS X

Download the zip file Tracker-4.xx-osx-installer.zip. Double-click the file to extract the installer file Tracker-4.xx-osx-installer.app. Double-click the installer file to run the installer.
Initial installation: install the Tracker application and options desired. We recommend you: (a) install the optional Xuggle video engine for maximum functionality and (b) accept the default installation paths for reliable upgrading and uninstallation.
Upgrade: choose the upgrade option offered by the installer. Note: if the installer cannot find the Tracker home directory, it will not offer an upgrade option even if you have previously installed Tracker. If this happens, you can overwrite the previous installation or uninstall the existing installation and reinstall from scratch.
Launch: double-click the Applications/Tracker.app file.

Installed files: OS X

In the Tracker home folder (hidden /usr/local/tracker by default):
- Tracker_README.txt
- tracker_install.log
- uninstall_Tracker.app
- .tracker.prefs (hidden file)
- .tracker_starter.prefs (hidden file)
- share folder (only if videos and experiments installed--see below)

In the Applications folder:
- Tracker.app (contains the following hidden folders and files)
- Contents folder containing files below:
- Info.plist
- PkgInfo
- MacOS folder containing files below:
- JavaApplicationStub
- Resources folder containing files below:
- tracker.icns
- Java folder containing files below:
- tracker_starter.jar
- tracker.jar
- tracker-4.xx.jar
- symlink to XUGGLE_HOME/share/java/jars/xuggle-xuggler.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-core.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-classic.jar
- symlink to XUGGLE_HOME/share/java/jars/slf4j-api.jar

In the Xuggle home folder (hidden /usr/local/xuggler by default):
- bin folder
- include folder
- lib folder
- share folder

In the videos and experiments folder (hidden /usr/local/tracker/share by default):
- videos folder containing video files
- experiments folder containing .trk experiment files

In the Java runtime external library directory (lib/ext):
- symlink to XUGGLE_HOME/share/java/jars/xuggle-xuggler.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-core.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-classic.jar
- symlink to XUGGLE_HOME/share/java/jars/slf4j-api.jar

In addition, if installed by a user rather than a superuser (root):

In the user home (~):
- .tracker.prefs (hidden file)
- .tracker_starter.prefs (hidden file)
- .profile (hidden file) created or modified to set environment variables below
- .MacOSX folder (hidden folder)
- environment.plist created or modified to set environment variables below

In the user Documents folder (~/Documents):
- Tracker folder containing the files below:
- Tracker.app symlink
- tracker_home symlink to the Tracker home folder
- resources symlink to videos and experiments folder
- jars symlink to Tracker.app/Contents/Resources/Java folder

Environment variables set or modified:
- TRACKER_HOME (path to Tracker home folder)
- XUGGLE_HOME (path to Xuggle home folder)
- DYLD_LIBRARY_PATH (path to XUGGLE_HOME/lib folder)

Uninstalling: OS X

The uninstaller file "uninstall_Tracker.app" is in the Tracker home folder (/usr/local/tracker/ by default). You can also open this folder using the "home" symlink in ~/Documents/Tracker. To run the uninstaller, double-click it. Enter your password to complete the uninstallation.

Linux (tested on Ubuntu)

System requirements: Linux

There are separate installers for 32-bit and 64-bit Linux machines. You must run Tracker in a Java VM (1.5+) with the same bitness as the OS. To see which Java VM you are running in, choose the Tracker Help|About Java menu. The first line shows the Java version and bitness.

If needed, you may add a "jre" entry in .tracker_starter.prefs to point to a preferred java executable (see Tracker Starter section below).

Installing and upgrading: Linux

Open a Terminal window and type the command uname -a to determine if your Linux OS is 32- or 64-bit. If the output ends with "i386 GNU/Linux" or "i686 GNU/Linux" it is 32-bit; if it ends with "x86_64 GNU/Linux" it is 64-bit. (Note: other 64-bit architectures such as IA64 are not yet supported.)
Download the appropriate installer file Tracker-4.xx-linux-32bit-installer.run or Tracker-4.xx-linux-64bit-installer.run.
Type sudo chmod 755 ~/Downloads/Tracker-4.61-linux-32bit-installer.run and enter your password to make the installer executable. Note: this and the next step assume the version 4.61 32-bit installer was downloaded to ~/Downloads/. If your download is different, change the command targets appropriately.
Type sudo ~/Downloads/Tracker-4.61-linux-32bit-installer.run to run the installer.
Initial installation: install the Tracker application and options desired. We recommend you: (a) install the optional Xuggle video engine for maximum functionality and (b) accept the default installation paths for reliable upgrading and uninstallation.
Upgrade: choose the upgrade option offered by the installer. Note: if the installer cannot find the Tracker home directory, it will not offer an upgrade option even if you have previously installed Tracker. If this happens, you can overwrite the previous installation or uninstall the existing installation and reinstall from scratch.
Launch: select the Applications/Education/Tracker menu item or other Tracker item.

Installed files: Linux

In the Tracker home folder (/opt/tracker by default):
- tracker.jar
- tracker-4.xx.jar
- tracker_starter.jar
- Tracker_README.txt
- tracker_install.log
- tracker.desktop
- tracker.sh
- tracker_icon48.png
- uninstall_Tracker
- uninstall_Tracker.dat
- .tracker.prefs (hidden file)
- .tracker_starter.prefs (hidden file)
- share folder (only if videos and experiments installed--see below)
- symlink to XUGGLE_HOME/share/java/jars/xuggle-xuggler.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-core.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-classic.jar
- symlink to XUGGLE_HOME/share/java/jars/slf4j-api.jar

In the Xuggle home folder (/opt/xuggler by default):
- bin folder
- include folder
- lib folder
- share folder

In the videos and experiments folder (/opt/tracker/share by default):
- videos folder containing video files

In the applications folder (/usr/share/applications):
- tracker.desktop

In addition, if installed by a user (i.e., using sudo) rather than a superuser (root):

In the user home (~):
- .tracker.prefs (hidden file)

In the user Documents folder (~/Documents):
- Tracker folder
- tracker.desktop
- tracker_home symlink to the Tracker home folder
- resources symlink to videos and experiments folder

Uninstalling: Linux

The uninstall file "uninstall_Tracker" is in the Tracker home folder (/opt/tracker/ by default). You can also open this folder using the "tracker home" symlink in ~/Documents/Tracker. To run the uninstaller, open a terminal window and type "sudo /opt/tracker/uninstall_Tracker". Enter your password to complete the uninstallation. Note: the uninstaller requires the data file "uninstall_Tracker.dat" in the same folder to operate.

If there is no uninstaller, you may uninstall the Tracker home directory, Xuggle home directory and other installed files by hand.

Tracker Starter

Tracker launches itself using a separate Tracker Starter application (Tracker.exe on Windows, tracker_starter.jar on Mac OSX and Linux) that searches for an appropriate tracker jar and then runs it in the appropriate Java VM. By default, Tracker Starter runs tracker.jar, or if none is found, the latest numbered tracker-x.xx.jar.

The Tracker-starting process can be customized by editing the following Tracker Preferences (Edit|Preferences...):

Tracker Version
This specifies the numbered "tracker-x.xx.jar" that is started. If no version is specified then "tracker.jar" is started. By default tracker.jar is the same as the most recently installed tracker-x.xx.jar, but you can make a copy of any numbered jar and rename it "tracker.jar" if desired.

Java Virtual Machine
This specifies the Java VM used to run Tracker. If no Java VM is specified, the system default VM is used.

Memory Size
This specifies the maximum memory in MB available for videos and other resources used by Tracker. If none is specified, the system default size (usually 64 to 256 MB) is used.

Programs Executed at Startup
This specifies one or more files that are executed prior to starting Tracker. The files must be executable by the OS. Tracker is not started until the execution process is complete. As an example, "copy.bat" (Windows) or "copy.sh" (OSX/Linux) might run a batch file that copies files from a server to the local (student) machine prior to launching Tracker.