1. Run /sbin/unsling disk1 in the telnet session which you have kept open.

1. Some form of a net connection.
2. "unslung 5.5beta" firmware package".

• Get the unslung 5.5-beta firmware from sourceforge.
• Ensure you have read the readme that comes with the unslung firmware and ensure you have tested your ability to TelnetIntoRedBoot, this is crucial should a mistake be made and you make the NSLU2 temporarily unbootable as I did. Once you can get to a RedBoot prompt you can type upgrade and then using the SerComm Upgrade Utility you can take your firmware back to the linksys original or re flash with an uNSLUng package. Ensure at the very least you are familiar with this process

1. Upload the new unslung 5.5beta firmware via the web interface install page. The update process can take a few minutes so be patient!

This situation will occur if you only have proxy access to the net. Don't fret however as you can manually download the packages and install sucessfully. You might like to check if you have the gateway set on the NSLU2, this is often the cause of not being able to get the NSLU2 connected to the internet.

1. You have a USB disk that you can format and not have to worry about the contents of (it doesn't have to be that big, but it must be larger than 1GB). You can also use a 256MB or larger flash key (you must plug it into the Disk1 USB port on the back of the NSLU2 if you are using a flash key as the unslung disk).

Once you have installed the above packages, you should reboot your slug with the USB disk attached and powered on. Since we have installed the openssh package, you no longer need to enable telnet. Instead, you can use your SSH client to connect to the slug and login as root with the default password uNSLUng (you can always follow generic unslung instructions for changing passwords, if you wish)

1. That you havn't done anything else to the NSLU2 apart from maybe turn it on and used it as Linksys expected ;)
2. You have a USB disk that you can format and not have to worry about the contents of (it doesn't have to be that big, but it must be larger than 1GB). You can also use a 256MB or larger flash key (you must plug it into the Disk1 port if you are using a flash key as the unslung disk).

• Ensure you have read the readme that comes with the unslung-able firmware and ensure you have tested your ability to TelnetIntoRedBoot, this is crucial should a mistake be made and you make the NSLU2 temporarily unbootable as I did. Once you can get to a RedBoot prompt you can type upgrade and then using the SerComm Upgrade Utility you can take your firmware back to the linksys original or re flash with an uNSLUng package. Ensure at the very least you are familiar with this process
• Get the NSLU2 on the local network. It is generally better to attach it to a home network that has a net connection as it will be much easier to download and install the packages later.

• Use the Linksys CD setup utility to set the IP address of the NSLU2.
• Set the NSLU2 IP address to IP 192.168.1.77, subnet 255.255.255.0, gateway 192.168.1.100
• Set my PC IP address to IP: 192.168.1.100, subnet : 255.255.255.0, gateway : 192.168.1.77

• Connect to the web interface of the slug. The default address assuming you set it to 192.168.1.77 is http://192.168.1.77/

• Connect a USB 2.0 disk to the slug.

(if you get a message that you don't have enough memory and you are running Windows you can use the SerComm Upgrade Utility

You're now running an unslung on your nslu2. Now onto getting some extra software (and most importantly puppy) installed.

The package below is optional:

If you've tried the above and get an error its normally because your NSLU2 can't grab the packages direct from the net.

Now you can run your puppy commands... AFTER you've connected your Topfield to the NSLU2.

You will need to have a big disk connected to the NSLU2 if you want to transfer files.

If you've tried the above and get an error its normally because your nslu2 can't grab the packages direct from the net. This situation will occur if you only have proxy access to the net. Don't fret however as you can manually download the packages and install sucessfully.

The manual install involving downloading to another machine and copying over the files.

The second method is a manual install involving manual downloads to another machine and copying over the files. These instructions are found on the ManualPuppyInstall page.

That's it now you are finished!

Or you can transfer the files directly from a windows pc.

First:

  In the webinterface, on the administration -system page, check the server name and workgroup of your slug. Change the workgroup to the same workgroup as your PC, and the server name to ie Slug.

Then:

  Open a windows explorer window
  Go to network environment - complete network - microsoft windows network - work group - server name (ie Slug) - DISK1?
  Copy the ipk files to DISK1?

Finally:

  Telnet to the slug
  type: cd /share/hdd/data/public
  type: ls, and you should see the transfered files

You can now continue with the manual install of the packages

1. "unslung-able 2.x" firmware package or the "unslung 3.17-beta".

• Ensure you have read the readme that comes with the unslung-able firmware and ensure you have tested your ability to http://www.nslu2-linux.org/wiki/HowTo/TelnetIntoRedBoot TelnetIntoRedBoot, this is crucial should a mistake be made a nd you "brick" your unit as I did. Once you can get to a Redboot prompt you can type upgrade and then using the http://www.sercomm.com/web/download.nsf/cd9678c311095856482566a5000aac9e/7f17bf7344cfc12f482566aa00389845/$FILE/Upgrade_207_XP.exe SerComm Upgrade Utility you can take your firmware back to the linksys original or re flash with an uNSLUng package. Ensure at the very least you are familiar with this process

• Ensure you have read the readme that comes with the unslung-able firmware and ensure you have tested your ability to http://www.nslu2-linux.org/wiki/HowTo/TelnetIntoRedBoot TelnetIntoRedBoot, this is crucial should a mistake be made a nd you "brick" your unit as I did. Once you can get to a Redboot prompt you can type upgrade and then using the http://www.sercomm.com/web/download.nsf/cd9678c311095856482566a5000aac9e/7f17bf7344cfc12f482566aa00389845/$FILE/Upgrade_207_XP.exe SerComm Upgrade Utilityyou can take your firmware back to the linksys original or re flash with an uNSLUng package. Ensure at the very least you are familiar with this process

• Ensure you have read the readme that comes with the unslung-able firmware and ensure you have tested your ability to http://www.nslu2-linux.org/wiki/HowTo/TelnetIntoRedBoot TelnetIntoRedBoot, this is crucial should a mistake be made a nd you "brick" your unit as I did. Once you can get to a Redboot prompt you can type upgrade and then using the http://www.sercomm.com/web/download.nsf/cd9678c311095856482566a5000aac9e/7f17bf7344cfc12f482566aa00389845/$FILE/Upgrade_207_XP.exe SerComm Upgrade Utilityutility you can take your firmware back to the linksys original or re flash with an uNSLUng package. Ensure at the very least you are familiar with this process

• Ensure you have read the readme that comes with the unslung-able firmware and ensure you have tested your ability to http://www.nslu2-linux.org/wiki/HowTo/TelnetIntoRedBoot, this is crucial should a mistake be made a nd you "brick" your unit as I did. Once you can get to a Redboot prompt you can type upgrade and then using the http://www.sercomm.com/web/download.nsf/cd9678c311095856482566a5000aac9e/7f17bf7344cfc12f482566aa00389845/$FILE/Upgrade_207_XP.exe SerComm Upgrade Utilityutility you can take your firmware back to the linksys original or re flash with an uNSLUng package. Ensure at the very least you are familiar with this process

1. "unslung-able 2.x" firmware package or the "unslung 3.16-beta".

• Get unslung-able 2.x firmware from peteru. Email him and politely request it from him. The email address for Peter is "toppy at urbanec dot net".

(if you get a message that you don't have enough memory and you are running windows you can use the http://www.sercomm.com/web/download.nsf/cd9678c311095856482566a5000aac9e/7f17bf7344cfc12f482566aa00389845/$FILE/Upgrade_207_XP.exe SerComm Upgrade Utility

See PuppyUsage for some examples of how to use puppy.

• Set the nslu IP address to IP 192.168.1.77, subnet 255.255.255.0, gateway 192.168.1.100
• Set my pc ip address to IP: 192.168.1.100, subnet : 255.255.255.0, gateway : 192.168.1.77

• Connect to the web interface of the slug. Default url address is http://192.168.1.77/

1. Enable telnet access via the telnet.cgi script. http://192.168.1.77/Management/telnet.cgi
2. Telnet to the slug. From a Windows machine you can type "telnet 192.168.1.77"

1. After a reboot, you will need to re-enable telnet access again using http://192.168.1.77/Management/telnet.cgi
2. Telnet back into the slug. From a Windows machine you can type "telnet 192.168.1.77"

ie. ftp 192.168.1.100 (pc). You'll need to have some type of ftp package installed to serve the files.

You will need to have a big disk connected to the NSLU2 if you want to transfer files.

1. Run /sbin/unsling in the telnet session which you have kept open.

Puppy End User install instructions.

Assumptions:

1. That you've just purchased a Linksys NSLU2 and want to run puppy on it to connect to your Toppy.
2. That you havn't done anything else to the NSLU2 apart from maybe turn it on and used it as linksys expected ;)
3. You have a usb disk that you can format and not have to worry about the contents of (it doesn't have to be that big, but it must be larger than 1 Gb). You can also use a 256MB or larger flash key (you must plug it into the Disk1 port if you are using a flash key as the unslung disk).
4. That you're not that familiar with Linux but have some general computer proficiency.

Requirements:

1. Some from of a net connection.
2. "unslung-able 2.x" firmware package.

Pre install.

• Get unslung-able 2.x firmware from peteru. Email him and politely request it from him. The email address for Peter is "toppy at urbanec dot net".

• Get the nslu2 on the local network. It is generally better to attach it to a home network that has a net connection as it will be much easier to download and install the packages later.

• Use the Linksys cd setup to set ip address of the nslu2.
• Set the nslu IP address to IP 192.168.0.77, subnet 255.255.255.0, gateway 192.168.0.100
• Set my pc ip address to IP: 192.168.0.100, subnet : 255.255.255.0, gateway : 192.168.0.77

• Connect to the web interface of the slug. Default url address is http://192.168.0.77/
  • Make sure that your DNS server is set in the web interface.
  • Connect a usb 2.0 disk to the slug.
  • Format the disk under the admin tools/disk page.
  • Test that you can sucessfully use the disk. Copy a file over the network to it.
  • This ensures that we have a known good disk before installing unslung packages on it.

New firmware install.

1. Shutdown the slug.
2. Remove any disks (including flash keys) connected to the slug.
3. Power on the slug and wait for the beep.
4. Upload the new unslungable 2.x firmware via the web interface install page. The update process can take a few minutes so be patient!
5. The slug will reboot at the end of the upgrade.
6. Enable telnet access via the telnet.cgi script. http://192.168.0.77/Management/telnet.cgi
7. Telnet to the slug. From a Windows machine you can type "telnet 192.168.0.77"
8. At the username prompt type "root" and at the password prompt type "uNSLUng".
9. Plug the disk back into the slug.
10. Wait for a minute or so while the slug recognises it.
11. Check and see if your disk is formated via the web interface. If not format it :)
12. Run /sbin/unslung in the telnet session which you have kept open.
13. When the process is finished, you should reboot the slug.
14. This time around you should have your USB disk connected during the boot process.
15. After a reboot, you will need to re-enable telnet access again using http://192.168.0.77/Management/telnet.cgi
16. Telnet back into the slug. From a Windows machine you can type "telnet 192.168.0.77"

Your now running an unslung on your nslu2. Now onto getting some extra software (and most importantly puppy) installed.

Updating and install extra software packages.

NSLU2 that is directly connected to the net.

 ipkg update

 ipkg install openssl
 ipkg install openssh

 ipkg install puppy

 ipkg install bash 

NSLU2 that is indirectly connected to the net.

If you've tried the above and get an error its normally because your nslu2 can't grab the packages direct from the net. This situation will occur if you only have proxy access to the net. Don't fret however as you can manually download the packages and install sucessfully.

Manually get packages

 openssl_0.9.7d-1_armeb.ipk 
 zlib_1.2.1-1_armeb.ipk 
 openssh_3.8p1-1_armeb.ipk
 puppy_1.2-1_armeb.ipk
 bash_2.05b-1_armeb.ipk

FTP Transfer to nlsu2.

Manual install of packages.

 ipkg install openssl_0.9.7d-1_armeb.ipk
 ipkg install zlib_1.2.1-1_armeb.ipk
 ipkg install openssh_3.8p1-1_armeb.ipk     <- This command will take a while as it generates the keys.
 ipkg install puppy_1.2-1_armeb.ipk
 ipkg install bash_2.05b-1_armeb.ipk

If you'd like to run some perl scripts you can optionally install perl.

 ipkg install perl_5.6.1-1_armeb.ipk

Now you are finished!

Connecting to the slug

Once you have installed the above packages, you should reboot your slug with the USB disk attached and powered on. Since we have installed the openssh package, you no longer need to enable telnet. Instead, you can use your ssh client to connect to the slug and login as root with the default password uNSLUng (you can always follow generic unslung instructions for changing passwords, if you wish)

Now you can run your puppy commands ... AFTER you've connected your Topfield to the nslu2.

Type puppy and press "Enter" and it will show you all the options that it can take.

In general you'll be interested in using the "-c" flag which sends commands to the Topfield TF5000PVRt.

A simple test would be to type puppy -c dir to list the contents of the Topfield disk.

The other commands are : "size, dir, get, put, rename, delete, reboot, cancel".

This will update the list of available packages and the following commands will download and install them from the net.

	c.You have a usb disk that you can format and not have to worry about the contents of (it doesn't have to be that big, but it must be larger than 1 Gb).  You can also use a 256MB or larger flash key (you must plug it into the Disk1 port if you are using a flash key as the unslung disk).
	d.That you're not that familiar with linux but have some general computer proficiency.

• Connect a usb 2.0 disk to the slug.

1. Remove any disks (including flash keys) connected to the slug.

1. Plug the disk back into the slug. Wait for a minute or so while the slug recognises it.

• Make sure that your DNS server is set in the web interface.
• Connect a usb 2.0 disk to the Disk1 port on the slug (it must be connected to the Disk1 port, or it won't work correctly).
• Format the disk under the admin tools/disk page.
• Test that you can sucessfully use the disk. Copy a file over the network to it.
• This ensures that we have a known good disk before installing unslung packages on it.

Make sure that your DNS server is set in the web interface.

	c.You have a 256MB or larger usb disk that you can format and not have to worry about the contents of.

Connect a usb 2.0 disk to the Disk1 port on the slug (it must be connected to the Disk1 port, or it won't work correctly). Format the disk under the admin tools/disk page.

1. Remove any disks (including USB disks) connected to the slug.

1. Plug the disk back into the Disk1 port. Wait for a minute or so while the slug recognises it.
2. Check and see if your disk is formated via the web interface. If not format it :)
3. Run /sbin/unslung in the telnet session which you have kept open.

	1.Use the Linksys cd setup to set ip address of the nslu2.

3.Connect to the web interface of the slug. Default url address is http://192.168.1.77/

1. Upload the new unslungable 2.x firmware via the web interface install page. The update process can take a few minutes so be patient!
2. Check and see if your disk is formated via the web interface. If not format it :)
3. Enable telnet access via the telnet.cgi script. http://192.168.1.77/Management/telnet.cgi
4. Telnet to the machine. From a windows machine you can type "telnet 192.168.0.77"
5. At the username prompt type "root" and at the password prompt type "uNSLUng".
6. run /sbin/unslung

2.Get the nslu2 on the local network. It is generally better to attach it home network that has a net connection as it will be much easier to download and install the packages later.

However it is still possible to do it without a direct net connection. I was using a crossover cable to do install puppy.

	1.Use linksys cd setup to set ip address of the nslu2.

Updating and install extra software packages.

2.Get the nslu2 on the local network.

	2.Set the nslu IP address to IP 192.168.0.77, subnet 255.255.255.0, gateway 192.168.0.100
	3.Set my pc ip address to IP: 192.168.0.100, subnet : 255.255.255.0, gateway : 192.168.0.77

You can get a free ssh client http://www.chiark.greenend.org.uk/~sgtatham/putty/ here

goto the http://ipkg.nslu2-linux.org/ipkg/ Ipkg Package site and get the following.

This package will start the SSH (secure shell) daemon when the nslu2 starts each time.

The package below is optional.

ipkg install bash

The other commands are : "size, dir, get, put, rename, delete, reboot, cancel".

Puppy End User install instructions.

Pre install.

New firmware install.

Your now running an unslung on your nslu2.

Updating packages.

NSLU2 that is directly connected to the net.

NSLU2 that is indirectly connected to the net.

This situation will occur if you only have proxy access to the net. Don't fret however as you can manually download them and install sucessfully.

Manually get packages

openssl_0.9.7d-1_armeb.ipk

zlib_1.2.1-1_armeb.ipk

openssh_3.8p1-1_armeb.ipk

puppy_1.2-1_armeb.ipk

bash_2.05b-1_armeb.ipk

FTP Transfer to nlsu2.

• add properly formatted example of ftp transfer*

Manual install of packages.

Basic puppy usage.

Using puppy is from the command line. There are several different parameters you can pass to it. Type "puppy" and press "Enter" and it will show you all the options that it can take.

In general you'll be interested in using the "-c" flag which sends commands to the Topfield5000PVRT?. A simple test would be to type "puppy -c dir".

Own notes: You'll need to enable telnet each time via the gui interface. I'm trying to find out how this is enabled permanently upon startup.

The Puppy End User install instructions for getting unslung and puppy working on your nslu2.

Assumptions :

	a.That you've just purchased a Linksys NSLU2 and want to run puppy on it to connect to your Toppy.
	b.That you havn't done anything else to the NSLU2 apart from maybe turn it on and used it as linksys expected ;)
	c.You have a usb disk that you can format and not have to worry about the contents of. 
	(doesn't have to be a huge disk btw!)
	d.That your not that familiar with linux but have some general computer proficiency.

Requirements : Some from of a net connection, "unslung-able 2.x" firmware package.

Pre install.

1.Get unslung-able 2.x firmware from peteru. Email him and politely request it from him. You can email Peter's via "toppy at urbanec dot net".

2. Get the nslug on the local network.

I was using a crossover cable so some of the following may not apply.

	1.Use linksys cd setup to set ip address of the slug.
	Set the nslu IP address to IP 192.168.0.77, subnet 255.255.255.0, gateway 192.168.0.100

	2.Set my pc ip address to IP: 192.168.0.100, subnet : 255.255.255.0, gateway : 192.168.0.77

3.Connect to the web interface of the slug. http://192.168.0.77/ Connect a usb 2.0 disk to the slug. Format the disk under the admin tools/disk page. Test that you can sucessfully use the disk. Copy a file over the network to it. This ensures that we have a known good disk before installing unslung packages on it.

New firmware install.

1.Upload the new unslungable 2.x firmware via the web interface install page. 2.Enable telnet access via the telnet.cgi script. http://192.168.0.77/Management/telnet.cgi 3.Telnet to the machine. From a windows machine you can type "telnet 192.168.0.77" 4.At the username prompt type "root" and at the password prompt type "uNSLUng". 5.Check and see if your disk is formated via the web interface. If not format it :) 6.run /sbin/unslung

Your now running an unslung nslu2! Now onto getting some extra software (and most importantly puppy) installed.

Updating packages.

Now there are two ways to install packages onto the newly unslung nslu2.

1. Direct from the net if your nslu2 has access to the internet.

Simply Type :

ipkg update ipkg install openssl ipkg install openssh ipkg install puppy ipkg install bash

This will update the list of available packages then downloads and installs them from the net.

2. If you've tried the above and get an error its normally because your nslu2 can't grab the packages direct from the net. This situation will occur if you only have proxy access to the net. Don't fret however as you can manually download them and install

sucessfully.

On a machine that has net access. ie. your normal net connected home machine.

goto the http://ipkg.nslu2-linux.org/ipkg/ site and get the following packages. openssl_0.9.7d-1_armeb.ipk, zlib_1.2.1-1_armeb.ipk, openssh_3.8p1-1_armeb.ipk ,puppy_1.2-1_armeb.ipk,bash_2.05b-1_armeb.ipk , optionally

(perl_5.6.1-1_armeb.ipk) from the how-to page.

Now from the nslu2 ftp to my local pc that i've downloaded the packages to. ie. ftp 192.168.0.100 (pc). You'll need to have some type of ftp package installed to serve the files. I was running the free alex small ftp package from my windows machine.

Below is an example ftp transfer of a file from my pc to the nslu2.

1. ftp 192.168.0.100

Connected to 192.168.0.100. 220 aac41689 FTP version 0.7 ready at Tue Dec 21 12:01:54 2004 Name (192.168.0.100:root): anonymous 331 Enter PASS command Password: 230 Logged in Remote system type is Windows95/NT. ftp> ls 200 Port command okay 150 Opening data connection for list "C:\DOCUME~1\LKHOO~1.AUN\LOCALS~1\Temp\FLS1? 0E.tmp" drwx------ 1 ftp users 0 Dec 21 11:42 . drwx------ 1 ftp users 0 Dec 21 11:42 .. -rwx------ 1 ftp users 298160 Dec 21 11:43 bash_2.05b-1_armeb.ipk -rwx------ 1 ftp users 542927 Dec 21 11:43 openssh_3.8p1-1_armeb.ipk -rwx------ 1 ftp users 899521 Dec 21 11:43 openssl_0.9.7d-1_armeb.ipk -rwx------ 1 ftp users 10338 Dec 21 11:42 puppy_1.2-1_armeb.ipk -rwx------ 1 ftp users 55098 Dec 21 12:00 zlib_1.2.1-1_armeb.ipk WARNING! 7 bare linefeeds received in ASCII mode File may not have transferred correctly. 226 Transfer complete ftp> hash Hash mark printing on (1024 bytes/hash mark). ftp> bin 200 Type I OK ftp> get zlib_1.2.1-1_armeb.ipk local: zlib_1.2.1-1_armeb.ipk remote: zlib_1.2.1-1_armeb.ipk 200 Port command okay 150 Opening data connection for retr "/zlib_1.2.1-1_armeb.ipk"

226 Transfer complete 55098 bytes received in 0.0205 secs (2.6e+03 Kbytes/sec) ftp> bye 221 Goodbye!

Now cut and paste each of in the following commands to install each of the packages.

ipkg install openssl_0.9.7d-1_armeb.ipk ipkg install zlib_1.2.1-1_armeb.ipk ipkg install openssh_3.8p1-1_armeb.ipk <- This command will take a while as it generates the keys. ipkg install puppy_1.2-1_armeb.ipk ipkg install bash_2.05b-1_armeb.ipk

If you'd like to run some perl scripts you can optionally install perl. (ipkg install perl_5.6.1-1_armeb.ipk)

Now your finished!

Now you can run your puppy commands ... AFTER you've connected your topfield to the nslu2.

ie. puppy -c dir

This should list the contents of the topfield disk.

The other commands are : "size, dir, get, put, rename, delete, reboot, cancel".

Notes: You'll need to enable telnet each time via the gui interface. I'm trying to find out how this is enabled permanently upon

startup.