SSH

There are a few ways to get SSH up and running. The easy methods are recommended for everyone.

The full manual method is retained to demonstrate how the process is actually achieved.

Easy Way (New Version)

This first method enables both SSH (for command line login) and SCP (for secure file copying). It also includes a little script for changing the default password and can be run multiple times, so you can use it to reset your password should you forget it. Simply attach the USB stick again and reboot.

This method can also be used to add SCP to a Joggler that has already had SSH enabled through any other method on this page. Just be aware that your password will be reset to 'joggler' and the username will change to 'joggler'.

Please make sure that you are running software version 26635.S3 (June 25 2010) before running this on your Joggler.

If your software is not up to date, the script will not run and neither SSH nor SCP will be enabled.

1. Download http://birdslikewires.co.uk/download/joggler/native/sshscp.zip
2. Copy zip file onto a blank FAT16 or FAT32 formatted USB stick.
3. Decompress the contents of the zip file.
4. Make sure all of the files are present, including the '.sum' file.
5. Eject the USB stick from your computer and connect it to a powered-off Joggler.
6. Power on the Joggler and wait until the normal interface appears.

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.

Easy Way (Original Version)

You can use this method to gain access to a new joggler without needing to first apply the telnet hack neccessary in the Manual Installation. This method will work alongside a system that has already had any telnet hack applied.

1. Download http://stephenford.org/joggler/files/joggler_enable_ssh_v0.1.zip
2. Extract joggler_enable_ssh_v0.1.zip and put the files in to the root of a FAT16 or FAT32 formated usb stick
   1. One of the necessary files is .sum and will be hidden on a Linux system. Make sure it is copied, or the process won't work.
3. Plug usb stick in to your Joggler and power on.
4. You should now be able to get root ssh access:
   1. Username: letmeinssh
   2. Password: joggler1234

You can delete the files from your usb stick after applying this patch. In fact, it's not advisable to run it multiple times.

Troubleshooting

• It may take a few minutes for the ssh daemon to start and for you to get access immediately after installation. If you get bored, reboot and it should work.
• The first partition on your USB stick must be FAT16 or FAT32. Reformat your stick before use.

Manual Installation

1. Do the Installing Telnet hack to get a terminal prompt.
2. Run the following commands, it is recommended you cut and paste each line:

nvram -w net.login=YES
touch /etc/shadow
ln -s  /openpeak/tango/common_libs/libgssapi_krb5.so.2 /lib/libgssapi_krb5.so.2
mkdir /var/run/sshd
cp -p /etc/ssh/sshd_config /etc/ssh/sshd_config.original
sed -i "s/UsePAM\ yes/\#UsePAM \yes/g" /etc/ssh/sshd_config
echo "letmeinssh:\$1\$ZiLC0meg\$e55qljsb4ssEKY3dQMsxP1:0:0:root:/:/bin/sh" >> /etc/passwd
/usr/sbin/sshd &
cp -p /etc/init.d/boot.d/S69boot.sshd /root/S69boot.sshd.original
sed -i "s/OFF in/\ in/g" /etc/init.d/boot.d/S69boot.sshd
sed -i "s/log_daemon_msg/\#\ log_daemon_msg/g"  /etc/init.d/boot.d/S69boot.sshd
sync
sync

Once this is enabled it is advisable to use it in preference to telnet, as telnet is insecure. SSH is secure and encrypted.

Change Your Password

To prevent unauthorised access, you should change your Joggler's password. The normal way of doing this on a Linux system is using the command:

passwd letmeinssh

But this won't necessarily work on a Joggler running the original operating system. If it doesn't, use this:

echo "joggler:`cryptpw password`:0:0:Joggler:/:/bin/sh" >> /etc/passwd

Where joggler is the username, password is the password and Joggler is the name associated with the account. Obviously, you can change these to whatever you like.

You can then use vi to remove the 'letmeinssh' entry in /etc/passwd.