NSLU2-Linux
view · edit · print · history

Debian.HomePage History

Hide minor edits - Show changes to markup

May 10, 2010, at 11:28 AM by Kees Moerman -- Some updates for Lenny release 5.0.4
Changed lines 65-66 from:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2, using the latest Debian point release (4.0r2). There is also a manual method described at http://www.cyrius.com/debian/nslu2/unpack.html, but everything should work using the automatic install.

to:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2, using the latest Debian Lenny release (5.0.4). There is also a manual method described at http://www.cyrius.com/debian/nslu2/unpack.html, but everything should work using the automatic install.

Changed lines 78-79 from:
  1. The current installer for Debian/NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.
to:
  1. The previous installer for Debian/NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory. [ Current Lenny installer debian-armel-5.0.4.zip from http://www.slug-firmware.net/ does not seem to have this problem anymore ]
November 02, 2009, at 10:36 PM by tbm -- fix markup
Changed lines 49-50 from:

Please note that a lot of information on this wiki is out of date. Refer to [[http://www.cyrius.com/debian/nslu2/] for up-to-date information about Debian on the NSLU2.

to:

Please note that a lot of information on this wiki is out of date. Refer to http://www.cyrius.com/debian/nslu2/ for up-to-date information about Debian on the NSLU2.

November 02, 2009, at 10:36 PM by tbm -- say that this wiki is quite out of date
Added lines 49-50:

Please note that a lot of information on this wiki is out of date. Refer to [[http://www.cyrius.com/debian/nslu2/] for up-to-date information about Debian on the NSLU2.

May 24, 2009, at 05:50 PM by Maisondouf --
Changed lines 28-29 from:
to:
   ( And it really run fine on my Slug after a long, long installation ! ) 
February 18, 2009, at 10:48 PM by rwhitby -- Lenny is released
Added lines 27-28:
  • [2009-02-14] Debian lenny (5.0) is released.
November 23, 2008, at 09:59 AM by vtetri -- spam rollback
Changed lines 1-214 from:

university of houston pharmacy school [URL=http://vforveeno.com/images/icons/article-1014.htm]university of houston pharmacy school[/URL] [url=http://vforveeno.com/images/icons/article-1014.htm]university of houston pharmacy school[/url] [url]http://vforveeno.com/images/icons/article-1014.htm[/url]

to:

Contents

What is Debian/NSLU2?

Debian/NSLU2 is the name given to the official Debian distribution for ARM that runs on the NSLU2, thanks to the efforts of the nslu2-linux developers to get the necessary kernel patches and utilities accepted upstream by the kernel maintainers and by the Debian Project.

Goals

The goal is to add full support for the NSLU2 and similar devices into the official Linux kernel and the Debian GNU/Linux distribution, so users can benefit from the full Debian package repository and also have slug-specific packages and patches for hardware devices such as the built-in Ethernet port, LEDs, etc.

News

  • [2008-11-12] The first release candidate for Debian 5.0 (lenny) is available. At this point lenny is recommended for new installations. You can find installation instructions and a list of changes and improvements in the new installer for lenny.
  • [2008-02-17] Debian Stable 4.0r3 is here (http://www.debian.org/News/2008/20080217). The latest information about it can be found at http://www.cyrius.com/debian/nslu2/install.html. If this is your first time installing Debian "etch", and if you need to use the on-board Ethernet port, the unofficial image with the the proprietary IXP4xx microcode can be found at http://www.slug-firmware.net/d-dls.php. If you have already installed 4.0r2 "normally", however, all you need to do to update is:
        # apt-get update
        # apt-get dist-upgrade
    
Standard caveats about backup apply. Per Martin Michlmayr, you can safely ignore this message:
    Hmm. The package shipped with a symbolic link /lib/modules/2.6.18-6-ixp4xx/source
      However, I can not read the target: No such file or directory
      Therefore, I am deleting /lib/modules/2.6.18-6-ixp4xx/source

State of the project

Debian fully supports the NSLU2 using the Debian Installer (this is the setup known as Debian/NSLU2). Please visit http://www.cyrius.com/debian/nslu2/ for the recommended way to install Debian on a NSLU2.

Known Problems

  • See http://www.us.debian.org/devel/debian-installer/errata for current known issues (not NSLU2-specific).

Installation instructions

You may still use debian installer. After connecting to the installer via SSH do the following:

  1. start the menu
  2. choose "<Go Back>"
  3. choose "Change debconf priority" and set the priority to "low"
  4. resume installation with "Choose a mirror of the Debian archive"
  5. when you'll be asked which kernel you want to use, choose "linux-image-2.6.18-5-ixp4xx"

Solution from Rainer Hlawaty.

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2, using the latest Debian point release (4.0r2). There is also a manual method described at http://www.cyrius.com/debian/nslu2/unpack.html, but everything should work using the automatic install.

If your device (i.e. an IXP4xx device other than the NSLU2) is not supported by the Debian Installer, then you can use the Bootstrap procedure instead.

French Version (DebianSlug): Debian GNU/Linux sur le NSLU2.

German Version (DebianSlug & DebianInstaller): Debian auf NSLU2 installieren.

Installation errata

  1. The previous installer for Debian/NSLU2 available via http://www.slug-firmware.net/d-dls.php (debian-4.0r0.zip) was hardwired to look for kernel version 2.6.18-4, but the kernels have been upgraded to 2.6.18-5 with the release if Debian 4.0r1 and the installer could not continue, causing the installation to abort. This is a known problem with Debian 4.0r1 and no longer applies to 4.0r2. The automatic install using debian-installer works correctly in 4.0r2.
  2. The current installer for Debian/NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.
  3. RC2 has the same problem as above when tested on an 2GB flash drive. Best bet is to format the flash drive on another box and then mount it as per the link below: You can choose to manually partition the flash drive in the installer making the second partition a 128Mb swap and the first partition the rest.

Check DebianInstallerDisconnectsSSH.

Another option is to create and format the ext3 partition on a normal PC as described in the FAQ.

Upgrade from previous versions

Upgrade from debian-installer beta2

If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.

Upgrade from manual bootstrap to testing ("etch")

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

 do_symlinks = yes
 relative_links = yes
 do_bootloader = no
 do_bootfloppy = no
 do_initrd = yes
 link_in_boot = yes

Ethernet driver issue: If your /etc/network/interfaces looks like this, it may happen, that eth0 isn't brought up.

 auto eth0
 iface eth0 inet static
         pre-up modprobe -f ixp400
         pre-up modprobe -f ixp400_eth
         address 10.0.0.201
         netmask 255.255.255.0
         gateway 10.0.0.138

If this is the case try this:

 allow-hotplug eth0
 iface eth0 inet static
         address 10.0.0.201
         netmask 255.255.255.0
         gateway 10.0.0.138

After that, follow the guide to Upgrading Debian on the Linksys NSLU2. When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.

Obtaining the NPE-B microcode

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the Wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage (you need a recent version of slugimage that includes second-stage bootloader support (the -L switch.).

(For Ubuntu users, fiesty is not up to date as of 09/09/07 and slugimage should be downloaded from the debian unstable repository and installed using dpkg. Frank: Ubuntu users can extend the software source for the installation to gutsy and will have the recent version

  sudo gedit /etc/apt/sources.list

add an additional line with

  deb http://at.archive.ubuntu.com/ubuntu/ gutsy universe

update your package list and install the newest version. remove the line afterwards again.).

 apt-get install slugimage
 slugimage -u -i di-nslu2.bin       # di-nslu2.bin is the debian-installer

Endian swap the initramfs (ramdisk.gz).

 apt-get install devio
 devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz

Unpack the initramfs into a directory e.g. initrd.

 mkdir initrd; cd initrd
 zcat ../ramdisk-swap.gz | cpio -i

The NPE microcode firmware will be in the lib/firmware directory. It is called NPE-B.01000201. Copy this file as root to /lib/firmware on the slug or to /mnt/lib/firmware if you are creating a usb drive image, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201.

 [s]cp NPE-B.01000201 [user@hostname:][/mnt]/lib/firmware/
 [ssh user@hostname]
 cd [/mnt]/lib/firmware; sudo ln -s NPE-B.01000201 NPE-B

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstrapped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.18. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

 deb http://ftp.XX.debian.org/debian testing main non-free contrib

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.18:

 apt-get -t testing install linux-image-2.6-ixp4xx

Links to more Debian/NSLU2 documentation

The Debian/NSLU2 FAQ.

To learn how to build a Debian/NSLU2 image, see BuildImage.

See ChangeKernelCommandLine for how to change the command line passed to the kernel by the second-stage bootloader, APEX, in a Debian/NSLU2 system.

If you want to free up some space in your internal flash, see NoInitramfs.

To use the Debian Installer with a FatSlug, follow the instructions here.

To use a Hauppauge WinTV PVR USB2, see InstallWinTVPVRUSB2

For information on installing rtorrent, go here InstallRtorrentOnDebian

Troubleshooting

Section moved to the Debian/NSLU2 Troubleshooting page.

Native Development

The Debian build-essential package should install without problems, however if you try to compile more than a few dozen lines you might see problems that don't appear to make sense. The first thing to check is that you have enough memory: on a system with 32Mb physical RAM Debian might only install another 90Mb swapspace.

I believe that in order to fix this you will have to reinstall, deleting/recreating partitions to get sensible sizes. Based on the fact that I've seen building the Lazarus GUI taking 200Mb I suggest 256Mb swap as a minimum, 512Mb is probably adequate.

Other Solutions

The old solution to run Debian packages in the NSLU2 is SlugOS/LE, previously known as DebianSlug. This solution uses the SlugOS kernel in little-endian mode, in a way that is compatible with the Debian arm distribution. This setup requires a manual bootstrap procedure and is no longer the recommended solution to run Debian in the slug.

Also available is Big Endian DebianSlug (known as OpenDebianSlug, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available.

French support

I have added some guidelines in french to install Debian on the Slug, with an associated support forum. Everything is located here and in the forum section of the site.

October 30, 2007, at 02:35 AM by Vernicht -- Adding information about rtorrent
Added lines 173-174:

To use rTorrent >= 0.7 then download the libtorrent10 from this link: [http://www.coutts.plus.com/rtorrent_nslu2] or compile libtorrent10 with the following arguments CXXFLAGS="-O2 -mcpu=xscale -mtune=xscale" ./configure --prefix=/root/installroot/ as told in bottom of the following page: [http://libtorrent.rakshasa.no/wiki/LibTorrentKnownIssues]

September 22, 2007, at 07:06 AM by Ruiqiang Huang --
Changed lines 122-123 from:
 wget http://www.groux.org/docs/ubuntu/NSLU2/di-nslu2.bin
 slugimage -u -i di-nslu2.bin
to:
 slugimage -u -i di-nslu2.bin       # di-nslu2.bin is the debian-installer
September 22, 2007, at 06:49 AM by Ruiqiang Huang -- Add URL for di-nslu2.bin
Added line 122:
 wget http://www.groux.org/docs/ubuntu/NSLU2/di-nslu2.bin
September 16, 2007, at 09:27 AM by Frank Banzhoff -- Ubuntu slugimage workaround
Changed lines 112-113 from:

(For Ubuntu users, fiesty is not up to date as of 09/09/07 and slugimage should be downloaded from the debian unstable repository and installed using dpkg.).

to:

(For Ubuntu users, fiesty is not up to date as of 09/09/07 and slugimage should be downloaded from the debian unstable repository and installed using dpkg. Frank: Ubuntu users can extend the software source for the installation to gutsy and will have the recent version

  sudo gedit /etc/apt/sources.list

add an additional line with

  deb http://at.archive.ubuntu.com/ubuntu/ gutsy universe

update your package list and install the newest version. remove the line afterwards again.).

September 09, 2007, at 03:09 PM by gencier -- Correction of firmware file location and added intructions to put this in a usb image.
Changed line 131 from:

The NPE microcode firmware will be in the initrd directory. It is called NPE-B.01000201. Copy this file to /lib/firmware on the slug, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201.

to:

The NPE microcode firmware will be in the lib/firmware directory. It is called NPE-B.01000201. Copy this file as root to /lib/firmware on the slug or to /mnt/lib/firmware if you are creating a usb drive image, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201.

Changed line 133 from:
 [s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/
to:
 [s]cp NPE-B.01000201 [user@hostname:][/mnt]/lib/firmware/
Changed line 135 from:
 cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B
to:
 cd [/mnt]/lib/firmware; sudo ln -s NPE-B.01000201 NPE-B
September 09, 2007, at 09:53 AM by gencier -- Problems with slugimage in Ubuntu, fiesty.
Changed lines 110-111 from:

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage (you need a recent version of slugimage that includes second-stage bootloader support (the -L switch).

to:

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage (you need a recent version of slugimage that includes second-stage bootloader support (the -L switch.).

(For Ubuntu users, fiesty is not up to date as of 09/09/07 and slugimage should be downloaded from the debian unstable repository and installed using dpkg.).

August 31, 2007, at 08:23 PM by fcarolo -- fixed false wikilinks
Changed lines 55-58 from:
  1. The current installer for NSLU2 available via http://www.slug-firmware.net/d-dls.php (debian-4.0r0.zip) seems to be hardwired to look for kernel version 2.6.18-4, but the kernels have since been upgraded to 2.6.18-5 and the installer cannot continue, causing the installation to abort. Maybe this is due to the mirrors now reflecting Debian 4.0r1 but the installer being built for 4.0r0? Know problem with Debian 4.0r1, see above for a workaround using a manual procedure.
  2. The current installer for NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.
to:
  1. The current installer for Debian/NSLU2 available via http://www.slug-firmware.net/d-dls.php (debian-4.0r0.zip) seems to be hardwired to look for kernel version 2.6.18-4, but the kernels have since been upgraded to 2.6.18-5 and the installer cannot continue, causing the installation to abort. Maybe this is due to the mirrors now reflecting Debian 4.0r1 but the installer being built for 4.0r0? Know problem with Debian 4.0r1, see above for a workaround using a manual procedure.
  2. The current installer for Debian/NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.
Changed lines 163-164 from:

To use a Hauppauge WinTV? PVR USB2?, see InstallWinTVPVRUSB2

to:

To use a Hauppauge WinTV PVR USB2, see InstallWinTVPVRUSB2

August 22, 2007, at 05:04 PM by fcarolo -- updated info about Debian 4.0r1
Changed lines 25-26 from:
  • [2007-08 17] Debian Stable 4.0r1 released (http://www.debian.org/News/2007/20070817). Unfortunately this release has broken the Debian Installer on the NSLU2. For a detailed explanation, please see http://lists.debian.org/debian-arm/2007/08/msg00073.html. It is not possible to install Debian on the NSLU2 using the automatic installer right now. This will be fixed in the next point release (4.0r2). In the meantime, people who wish to install Debian on the NSLU2 can use the manual method described at http://www.cyrius.com/debian/nslu2/unpack.html.
to:
  • [2007-08 17] Debian Stable 4.0r1 released (http://www.debian.org/News/2007/20070817). Unfortunately this release has broken the Debian Installer on the NSLU2. For a detailed explanation, please see http://lists.debian.org/debian-arm/2007/08/msg00073.html.
    It is not possible to install Debian on the NSLU2 using the automatic installer right now. This will be fixed in the next point release (4.0r2). In the meantime, people who wish to install Debian on the NSLU2 can use the manual method described at http://www.cyrius.com/debian/nslu2/unpack.html.
Changed lines 44-45 from:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2. Please note that a recent problem with the latest Debian point release (4.0r1), it is not possible to use the automatic install procedure based on Debian Installer. If you wish to install Debian on your NSLU2, please use the manual method described at http://www.cyrius.com/debian/nslu2/unpack.html.

to:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2. Please note that a recent problem with the latest Debian point release (4.0r1), it is not possible to use the automatic install procedure based on Debian Installer right now. If you wish to install Debian on your NSLU2, please use the manual method described at http://www.cyrius.com/debian/nslu2/unpack.html.

August 22, 2007, at 05:03 PM by fcarolo -- updated info about Debian 4.0r1
Changed lines 25-26 from:
  • [2007-08 17] Debian Stable 4.0r1 released (http://www.debian.org/News/2007/20070817). Unfortunately this release has broken the Debian Installer on the NSLU2. For a detailed explanation, please see http://lists.debian.org/debian-arm/2007/08/msg00073.html.
to:
  • [2007-08 17] Debian Stable 4.0r1 released (http://www.debian.org/News/2007/20070817). Unfortunately this release has broken the Debian Installer on the NSLU2. For a detailed explanation, please see http://lists.debian.org/debian-arm/2007/08/msg00073.html. It is not possible to install Debian on the NSLU2 using the automatic installer right now. This will be fixed in the next point release (4.0r2). In the meantime, people who wish to install Debian on the NSLU2 can use the manual method described at http://www.cyrius.com/debian/nslu2/unpack.html.
Changed lines 43-44 from:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2. If your device (i.e. an IXP4xx? device other than the NSLU2) is not supported by the Debian Installer, then you can use the Bootstrap procedure instead.

to:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2. Please note that a recent problem with the latest Debian point release (4.0r1), it is not possible to use the automatic install procedure based on Debian Installer. If you wish to install Debian on your NSLU2, please use the manual method described at http://www.cyrius.com/debian/nslu2/unpack.html.

If your device (i.e. an IXP4xx device other than the NSLU2) is not supported by the Debian Installer, then you can use the Bootstrap procedure instead.

Changed lines 54-55 from:
  1. The current installer for NSLU2 available via http://www.slug-firmware.net/d-dls.php (debian-4.0r0.zip) seems to be hardwired to look for kernel version 2.6.18-4, but the kernels have since been upgraded to 2.6.18-5 and the installer cannot continue, causing the installation to abort. Maybe this is due to the mirrors now reflecting Debian 4.0r1 but the installer being built for 4.0r0?
to:
  1. The current installer for NSLU2 available via http://www.slug-firmware.net/d-dls.php (debian-4.0r0.zip) seems to be hardwired to look for kernel version 2.6.18-4, but the kernels have since been upgraded to 2.6.18-5 and the installer cannot continue, causing the installation to abort. Maybe this is due to the mirrors now reflecting Debian 4.0r1 but the installer being built for 4.0r0? Know problem with Debian 4.0r1, see above for a workaround using a manual procedure.
Changed lines 58-59 from:
  1. RC2? has the same problem as above when tested on an 2GB flash drive. Best bet is to format the flash drive on another box and then mount it as per the link below: You can choose to manually partition the flash drive in the installer making the second partition a 128Mb swap and the first partition the rest.
to:
  1. RC2 has the same problem as above when tested on an 2GB flash drive. Best bet is to format the flash drive on another box and then mount it as per the link below: You can choose to manually partition the flash drive in the installer making the second partition a 128Mb swap and the first partition the rest.
August 22, 2007, at 03:19 AM by dumfrac -- Update notice about Debian Stable 4.0r1 to reference Martin\'s email on debian-arm
Changed lines 25-26 from:
  • [2007-08 17] Debian Stable 4.0r1 released. Unfortunately it seems to have broken netinstall on NSLU2. http://www.debian.org/News/2007/20070817
to:
  • [2007-08 17] Debian Stable 4.0r1 released (http://www.debian.org/News/2007/20070817). Unfortunately this release has broken the Debian Installer on the NSLU2. For a detailed explanation, please see http://lists.debian.org/debian-arm/2007/08/msg00073.html.
August 21, 2007, at 07:36 PM by blue -- debian r1 - broke netinstall
Changed lines 25-26 from:
to:
  • [2007-08 17] Debian Stable 4.0r1 released. Unfortunately it seems to have broken netinstall on NSLU2. http://www.debian.org/News/2007/20070817
August 21, 2007, at 02:17 PM by cyboreal -- Installer is broken - chokes installing kernel 2.6.18-4
Added lines 51-52:
  1. The current installer for NSLU2 available via http://www.slug-firmware.net/d-dls.php (debian-4.0r0.zip) seems to be hardwired to look for kernel version 2.6.18-4, but the kernels have since been upgraded to 2.6.18-5 and the installer cannot continue, causing the installation to abort. Maybe this is due to the mirrors now reflecting Debian 4.0r1 but the installer being built for 4.0r0?
August 19, 2007, at 09:37 PM by dumfrac -- Suppress WikiLink
Changed lines 162-163 from:

Section moved to the NSLU2 Troubleshooting page.

to:

Section moved to the Debian/NSLU2 Troubleshooting page.

August 19, 2007, at 08:50 PM by dumfrac -- Move troubleshooting section to new page
Changed lines 162-292 from:

Loss of Network Connectivity

Jim Buzbee reported here

Case in point is that I had been successfully running my new Debian Slug for a couple of days, booting and rebooting a number of times. At some point, I noticed that I couldn't reach the slug on the network. I don't remember exactly what I had done last, but to bring it back, I just unplugged and re-plugged the power. As it booted back up, everything looked normal. The LEDs flashed, the disk clicked and all seemed right with the world. But when the boot finished, the NSLU2 was again nowhere to be found on my network.

Update: This occurs when apt attempts to install the "hotplug" package.

And the Fix:

The only way I could see what was happening was to add debug statements to the boot, building my own boot log. This was a tedious process of adding statements, unplugging the drive from my MacBook, plugging it back into my NSLU2, rebooting the NSLU2, putting the disk back on my MacBook, examining the logs, etc. What I finally found is that everything was normal except that the interfaces file, which tells the Debian boot which network interfaces to bring up, was missing the one line that told it to automatically configure the internal Ethernet device. Once I added this line, I rebooted and was back to normal.

From my experience, this was the file was missing an auto eth0 line.

In windows arp -a reported the NSLU2 IP Address with a MAC Address of 00-00-00-00-00-00 and that it was Invalid. I was unable to ping it, and therefore no SSH

If you know what you are doing, you only need to add auto eth0 to /etc/network/interfaces, using vi, Nano, or what ever other text editor you are fimiliar with.

My Old/default Debian Etch RC1 /etc/network/interfaces

 # This file describes the network interfaces available on your system
 # and how to activate them. For more information, see interfaces(5).

 # The loopback network interface
 auto lo
 iface lo inet loopback

 # The primary network interface
 allow-hotplug eth0
 iface eth0 inet static
         address 192.168.0.70
         netmask 255.255.255.0
         network 192.168.0.0
         broadcast 192.168.0.255
         gateway 192.168.0.1
         # dns-* options are implemented by the resolvconf package, if installed
         dns-nameservers 212.159.13.49 212.159.13.50 212.159.6.9
         dns-search example.org

Fixed /etc/network/interfaces

 # This file describes the network interfaces available on your system
 # and how to activate them. For more information, see interfaces(5).

 # The loopback network interface
 auto lo
 iface lo inet loopback

 # The primary network interface
 #allow-hotplug eth0
 auto eth0
 iface eth0 inet static
         address 192.168.0.70
         netmask 255.255.255.0
         network 192.168.0.0
         broadcast 192.168.0.255
         gateway 192.168.0.1
         # dns-* options are implemented by the resolvconf package, if installed
         dns-nameservers 212.159.13.49 212.159.13.50 212.159.6.9
         dns-search example.org

I also commented #allow-hotplug eth0 out upon suggestion in NSLU2-General IRC Channel.

After changing this, on reboot, I was able to ping during boot, ARP -a was reporting correctly, and when start up was complete - I had SSH. I have reported this on the debian-arm mailing list, as my config was like the top one from installation.

The slug fails to reboot with 2 drives connected

If you connect a second drive after you have installed Debian, for example to store your data files, the order of the drives will be random after rebooting, i.e. the new drive could become /dev/sda with your root filesystem being /dev/sdb. If that happens the slug will fail to boot because it will be looking for its root filesystem on the wrong disk. To recover, boot with only the root drive connected and change your fstab to mount your root drive by UUID by following the procedure outlined below.

List the UUIDs of your drives with the tree (apt-get install tree) command

 $ tree /dev/disk
 /dev/disk
 |-- by-id
 |   |-- usb-ST340014_A_5000000000002886 -> ../../sda
 |   |-- usb-ST340014_A_5000000000002886-part1 -> ../../sda1
 |   |-- usb-ST340014_A_5000000000002886-part2 -> ../../sda2
 |   `-- usb-ST340014_A_5000000000002886-part5 -> ../../sda5
 |-- by-path
 |   |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0 -> ../../sda
 |   |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part1 -> ../../sda1
 |   |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part2 -> ../../sda2
 |   `-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part5 -> ../../sda5
 `-- by-uuid
    `-- 424ba820-8e80-422e-aaeb-b343b4a462f1 -> ../../sda1

and then modify your fstab by replacing /dev/sda1 (your root partition) with the UUID, e.g.

 # /etc/fstab: static file system information.
 #
 # <file system> <mount point>   <type>  <options>       <dump>  <pass>
 proc            /proc           proc    defaults        0       0
 UUID=424ba820-8e80-422e-aaeb-b343b4a462f1       /       ext3 defaults,errors=remount-ro 0       1
 /dev/sda5       none            swap    sw              0       0
 /dev/sda1       /media/usb0     auto    rw,user,noauto  0       0
 /dev/sda5       /media/usb1     auto    rw,user,noauto  0       0

Then update the initramfs:

 $ sudo update-initramfs -u

and flash the new initramfs

 $ sudo flash-kernel

You may want to make a copy of your existing flash before this last step in case something goes wrong.

The slug gets stuck during boot

The default configuration will cause the slug to fail to boot if errors are encountered during filesystem check on reboot. This can be the cause of a slug which works fine over a few reboots but then one day hangs during boot with no response to ping or ssh. This problem is described in the README. The simple fix is to set "FSCKFIX=yes" in /etc/default/rcS. Do this on thefirst boot, or connect the slug drive to another computer to make the change.

The README also suggests changes which cause networking and SSH to start earlier in the init procedure, both of which can help to diagnose problems like this.

Long startup time hwclock

If you experience whey long start up time (20 min) this may be be a indication that the hwclock cant be set. Try to set the hwclock in your command promt with

 $ sudo hwclock  --systohc

If this doesn’t work you could try to change the Nslu Bios battery.

to:

Section moved to the NSLU2 Troubleshooting page.

August 09, 2007, at 08:03 PM by marceln -- removed false wikilinks
Changed lines 51-52 from:
  1. The current installer for NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.
to:
  1. The current installer for NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.
August 08, 2007, at 02:22 PM by fcarolo --
Changed line 298 from:

Also available is Big Endian DebianSlug (known as OpenDebianSlug, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available linux versions and linux

to:

Also available is Big Endian DebianSlug (known as OpenDebianSlug, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available.

August 05, 2007, at 10:02 AM by celyade --
Changed line 298 from:

Also available is Big Endian DebianSlug (known as OpenDebianSlug, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available.

to:

Also available is Big Endian DebianSlug (known as OpenDebianSlug, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available linux versions and linux

July 25, 2007, at 05:56 AM by fabroce -- Link update
Changed lines 44-45 from:

French Version (DebianSlug): Debian GNU/Linux sur le NSLU2.

to:

French Version (DebianSlug): Debian GNU/Linux sur le NSLU2.

July 15, 2007, at 08:18 AM by Lars -- long start up time check hwclock
Changed lines 284-292 from:
to:

Long startup time hwclock

If you experience whey long start up time (20 min) this may be be a indication that the hwclock cant be set. Try to set the hwclock in your command promt with

 $ sudo hwclock  --systohc

If this doesn’t work you could try to change the Nslu Bios battery.

July 13, 2007, at 12:56 PM by oo -- added hauppauge wintv pvr usb2 link
Added lines 157-158:

To use a Hauppauge WinTV? PVR USB2?, see InstallWinTVPVRUSB2

June 17, 2007, at 06:22 AM by rwhitby --
Changed lines 42-43 from:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2. If your device (i.e. an IXP4xx? device other than the NSLU2) is not supported by the Debian Installer, then you can use the [[Debian/Bootstrap] procedure instead.

to:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2. If your device (i.e. an IXP4xx? device other than the NSLU2) is not supported by the Debian Installer, then you can use the Bootstrap procedure instead.

June 17, 2007, at 06:22 AM by rwhitby --
Changed lines 42-43 from:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2. If your device (i.e. an IXP4xx? device other than the NSLU2) is not supported by the Debian Installer, then you can use the Debian/Bootstrap procedure instead.

to:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2. If your device (i.e. an IXP4xx? device other than the NSLU2) is not supported by the Debian Installer, then you can use the [[Debian/Bootstrap] procedure instead.

June 17, 2007, at 06:21 AM by rwhitby --
Changed lines 42-43 from:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2.

to:

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2. If your device (i.e. an IXP4xx? device other than the NSLU2) is not supported by the Debian Installer, then you can use the Debian/Bootstrap procedure instead.

May 14, 2007, at 01:39 AM by Chris Salinardi -- Removing pointless info that I added last week
Deleted lines 52-53:

Note: This issue will happen every time if you manually create a swap partition with a partition type of primary. Making the swap partition a logical partition resolves this issue.

May 10, 2007, at 02:47 AM by Christopher Salinardi --
Added lines 53-54:

Note: This issue will happen every time if you manually create a swap partition with a partition type of primary. Making the swap partition a logical partition resolves this issue.

Deleted lines 56-57:

Note: This issue will happen every time if you manually create a swap partition with a partition type of primary. Making the swap partition a logical partition resolves this issue.

May 10, 2007, at 02:45 AM by Christopher Salinardi -- Note on partition creation and losing SSH session during installation.
Added lines 55-56:

Note: This issue will happen every time if you manually create a swap partition with a partition type of primary. Making the swap partition a logical partition resolves this issue.

May 08, 2007, at 01:00 AM by joederygmailcom -- loss of network connectivity caused by apt-get install hotplug
Added lines 165-166:

Update: This occurs when apt attempts to install the "hotplug" package.

May 02, 2007, at 03:49 AM by dumfrac -- Remove some more obsolete text.
Deleted lines 38-39:
  • The previous problem with more than one disk, that required mounting disks by label, is fixed in Etch Debian Installer RC2. If you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit. If you can't wait, see MountDisksByLabel for one solution.
May 02, 2007, at 03:44 AM by dumfrac -- Move text about apt-get segmentation fault to FAQ (obsolete).
Deleted lines 161-167:

Segmentation Fault on Upgrade

If apt-get quits with a 'Segmentation Fault', remove the APT cache files in /var/cache/apt.

 rm -rf /var/cache/apt/*.bin

Then rerun apt-get again. This problem was caused by a bug in the Debian kernel and has been fixed in the kernel source version 2.6.18.dfsg.1-9. See Debian bug #401980 for more information.

May 02, 2007, at 03:34 AM by dumfrac -- Remove some outdated text (move to FAQ for posterity)
Deleted lines 40-41:
  • The previous problem with the real time clock is also fixed in RC2. Please note that the NSLU2 will not keep time with the 2.6.17 kernel. The problem has been fixed in 2.6.18, which is the current linux kernel image for ixp4xx in testing, but was not in testing when the RC1 debian-installer was released. To permanently fix this problem, update your slug to a 2.6.18 ixp4xx kernel and restart. To temporarily fix the problem without restarting, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.
May 02, 2007, at 03:22 AM by dumfrac -- Axe information about loading the NPE-B microcode manually - it is done automatically
Changed lines 134-136 from:

Loading the NPE-B microcode

debian-etch-rc1-20061102 will not load the microcode for you. Instead you will have to do it yourself:

to:

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstrapped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.18. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

Changed lines 139-145 from:
 if [ ! -e  /dev/ixp4xx_ucode ]; then
  mknod /dev/ixp4xx_ucode c 10 184
 fi

 for f in ixp4xx_mac ixp4xx_qmgr ixp4xx_npe; do modprobe $f;done
 cat /lib/firmware/NPE-B > /dev/ixp4xx_ucode
 ifup eth0
to:
 deb http://ftp.XX.debian.org/debian testing main non-free contrib
Changed lines 142-146 from:

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstrapped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.18. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

to:

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.18:

Changed line 144 from:
 deb http://ftp.XX.debian.org/debian testing main non-free contrib
to:
 apt-get -t testing install linux-image-2.6-ixp4xx
Changed lines 147-152 from:

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.18:

 apt-get -t testing install linux-image-2.6-ixp4xx
to:
April 26, 2007, at 03:14 AM by dumfrac -- Fix link and suppress some auto wiki links
Changed lines 183-184 from:

Then rerun apt-get again. This problem was caused by a bug in the Debian kernel and has been fixed in the kernel source version 2.6.18.dfsg.1-9. See Debian bug [[http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=401980 | #401980] for more information.

to:

Then rerun apt-get again. This problem was caused by a bug in the Debian kernel and has been fixed in the kernel source version 2.6.18.dfsg.1-9. See Debian bug #401980 for more information.

Changed lines 253-254 from:

List the UUIDs? of your drives with the tree (apt-get install tree) command

to:

List the UUIDs of your drives with the tree (apt-get install tree) command

Changed lines 259-262 from:
 |   |-- usb-ST340014?_A_5000000000002886 -> ../../sda
 |   |-- usb-ST340014?_A_5000000000002886-part1 -> ../../sda1
 |   |-- usb-ST340014?_A_5000000000002886-part2 -> ../../sda2
 |   `-- usb-ST340014?_A_5000000000002886-part5 -> ../../sda5
to:
 |   |-- usb-ST340014_A_5000000000002886 -> ../../sda
 |   |-- usb-ST340014_A_5000000000002886-part1 -> ../../sda1
 |   |-- usb-ST340014_A_5000000000002886-part2 -> ../../sda2
 |   `-- usb-ST340014_A_5000000000002886-part5 -> ../../sda5
April 26, 2007, at 03:11 AM by dumfrac -- Fix formatting
Changed line 256 from:

$ tree /dev/disk

to:
 $ tree /dev/disk
April 26, 2007, at 03:09 AM by dumfrac -- Fix formatting
Changed lines 257-269 from:

/dev/disk |-- by-id | |-- usb-ST340014?_A_5000000000002886 -> ../../sda | |-- usb-ST340014?_A_5000000000002886-part1 -> ../../sda1 | |-- usb-ST340014?_A_5000000000002886-part2 -> ../../sda2 | `-- usb-ST340014?_A_5000000000002886-part5 -> ../../sda5 |-- by-path | |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0 -> ../../sda | |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part1 -> ../../sda1 | |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part2 -> ../../sda2 | `-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part5 -> ../../sda5 `-- by-uuid

   `-- 424ba820-8e80-422e-aaeb-b343b4a462f1 -> ../../sda1
to:
 /dev/disk
 |-- by-id
 |   |-- usb-ST340014?_A_5000000000002886 -> ../../sda
 |   |-- usb-ST340014?_A_5000000000002886-part1 -> ../../sda1
 |   |-- usb-ST340014?_A_5000000000002886-part2 -> ../../sda2
 |   `-- usb-ST340014?_A_5000000000002886-part5 -> ../../sda5
 |-- by-path
 |   |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0 -> ../../sda
 |   |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part1 -> ../../sda1
 |   |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part2 -> ../../sda2
 |   `-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part5 -> ../../sda5
 `-- by-uuid
    `-- 424ba820-8e80-422e-aaeb-b343b4a462f1 -> ../../sda1
Changed lines 275-283 from:
  1. /etc/fstab: static file system information.
  2. <file system> <mount point> <type> <options> <dump> <pass>

proc /proc proc defaults 0 0 UUID=424ba820-8e80-422e-aaeb-b343b4a462f1 / ext3 defaults,errors=remount-ro 0 1 /dev/sda5 none swap sw 0 0 /dev/sda1 /media/usb0 auto rw,user,noauto 0 0 /dev/sda5 /media/usb1 auto rw,user,noauto 0 0

to:
 # /etc/fstab: static file system information.
 #
 # <file system> <mount point>   <type>  <options>       <dump>  <pass>
 proc            /proc           proc    defaults        0       0
 UUID=424ba820-8e80-422e-aaeb-b343b4a462f1       /       ext3 defaults,errors=remount-ro 0       1
 /dev/sda5       none            swap    sw              0       0
 /dev/sda1       /media/usb0     auto    rw,user,noauto  0       0
 /dev/sda5       /media/usb1     auto    rw,user,noauto  0       0
Changed line 288 from:

$ sudo update-initramfs -u

to:
 $ sudo update-initramfs -u
Changed line 294 from:

$ sudo flash-kernel

to:
 $ sudo flash-kernel
April 26, 2007, at 03:08 AM by dumfrac -- Update section on mounting the root partition when two or more drive are connected to the NSLU2
Changed lines 251-254 from:

If you connect a second drive after you have installed Debian, for example to store your data files, the order of the drives will be random after rebooting, i.e. the new drive could become /dev/sda with your root filesystem being /dev/sdb. If that happens the slug will fail to boot because it will be looking for its root filesystem on the wrong disk. To recover, you'll have to boot with only the root drive connected and only after Debian is running connect the second drive and mount it (or auto-mount). Changing the physical ports that the drives are connected to won't help.

The fix is quite complex, and is described on this page: MountDisksByLabel. It will get simpler when APEX has an easier way of setting the kernel command line and a bug has been fixed in the Debian initramfs.

to:

If you connect a second drive after you have installed Debian, for example to store your data files, the order of the drives will be random after rebooting, i.e. the new drive could become /dev/sda with your root filesystem being /dev/sdb. If that happens the slug will fail to boot because it will be looking for its root filesystem on the wrong disk. To recover, boot with only the root drive connected and change your fstab to mount your root drive by UUID by following the procedure outlined below.

List the UUIDs? of your drives with the tree (apt-get install tree) command

$ tree /dev/disk /dev/disk |-- by-id | |-- usb-ST340014?_A_5000000000002886 -> ../../sda | |-- usb-ST340014?_A_5000000000002886-part1 -> ../../sda1 | |-- usb-ST340014?_A_5000000000002886-part2 -> ../../sda2 | `-- usb-ST340014?_A_5000000000002886-part5 -> ../../sda5 |-- by-path | |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0 -> ../../sda | |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part1 -> ../../sda1 | |-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part2 -> ../../sda2 | `-- pci-0000:00:01.2-usb-0:1:1.0-scsi-0:0:0:0-part5 -> ../../sda5 `-- by-uuid

   `-- 424ba820-8e80-422e-aaeb-b343b4a462f1 -> ../../sda1

and then modify your fstab by replacing /dev/sda1 (your root partition) with the UUID, e.g.

  1. /etc/fstab: static file system information.
  2. <file system> <mount point> <type> <options> <dump> <pass>

proc /proc proc defaults 0 0 UUID=424ba820-8e80-422e-aaeb-b343b4a462f1 / ext3 defaults,errors=remount-ro 0 1 /dev/sda5 none swap sw 0 0 /dev/sda1 /media/usb0 auto rw,user,noauto 0 0 /dev/sda5 /media/usb1 auto rw,user,noauto 0 0

Then update the initramfs:

$ sudo update-initramfs -u

and flash the new initramfs

$ sudo flash-kernel

You may want to make a copy of your existing flash before this last step in case something goes wrong.

April 21, 2007, at 01:03 AM by Zword -- Wiki syntax error
Changed lines 26-27 from:
  • [2007-04-08] NSLU2 Stable 4.0r0 released.
to:
  • [2007-04-08] Debian/NSLU2 Stable 4.0r0 released.
April 21, 2007, at 01:00 AM by Zword -- News about Debian/NSLU2 Stable 4.0r0 release added
Changed lines 26-27 from:
  • [2007.03.11] Etch Debian Installer Release Candidate 2 available.
to:
  • [2007-04-08] NSLU2 Stable 4.0r0 released.
  • [2007-03-12] Etch Debian Installer Release Candidate 2 available.
March 28, 2007, at 02:55 PM by emm_is --
Changed lines 55-56 from:
  1. RC2? has the same problem as above when tested on an 2GB flash drive. Best bet is to format the flash drive on another box and then mount it as per the link below:
to:
  1. RC2? has the same problem as above when tested on an 2GB flash drive. Best bet is to format the flash drive on another box and then mount it as per the link below: You can choose to manually partition the flash drive in the installer making the second partition a 128Mb swap and the first partition the rest.
March 28, 2007, at 03:47 AM by ptan -- Updated info on RC2 problems
Added lines 55-56:
  1. RC2? has the same problem as above when tested on an 2GB flash drive. Best bet is to format the flash drive on another box and then mount it as per the link below:
March 21, 2007, at 09:45 PM by Andy O'Neill -- Fixing link to use wiki syntax (preview didnt work here)
Changed lines 253-254 from:

The default configuration will cause the slug to fail to boot if errors are encountered during filesystem check on reboot. This can be the cause of a slug which works fine over a few reboots but then one day hangs during boot with no response to ping or ssh. This problem is described in the <a href="http://svn.debian.org/wsvn/pkg-nslu2-utils/trunk/debian/README.Debian?op=file">README</a>. The simple fix is to set "FSCKFIX=yes" in /etc/default/rcS. Do this on thefirst boot, or connect the slug drive to another computer to make the change.

to:

The default configuration will cause the slug to fail to boot if errors are encountered during filesystem check on reboot. This can be the cause of a slug which works fine over a few reboots but then one day hangs during boot with no response to ping or ssh. This problem is described in the README. The simple fix is to set "FSCKFIX=yes" in /etc/default/rcS. Do this on thefirst boot, or connect the slug drive to another computer to make the change.

March 21, 2007, at 09:42 PM by Andy O'Neill -- Added fix for FSCK hang at boot
Changed lines 251-257 from:
to:

The slug gets stuck during boot

The default configuration will cause the slug to fail to boot if errors are encountered during filesystem check on reboot. This can be the cause of a slug which works fine over a few reboots but then one day hangs during boot with no response to ping or ssh. This problem is described in the <a href="http://svn.debian.org/wsvn/pkg-nslu2-utils/trunk/debian/README.Debian?op=file">README</a>. The simple fix is to set "FSCKFIX=yes" in /etc/default/rcS. Do this on thefirst boot, or connect the slug drive to another computer to make the change.

The README also suggests changes which cause networking and SSH to start earlier in the init procedure, both of which can help to diagnose problems like this.

March 19, 2007, at 12:26 PM by vatachino -- Typo and capitalisation fixes
Changed line 147 from:

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.18. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

to:

If you have previously bootstrapped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.18. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

Changed lines 243-244 from:

After changing this, on reboot, i was able to ping during boot, ARP -a was reporting correctly, and when start up was complete - i had SSH. I have reported this on the debian-arm mailing list, as my config was like the top one from installation.

to:

After changing this, on reboot, I was able to ping during boot, ARP -a was reporting correctly, and when start up was complete - I had SSH. I have reported this on the debian-arm mailing list, as my config was like the top one from installation.

March 12, 2007, at 11:08 PM by fcarolo -- updated info about d-i rc2
Changed lines 39-40 from:
  • The previous problem with the real time click is also fixed in RC2. Please note that the NSLU2 will not keep time with the 2.6.17 kernel. The problem has been fixed in 2.6.18, which is the current linux kernel image for ixp4xx in testing, but was not in testing when the RC1 debian-installer was released. To permanently fix this problem, update your slug to a 2.6.18 ixp4xx kernel and restart. To temporarily fix the problem without restarting, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.
to:
  • The previous problem with the real time clock is also fixed in RC2. Please note that the NSLU2 will not keep time with the 2.6.17 kernel. The problem has been fixed in 2.6.18, which is the current linux kernel image for ixp4xx in testing, but was not in testing when the RC1 debian-installer was released. To permanently fix this problem, update your slug to a 2.6.18 ixp4xx kernel and restart. To temporarily fix the problem without restarting, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.
March 12, 2007, at 11:08 PM by fcarolo -- updated info about d-i rc2
Changed lines 37-40 from:
  • The previous problem with more than one disk, that required mounting disks by label, is fixed in Etch Debian Installer RC2?. If you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit. If you can't wait, see MountDisksByLabel for one solution.
  • The previous problem with the real time click is also fixed in RC2?. Please note that the NSLU2 will not keep time with the 2.6.17 kernel. The problem has been fixed in 2.6.18, which is the current linux kernel image for ixp4xx in testing, but was not in testing when the RC1 debian-installer was released. To permanently fix this problem, update your slug to a 2.6.18 ixp4xx kernel and restart. To temporarily fix the problem without restarting, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.
to:
  • The previous problem with more than one disk, that required mounting disks by label, is fixed in Etch Debian Installer RC2. If you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit. If you can't wait, see MountDisksByLabel for one solution.
  • The previous problem with the real time click is also fixed in RC2. Please note that the NSLU2 will not keep time with the 2.6.17 kernel. The problem has been fixed in 2.6.18, which is the current linux kernel image for ixp4xx in testing, but was not in testing when the RC1 debian-installer was released. To permanently fix this problem, update your slug to a 2.6.18 ixp4xx kernel and restart. To temporarily fix the problem without restarting, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.
March 12, 2007, at 11:07 PM by fcarolo -- updated info about d-i rc2
Changed lines 35-38 from:
  • See http://www.us.debian.org/devel/debian-installer/errata for current known issues (not NSLU2-specific). In particular, note the first point: if you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit. If you can't wait, see MountDisksByLabel for one solution.
  • Please note that the NSLU2 will not keep time with the 2.6.17 kernel. The problem has been fixed in 2.6.18, which is the current linux kernel image for ixp4xx in testing, but was not in testing when the RC1 debian-installer was released. To permanently fix this problem, update your slug to a 2.6.18 ixp4xx kernel and restart. To temporarily fix the problem without restarting, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.
to:
  • See http://www.us.debian.org/devel/debian-installer/errata for current known issues (not NSLU2-specific).
  • The previous problem with more than one disk, that required mounting disks by label, is fixed in Etch Debian Installer RC2?. If you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit. If you can't wait, see MountDisksByLabel for one solution.
  • The previous problem with the real time click is also fixed in RC2?. Please note that the NSLU2 will not keep time with the 2.6.17 kernel. The problem has been fixed in 2.6.18, which is the current linux kernel image for ixp4xx in testing, but was not in testing when the RC1 debian-installer was released. To permanently fix this problem, update your slug to a 2.6.18 ixp4xx kernel and restart. To temporarily fix the problem without restarting, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.
March 12, 2007, at 03:58 AM by dumfrac -- Add news link and change the \"Known Problems\" text section to a list
Added line 4:
Changed lines 35-38 from:

See http://www.us.debian.org/devel/debian-installer/errata for current known issues (not NSLU2-specific). In particular, note the first point: if you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit. If you can't wait, see MountDisksByLabel for one solution.

Please note that the NSLU2 will not keep time with the 2.6.17 kernel. The problem has been fixed in 2.6.18, which is the current linux kernel image for ixp4xx in testing, but was not in testing when the RC1 debian-installer was released. To permanently fix this problem, update your slug to a 2.6.18 ixp4xx kernel and restart. To temporarily fix the problem without restarting, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.

to:
  • See http://www.us.debian.org/devel/debian-installer/errata for current known issues (not NSLU2-specific). In particular, note the first point: if you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit. If you can't wait, see MountDisksByLabel for one solution.
  • Please note that the NSLU2 will not keep time with the 2.6.17 kernel. The problem has been fixed in 2.6.18, which is the current linux kernel image for ixp4xx in testing, but was not in testing when the RC1 debian-installer was released. To permanently fix this problem, update your slug to a 2.6.18 ixp4xx kernel and restart. To temporarily fix the problem without restarting, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.
March 12, 2007, at 03:56 AM by dumfrac -- Remove some outdated text from the \"State of the Project\" text, and add a news section with the news of the release of the etch RC2 installer
Added lines 22-26:

News

  • [2007.03.11] Etch Debian Installer Release Candidate 2 available.
Changed lines 30-31 from:

Debian fully supports the NSLU2 using the debian-installer (this is the setup known as Debian/NSLU2). This was first supported with the beta2 installer for etch but support got broken with beta3 because of an incompatibility between the proprietary Ethernet module and the Debian kernel. This has been fixed as of debian-installer rc1 which supports the NSLU2 again. Please visit http://www.cyrius.com/debian/nslu2/. This is the current recommended way to install Debian on a slug.

to:

Debian fully supports the NSLU2 using the Debian Installer (this is the setup known as Debian/NSLU2). Please visit http://www.cyrius.com/debian/nslu2/ for the recommended way to install Debian on a NSLU2.

March 12, 2007, at 03:41 AM by dumfrac -- Removed comment about RC1 being broken - RC2 is out !
Changed lines 45-48 from:

1. http://www.slug-firmware.net reports that "Debian Installer RC1? is currently broken". I downloaded the nightly build (6. march 07) from debain and added the network driver (BuildImage). It installed and runned ok!

2. The current installer for NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.

to:
  1. The current installer for NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.
Changed lines 94-95 from:

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.

to:

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the Wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.

March 10, 2007, at 04:13 PM by Stein --
Changed lines 45-46 from:

1. [http://www.slug-firmware.net/] reports that "Debian Installer RC1? is currently broken". I downloaded the nightly build (6. march 07) from debain and added the network driver ([http://www.nslu2-linux.org/wiki/Debian/BuildImage]). It installed and runned ok!

to:

1. http://www.slug-firmware.net reports that "Debian Installer RC1? is currently broken". I downloaded the nightly build (6. march 07) from debain and added the network driver (BuildImage). It installed and runned ok!

March 10, 2007, at 04:09 PM by Stein -- Debian Installer seems OK
Changed lines 45-46 from:

1. The current installer for NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.

to:

1. [http://www.slug-firmware.net/] reports that "Debian Installer RC1? is currently broken". I downloaded the nightly build (6. march 07) from debain and added the network driver ([http://www.nslu2-linux.org/wiki/Debian/BuildImage]). It installed and runned ok!

2. The current installer for NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.

February 28, 2007, at 03:39 AM by dumfrac -- Clean up text
Changed line 167 from:

If after performing an apt-get update, then apt-get upgrade, your slug reports a 'Segmentation Fault' - Suggesting to try apt-get -f install, and this doesn't work, try

to:

If apt-get quits with a 'Segmentation Fault', remove the APT cache files in /var/cache/apt.

Changed lines 171-174 from:

This problem has been fixed in kernel version 2.6.18-4-ixp4xx (source version 2.6.18.dfsg.1-9). See Debian bug [[http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=401980 | #401980].

This will remove the APT cache files, as they are possibly corrupt. Then try apt-get update and then apt-get upgrade again

to:

Then rerun apt-get again. This problem was caused by a bug in the Debian kernel and has been fixed in the kernel source version 2.6.18.dfsg.1-9. See Debian bug [[http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=401980 | #401980] for more information.

February 28, 2007, at 03:30 AM by dumfrac -- Remove installation errata note describing Debian bug #406630
Deleted lines 50-53:

2. There is a tasksel bug in the debian-etch-rc1-20061102.zip installer reported here: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=406630 The "Desktop Task" is not displayed and you cannot deselect it. This leads to the installation of all desktop packages which takes many many hours on the NSLU2. -- This bug is fixed with tasksel 2.6.3 which is now in etch. Meaning this bug should no longer exist.

February 28, 2007, at 03:23 AM by dumfrac -- Add note the new kernel fixes Debian bug #401980 (apt-get segmentation faults)
Changed line 171 from:

If after preforming an apt-get update, then apt-get upgrade, your slug reports a 'Segmentation Fault' - Suggesting to try apt-get -f install, and this doesn't work, try

to:

If after performing an apt-get update, then apt-get upgrade, your slug reports a 'Segmentation Fault' - Suggesting to try apt-get -f install, and this doesn't work, try

Changed lines 175-176 from:
to:

This problem has been fixed in kernel version 2.6.18-4-ixp4xx (source version 2.6.18.dfsg.1-9). See Debian bug [[http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=401980 | #401980].

February 16, 2007, at 11:54 AM by fcarolo -- formatting
Changed lines 29-30 from:

See http://www.us.debian.org/devel/debian-installer/errata for current known issues (not NSLU2-specific). In particular, note the first point: if you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit. If you can't wait, see MountDisksByLabel for one solution.

to:

See http://www.us.debian.org/devel/debian-installer/errata for current known issues (not NSLU2-specific). In particular, note the first point: if you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit. If you can't wait, see MountDisksByLabel for one solution.

Changed lines 39-40 from:

German Version (DebianSlug & DebianInstaller?): Debian auf NSLU2 installieren.

to:

German Version (DebianSlug & DebianInstaller): Debian auf NSLU2 installieren.

Changed line 254 from:

Also available is Big Endian DebianSlug (known as OpenDebianSlug, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug? makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available.

to:

Also available is Big Endian DebianSlug (known as OpenDebianSlug, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available.

February 16, 2007, at 03:07 AM by age -- link to German howto
Changed lines 39-40 from:
to:

German Version (DebianSlug & DebianInstaller?): Debian auf NSLU2 installieren.

February 13, 2007, at 08:10 AM by fabroce -- adding a french Installation Instructions link
Added lines 38-39:

French Version (DebianSlug): Debian GNU/Linux sur le NSLU2.

February 01, 2007, at 01:44 PM by lesterc -- format touchup
Changed lines 126-132 from:

if [ ! -e /dev/ixp4xx_ucode ]; then

 mknod /dev/ixp4xx_ucode c 10 184

fi

for f in ixp4xx_mac ixp4xx_qmgr ixp4xx_npe; do modprobe $f;done cat /lib/firmware/NPE-B > /dev/ixp4xx_ucode ifup eth0

to:
 if [ ! -e  /dev/ixp4xx_ucode ]; then
  mknod /dev/ixp4xx_ucode c 10 184
 fi

 for f in ixp4xx_mac ixp4xx_qmgr ixp4xx_npe; do modprobe $f;done
 cat /lib/firmware/NPE-B > /dev/ixp4xx_ucode
 ifup eth0
February 01, 2007, at 01:41 PM by lesterc -- info on how to load the NPE microcode
Changed lines 122-124 from:

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.18. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

to:

Loading the NPE-B microcode

debian-etch-rc1-20061102 will not load the microcode for you. Instead you will have to do it yourself:

Changed lines 126-132 from:
 deb http://ftp.XX.debian.org/debian testing main non-free contrib
to:

if [ ! -e /dev/ixp4xx_ucode ]; then

 mknod /dev/ixp4xx_ucode c 10 184

fi

for f in ixp4xx_mac ixp4xx_qmgr ixp4xx_npe; do modprobe $f;done cat /lib/firmware/NPE-B > /dev/ixp4xx_ucode ifup eth0

Changed lines 135-139 from:

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.18:

to:

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.18. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

Changed line 141 from:
 apt-get -t testing install linux-image-2.6-ixp4xx
to:
 deb http://ftp.XX.debian.org/debian testing main non-free contrib
Changed lines 144-149 from:
to:

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.18:

 apt-get -t testing install linux-image-2.6-ixp4xx
January 15, 2007, at 02:15 PM by condor2k -- tasksel bug edited.
Changed lines 49-50 from:
to:

-- This bug is fixed with tasksel 2.6.3 which is now in etch. Meaning this bug should no longer exist.

January 13, 2007, at 08:28 AM by Anguel Stankov -- Tasksel bug in installer
Changed lines 41-42 from:

The current installer for NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.

to:

1. The current installer for NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.

Added lines 45-49:

Another option is to create and format the ext3 partition on a normal PC as described in the FAQ.

2. There is a tasksel bug in the debian-etch-rc1-20061102.zip installer reported here: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=406630 The "Desktop Task" is not displayed and you cannot deselect it. This leads to the installation of all desktop packages which takes many many hours on the NSLU2.

January 13, 2007, at 04:17 AM by dumfrac -- Kill some automatic wiki links - hates the automatic wiki links :-)
Changed line 168 from:

My Old/default Debian Etch RC1? /etc/network/interfaces

to:

My Old/default Debian Etch RC1 /etc/network/interfaces

Changed line 229 from:

Also available is Big Endian DebianSlug (known as OpenDebianSlug?, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug? makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available.

to:

Also available is Big Endian DebianSlug (known as OpenDebianSlug, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug? makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available.

January 12, 2007, at 11:54 PM by Phil Endecott -- Remove inaccurate drive labelling instructions
Changed lines 223-262 from:

(The following instructions were added to this page by someone, but they won't work: adding LABEL= to /etc/fstab is not sufficient as the root filesystem is mounted before /etc/fstab is read. Please see MountDisksByLabel for instructions that will work. I propose to remove these instructions.)

{-The fix is to properly label the filesystems and swap on the drives so that debian can boot correctly even if the drives names have changed.

So you have to enter :

 NSLU2:~# tune2fs -L root /dev/sda1 
 NSLU2:~# tune2fs -L home /dev/sda9 
 ...
 NSLU2:~# tune2fs -L data /dev/sdc1

and so on for all your filesystems and then :

 NSLU2:~# swapoff -a
 NSLU2:~# mkswap /dev/sda7 -L swap1
 NSLU2:~# swapon LABEL=swap1

and modify your /etc/fstab so the system mount the filesystems with the labels your entered :

 # /etc/fstab: static file system information.
 #
 # <file system> <mount point>   <type>  <options>       <dump>  <pass>
 proc            /proc           proc    defaults        0       0
 LABEL=root       /               ext3    defaults,errors=remount-ro 0       1
 LABEL=home       /home           ext3    defaults        0       2
 LABEL=tmp       /tmp            ext3    defaults        0       2
 LABEL=usr       /usr            ext3    defaults        0       2
 LABEL=var       /var            ext3    defaults        0       2
 LABEL=swap1       none            swap    sw              0       0
 # Disk externe
 LABEL=data      /mnt/nas        ext3    defaults        0       0

Then you can connect any number of drives using one usb hub in any order and get your system boot properly.-}

to:
January 12, 2007, at 02:22 PM by Dean Jackson -- Debian installer keeps disconnecting, link to a fix.
Added line 6:
Added lines 38-44:

Installation errata

The current installer for NSLU2 available via http://www.slug-firmware.net (debian-etch-rc1-20061102.zip) seems to repeatedly close SSH during installation, causing the install to restart. This is a symptom of the NSLU2 running out of available memory.

Check DebianInstallerDisconnectsSSH.

January 12, 2007, at 02:36 AM by dumfrac -- Add a link to the Debian/NSLU2 FAQ.
Added lines 124-125:

The Debian/NSLU2 FAQ.

January 09, 2007, at 12:01 PM by Phil Endecott -- Refer to MountDisksByLabel, mark disk labelling description on this page pending-delete
Changed lines 207-212 from:

The slug dont reboot with 2 drives connected

If you plug to the slug one other drive after you have installed debian, for example to put your data files, that new drive could as well become /dev/sda or stay /dev/sdb upon reboot or even become /dev/sdc. If that happen the slug wont reboot with the two drives connected and you have to boot with system drive and only after debian is running connect the second drive and mount it ( or auto-mount ). Changing the ports of the drives wont help ! The fix is to properly label the filesystems and swap on the drives so that debian can boot correctly even if the drives names have changed.

to:

The slug fails to reboot with 2 drives connected

If you connect a second drive after you have installed Debian, for example to store your data files, the order of the drives will be random after rebooting, i.e. the new drive could become /dev/sda with your root filesystem being /dev/sdb. If that happens the slug will fail to boot because it will be looking for its root filesystem on the wrong disk. To recover, you'll have to boot with only the root drive connected and only after Debian is running connect the second drive and mount it (or auto-mount). Changing the physical ports that the drives are connected to won't help.

The fix is quite complex, and is described on this page: MountDisksByLabel. It will get simpler when APEX has an easier way of setting the kernel command line and a bug has been fixed in the Debian initramfs.

(The following instructions were added to this page by someone, but they won't work: adding LABEL= to /etc/fstab is not sufficient as the root filesystem is mounted before /etc/fstab is read. Please see MountDisksByLabel for instructions that will work. I propose to remove these instructions.)

{-The fix is to properly label the filesystems and swap on the drives so that debian can boot correctly even if the drives names have changed.

Changed lines 251-252 from:

Then you can connect any number of drives using one usb hub in any order and get your system boot properly.

to:

Then you can connect any number of drives using one usb hub in any order and get your system boot properly.-}

January 09, 2007, at 09:17 AM by mururoa --
Changed lines 209-212 from:

If you plug to the slug one other drive after you installed debian, for example to put your data files, that new drive could as well become /dev/sda or stay /dev/sdb upon reboot or even become sdc. If that happen the slug wont reboot with the two drives connected and you have to boot with system drive and only after debian is running connect the second drive and mount it ( or auto-mount ). Changing the port of the drives wont help ! The fix is to properly label the filesystems and swap on the drives so that debian can boot correctly with the drives names changed.

to:

If you plug to the slug one other drive after you have installed debian, for example to put your data files, that new drive could as well become /dev/sda or stay /dev/sdb upon reboot or even become /dev/sdc. If that happen the slug wont reboot with the two drives connected and you have to boot with system drive and only after debian is running connect the second drive and mount it ( or auto-mount ). Changing the ports of the drives wont help ! The fix is to properly label the filesystems and swap on the drives so that debian can boot correctly even if the drives names have changed.

January 09, 2007, at 09:14 AM by mururoa --
Changed line 224 from:
 >>bgcolor=#eeffee<<
to:
Changed lines 228-229 from:
 >><<
to:
Changed line 232 from:
 >>bgcolor=#eeffee<<
to:
Changed lines 245-246 from:
 >><<
to:
January 09, 2007, at 09:13 AM by mururoa --
Changed lines 216-219 from:

NSLU2:~# tune2fs -L root /dev/sda1 NSLU2:~# tune2fs -L home /dev/sda9 ... NSLU2:~# tune2fs -L data /dev/sdc1

to:
 NSLU2:~# tune2fs -L root /dev/sda1 
 NSLU2:~# tune2fs -L home /dev/sda9 
 ...
 NSLU2:~# tune2fs -L data /dev/sdc1
Changed lines 224-229 from:

NSLU2:~# swapoff -a NSLU2:~# mkswap /dev/sda7 -L swap1 NSLU2:~# swapon LABEL=swap1

to:
 >>bgcolor=#eeffee<<
 NSLU2:~# swapoff -a
 NSLU2:~# mkswap /dev/sda7 -L swap1
 NSLU2:~# swapon LABEL=swap1
 >><<
Changed lines 232-246 from:
  1. /etc/fstab: static file system information.
  2. <file system> <mount point> <type> <options> <dump> <pass>

proc /proc proc defaults 0 0 LABEL=root / ext3 defaults,errors=remount-ro 0 1 LABEL=home /home ext3 defaults 0 2 LABEL=tmp /tmp ext3 defaults 0 2 LABEL=usr /usr ext3 defaults 0 2 LABEL=var /var ext3 defaults 0 2 LABEL=swap1 none swap sw 0 0

  1. Disk externe

LABEL=data /mnt/nas ext3 defaults 0 0

to:
 >>bgcolor=#eeffee<<
 # /etc/fstab: static file system information.
 #
 # <file system> <mount point>   <type>  <options>       <dump>  <pass>
 proc            /proc           proc    defaults        0       0
 LABEL=root       /               ext3    defaults,errors=remount-ro 0       1
 LABEL=home       /home           ext3    defaults        0       2
 LABEL=tmp       /tmp            ext3    defaults        0       2
 LABEL=usr       /usr            ext3    defaults        0       2
 LABEL=var       /var            ext3    defaults        0       2
 LABEL=swap1       none            swap    sw              0       0
 # Disk externe
 LABEL=data      /mnt/nas        ext3    defaults        0       0
 >><<
January 09, 2007, at 09:11 AM by mururoa --
Added line 215:
Changed lines 220-221 from:
to:
Added line 224:
Changed lines 228-229 from:
to:
Added line 232:
Changed lines 245-246 from:
to:
January 09, 2007, at 09:09 AM by mururoa -- Nslu2 with 2 or more drives
Added lines 207-242:

The slug dont reboot with 2 drives connected

If you plug to the slug one other drive after you installed debian, for example to put your data files, that new drive could as well become /dev/sda or stay /dev/sdb upon reboot or even become sdc. If that happen the slug wont reboot with the two drives connected and you have to boot with system drive and only after debian is running connect the second drive and mount it ( or auto-mount ). Changing the port of the drives wont help ! The fix is to properly label the filesystems and swap on the drives so that debian can boot correctly with the drives names changed.

So you have to enter :

NSLU2:~# tune2fs -L root /dev/sda1 NSLU2:~# tune2fs -L home /dev/sda9 ... NSLU2:~# tune2fs -L data /dev/sdc1

and so on for all your filesystems and then :

NSLU2:~# swapoff -a NSLU2:~# mkswap /dev/sda7 -L swap1 NSLU2:~# swapon LABEL=swap1

and modify your /etc/fstab so the system mount the filesystems with the labels your entered :

  1. /etc/fstab: static file system information.
  2. <file system> <mount point> <type> <options> <dump> <pass>

proc /proc proc defaults 0 0 LABEL=root / ext3 defaults,errors=remount-ro 0 1 LABEL=home /home ext3 defaults 0 2 LABEL=tmp /tmp ext3 defaults 0 2 LABEL=usr /usr ext3 defaults 0 2 LABEL=var /var ext3 defaults 0 2 LABEL=swap1 none swap sw 0 0

  1. Disk externe

LABEL=data /mnt/nas ext3 defaults 0 0

Then you can connect any number of drives using one usb hub in any order and get your system boot properly.

January 08, 2007, at 08:33 PM by fcarolo -- fixed upgrade instructions about 2.6.18
Changed line 110 from:

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

to:

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.18. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

Changed line 115 from:

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.17:

to:

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.18:

Changed line 117 from:
 apt-get -t testing install linux-image-2.6-ixp4xx linux-image-2.6.17-2-ixp4xx
to:
 apt-get -t testing install linux-image-2.6-ixp4xx
January 03, 2007, at 02:58 PM by hs -- Formatting
Changed lines 103-105 from:

[s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/ [ssh user@hostname] cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B

to:
 [s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/
 [ssh user@hostname]
 cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B
Changed line 112 from:
 deb http://ftp.XX.debian.org/debian testing main non-free contrib
to:
 deb http://ftp.XX.debian.org/debian testing main non-free contrib
Changed lines 146-147 from:

Case in point is that I had been successfully running my new Debian Slug for a couple of days, booting and rebooting a number of times. At some point, I noticed that I couldn't reach the slug on the network. I don't remember exactly what I had done last, but to bring it back, I just unplugged and re-plugged the power. As it booted back up, everything looked normal. The LEDs? flashed, the disk clicked and all seemed right with the world. But when the boot finished, the NSLU2 was again nowhere to be found on my network.

to:

Case in point is that I had been successfully running my new Debian Slug for a couple of days, booting and rebooting a number of times. At some point, I noticed that I couldn't reach the slug on the network. I don't remember exactly what I had done last, but to bring it back, I just unplugged and re-plugged the power. As it booted back up, everything looked normal. The LEDs flashed, the disk clicked and all seemed right with the world. But when the boot finished, the NSLU2 was again nowhere to be found on my network.

Changed lines 149-150 from:

The only way I could see what was happening was to add debug statements to the boot, building my own boot log. This was a tedious process of adding statements, unplugging the drive from my MacBook?, plugging it back into my NSLU2, rebooting the NSLU2, putting the disk back on my MacBook?, examining the logs, etc. What I finally found is that everything was normal except that the interfaces file, which tells the Debian boot which network interfaces to bring up, was missing the one line that told it to automatically configure the internal Ethernet device. Once I added this line, I rebooted and was back to normal.

to:

The only way I could see what was happening was to add debug statements to the boot, building my own boot log. This was a tedious process of adding statements, unplugging the drive from my MacBook, plugging it back into my NSLU2, rebooting the NSLU2, putting the disk back on my MacBook, examining the logs, etc. What I finally found is that everything was normal except that the interfaces file, which tells the Debian boot which network interfaces to bring up, was missing the one line that told it to automatically configure the internal Ethernet device. Once I added this line, I rebooted and was back to normal.

January 03, 2007, at 02:27 PM by hs -- Reorder of sections, reformatting without tables, THE PREVIEW IS BROKEN
Added line 8:
Added lines 26-27:

Known Problems

Changed lines 32-48 from:

Useful Information

Segmentation Fault

If after preforming an apt-get update, then apt-get upgrade, your slug reports a 'Segmentation Fault' - Suggesting to try apt-get -f install , and this doesnt work

Try typing (:table border=0 width=80% :) (:cell:)

rm -rf /var/cache/apt/*.bin

(:tableend:)

This will remove the APT cache files, as they are possibly corrupt.

Try apt-get update and then apt-get upgrade again

to:

Installation instructions

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2.

Upgrade from previous versions

Upgrade from debian-installer beta2

If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.

Upgrade from manual bootstrap to testing ("etch")

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

 do_symlinks = yes
 relative_links = yes
 do_bootloader = no
 do_bootfloppy = no
 do_initrd = yes
 link_in_boot = yes

Ethernet driver issue: If your /etc/network/interfaces looks like this, it may happen, that eth0 isn't brought up.

 auto eth0
 iface eth0 inet static
         pre-up modprobe -f ixp400
         pre-up modprobe -f ixp400_eth
         address 10.0.0.201
         netmask 255.255.255.0
         gateway 10.0.0.138

If this is the case try this:

 allow-hotplug eth0
 iface eth0 inet static
         address 10.0.0.201
         netmask 255.255.255.0
         gateway 10.0.0.138

After that, follow the guide to Upgrading Debian on the Linksys NSLU2. When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.

Obtaining the NPE-B microcode

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage (you need a recent version of slugimage that includes second-stage bootloader support (the -L switch).

 apt-get install slugimage
 slugimage -u -i di-nslu2.bin

Endian swap the initramfs (ramdisk.gz).

 apt-get install devio
 devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz

Unpack the initramfs into a directory e.g. initrd.

 mkdir initrd; cd initrd
 zcat ../ramdisk-swap.gz | cpio -i

The NPE microcode firmware will be in the initrd directory. It is called NPE-B.01000201. Copy this file to /lib/firmware on the slug, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201.

[s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/ [ssh user@hostname] cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

 deb http://ftp.XX.debian.org/debian testing main non-free contrib

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.17:

 apt-get -t testing install linux-image-2.6-ixp4xx linux-image-2.6.17-2-ixp4xx

Links to more Debian/NSLU2 documentation

To learn how to build a Debian/NSLU2 image, see BuildImage.

See ChangeKernelCommandLine for how to change the command line passed to the kernel by the second-stage bootloader, APEX, in a Debian/NSLU2 system.

If you want to free up some space in your internal flash, see NoInitramfs.

To use the Debian Installer with a FatSlug, follow the instructions here.

Troubleshooting

Segmentation Fault on Upgrade

If after preforming an apt-get update, then apt-get upgrade, your slug reports a 'Segmentation Fault' - Suggesting to try apt-get -f install, and this doesn't work, try

 rm -rf /var/cache/apt/*.bin

This will remove the APT cache files, as they are possibly corrupt. Then try apt-get update and then apt-get upgrade again

Changed lines 144-152 from:

Jim Buzbee Reported here

(:table border=0 width=80% bgcolor=#ffeeee:) (:cell:) Case in point is that I had been successfully running my new Debian Slug for a couple of days, booting and rebooting a number of times. At some point, I noticed that I couldn't reach the slug on the network. I don't remember exactly what I had done last, but to bring it back, I just unplugged and re-plugged the power. As it booted back up, everything looked normal. The LEDs? flashed, the disk clicked and all seemed right with the world. But when the boot finished, the NSLU2 was again nowhere to be found on my network. (:tableend:)

to:

Jim Buzbee reported here

Case in point is that I had been successfully running my new Debian Slug for a couple of days, booting and rebooting a number of times. At some point, I noticed that I couldn't reach the slug on the network. I don't remember exactly what I had done last, but to bring it back, I just unplugged and re-plugged the power. As it booted back up, everything looked normal. The LEDs? flashed, the disk clicked and all seemed right with the world. But when the boot finished, the NSLU2 was again nowhere to be found on my network.

Changed lines 149-158 from:

(:table border=0 width=80% bgcolor=#eeffee:) (:cell:) The only way I could see what was happening was to add debug statements to the boot, building my own boot log. This was a tedious process of adding statements, unplugging the drive from my MacBook?, plugging it back into my NSLU2, rebooting the NSLU2, putting the disk back on my MacBook?, examining the logs, etc. What I finally found is that everything was normal except that the "interfaces" file, which tells the Debian boot which network interfaces to bring up, was missing the one line that told it to automatically configure the internal Ethernet device. Once I added this line, I rebooted and was back to normal. (:tableend:)

From my experience, this was the file was missing an auto eth0 line.

to:

The only way I could see what was happening was to add debug statements to the boot, building my own boot log. This was a tedious process of adding statements, unplugging the drive from my MacBook?, plugging it back into my NSLU2, rebooting the NSLU2, putting the disk back on my MacBook?, examining the logs, etc. What I finally found is that everything was normal except that the interfaces file, which tells the Debian boot which network interfaces to bring up, was missing the one line that told it to automatically configure the internal Ethernet device. Once I added this line, I rebooted and was back to normal.

From my experience, this was the file was missing an auto eth0 line.

Changed lines 155-379 from:

If you know what you are doing, you only need to add auto eth0 to /etc/network/interfaces, using vi, Nano, or what ever other text editor you are fimiliar with.

My Old/default Debian Etch RC1? /etc/network/interfaces (:table border=0 width=80% bgcolor=#ffeeee:) (:cell:)

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
allow-hotplug eth0
iface eth0 inet static
        address 192.168.0.70
        netmask 255.255.255.0
        network 192.168.0.0
        broadcast 192.168.0.255
        gateway 192.168.0.1
        # dns-* options are implemented by the resolvconf package, if installed
        dns-nameservers 212.159.13.49 212.159.13.50 212.159.6.9
        dns-search example.org

(:tableend:)

Fixed /etc/network/interfaces (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
#allow-hotplug eth0
auto eth0
iface eth0 inet static
        address 192.168.0.70
        netmask 255.255.255.0
        network 192.168.0.0
        broadcast 192.168.0.255
        gateway 192.168.0.1
        # dns-* options are implemented by the resolvconf package, if installed
        dns-nameservers 212.159.13.49 212.159.13.50 212.159.6.9
        dns-search example.org

(:tableend:)

I also commented #allow-hotplug eth0 out the upon suggestion in NSLU2-General IRC Channel

After changing this, on reboot, i was able to ping during boot, ARP -a was reporting correctly, and when start up was complete - i had SSH

I have reported this on the debian-arm mailing list, as my config was like the top one from installation

I fixed the file by mounting the drive on my Unslung NSLU2, and then using nano to edit the files.

Method for Editing file on another PC or NSLU2 My other NSLU2 was already unslung to a USB, so that device took SDA, and the usb drive from the debian slug was mounted at sdb

Verified by: fdisk -l /dev/sdb

Which showed 2 partitions, one being swap, and it was around the 7GB mark of my drive

Next Enter mount -o rw /dev/sdb1 /mnt

To mount the drive to /mnt.

If you do not currently have a text editor installed, i am going to use nano (to install on unslung ipkg install nano)

You may need to type export TERM='linux'

Next nano -w /mnt/etc/network/interfaces

You may have to use /opt/bin/nano -w /mnt/etc/network/interfaces

This will open the interfaces file for you to write to

Using your client, browse to relevant point, add a new line, and put auto eth0

Press Ctrl + o, then press enter, and then ctrl + x to take you back to the prompt.

You can then unmount the drive using umount /mnt

If you get an error saying drive is in use, type cd / and then try the unmount command again

(Most of that method should work fine

Installation instructions

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2.

Upgrade from previous versions

Upgrade from debian-installer beta2

If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.

Upgrade from manual bootstrap to testing ("etch")

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

(:table border=0 width=80% bgcolor=#ffeeee:) (:cell:)

do_symlinks = yes
relative_links = yes
do_bootloader = no
do_bootfloppy = no
do_initrd = yes
link_in_boot = yes

(:tableend:)

Ethernet driver issue: If you followed the same guide/help I did, you may have a static ip address as folows in /etc/interfaces. (The following does not work; eth0 will not be brought up).

(:table border=0 width=80% bgcolor=#ffeeee:) (:cell:)

auto eth0
iface eth0 inet static
        pre-up modprobe -f ixp400
        pre-up modprobe -f ixp400_eth
        address 10.0.0.201
        netmask 255.255.255.0
        gateway 10.0.0.138

(:tableend:)

This didn't work, the slug's eth0 was not brought up. So I spent 2.5 hours running the debian installer on a 2Gb memory stick to find out that you need:

(:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

allow-hotplug eth0
iface eth0 inet static
        address 10.0.0.201
        netmask 255.255.255.0
        gateway 10.0.0.138

(:tableend:)

I suspect that the same is valid for dhcp. Sorry for interrupting this tour, please carry on...

After that, just follow the guide to Upgrading Debian on the Linksys NSLU2. Update (2006-12-11) When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage (you need a recent version of slugimage that includes second-stage bootloader support (the -L switch).

(:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

apt-get install slugimage
slugimage -u -i di-nslu2.bin

(:tableend:)

Endian swap the initramfs (ramdisk.gz). (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

apt-get install devio
devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz

(:tableend:)

Unpack the initramfs into a directory e.g. initrd. (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

mkdir initrd; cd initrd
zcat ../ramdisk-swap.gz | cpio -i

(:tableend:)

The NPE microcode firmware will be in the initrd directory. It is called NPE-B.01000201. Copy this file to /lib/firmware on the slug, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201. (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

[s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/
[ssh user@hostname]
cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B

(:tableend:)

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror): (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

deb http://ftp.XX.debian.org/debian testing main non-free contrib

(:tableend:)

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.17: (:table border=0 width=80% bgcolor=#eeffee:) (:cell:) apt-get -t testing install linux-image-2.6-ixp4xx linux-image-2.6.17-2-ixp4xx (:tableend:)

Links to more Debian/NSLU2 documentation

To learn how to build a Debian/NSLU2 image, see BuildImage.

See ChangeKernelCommandLine for how to change the command line passed to the kernel by the second-stage bootloader, APEX, in a Debian/NSLU2 system.

If you want to free up some space in your internal flash, see NoInitramfs.

To use the Debian Installer with a FatSlug, follow the instructions here.

to:

If you know what you are doing, you only need to add auto eth0 to /etc/network/interfaces, using vi, Nano, or what ever other text editor you are fimiliar with.

My Old/default Debian Etch RC1? /etc/network/interfaces

 # This file describes the network interfaces available on your system
 # and how to activate them. For more information, see interfaces(5).

 # The loopback network interface
 auto lo
 iface lo inet loopback

 # The primary network interface
 allow-hotplug eth0
 iface eth0 inet static
         address 192.168.0.70
         netmask 255.255.255.0
         network 192.168.0.0
         broadcast 192.168.0.255
         gateway 192.168.0.1
         # dns-* options are implemented by the resolvconf package, if installed
         dns-nameservers 212.159.13.49 212.159.13.50 212.159.6.9
         dns-search example.org

Fixed /etc/network/interfaces

 # This file describes the network interfaces available on your system
 # and how to activate them. For more information, see interfaces(5).

 # The loopback network interface
 auto lo
 iface lo inet loopback

 # The primary network interface
 #allow-hotplug eth0
 auto eth0
 iface eth0 inet static
         address 192.168.0.70
         netmask 255.255.255.0
         network 192.168.0.0
         broadcast 192.168.0.255
         gateway 192.168.0.1
         # dns-* options are implemented by the resolvconf package, if installed
         dns-nameservers 212.159.13.49 212.159.13.50 212.159.6.9
         dns-search example.org

I also commented #allow-hotplug eth0 out upon suggestion in NSLU2-General IRC Channel.

After changing this, on reboot, i was able to ping during boot, ARP -a was reporting correctly, and when start up was complete - i had SSH. I have reported this on the debian-arm mailing list, as my config was like the top one from installation.

January 03, 2007, at 01:43 PM by hs -- -(:toc:), no, it\'s not installed. THE PREVIEW IS BROKEN
Deleted line 1:

(:toc:)

January 03, 2007, at 01:42 PM by hs -- +(:toc:), to see if it\'s available. THE PREVIEW IS BROKEN
Added line 2:

(:toc:)

January 03, 2007, at 05:25 AM by JLM -- Remove preformatted blocks that were making line wrapping empossible
Deleted line 50:

[@

Deleted line 53:

@]

Deleted line 58:

[@

Deleted line 62:

@]

January 02, 2007, at 12:44 PM by Reedy Boy -- Added info for mounting drive and editing file
Changed lines 73-74 from:

If you know what you are doing, you only need to add auto eth0 to /etc/network/interfaces

to:

If you know what you are doing, you only need to add auto eth0 to /etc/network/interfaces, using vi, Nano, or what ever other text editor you are fimiliar with.

Added lines 134-167:

Method for Editing file on another PC or NSLU2 My other NSLU2 was already unslung to a USB, so that device took SDA, and the usb drive from the debian slug was mounted at sdb

Verified by: fdisk -l /dev/sdb

Which showed 2 partitions, one being swap, and it was around the 7GB mark of my drive

Next Enter mount -o rw /dev/sdb1 /mnt

To mount the drive to /mnt.

If you do not currently have a text editor installed, i am going to use nano (to install on unslung ipkg install nano)

You may need to type export TERM='linux'

Next nano -w /mnt/etc/network/interfaces

You may have to use /opt/bin/nano -w /mnt/etc/network/interfaces

This will open the interfaces file for you to write to

Using your client, browse to relevant point, add a new line, and put auto eth0

Press Ctrl + o, then press enter, and then ctrl + x to take you back to the prompt.

You can then unmount the drive using umount /mnt

If you get an error saying drive is in use, type cd / and then try the unmount command again

(Most of that method should work fine

January 02, 2007, at 09:51 AM by Reedy Boy --
Changed lines 52-54 from:

Case in point is that I had been successfully running my new Debian Slug for a couple of days, booting and rebooting a number of times. At some point, I noticed that I couldn't reach the slug on the network. I don't remember exactly what I had done last, but to bring it back, I just unplugged and re-plugged the power. As it booted back up, everything looked normal. The LEDs? flashed, the disk clicked and all seemed right with the world. But when the boot finished, the NSLU2 was again nowhere to be found on my network.

to:

Case in point is that I had been successfully running my new Debian Slug for a couple of days, booting and rebooting a number of times. At some point, I noticed that I couldn't reach the slug on the network. I don't remember exactly what I had done last, but to bring it back, I just unplugged and re-plugged the power. As it booted back up, everything looked normal. The LEDs? flashed, the disk clicked and all seemed right with the world. But when the boot finished, the NSLU2 was again nowhere to be found on my network.

Changed lines 62-65 from:

The only way I could see what was happening was to add debug statements to the boot, building my own boot log. This was a tedious process of adding statements, unplugging the drive from my MacBook?, plugging it back into my NSLU2, rebooting the NSLU2, putting the disk back on my MacBook?, examining the logs, etc. What I finally found is that everything was normal except that the "interfaces" file, which tells the Debian boot which network interfaces to bring up, was missing the one line that told it to automatically configure the internal Ethernet device. Once I added this line, I rebooted and was back to normal.

to:

The only way I could see what was happening was to add debug statements to the boot, building my own boot log. This was a tedious process of adding statements, unplugging the drive from my MacBook?, plugging it back into my NSLU2, rebooting the NSLU2, putting the disk back on my MacBook?, examining the logs, etc. What I finally found is that everything was normal except that the "interfaces" file, which tells the Debian boot which network interfaces to bring up, was missing the one line that told it to automatically configure the internal Ethernet device. Once I added this line, I rebooted and was back to normal.

January 02, 2007, at 09:51 AM by Reedy Boy --
Changed lines 46-60 from:

Installation instructions

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2.

Upgrade from previous versions

Upgrade from debian-installer beta2

If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.

Upgrade from manual bootstrap to testing ("etch")

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

(:table border=0 width=80% bgcolor=#eeffee:)

to:

Loss of Network Connectivity

Jim Buzbee Reported here

(:table border=0 width=80% bgcolor=#ffeeee:)

Changed lines 52-57 from:

do_symlinks = yes relative_links = yes do_bootloader = no do_bootfloppy = no do_initrd = yes link_in_boot = yes

to:

Case in point is that I had been successfully running my new Debian Slug for a couple of days, booting and rebooting a number of times. At some point, I noticed that I couldn't reach the slug on the network. I don't remember exactly what I had done last, but to bring it back, I just unplugged and re-plugged the power. As it booted back up, everything looked normal. The LEDs? flashed, the disk clicked and all seemed right with the world. But when the boot finished, the NSLU2 was again nowhere to be found on my network.

Changed lines 56-59 from:

Ethernet driver issue: If you followed the same guide/help I did, you may have a static ip address as folows in /etc/interfaces. (The following does not work; eth0 will not be brought up).

(:table border=0 width=80% bgcolor=#ffeeee:)

to:

And the Fix: (:table border=0 width=80% bgcolor=#eeffee:)

Changed lines 60-66 from:

auto eth0 iface eth0 inet static

        pre-up modprobe -f ixp400
        pre-up modprobe -f ixp400_eth
        address 10.0.0.201
        netmask 255.255.255.0
        gateway 10.0.0.138
to:

The only way I could see what was happening was to add debug statements to the boot, building my own boot log. This was a tedious process of adding statements, unplugging the drive from my MacBook?, plugging it back into my NSLU2, rebooting the NSLU2, putting the disk back on my MacBook?, examining the logs, etc. What I finally found is that everything was normal except that the "interfaces" file, which tells the Debian boot which network interfaces to bring up, was missing the one line that told it to automatically configure the internal Ethernet device. Once I added this line, I rebooted and was back to normal.

Changed lines 64-67 from:

This didn't work, the slug's eth0 was not brought up. So I spent 2.5 hours running the debian installer on a 2Gb memory stick to find out that you need:

(:table border=0 width=80% bgcolor=#eeffee:)

to:

From my experience, this was the file was missing an auto eth0 line.

In windows arp -a reported the NSLU2 IP Address with a MAC Address of 00-00-00-00-00-00 and that it was Invalid. I was unable to ping it, and therefore no SSH

If you know what you are doing, you only need to add auto eth0 to /etc/network/interfaces

My Old/default Debian Etch RC1? /etc/network/interfaces (:table border=0 width=80% bgcolor=#ffeeee:)

Added lines 74-81:
  1. This file describes the network interfaces available on your system
  2. and how to activate them. For more information, see interfaces(5).
  3. The loopback network interface

auto lo iface lo inet loopback

  1. The primary network interface
Changed line 84 from:
        address 10.0.0.201
to:
        address 192.168.0.70
Changed lines 86-91 from:
        gateway 10.0.0.138
to:
        network 192.168.0.0
        broadcast 192.168.0.255
        gateway 192.168.0.1
        # dns-* options are implemented by the resolvconf package, if installed
        dns-nameservers 212.159.13.49 212.159.13.50 212.159.6.9
        dns-search example.org
Changed lines 95-103 from:

I suspect that the same is valid for dhcp. Sorry for interrupting this tour, please carry on...

After that, just follow the guide to Upgrading Debian on the Linksys NSLU2. Update (2006-12-11) When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage (you need a recent version of slugimage that includes second-stage bootloader support (the -L switch).

to:

Fixed /etc/network/interfaces

Changed lines 99-100 from:

apt-get install slugimage slugimage -u -i di-nslu2.bin

to:
  1. This file describes the network interfaces available on your system
  2. and how to activate them. For more information, see interfaces(5).
  3. The loopback network interface

auto lo iface lo inet loopback

  1. The primary network interface
  2. allow-hotplug eth0

auto eth0 iface eth0 inet static

        address 192.168.0.70
        netmask 255.255.255.0
        network 192.168.0.0
        broadcast 192.168.0.255
        gateway 192.168.0.1
        # dns-* options are implemented by the resolvconf package, if installed
        dns-nameservers 212.159.13.49 212.159.13.50 212.159.6.9
        dns-search example.org
Changed lines 121-122 from:

Endian swap the initramfs (ramdisk.gz). (:table border=0 width=80% bgcolor=#eeffee:)

to:

I also commented #allow-hotplug eth0 out the upon suggestion in NSLU2-General IRC Channel

After changing this, on reboot, i was able to ping during boot, ARP -a was reporting correctly, and when start up was complete - i had SSH

I have reported this on the debian-arm mailing list, as my config was like the top one from installation

I fixed the file by mounting the drive on my Unslung NSLU2, and then using nano to edit the files.

Installation instructions

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2.

Upgrade from previous versions

Upgrade from debian-installer beta2

If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.

Upgrade from manual bootstrap to testing ("etch")

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

(:table border=0 width=80% bgcolor=#ffeeee:)

Changed lines 146-147 from:

apt-get install devio devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz

to:

do_symlinks = yes relative_links = yes do_bootloader = no do_bootfloppy = no do_initrd = yes link_in_boot = yes

Changed lines 155-156 from:

Unpack the initramfs into a directory e.g. initrd. (:table border=0 width=80% bgcolor=#eeffee:)

to:

Ethernet driver issue: If you followed the same guide/help I did, you may have a static ip address as folows in /etc/interfaces. (The following does not work; eth0 will not be brought up).

(:table border=0 width=80% bgcolor=#ffeeee:)

Changed lines 161-162 from:

mkdir initrd; cd initrd zcat ../ramdisk-swap.gz | cpio -i

to:

auto eth0 iface eth0 inet static

        pre-up modprobe -f ixp400
        pre-up modprobe -f ixp400_eth
        address 10.0.0.201
        netmask 255.255.255.0
        gateway 10.0.0.138
Changed lines 171-173 from:

The NPE microcode firmware will be in the initrd directory. It is called NPE-B.01000201. Copy this file to /lib/firmware on the slug, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201.

to:

This didn't work, the slug's eth0 was not brought up. So I spent 2.5 hours running the debian installer on a 2Gb memory stick to find out that you need:

Changed lines 177-179 from:

[s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/ [ssh user@hostname] cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B

to:

allow-hotplug eth0 iface eth0 inet static

        address 10.0.0.201
        netmask 255.255.255.0
        gateway 10.0.0.138
Changed lines 185-187 from:

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

to:

I suspect that the same is valid for dhcp. Sorry for interrupting this tour, please carry on...

After that, just follow the guide to Upgrading Debian on the Linksys NSLU2. Update (2006-12-11) When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage (you need a recent version of slugimage that includes second-stage bootloader support (the -L switch).

Changed lines 197-198 from:

deb http://ftp.XX.debian.org/debian testing main non-free contrib

to:

apt-get install slugimage slugimage -u -i di-nslu2.bin

Changed line 202 from:

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.17:

to:

Endian swap the initramfs (ramdisk.gz).

Changed lines 205-208 from:

apt-get -t testing install linux-image-2.6-ixp4xx linux-image-2.6.17-2-ixp4xx

to:
apt-get install devio
devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz
Changed lines 211-246 from:
to:

Unpack the initramfs into a directory e.g. initrd. (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

mkdir initrd; cd initrd
zcat ../ramdisk-swap.gz | cpio -i

(:tableend:)

The NPE microcode firmware will be in the initrd directory. It is called NPE-B.01000201. Copy this file to /lib/firmware on the slug, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201. (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

[s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/
[ssh user@hostname]
cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B

(:tableend:)

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror): (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

deb http://ftp.XX.debian.org/debian testing main non-free contrib

(:tableend:)

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.17: (:table border=0 width=80% bgcolor=#eeffee:) (:cell:) apt-get -t testing install linux-image-2.6-ixp4xx linux-image-2.6.17-2-ixp4xx (:tableend:)

January 02, 2007, at 09:42 AM by Reedy Boy -- Added fix for Segmentation Fault
Added lines 29-45:

Useful Information

Segmentation Fault

If after preforming an apt-get update, then apt-get upgrade, your slug reports a 'Segmentation Fault' - Suggesting to try apt-get -f install , and this doesnt work

Try typing (:table border=0 width=80% :) (:cell:)

rm -rf /var/cache/apt/*.bin

(:tableend:)

This will remove the APT cache files, as they are possibly corrupt.

Try apt-get update and then apt-get upgrade again

December 29, 2006, at 06:33 PM by Tim Froidcoeur --
Deleted line 54:

<<<<<<<

Changed lines 57-61 from:

======= Ethernet driver issue: If you followed the same guide/help I did, you may have a static ip address as folows in /etc/interfaces. The following does not work; eth0 will not be brought up: >>>>>>>

to:
December 29, 2006, at 06:31 PM by Tim Froidcoeur --
Added line 55:

<<<<<<<

Added lines 57-59:

(The following does not work; eth0 will not be brought up). ======= Ethernet driver issue: If you followed the same guide/help I did, you may have a static ip address as folows in /etc/interfaces.

Changed lines 61-62 from:
to:

>>>>>>>

Added line 76:

This didn't work, the slug's eth0 was not brought up.

December 29, 2006, at 06:30 PM by Tim Froidcoeur --
Changed lines 55-56 from:

Ethernet driver issue: If you followed the same guide/help I did, you may have a static ip address as folows in /etc/interfaces. This does not work. eth0 will not be brought up.

to:

Ethernet driver issue: If you followed the same guide/help I did, you may have a static ip address as folows in /etc/interfaces. The following does not work; eth0 will not be brought up:

December 29, 2006, at 06:29 PM by Tim Froidcoeur -- previous change sucks, why is the preview not working damnit!
Changed lines 54-56 from:

(:table border=2 width=80% bgcolor=#cacaca:) (:cell:) [@

to:
Changed lines 84-86 from:

@] (:tableend:)

to:
December 29, 2006, at 06:28 PM by Tim Froidcoeur -- made my previous comment stand out as a remark
Changed lines 54-56 from:
to:

(:table border=2 width=80% bgcolor=#cacaca:) (:cell:) [@

Changed lines 86-88 from:
to:

@] (:tableend:)

December 29, 2006, at 06:25 PM by Tim Froidcoeur -- Explain my eth0 woos and maybe help others avoid them.
Changed lines 55-61 from:

After that, just follow the guide to Upgrading Debian on the Linksys NSLU2. Update (2006-12-11) When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage (you need a recent version of slugimage that includes second-stage bootloader support (the -L switch).

(:table border=0 width=80% bgcolor=#eeffee:)

to:

Ethernet driver issue: If you followed the same guide/help I did, you may have a static ip address as folows in /etc/interfaces. This does not work. eth0 will not be brought up.

(:table border=0 width=80% bgcolor=#ffeeee:)

Changed lines 60-61 from:

apt-get install slugimage slugimage -u -i di-nslu2.bin

to:

auto eth0 iface eth0 inet static

        pre-up modprobe -f ixp400
        pre-up modprobe -f ixp400_eth
        address 10.0.0.201
        netmask 255.255.255.0
        gateway 10.0.0.138
Changed lines 70-71 from:

Endian swap the initramfs (ramdisk.gz).

to:

So I spent 2.5 hours running the debian installer on a 2Gb memory stick to find out that you need:

Changed lines 75-76 from:

apt-get install devio devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz

to:

allow-hotplug eth0 iface eth0 inet static

        address 10.0.0.201
        netmask 255.255.255.0
        gateway 10.0.0.138
Changed lines 83-90 from:

Unpack the initramfs into a directory e.g. initrd.

to:

I suspect that the same is valid for dhcp. Sorry for interrupting this tour, please carry on...

After that, just follow the guide to Upgrading Debian on the Linksys NSLU2. Update (2006-12-11) When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage (you need a recent version of slugimage that includes second-stage bootloader support (the -L switch).

Changed lines 94-95 from:

mkdir initrd; cd initrd zcat ../ramdisk-swap.gz | cpio -i

to:

apt-get install slugimage slugimage -u -i di-nslu2.bin

Changed line 99 from:

The NPE microcode firmware will be in the initrd directory. It is called NPE-B.01000201. Copy this file to /lib/firmware on the slug, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201.

to:

Endian swap the initramfs (ramdisk.gz).

Changed lines 103-105 from:

[s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/ [ssh user@hostname] cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B

to:

apt-get install devio devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz

Changed lines 108-110 from:

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

to:

Unpack the initramfs into a directory e.g. initrd.

Changed lines 112-113 from:

deb http://ftp.XX.debian.org/debian testing main non-free contrib

to:

mkdir initrd; cd initrd zcat ../ramdisk-swap.gz | cpio -i

Changed line 117 from:

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.17:

to:

The NPE microcode firmware will be in the initrd directory. It is called NPE-B.01000201. Copy this file to /lib/firmware on the slug, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201.

Changed lines 120-124 from:

apt-get -t testing install linux-image-2.6-ixp4xx linux-image-2.6.17-2-ixp4xx

to:
[s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/
[ssh user@hostname]
cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B
Changed lines 127-143 from:
to:

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror): (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

deb http://ftp.XX.debian.org/debian testing main non-free contrib

(:tableend:)

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.17: (:table border=0 width=80% bgcolor=#eeffee:) (:cell:) apt-get -t testing install linux-image-2.6-ixp4xx linux-image-2.6.17-2-ixp4xx (:tableend:)

December 28, 2006, at 03:45 PM by dunfrac -- Add a link to a page about Debain and FatSlugs
Changed lines 123-125 from:
to:

To use the Debian Installer with a FatSlug, follow the instructions here.

December 28, 2006, at 06:26 AM by TBBle -- 2.6.18 is now in Debian/testing, but people may not have autoupdated to it
Changed lines 27-28 from:

Please note that the NSLU2 will not keep time with the RC1 release of the Debian Installer because this version of the installer uses the 2.6.17 kernel. The problem has been fixed in 2.6.18, which currently (as of 2006.11.28) has not transitioned from unstable to testing. To temporarily fix the problem, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.

to:

Please note that the NSLU2 will not keep time with the 2.6.17 kernel. The problem has been fixed in 2.6.18, which is the current linux kernel image for ixp4xx in testing, but was not in testing when the RC1 debian-installer was released. To permanently fix this problem, update your slug to a 2.6.18 ixp4xx kernel and restart. To temporarily fix the problem without restarting, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.

December 27, 2006, at 08:19 PM by rwhitby --
Deleted lines 60-66:

Help:: this does't work for me.

  • If i start from the RC1? download, 'slugimage -u -i di-nslu2.bin' tells me "Unexpected partition <Loader> (expecting <Kernel>)"
  • If i use the older Beta2 download, slugimage can extract a ramdisk.gz, but after swapping according to below instructions 'zcat ../ramdisk-swap.gz | cpio -i' comes back with "cpio: warning: skipped 16908 bytes of junk

cpio: <junk>" <junk> = weird characters and i need to reset the terminal afterwards.

December 27, 2006, at 08:18 PM by rwhitby --
Changed lines 59-60 from:

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage.

to:

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage (you need a recent version of slugimage that includes second-stage bootloader support (the -L switch).

December 27, 2006, at 06:53 PM by Tim Froidcoeur -- Extracting the NPE-B microcode doesn\'t work for me
Changed lines 59-67 from:

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage. NOTE: Unpacking the installer with slugimage did not work with the latest release, so I used debian-etch-beta2-20060311.zip instead. I haven't yet done the full procedure yet, but at least that one can be unpacked.

to:

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage.

Help:: this does't work for me.

  • If i start from the RC1? download, 'slugimage -u -i di-nslu2.bin' tells me "Unexpected partition <Loader> (expecting <Kernel>)"
  • If i use the older Beta2 download, slugimage can extract a ramdisk.gz, but after swapping according to below instructions 'zcat ../ramdisk-swap.gz | cpio -i' comes back with "cpio: warning: skipped 16908 bytes of junk

cpio: <junk>" <junk> = weird characters and i need to reset the terminal afterwards.

December 21, 2006, at 09:22 PM by Tim Froidcoeur -- Note about slugimage not working on latest rc1
Changed line 59 from:

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage.

to:

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage. NOTE: Unpacking the installer with slugimage did not work with the latest release, so I used debian-etch-beta2-20060311.zip instead. I haven't yet done the full procedure yet, but at least that one can be unpacked.

December 11, 2006, at 02:23 PM by dumfrac -- Make the text a little more clear.
Changed lines 57-58 from:

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, but apart from building the microcode from the source, it is the only documented legal procedure at the moment.

to:

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, so please provide feedback or update the wiki if you find errors. Note that, apart from building the microcode from the source, this procedure is currently the only documented legal way to obtain the microcode.

December 11, 2006, at 01:44 PM by dumfrac --
Changed lines 55-58 from:

Update (2006-12-11) After that, just follow the guide to Upgrading Debian on the Linksys NSLU2. When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.

Important: The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, but apart from building the microcode from the source, it is the only documented legal procedure at the moment.

to:

After that, just follow the guide to Upgrading Debian on the Linksys NSLU2. Update (2006-12-11) When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.

The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, but apart from building the microcode from the source, it is the only documented legal procedure at the moment.

December 11, 2006, at 01:42 PM by dumfrac -- Make the text about upgrading from a debootstrap system consistent with Martin\'s upgrade page
Changed lines 55-58 from:

Need to make sure that the procedure referenced here is not out of date now that 2.6.18 has migrated to testing. After that, just follow the guide to Upgrading Debian on the Linksys NSLU2.

Important note: The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, but apart from building the microcode from the source, it is the only documented legal procedure at the moment.

to:

Update (2006-12-11) After that, just follow the guide to Upgrading Debian on the Linksys NSLU2. When you get to the step, "You need to obtain Intel's proprietary NPE-B microcode so built-in Ethernet will work.", follow the procedure documented below in the next few paragraphs.

Important: The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, but apart from building the microcode from the source, it is the only documented legal procedure at the moment.

December 11, 2006, at 06:31 AM by dumfrac -- Move the section about obtaining the NPE-B microcode.
Changed lines 37-39 from:

Important note: This procedure is not tested yet, but it is the only legal procedure at the moment. The following procedures will be invalid soon!

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage.

to:

Upgrade from debian-installer beta2

If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.

Upgrade from manual bootstrap to testing ("etch")

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

Changed lines 46-47 from:

apt-get install slugimage slugimage -u -i di-nslu2.bin

to:

do_symlinks = yes relative_links = yes do_bootloader = no do_bootfloppy = no do_initrd = yes link_in_boot = yes

Changed lines 55-59 from:

Endian swap the initramfs (ramdisk.gz).

to:

Need to make sure that the procedure referenced here is not out of date now that 2.6.18 has migrated to testing. After that, just follow the guide to Upgrading Debian on the Linksys NSLU2.

Important note: The following details a method for obtaining the NPE-B microcode, which is needed for the ethernet driver in 2.6.18. The procedure is not tested yet, but apart from building the microcode from the source, it is the only documented legal procedure at the moment.

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage.

Changed lines 63-64 from:

apt-get install devio devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz

to:

apt-get install slugimage slugimage -u -i di-nslu2.bin

Changed line 68 from:

Unpack the initramfs into a directory e.g. initrd.

to:

Endian swap the initramfs (ramdisk.gz).

Changed lines 72-73 from:

mkdir initrd; cd initrd zcat ../ramdisk-swap.gz | cpio -i

to:

apt-get install devio devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz

Changed line 77 from:

The NPE microcode firmware will be in the initrd directory. It is called NPE-B.01000201. Copy this file to /lib/firmware on the slug, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201.

to:

Unpack the initramfs into a directory e.g. initrd.

Changed lines 81-83 from:

[s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/ [ssh user@hostname] cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B

to:

mkdir initrd; cd initrd zcat ../ramdisk-swap.gz | cpio -i

Changed lines 86-91 from:

Upgrade from debian-installer beta2

If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.

Upgrade from manual bootstrap to testing ("etch")

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

to:

The NPE microcode firmware will be in the initrd directory. It is called NPE-B.01000201. Copy this file to /lib/firmware on the slug, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201.

Changed lines 90-95 from:

do_symlinks = yes relative_links = yes do_bootloader = no do_bootfloppy = no do_initrd = yes link_in_boot = yes

to:

[s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/ [ssh user@hostname] cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B

Deleted lines 95-96:

After that, just follow the guide to Upgrading Debian on the Linksys NSLU2.

December 11, 2006, at 06:24 AM by dumfrac -- Update the procedure to obtain the NPE-B microcode from the rc1 installer image
Changed lines 37-55 from:
  1. Download the debian-installer image from slug-firmware.net
  2. Unpack the image using slugimage (available via apt)
  3. devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz. (devio available via apt)
  4. mkdir initrd; cd initrd
  5. su -c 'zcat ../ramdisk-swap.gz | cpio -i'. the su is not really necessary - it just keeps the files owned by root, but since you won't be modifying the initramfs, it isn't a problem if they are not owned by root
  6. cp NPE-B.01000201 /lib/firmware/
  7. cd /lib/firmware; ln -s NPE-B.01000201 NPE-B

Thanks to dumfrac at #nslu2-linux (freenode).

Important note: This procedure is not tested yet, but it is the only legal procedure at the moment. The following procedures will be invalid soon!

Upgrade from debian-installer beta2

If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.

Upgrade from manual bootstrap to testing ("etch")

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

to:

Important note: This procedure is not tested yet, but it is the only legal procedure at the moment. The following procedures will be invalid soon!

Download the debian-installer image from slug-firmware.net and unpack the image using slugimage.

Changed lines 43-48 from:

do_symlinks = yes relative_links = yes do_bootloader = no do_bootfloppy = no do_initrd = yes link_in_boot = yes

to:

apt-get install slugimage slugimage -u -i di-nslu2.bin

Changed lines 48-52 from:

After that, just follow the guide to Upgrading Debian on the Linksys NSLU2.

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

to:

Endian swap the initramfs (ramdisk.gz).

Changed lines 52-53 from:

deb http://ftp.XX.debian.org/debian testing main non-free contrib

to:

apt-get install devio devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz

Changed line 57 from:

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.17:

to:

Unpack the initramfs into a directory e.g. initrd.

Changed lines 60-63 from:

apt-get -t testing install linux-image-2.6-ixp4xx linux-image-2.6.17-2-ixp4xx

to:
mkdir initrd; cd initrd
zcat ../ramdisk-swap.gz | cpio -i
Changed lines 66-112 from:
to:

The NPE microcode firmware will be in the initrd directory. It is called NPE-B.01000201. Copy this file to /lib/firmware on the slug, and then create a symbolic link in /lib/firmware called NPE-B which points to NPE-B.01000201. (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

[s]cp NPE-B.01000201 [user@hostname:]/lib/firmware/
[ssh user@hostname]
cd /lib/firmware; sudo ln -s NPE-B.01000201 NPE-B

(:tableend:)

Upgrade from debian-installer beta2

If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.

Upgrade from manual bootstrap to testing ("etch")

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

(:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

do_symlinks = yes
relative_links = yes
do_bootloader = no
do_bootfloppy = no
do_initrd = yes
link_in_boot = yes

(:tableend:)

After that, just follow the guide to Upgrading Debian on the Linksys NSLU2.

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror): (:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

deb http://ftp.XX.debian.org/debian testing main non-free contrib

(:tableend:)

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.17: (:table border=0 width=80% bgcolor=#eeffee:) (:cell:) apt-get -t testing install linux-image-2.6-ixp4xx linux-image-2.6.17-2-ixp4xx (:tableend:)

December 11, 2006, at 06:03 AM by Ahmad Khayyat --
Changed lines 37-44 from:

1. Download the debian-installer image from slug-firmware.net 2. Unpack the image using slugimage (available via apt) 3. devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz. (devio available via apt) 4. mkdir initrd; cd initrd 5. su -c 'zcat ../ramdisk-swap.gz | cpio -i'. the su is not really necessary - it just keeps the files owned by root, but since you won't be modifying the initramfs, it isn't a problem if they are not owned by root 6. cp NPE-B.01000201 /lib/firmware/ 7. cd /lib/firmware; ln -s NPE-B.01000201 NPE-B

to:
  1. Download the debian-installer image from slug-firmware.net
  2. Unpack the image using slugimage (available via apt)
  3. devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz. (devio available via apt)
  4. mkdir initrd; cd initrd
  5. su -c 'zcat ../ramdisk-swap.gz | cpio -i'. the su is not really necessary - it just keeps the files owned by root, but since you won't be modifying the initramfs, it isn't a problem if they are not owned by root
  6. cp NPE-B.01000201 /lib/firmware/
  7. cd /lib/firmware; ln -s NPE-B.01000201 NPE-B
December 11, 2006, at 06:02 AM by Ahmad Khayyat -- Fixed upgrade to Debian/NSLU2 with kernels newer than 2.6.17
Added lines 37-49:

1. Download the debian-installer image from slug-firmware.net 2. Unpack the image using slugimage (available via apt) 3. devio '<< ramdisk.gz; xp $ 4' > ramdisk-swap.gz. (devio available via apt) 4. mkdir initrd; cd initrd 5. su -c 'zcat ../ramdisk-swap.gz | cpio -i'. the su is not really necessary - it just keeps the files owned by root, but since you won't be modifying the initramfs, it isn't a problem if they are not owned by root 6. cp NPE-B.01000201 /lib/firmware/ 7. cd /lib/firmware; ln -s NPE-B.01000201 NPE-B

Thanks to dumfrac at #nslu2-linux (freenode).

Important note: This procedure is not tested yet, but it is the only legal procedure at the moment. The following procedures will be invalid soon!

December 08, 2006, at 04:45 PM by Phil Endecott -- Link to Debian/NoInitramfs
Changed lines 81-83 from:
to:

If you want to free up some space in your internal flash, see NoInitramfs.

November 29, 2006, at 01:07 AM by dumfrac -- Add a note about tickadj.
Changed lines 27-28 from:

Please note that the NSLU2 will not keep time with the RC1 release of the Debian Installer because this version of the installer uses the 2.6.17 kernel. The problem has been fixed in 2.6.18, which currently (as of 2006.11.28) has not transitioned from unstable to testing. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.

to:

Please note that the NSLU2 will not keep time with the RC1 release of the Debian Installer because this version of the installer uses the 2.6.17 kernel. The problem has been fixed in 2.6.18, which currently (as of 2006.11.28) has not transitioned from unstable to testing. To temporarily fix the problem, use tickadj to set the kernel ticks to 10101. You need to do this every time the NSLU2 is turned on. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.

November 29, 2006, at 12:49 AM by dumfrac -- Suppress WikiWords for \"RC1\"
Changed lines 27-28 from:

Please note that the NSLU2 will not keep time with the Debian Installer RC1? as this version of the installer uses the 2.6.17 kernel. The problem has been fixed in 2.6.18, which currently (as of 2006.11.28) has not transitioned from unstable to testing. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.

to:

Please note that the NSLU2 will not keep time with the RC1 release of the Debian Installer because this version of the installer uses the 2.6.17 kernel. The problem has been fixed in 2.6.18, which currently (as of 2006.11.28) has not transitioned from unstable to testing. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.

November 29, 2006, at 12:41 AM by dumfrac -- Add a note about the NSLU2 clock and the Debian 2.6.17 kernel
Added lines 27-28:

Please note that the NSLU2 will not keep time with the Debian Installer RC1? as this version of the installer uses the 2.6.17 kernel. The problem has been fixed in 2.6.18, which currently (as of 2006.11.28) has not transitioned from unstable to testing. This problem has been reported many times on the nslu2-linux mailing list. Please try to resist the urge to report it again.

November 27, 2006, at 02:03 PM by Phil Endecott -- Link to HowTo/MountDisksByLabel
Changed lines 25-26 from:

See http://www.us.debian.org/devel/debian-installer/errata for current known issues (not NSLU2-specific). In particular, note the first point: if you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit.

to:

See http://www.us.debian.org/devel/debian-installer/errata for current known issues (not NSLU2-specific). In particular, note the first point: if you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit. If you can't wait, see MountDisksByLabel for one solution.

November 25, 2006, at 11:17 PM by Phil Endecott -- Link to Debian/ChangeKernelCommandLine
Changed line 7 from:
to:
Changed lines 71-76 from:

Building a Debian/NSLU2 image

See BuildImage.

to:

Links to more Debian/NSLU2 documentation

To learn how to build a Debian/NSLU2 image, see BuildImage.

See ChangeKernelCommandLine for how to change the command line passed to the kernel by the second-stage bootloader, APEX, in a Debian/NSLU2 system.

November 25, 2006, at 10:43 PM by Phil Endecott -- Discourage users with more than one disk from trying this for the time being
Added lines 25-26:

See http://www.us.debian.org/devel/debian-installer/errata for current known issues (not NSLU2-specific). In particular, note the first point: if you have more than one disk or flash storage device attached to your NSLU2 you are likely to run into trouble. This is a priority for the next release, so if you have multiple disks you might want to wait for a bit.

Deleted lines 31-32:

See http://www.us.debian.org/devel/debian-installer/errata for current known issues, not NSLU2-specific.

November 23, 2006, at 07:55 AM by rwhitby --
Changed lines 74-76 from:

+ Install Debian etch on a desktop machine

to:
November 23, 2006, at 07:49 AM by rwhitby --
Changed lines 72-73 from:

Building a NSLU2 image

to:

Building a Debian/NSLU2 image

+ Install Debian etch on a desktop machine

November 23, 2006, at 07:49 AM by rwhitby --
Added line 7:
Added lines 71-73:

Building a NSLU2 image

November 23, 2006, at 06:20 AM by molli123 --
Changed line 75 from:

Also available is Big Endian DebianSlug (known as OpenDebianSlug?, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug? makes use of the unofficial armeb port of Debian. Currently, only parts debian sarge and sid are available.

to:

Also available is Big Endian DebianSlug (known as OpenDebianSlug?, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug? makes use of the unofficial armeb port of Debian. Currently, only parts of debian sarge and sid are available.

November 22, 2006, at 04:46 PM by fcarolo -- fixed link
Changed lines 38-39 from:

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to [http://tech.groups.yahoo.com/group/nslu2-linux/message/15925|this message]] from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

to:

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

November 22, 2006, at 04:46 PM by fcarolo -- update instructions for sid
Changed lines 38-39 from:

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

to:

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure with Debian testing ("etch") and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to [http://tech.groups.yahoo.com/group/nslu2-linux/message/15925|this message]] from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

Changed line 56 from:

If you have previously bootstraped your NSLU2 to unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

to:

If you have previously bootstraped your NSLU2 to Debian unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror):

November 22, 2006, at 04:44 PM by fcarolo -- update instructions for sid
Changed lines 59-61 from:

deb http://ftp.XX.debian.org/debian testing main non-free contrib

to:
deb http://ftp.XX.debian.org/debian testing main non-free contrib
November 22, 2006, at 04:42 PM by fcarolo -- update instructions for sid
Deleted lines 23-24:

See http://www.us.debian.org/devel/debian-installer/errata for current known issues, not NSLU2-specific.

Added lines 29-30:

See http://www.us.debian.org/devel/debian-installer/errata for current known issues, not NSLU2-specific.

Added line 34:

Upgrade from debian-installer beta2

Added line 37:

Upgrade from manual bootstrap to testing ("etch")

Deleted line 48:

postinst_hook = flash-kernel

Deleted line 51:
Added lines 54-67:

Upgrade from manual bootstrap to unstable ("sid")

If you have previously bootstraped your NSLU2 to unstable ("sid"), you will have to adjust your /etc/apt/sources.list file in order to install the correct packages for kernel 2.6.17. Before you start the upgrade procedure, add a line to /etc/apt/sources.list for testing (remember to use your favorite Debian mirror): (:table border=0 width=80% bgcolor=#eeffee:) (:cell:) deb http://ftp.XX.debian.org/debian testing main non-free contrib (:tableend:)

Now follow the same steps mentioned above for etch: create the /etc/kernel-img.conf and follow the upgrade guide. However, during the upgrade procedure, at the point you have to install the kernel packages, use this command to get the correct packages for kernel 2.6.17: (:table border=0 width=80% bgcolor=#eeffee:) (:cell:) apt-get -t testing install linux-image-2.6-ixp4xx linux-image-2.6.17-2-ixp4xx (:tableend:)

November 22, 2006, at 01:05 PM by Phil Endecott -- Link to errata
Added lines 24-25:

See http://www.us.debian.org/devel/debian-installer/errata for current known issues, not NSLU2-specific.

November 16, 2006, at 07:16 PM by fcarolo -- better info about upgrade and name change for SlugOS/LE
Added lines 1-9:
Added line 11:
Added lines 14-18:

Goals

The goal is to add full support for the NSLU2 and similar devices into the official Linux kernel and the Debian GNU/Linux distribution, so users can benefit of the full Debian package repository and also have slug-specific packages and patches for hardware devices such as the built-in Ethernet port, LEDs, etc.

Changed lines 22-57 from:

Debian fully supports the NSLU2 using the debian-installer (this is the setup known as Debian/NSLU2). This was first supported with the beta2 installer for etch but support got broken with beta3 because of an incompatibility between the proprietary Ethernet module and the Debian kernel. This has been fixed as of debian-installer rc1 which supports the NSLU2 again. Please visit http://www.cyrius.com/debian/nslu2. This is the current recommended way to install Debian on a slug.

to:

Debian fully supports the NSLU2 using the debian-installer (this is the setup known as Debian/NSLU2). This was first supported with the beta2 installer for etch but support got broken with beta3 because of an incompatibility between the proprietary Ethernet module and the Debian kernel. This has been fixed as of debian-installer rc1 which supports the NSLU2 again. Please visit http://www.cyrius.com/debian/nslu2/. This is the current recommended way to install Debian on a slug.

Installation instructions

Instructions to set up Debian/NSLU2 are available at Debian on NSLU2.

Upgrade from previous versions

If you are already running Debian/NSLU2 as installed by debian-installer beta2, you can upgrade to the latest version following the guide for Upgrading Debian on the NSLU2. Please note that this manual procedure is necessary due to changes in the way the kernel is loaded at boot time.

If you have previously installed SlugOS/LE (formerly know as DebianSlug) using the manual bootstrap procedure and your root partition is /dev/sda1, you can upgrade to Debian/NSLU2 according to this message from the mailing list. To do this, first create the file /etc/kernel-img.conf with the following contents:

(:table border=0 width=80% bgcolor=#eeffee:) (:cell:)

do_symlinks = yes
relative_links = yes
do_bootloader = no
do_bootfloppy = no
do_initrd = yes
link_in_boot = yes
postinst_hook = flash-kernel

(:tableend:)

After that, just follow the guide to Upgrading Debian on the Linksys NSLU2.

Other Solutions

The old solution to run Debian packages in the NSLU2 is SlugOS/LE, previously known as DebianSlug. This solution uses the SlugOS kernel in little-endian mode, in a way that is compatible with the Debian arm distribution. This setup requires a manual bootstrap procedure and is no longer the recommended solution to run Debian in the slug.

Also available is Big Endian DebianSlug (known as OpenDebianSlug?, because it uses the big-endian OpenSlug binary image). Since Debian does not provide big endian ARM as a supported Debian architecture, OpenDebianSlug? makes use of the unofficial armeb port of Debian. Currently, only parts debian sarge and sid are available.

November 11, 2006, at 01:54 PM by dumfrac -- State that support first appeared in the beta2 installer of *etch*. Also add a link to the email about SLOB and the Intel ethernet driver.
Changed line 7 from:

Debian fully supports the NSLU2 using debian-installer (this is the setup known as Debian/NSLU2). This was first supported with beta2 but support got broken as of beta3 because of an incompatibility between the proprietary Ethernet module and the Debian kernel. This has been fixed as of debian-installer rc1 which supports the NSLU2 again. Please visit http://www.cyrius.com/debian/nslu2. This is the current recommended way to install Debian on a slug.

to:

Debian fully supports the NSLU2 using the debian-installer (this is the setup known as Debian/NSLU2). This was first supported with the beta2 installer for etch but support got broken with beta3 because of an incompatibility between the proprietary Ethernet module and the Debian kernel. This has been fixed as of debian-installer rc1 which supports the NSLU2 again. Please visit http://www.cyrius.com/debian/nslu2. This is the current recommended way to install Debian on a slug.

November 09, 2006, at 08:51 PM by rwhitby --
Added lines 1-7:

What is Debian/NSLU2?

Debian/NSLU2 is the name given to the official Debian distribution for ARM that runs on the NSLU2, thanks to the efforts of the nslu2-linux developers to get the necessary kernel patches and utilities accepted upstream by the kernel maintainers and by the Debian Project.

State of the project

Debian fully supports the NSLU2 using debian-installer (this is the setup known as Debian/NSLU2). This was first supported with beta2 but support got broken as of beta3 because of an incompatibility between the proprietary Ethernet module and the Debian kernel. This has been fixed as of debian-installer rc1 which supports the NSLU2 again. Please visit http://www.cyrius.com/debian/nslu2. This is the current recommended way to install Debian on a slug.