Documentation

Research Publications

Thomas Ristenpart, Gabriel Maganis, Arvind Krishnamurthy, and Tadayoshi Kohno. Privacy-Preserving Location Tracking of Lost or Stolen Devices: Cryptographic Techniques and Replacing Trusted Third Parties with DHTs. In Proceedings of the 17th USENIX Security Symposium, 2008.

Installation

You may download the most recent version of Adeona here.

To install the Adeona system, follow the steps below according to your operating system.

Linux

For linux installation notes, please click here.

A shorter description of the steps:

Make sure your computer has the following installed:

1. OpenSSL
2. traceroute
3. cron
4. iwconfig [optional]

Run the following commands,

1. tar xzf adeona-0.2.1.tar.gz
2. cd adeona/
3. ./configure
4. sudo make install
5. sudo crontab -e then add the crontab entry echo'd by the install script

Mac OS X

For a detailed step-by-step guide, please click here.

A shorter description of the steps:

1. Mount the disk image (.dmg) by double clicking on the adeona-osx.dmg icon.
2. Double click on the package icon. This will launch the installer that will guide you through the rest of the installation and initialization process.

Windows XP/Vista

For a detailed step-by-step guide, please click here.

A shorter description of the steps:

1. Double click on the AdeonaSetup.exe icon.
2. This will launch the Adeona installer that will guide you through the rest of the installation and initialization process.

Retrieval

Important Note

The retrieval results are for informational, research and evaluation purposes only. Do not attempt to recover your lost or stolen laptop yourself. If you believe your laptop has been stolen, contact the appropriate law enforcement agency.

If you are performing retrieval from a computer different from that you wish to track, then first install the retrieval tools. Then, follow the directions below depending on the operating system from which you want to perform retrieval.

Linux

To view the arguments and options for the Adeona retrieval program, run the following command:

ADEONADIR=/usr/local/adeona

$ADEONADIR/adeona-retrieve.exe -h

For example, the command below will retrieve the most recent location given the encrypted location-finding credential file /path/to/your/adeona-retrievecredentials.ost

$ADEONADIR/adeona-retrieve.exe -r $ADEONADIR/resources/ -l /path/to/results/ -s /path/to/your/adeona-retrievecredentials.ost -n 1

Please note the terminating '/' character needed for the '-r' and '-l' arguments

Mac OS X

For a detailed step-by-step guide, please click here.

A shorter description of the steps:

1. Browse to the Adeona folder located under Applications.
2. Double click on the adeona-retrieve.term icon. This will run a Terminal window that will guide you through the retrieval process.

Windows XP/Vista

For a detailed step-by-step guide, please click here.

A shorter description of the steps:

1. Navigate to Start -> Programs -> Adeona -> Run Adeona Recovery. The Adeona Recovery Wizard will guide you through the rest of the retrieval process.

Installing Retrieval Tools

One can perform retrieval given just the Adeona retrieve credentials (adeona-retrievecredentials.ost) generated during the setup of the Adeona tracking client. For example, if the laptop installed with the Adeona tracking client was Windows, you can perform retrieval from a distinct OS X, or Windows system. To do so, first download the Adeona package appropriate for the system you will be attempting retrieval from. Then, follow the appropriate instructions below for installing the retrieval tools.

Mac OS X

For a detailed step-by-step guide, please click here.

A shorter description of the steps:

1. Mount the disk image (.dmg) by double clicking on the adeona-osx.dmg icon.
2. Double click on the package icon to launch the installer.
3. Before clicking on the "Install" button, click on "Customize" then uncheck the "Full Adeona Installation" box and check the " Adeona Retrieval Only Installation" box instead.

You can now perform retrieval using the installed adeona-retrieve.term program.

Windows XP/Vista

For a detailed step-by-step guide, please click here.

A shorter description of the steps:

1. Double click on the AdeonaSetup.exe icon.
2. This will launch the Adeona installer. In the components dialog box, uncheck "Adeona Client", otherwise proceed as directed by the wizard.

You can now perform retrieval using the installed AdeonaRecovery.exe program.

Uninstallation

Hopefully you won't ever need to follow the instructions below but here they are. The instructions lead to the complete removal of the Adeona system from your computer.

Linux

Use the kill command to stop the adeona-client.exe program

Delete the Adeona directory,

$ sudo rm -rf /usr/local/adeona

Remove the crontab entry for Adeona through

$ sudo crontab -e

Mac OS X

For a detailed step-by-step guide, please click here.

Run the commands below in Terminal ( without the '$' sign ),

Please note that you will be asked for your login password after you type the first command. The program asking for your password is "sudo", a systems administration utility provided by Apple.

Stop the adeona-client.exe program.

$ sudo launchctl stop edu.washington.cs.adeona

$ sudo launchctl unload /Library/LaunchDaemons/edu.washington.cs.adeona.plist

Delete the Adeona folders and files

$ sudo rm -rf /usr/local/adeona

$ sudo rm -rf /Applications/Adeona

$ sudo rm /Library/LaunchDaemons/edu.washington.cs.adeona.plist

$ sudo rm -rf /Library/Receipts/adeona.pkg

Windows XP/Vista

The Uninstall program will completely remove Adeona from your system.

1. Navigate to Start -> Programs -> Adeona -> Uninstall Adeona