
        SSH/SCP Enabler for Joggler v1.02 (16th November 2011) by Andy Davison
==============================================================================
                                                          birdslikewires.co.uk


------------------------------------------------------------------------------
WARNING! No responsibility will be accepted for any loss or damage which may
         occur through the use of these files. This software is provided
         without warranty.

If you find this software useful, maybe you would like to make a contribution
towards it's hosting? If you would like some more information, please visit:

                                      http://birdslikewires.co.uk/about/donate
------------------------------------------------------------------------------


This script will enable SSH and SCP communication on an O2 Joggler.

Please ensure that you are running software version 26635.S3 (June 25 2010) before running this on your Joggler. If you need to reset your password, simply boot with the USB stick attached again.


Instructions
------------

1. Copy the contents of the zip file to a FAT16 or FAT32 formatted USB stick.
2. Make sure you have copied all the files, including the '.sum' file.
3. Plug the USB stick into a powered-off Joggler.
4. Power on the Joggler and wait until the normal interface appears.

When the script has completed, your Joggler should beep twice.

The default username and password are:

USERNAME: joggler
PASSWORD: joggler

You should now be able to get SSH and SCP access using a Terminal application or file transfer utility, eg.

ssh joggler@<ip_of_your_joggler>

You can find your Joggler's IP address by using the Settings app and choosing 'Network'.

To change your password, keep the USB stick attached to the Joggler, log in using the details above and issue the following command:

/mnt/setpasswd.sh <password>

This will change the Joggler user's password.


Troubleshooting
---------------

- Make sure that you are running software version 26635.S3 (June 25 2010)
  You can check using the Settings app and choosing 'About'.

- Make sure you copied the '.sum' file to your USB stick.
  This is a hidden file on UNIX-based systems.

- The SSH daemon may take some time to start the first time.
  Wait for 5 minutes. If it does not allow you access, reboot and try again.

- If you continue to have problems, follow the installation procedure again.
  You can rerun the installation procedure as many times as you like.

- Forgotten your password?
  Rerun the installation procedure. This will reset your password back to 'joggler'.


Details
-------

The SSH daemon is restarted each time the Joggler reboots. The script patches a few script files and adds the necessary libraries and binaries for SCP to work. Notably, it comments out lines in S69boot.sshd with the command "log_daemon_msg" which causes the rcS script to die (thus not starting sshd).



Built upon the work of:
	Stephen Ford: http://stephenford.org/
	Miles Burton: http://milesburton.com/


