Search ajhonline
 
   
  Help Section  
 

Help

Installation - Windows

Installation - Other Operating Systems

Configuration

Installation - Windows

Installation of FindYourLaptop under Windows is simple. First if it is not already, download and install the Java JRE from here. Next download and run the Windows installer version of FindYourLaptop from the download page.

As of version 0.1b the installer wizard will give you the option of whether or not to create a start menu programs group. By default it will not create the icons, meaning that to uninstall the software or edit the config file, the user will have to browse to the install directory. This was done so that the existence of the software is less obvious.

At the end of the installation wizard, the option to edit the configuration file is given, keep this selected and click finish and the config file will be displayed in notepad. See the configuration section further down this page for details on how to set up FindYourLaptop.

 

Installation - Other Operating Systems

Installation under other Operating Systems is a little more complicated, but not by much. The following instructions have been tested under Ubuntu Intrepid Ibex, but should be valid for other Linux distros, and probably Mac OSX too (I don't have a Mac so I can't test that one).

The first step is to get Java installed, the easiest way to do this under Ubuntu is to use apt-get to install it, although it can also be downloaded from www.java.com and installed manually. The command below will install the latest update of the Sun version 6 JRE.

sudo apt-get install sun-java6-bin

Check that the Sun JRE is installed and in use by typing the following command

java -version

Next, download the platform independent version of FindYourLaptop from the download page.

Change directory to the location of the downloaded file and issue the following commands

sudo mkdir /usr/fyl
sudo chmod 777 /usr/fyl
sudo unzip fyl.zip /usr/fyl

The files should be extracted from the zip file. Next edit the .properties file in a text editor as described in the configuration section below.

Finally edit the /etc/rc.local file so that the /usr/fyl/runFYL.sh script is executed whenever the machine is booted.

Reboot the machine to check that all is working, if it is, an email should be sent to the address entered in the .properties file, and java -jar security.jar should show up as a running process.

If you receive multiple emails reporting that the same IP address has been detected for the first time, check that the fyl.properties file is writable.

If you install to a directory other than /usr/fyl edit the runFYL.sh file to change the path as appropriate.

Configuration

As of version 0.2 manually editing the configuration file is no longer required due to the addition of a configuration application. However the instructions below remain for information if required due to any problems with the config app.

 

An example configuration file is shown below, explanations of each of the fields is shown below that.

#Mon Oct 06 21:18:24 BST 2008
known.ip.count=2
known.ip.0=192.168.0.1
known.ip.1=192.168.0.2

mailserver.name=my.mailserver.com
mailserver.username=username
mailserver.password=password

mail.destination.address=me@my.email.com

  • known.ip.count - The number of known IP addresses
  • known.ip.n - An IP address that is already known, either by the user having entered it manually or because it was detected as being used. Or (As of version 0.22) a range of IP Addresses separated by a '-'.

 

  • mailserver.name - The name or IP address of the SMTP mailserver that will be used to send any emails detailing detected IP addresses. See below for more information about the mail server.
  • mailserver.username - The username used to connect to the SMTP mailserver
  • mailserver.password - The password used to connect to the mailserver. Since version 0.2, once FindYourLaptop has been run for the first time and detected a new IP address, this field will be replaced with "mailserver.password.encrypted", containing an encrypted version of the password.

 

  • mail.destination.address - The address that emails will be sent to when a previously unknown IP address is detected. This can be any address, it does not have to be related to the mailserver use for sending the emails. In fact, it would be better if it was a separate account.

 

It is important that the mailserver will allow emails to be sent from anywhere, many ISP don't allow emails to be sent through their server if you are not connected to the internet from one of their accounts. However there are plenty of free mailservers you can set up an account with that will work correctly with FindYourLaptop. Inbox.com (which I use) and gmail both offer free accounts that include access to SMTP servers. Yahoo allows SMTP access with their paid accounts.

When first setting up FindYourLaptop, it's a good idea to leave the known.ip.count as zero so that when it is first run (usually after a reboot, although the executable can just be run) an email will be immediately sent to the specified email address to verify that it is working correctly.