Whereabouts Getting Started Guide

Get a device that supports Ekahau, such as a laptop, PDA, or Ekahau tag.
If you are using a laptop or PDA, install the Ekahau client.
Find out the MAC address of your device.
Get a command-line Whereabouts client, such as the Whereabouts Perl Client.
Register the device to yourself. With the Whereabouts perl client, you would run:
```
whereabouts -u you@umich.edu -p -c RegisterDevice whereabouts.eecs.umich.edu 601
```
Enter your password when prompted, then enter this XML document on your terminal, replacing the MAC address with your own (must be in uppercase):
```
<device-id>Ekahau.YO:UR:MA:CA:DD:RE:SS</device-id>
```
Finally, send your system’s end-of-file character (CTRL-D on Unix and Mac, CTRL-Z Enter on Windows) and make sure the command worked.
If you don’t have one, create a privacy policy. To create a simple privacy policy that will allow everybody to see all of your information, you could run:
```
whereabouts -u you@umich.edu -p -c SetPrivacyPolicy whereabouts.eecs.umich.edu 601
```
A very simple policy that will allow anybody to see all of your location information would be:
```
<privacy-policy><policy><sighting allow='yes' /></policy></privacy-policy>
```
A more restrictive policy that will only allow you to see your own information is:
```
<privacy-policy>
  <policy>
    <sighting allow='yes'><inquirer><user>you@umich.edu</user></inquirer></sighting>
  </policy>
</privacy-policy>
```
You can paste that on your terminal, followed by your system’s end-of-file character, to install it as your policy, or you can create a more complex policy following the privacy policy instructions in the Whereabouts User's Guide.
Now you should be able to see yourself in query results. The simplest query is for all results; you can run that with:
```
whereabouts -u you@umich.edu -p whereabouts.eecs.umich.edu 601 ALL
```
To run a query provided on your terminal, instead use:
```
whereabouts -u you@umich.edu -p whereabouts.eecs.umich.edu 601
```
As above, you should send your system’s end-of-file character after the query to begin executing. A query to search for yourself by username would be something like:
```
<whery><sighting><who><core><user>you@umich.edu</user></core></who></sighting></whery>
```
To search for yourself by device ID (in case you have multiple devices), you could use:
```
<whery><sighting><who><core><device-id>Ekahau.YO:UR:MA:CA:DD:RE:SS</device-id></core></who></sighting></whery>
```