Tracker Home | Help | Share | OSP Home

Tracker logo

Installer Help

Contents

Windows:System RequirementsInstalling and upgradingInstalled FilesUninstalling
Mac OS X:System RequirementsInstalling and upgradingInstalled FilesUninstalling
Linux (tested on Ubuntu):System RequirementsInstalling and upgradingInstalled FilesUninstalling

Windows (XP+)

System requirements: Windows

Tracker comes with a bundled 32-bit JRE and Xuggle video engine. Tracker must run in a 32-bit JRE in order to use Xuggle.

Installing and upgrading: Windows

  1. Download the installer file Tracker-5.x.x-windows-installer.exe from ComPADRE or the Tracker home page. Double-click the file to run the installer. Note: on Windows 8 you may need to run the installer as administrator by right-clicking and choosing "Run as administrator."
  2. Installation: install the Tracker application and options desired. We recommend you accept the default installation paths for reliable upgrading and uninstallation.
  3. Upgrades: when a new version is available, a notification is displayed on the toolbar. To upgrade, click the notification and choose Upgrade Now from the popup menu. For more information about the new version, choose Learn More. Most upgrades are instant: the new version or upgrade installer is downloaded and launched immediately. Some upgrades will require that you download a new installer from the Tracker website. Upgrades may include Tracker itself, Java, Xuggle and/or other components.
  4. Upgrade notification Upgrade notification button--click to show popup menu

  5. Launch: choose the Tracker item in the Start Menu.

Installed files: Windows

In the Tracker home directory (Program Files(x86)\Tracker by default):
- Tracker.exe
- tracker.jar
- tracker-5.x.x.jar
- tracker.ico
- trk.ico
- tracker_icon.png
- tracker_install.log
- Tracker_README.txt
- uninstall_Tracker.exe
- uninstall_Tracker.dat
- tracker.prefs.default
- tracker_start.log (only after Tracker is launched)
- xuggle-xuggler.jar
- logback-core.jar
- logback-classic.jar
- slf4j-api.jar
- jre subdirectory (bundled JRE)
- Xuggle subdirectory (video engine)

In the user home directory:
- tracker.prefs
- AppData\Local\OSP subdirectory with tracker.prefs and Cache subdirectory (only if the digital library browser has been accessed)

In the videos and experiments directory (My Documents\Tracker by default, only if installed):
- experiments subdirectory
- videos subdirectory
- tracker_start.log (only after Tracker is launched)

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

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 delete the Tracker home directory and other installed files by hand. However, this will not remove Windows registry entries.

Mac OS X (10.7+)

System requirements: OS X

Tracker comes with a bundled 64-bit JRE and Xuggle video engine. Tracker must run in a 64-bit JRE in order to use Xuggle.

Installing and upgrading: OS X

  1. Download the zip file Tracker-5.x.x-osx-installer.zip from ComPADRE or the Tracker home page. Double-click the file to extract the installer file Tracker-5.xx-osx-installer.app. Double-click the installer file to run the installer. (Note: Mountain Lion and later OSX versions may warn you that the installer "can't be opened because it is from an unidentified developer." In this case, you must control-click the installer and choose Open from the popup menu rather than double-clicking. Rest assured that Tracker is safe as long as the installer is downloaded from ComPADRE or the Tracker home page.)
  2. Installation: install the Tracker application and options desired. We recommend you accept the default installation paths for reliable upgrading and uninstallation.
  3. Upgrades: when a new version is available, a notification is displayed on the toolbar. To upgrade, click the notification and choose Upgrade Now from the popup menu. For more information about the new version, choose Learn More. Most upgrades are instant: the new version or upgrade installer is downloaded and launched immediately. Some upgrades will require that you download a new installer from the Tracker website. Upgrades may include Tracker itself, Java, Xuggle and/or other components.
  4. Upgrade notification Upgrade notification button--click to show popup menu

  5. 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
- share subfolder (only if videos and experiments installed--see below)

In the Applications folder:
- Tracker.app (contains the following hidden folders and files)
Contents folder containing Info.plist, PkgInfo and the 5 subfolders below
Java subfolder containing files below:
- tracker_starter.jar
- tracker.jar
- tracker-5.x.x.jar
- Tracker.cfg
- xuggle-xuggler.jar
- logback-core.jar
- logback-classic.jar
MacOS subfolder containing files below:
- libpackager.dylib
- Tracker (executable)
PlugIns subfolder containing Java.runtime (bundled JRE)
Resources subfolder containing files below:
- Tracker_README.txt
- Tracker.icns
- trk.icns
Xuggle subfolder (video engine)

In the videos and experiments folder (/usr/local/tracker/share by default, only if installed):
videos subfolder containing video files
experiments subfolder containing .trk experiment files

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

In the preferences folder (~/Library/Application Support/OSP):
- .tracker.prefs

In the OSP cache (~/Library/Caches/OSP) (only if the digital library browser has been accessed):
- Search folder and multiple osp-xxx folders

In the user Documents folder (~/Documents):
Tracker subfolder containing Tracker.app (symlink) and tracker_start.log (only after Tracker is launched)

Uninstalling: OS X

The uninstaller file "uninstall_Tracker.app" is in the Tracker home folder (/usr/local/tracker/ by default). To run the uninstaller, double-click it. Enter your password to complete the uninstallation.

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

Linux (tested on Ubuntu)

System requirements: Linux

There are separate installers for 32-bit and 64-bit Linux machines. To see which Java VM you are running in, choose Help|About Java. The first line shows the Java version and bitness. Tracker comes with a bundled JRE and Xuggle video engine.

Installing and upgrading: Linux

  1. 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 supported.)
  2. Download the appropriate installer file Tracker-5.x.x-linux-32bit-installer.run or Tracker-5.x.x-linux-64bit-installer.run from ComPADRE or the Tracker home page.
  3. Type sudo chmod 755 ~/Downloads/Tracker-5.x.x-linux-yybit-installer.run (change x.x and yy to the numbers for your installer) and enter your password to make the installer executable. Note: this and the next step assume the installer was downloaded to ~/Downloads/. If your download is different, change the command targets appropriately.
  4. Type sudo ~/Downloads/Tracker-5.x.x-linux-yybit-installer.run to run the installer.
  5. Installation: install the Tracker application and options desired. We recommend you accept the default installation paths for reliable upgrading and uninstallation.
  6. Upgrades: when a new version is available, a notification is displayed on the toolbar. To upgrade, click the notification and choose Upgrade Now from the popup menu. For more information about the new version, choose Learn More. Most upgrades are instant: the new version or upgrade installer is downloaded and launched immediately. Some upgrades will require that you download a new installer from the Tracker website. Upgrades may include Tracker itself, Java, Xuggle and/or other components.
  7. Upgrade notification Upgrade notification button--click to show popup menu

  8. Launch: double-click the Tracker launcher in Dash.

Installed files: Linux

In the Tracker home folder (/opt/tracker by default):
- tracker.jar
- tracker-5.x.x.jar
- tracker_starter.jar
- Tracker_README.txt
- tracker_install.log
- tracker_start.log (only after Tracker is launched)
- tracker.desktop (executable)
- tracker.sh
- tracker_icon48.png
- trk_icon_48.png
- uninstall_Tracker
- uninstall_Tracker.dat
- osptracker-mime.xml
- tracker.prefs.default
- xuggle-xuggler.jar
- logback-core.jar
- logback-classic.jar
- slf4j-api.jar
- share subfolder (only if videos and experiments installed)
- jre subfolder (bundled JRE)
- Xuggle subfolder (video engine)

In the videos and experiments folder (/opt/tracker/share by default), only if installed:
- videos subfolder containing video files
- experiments subfolder containing .trk experiment files

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

In the user Documents folder (~/Documents or equivalent):
- Tracker subfolder containing files below:
- tracker_start.log (only after Tracker is launched)
- Tracker.app symlink
- tracker_home symlink to the Tracker home folder
- resources symlink to the videos and experiments folder (only if videos and experiments installed

In the user OSP configuration folder (~/.config/OSP):
- .tracker.prefs and osp.prefs
- Cache subfolder (only if the digital library browser has been accessed)

Uninstalling: Linux

The uninstall file "uninstall_Tracker" is in the Tracker home folder (/opt/tracker/ by default). 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 folder and other installed files by hand.