summaryrefslogtreecommitdiff
path: root/packages/nslu2-binary-only
diff options
context:
space:
mode:
authorMichael Lauer <mickey@vanille-media.de>2006-04-14 15:27:00 +0000
committerOpenEmbedded Project <openembedded-devel@lists.openembedded.org>2006-04-14 15:27:00 +0000
commit64a0899b9317814694d2a80b42edd7f0896d1507 (patch)
treeaa402bd7fa088ecffb86ad348c1be2b82deea5cc /packages/nslu2-binary-only
parent511f610654ce94cd5d0030e1af17a37c7c4ccffb (diff)
parentf42b0f7d3dffbf3e6f14de26825a231ba1424de2 (diff)
merge of 57ac60221ec66341d6031290ebe0ea39dea0b9c7
and 9e2b0b36ac437fa39c2d640705951c444373f8c8
Diffstat (limited to 'packages/nslu2-binary-only')
-rw-r--r--packages/nslu2-binary-only/nslu2-linksys-firmware_2.3r29.bb24
-rw-r--r--packages/nslu2-binary-only/nslu2-linksys-libs_2.3r29.bb23
-rw-r--r--packages/nslu2-binary-only/nslu2-linksys-ramdisk_2.3r29.bb20
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs-2.3r63/.mtn2git_empty0
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs-2.3r63/NOTES489
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs-2.3r63/README370
-rwxr-xr-xpackages/nslu2-binary-only/unslung-rootfs-2.3r63/linuxrc70
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs-2.3r63/rc.modules-diversion.patch8
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs-2.3r63/remount-noatime.patch51
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs-2.3r63/security-fixes.patch11
-rwxr-xr-xpackages/nslu2-binary-only/unslung-rootfs-2.3r63/unsling233
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs-2.3r63/upgrade.htm129
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs-2.3r63/wait-for-quotacheck.patch10
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/NOTES73
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/README272
-rwxr-xr-xpackages/nslu2-binary-only/unslung-rootfs/ipkg-fl (renamed from packages/nslu2-binary-only/unslung-rootfs-2.3r63/ipkg-fl)0
-rwxr-xr-xpackages/nslu2-binary-only/unslung-rootfs/linuxrc134
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/motd-fl (renamed from packages/nslu2-binary-only/unslung-rootfs-2.3r63/motd-fl)0
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/motd-un (renamed from packages/nslu2-binary-only/unslung-rootfs-2.3r63/motd-un)0
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/profile2
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/rc.modules-diversion.patch4
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/rc.sysinit-clean_var.patch (renamed from packages/nslu2-binary-only/unslung-rootfs-2.3r63/rc.sysinit-clean_var.patch)0
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/remount-noatime.patch48
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/security-fixes.patch9
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/telnet.htm (renamed from packages/nslu2-binary-only/unslung-rootfs-2.3r63/telnet.htm)0
-rwxr-xr-xpackages/nslu2-binary-only/unslung-rootfs/unsling192
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/upgrade.htm16
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs/wait-for-quotacheck.patch3
-rw-r--r--packages/nslu2-binary-only/unslung-rootfs_2.3r29.bb104
29 files changed, 467 insertions, 1828 deletions
diff --git a/packages/nslu2-binary-only/nslu2-linksys-firmware_2.3r29.bb b/packages/nslu2-binary-only/nslu2-linksys-firmware_2.3r29.bb
deleted file mode 100644
index dbb4ad2502..0000000000
--- a/packages/nslu2-binary-only/nslu2-linksys-firmware_2.3r29.bb
+++ /dev/null
@@ -1,24 +0,0 @@
-SECTION = "base"
-DEPENDS = "slugimage-native unzip-native"
-PACKAGES = ""
-LICENSE = "GPL"
-INHIBIT_DEFAULT_DEPS = "1"
-PR = "r1"
-
-SRC_URI = "ftp://ftp.linksys.com/pub/network/NSLU2_V23R29.zip"
-S = "${WORKDIR}"
-
-python () {
- # Don't build unless we're targeting an nslu2
- if bb.data.getVar("MACHINE", d, 1) != "nslu2":
- raise bb.parse.SkipPackage("NSLU2 firmware only builds for the Linksys NSLU2")
-}
-
-do_compile () {
- slugimage -u -i NSLU2_V23R29.bin -b RedBoot -s SysConf -r ramdisk.ext2.gz -t Trailer
- install -d ${STAGING_LIBDIR}/nslu2-binaries
- install -m 0755 RedBoot ${STAGING_LIBDIR}/nslu2-binaries/
- install -m 0755 SysConf ${STAGING_LIBDIR}/nslu2-binaries/
- install -m 0755 ramdisk.ext2.gz ${STAGING_LIBDIR}/nslu2-binaries/
- install -m 0755 Trailer ${STAGING_LIBDIR}/nslu2-binaries/
-}
diff --git a/packages/nslu2-binary-only/nslu2-linksys-libs_2.3r29.bb b/packages/nslu2-binary-only/nslu2-linksys-libs_2.3r29.bb
deleted file mode 100644
index f8348a615a..0000000000
--- a/packages/nslu2-binary-only/nslu2-linksys-libs_2.3r29.bb
+++ /dev/null
@@ -1,23 +0,0 @@
-DESCRIPTION = "Linksys NSLU2 Stock Firmware Libraries."
-PACKAGE_ARCH = "nslu2"
-SECTION = "base"
-PRIORITY = "required"
-PR = "r2"
-
-SRC_URI = "http://nslu.sf.net/downloads/nslu2-linksys-ramdisk-2.3r29.tar.bz2"
-
-S = "${WORKDIR}/nslu2-linksys-ramdisk-2.3r29"
-
-do_install () {
- ( cd ${S} ; rm -rf bin dev home mnt proc sbin share tmp upload usr var )
- ( cd ${S} ; tar cvf - . ) | ( cd ${D} ; tar xvf - )
-}
-
-PACKAGES = "${PN}"
-FILES_${PN} = "/lib"
-
-python () {
- # Don't build unless we're targeting an nslu2
- if bb.data.getVar("MACHINE", d, 1) != "nslu2":
- raise bb.parse.SkipPackage("NSLU2 stock firmware libraries only builds for the Linksys NSLU2")
-}
diff --git a/packages/nslu2-binary-only/nslu2-linksys-ramdisk_2.3r29.bb b/packages/nslu2-binary-only/nslu2-linksys-ramdisk_2.3r29.bb
deleted file mode 100644
index c37c283706..0000000000
--- a/packages/nslu2-binary-only/nslu2-linksys-ramdisk_2.3r29.bb
+++ /dev/null
@@ -1,20 +0,0 @@
-DESCRIPTION = "Linksys NSLU2 Stock Firmware Ramdisk."
-PACKAGE_ARCH = "nslu2"
-SECTION = "base"
-PRIORITY = "required"
-PR = "r1"
-
-SRC_URI = "http://nslu.sf.net/downloads/nslu2-linksys-ramdisk-2.3r29.tar.bz2"
-
-do_install () {
- ( cd ${S} ; tar cvf - . ) | ( cd ${D} ; tar xvf - )
-}
-
-PACKAGES = "${PN}"
-FILES_${PN} = "/"
-
-python () {
- # Don't build unless we're targeting an nslu2
- if bb.data.getVar("MACHINE", d, 1) != "nslu2":
- raise bb.parse.SkipPackage("NSLU2 ramdisk only builds for the Linksys NSLU2")
-}
diff --git a/packages/nslu2-binary-only/unslung-rootfs-2.3r63/.mtn2git_empty b/packages/nslu2-binary-only/unslung-rootfs-2.3r63/.mtn2git_empty
deleted file mode 100644
index e69de29bb2..0000000000
--- a/packages/nslu2-binary-only/unslung-rootfs-2.3r63/.mtn2git_empty
+++ /dev/null
diff --git a/packages/nslu2-binary-only/unslung-rootfs-2.3r63/NOTES b/packages/nslu2-binary-only/unslung-rootfs-2.3r63/NOTES
deleted file mode 100644
index ae9d7c607c..0000000000
--- a/packages/nslu2-binary-only/unslung-rootfs-2.3r63/NOTES
+++ /dev/null
@@ -1,489 +0,0 @@
-Unslung-6.x Family Release Notes
-
-Unslung is a replacement firmware image for the Linksys NSLU2 which is designed
-to allow you to make changes to the root filesystem (including the installation
-of downloadable packages) while still providing all the standard product
-functionality.
-
-If, at any time, you have any questions concerning the installation or
-operation of Unslung firmware, your first port of call should be the
-NSLU2-Linux wiki at:
-
- http://www.nslu2-linux.org
-
-Specifically, check the HowTos and the Frequently Asked Questions before
-posting to the mailing list or asking a question in the IRC channel
-[#nslu2-general @ irc.freenode.net].
-
-OK! Now that that's out of the way...
-
-This file is provided to give general information and usage notes for the
-Unslung 6.x firmware. If you are looking for installation instructions, please
-stop now and go to the README file. Follow the README instructions WORD for
-WORD to keep from turning your NSLU2 into a brick. The information contained
-in this file will make more sense if you have already "unslung" your NSLU2.
-
---------------------------------------------------------------------------------
-
-These "Notes" are divided into four sections:
-
- 1 - GENERAL INFORMATION
- 2 - IPKG PACKAGES
- 3 - DIVERSION SCRIPTS
- 4 - CHANGELOG
-
-
-GENERAL INFORMATION
-
-As stated above, Unslung firmware is a replacement firmware image for the
-Linksys NSLU2. The Unslung firmware is intended to be used for loading new
-packages (giving enhanced or additional functionality) with minimal changes
-to the standard user interface and firmware. The differences in the Unslung 6.x
-firmware from the standard Linksys 2.3R63 firmware can be found at:
-
- http://www.nslu2-linux.org/wiki/Unslung/UnslungFeatures
-
-For more information about the Unslung firmware, including details on how to
-build it from source code yourself, look at:
-
- http://www.nslu2-linux.org/wiki/Unslung
-
-There are several assumptions made in this Notes. One, you've successfully
-unslung your NSLU2, and can verify the basic Linksys functionality (samba
-users, groups, and shares setup with the Linksys interface). Two, that you can
-get telnet or ssh shell access to your NSLU2 from any computer on the same
-network as the NSLU2. Three, that you have read and understand the NSLU2-linux
-community rules at:
-
- http://www.nslu2-linux.org/wiki/Main/HomePage
-
-If you understand the third assumption, then you also understand that there is
-an emphasis on using and developing the NSLU2-Linux wiki. Clarifications and
-further documentation is always welcomed on the wiki.
-
-If you are experienced with the Linux operating system, then you can make
-changes directly to the root filesystem - changes which are persistent across
-reboot. If you want to get involved, then check the NSLU2-linux wiki at:
-
- http://www.nslu2-linux.org/wiki/Main/HowToGetInvolved
-
-
-IPKG PACKAGES
-
-Packages require you to be running Unslung firmware (as you may have already
-guessed!) In general, ipkg packages are commonly available software packages
-that have been ported to the NSLU2 - giving enhanced or additional
-functionality. If you run into problems or have specific question with a
-certain package, you should look on the Internet for the general documentation
-about the package first. If your problem is specific to the NSLU2 port, then
-check for further documentation for the corresponding package on the
-NSLU2-Linux wiki at:
-
- http://www.nslu2-linux.org/wiki/Unslung/Packages
-
-When you "unsling" an external disk (check the README for instructions),
-downloaded packages will be installed onto that external disk. The number of
-packages that you can install is only limited by the size of the "data"
-partition on the external disk. Note that you *must* *not* install any
-packages before you have booted with an external "Unslung" disk. To do so will
-almost certainly cause your internal jffs2 flash memory become full, and cause
-you to have to reflash your NSLU2.
-
-Package Installation Details
-
- 1) Check for network connectivity to the package repository from the NSLU2
- first: "ping ipkg.nslu2-linux.org"
-
- - If this does not work, then please check the NSLU2 DNS settings in
- the web interface (under "Administration", "LAN").
-
- 3) Update the list of available packages from new feeds: "ipkg update"
-
- 4) Check the list of available packages for ones that you want on your
- NSLU2: "ipkg list"
-
- 5) Install the packages: "ipkg install <package-name>"
-
-Most packages put their startup scripts into /opt/etc/init.d - which the
-Unslung firmware automatically runs at boot. Some other packages are run from
-the cron or xinetd daemons.
-
-You can also check the ipkg command arguments simply by typing "ipkg" at the
-prompt.
-
-
-DIVERSION SCRIPTS
-
-Diversion scripts are used to start packages, set variables or function
-definitions at the time of the NSLU2 boot. The diversion mechanism allows you
-to add to, or even replace the Linksys script functionality. They "divert" the
-normal boot scripts to perform the needed action(s) and then can either "return
-1" to continue normal factory script progress or "return 0" to abort the
-diverted factory script. The diversion of startup scripts is done at the
-lowest granularity, so you can just divert the rc.xinetd script and leave all
-others unchanged. You are advised to use diversion scripts rather than editing
-system files directly (as this will allow you to upgrade the Unslung firmware
-in the future without having to make all of your changes again).
-
- - Note: If you do need to edit the system files directly, you can use the
- "resling" script to save and load your modified system files. See
- the NSLU2-Linux wiki at:
-
- http://www.nslu2-linux.org/wiki/Unslung/ReSling
-
-Diversion scripts go in the /unslung directory (you may have to create that
-directory first). Note that after you have unslung to an external disk, then
-the diversion scripts will be stored on that external disk (along with the rest
-of the root filesystem). This means that recovering from an incorrect
-diversion script is as simple as powering off, unplugging the disk, powering
-on, hot-plugging the disk (note that the diversion scripts will only run if the
-disk is attached at boot), and fix or remove the diversion script.
-
-You may divert as many or as few scripts as you like. Simply add the name of
-the standard rc script into the appropriate /unslung directory and it will be
-run.
-
-For example, I have a script /unslung/rc.local:
-
-#! /bin/sh
-/opt/bin/do_foo
-return 1
-
-That will run at the beginning of the normal /etc/rc.d/rc.local, and then
-the rest of the factory rc.local will be executed. If I do NOT want to run
-the factory rc.local, my script would be:
-
-#!/bin/sh
-/opt/bin/do_foo
-return 0
-
-That is, if the diversion script returns with something other than 0, it will
-run the rest of the factory script.
-
-Note that any variable definitions or function declarations are allowed to
-happen before the diversion script is called. This allows you to use the
-variables and functions defined by the factory script.
-
-Also not that telnet is not enabled by default - there is an openssh package
-and a dropbear package that either can replace telnet access with secure shell
-access.
-
-OpenSSH is the simplest to install:
-
- - OpenSSH package details on NSLU2-Linux wiki at:
- http://www.nslu2-linux.org/wiki/HowTo/UseOpenSSHForRemoteAccess
-
-Dropbear is preferred by some:
-
- - Dropbear package details on NSLU2-Linux wiki at:
- http://www.nslu2-linux.org/wiki/HowTo/UseDropBearForRemoteAccess
-
-The rationale behind not enabling telnet by default is ensure that an Unslung
-NSLU2 has the same network footprint as a stock NSLU2 with Linksys firmware.
-That said, if you want to enable telnet on boot, then install the xinetd
-package (which enables telnet by default).
-
-
-CHANGELOG
-
-1.11:
-
-First public release
-
-1.12:
-
-Added a symlink to slingbox for gzip. Added flashfs (as simple utility for
-preserving user files across hard disk formats during beta testing).
-
-1.13:
-
-Added LD_LIBRARY_PATH to /etc/profile (only works for telnet and ssh access,
-not for serial or diversion scripts).
-
-1.14:
-
-Added Unslung Doc link to the User Guide page.
-
-2.3:
-
-Moved development to OpenEmbedded.
-
-2.4:
-
-Updated to the latest ipk binary instead of the simple script.
-
-2.5:
-
-Added the real wget (instead of using the busybox version). This is so we can
-support .netrc files for commercial packages.
-
-2.6:
-
-Fixed the unsling script so it removes conflicting files on an upgrade.
-
-2.7:
-
-Began development of the -able variant.
-
-2.8:
-
-Added the patch for genesys enclosures.
-
-2.9:
-
-Reorganized the various variants into a more consistent scheme.
-
-2.10:
-
-Added the ext3flash-on-disk1 functionality.
-
-2.11:
-
-Added the README to /opt/doc.
-
-2.12:
-
-First public release of 2.x firmware.
-
-3.1:
-
-Added jffs2 functionality.
-
-3.2:
-
-Incorporated switchbox functionality.
-
-3.3:
-
-Added ramdisks for /dev and /var to reduce internal flash writes.
-
-3.4:
-
-Replaced flashfs script with new resling script.
-
-3.5:
-
-Added code to reinitialize /etc/mtab on boot.
-
-3.6:
-
-Mounted /dev and /var jffs2 directories as /dev.state and /var.state so that
-they can be used for persistent changes which are used to populate the ramdisks
-on the next boot.
-
-3.7:
-
-Added "Pluggable Personalities" - now runs diversion scripts from both the
-internal jffs2 area and also from an external drive attached at boot time.
-
-3.8:
-
-Enabled mounting of external drives earlier in the boot process, so that the
-rc, rc.sysinit, and rc.1 scripts can be diverted by external diversion scripts
-on an attached drive.
-
-3.9:
-
-Moved a number of -able kernel features (such as USB devfs support) into
--standard.
-
-3.10:
-
-Added support for unslung-start and unslung-stop diversion scripts, and package
-shutdown scripts (K??foo).
-
-3.11:
-
-Added NFS kernel support (both client and server, and both V2 and V3
-protocols).
-
-3.12:
-
-Added basic maintenance mode support. If /.ramdisk exists in the jffs2
-filesystem, then the jffs2 filesystem is copied into a ramdisk on boot, and run
-from there. This allows for updating firmware using the web interface.
-
-3.13:
-
-Added recovery mode support. If a viable root filesystem cannot be found, then
-switchbox drops into a basic recovery shell, with a telnet daemon running as
-192.168.1.77 with no password. This behavior can also be forced with a
-/.recovery file in the jffs2 filesystem.
-
-3.14:
-
-Added web control of maintenance mode. You have to enable maintenance mode and
-reboot before the firmware upgrade page allows you to enter a filename for the
-new firmware.
-
-3.15:
-
-Added confirmation dialog boxes to the maintenance mode web control.
-
-3.16:
-
-First public release of 3.x firmware.
-
-3.17:
-
-Fixed syslog issue. Added FP patches.
-
-3.18:
-
-Fixed a number of minor issues regarding file permissions.
-Added support for unslinging to the data partition.
-
-4.1:
-
-Split from 3.x stream to allow parallel development.
-
-4.2:
-
-New switchbox implementation with NFS and external USB disk root filesystem
-support.
-
-4.3:
-
-Enabled devfs.
-
-4.4:
-
-Changed slingbox program locations to match those of OpenSlug so that
-we can use the same switchbox for both.
-
-4.5:
-
-Enabled RAID support modules and USB camera support modules.
-
-4.6:
-
-Merged unslung-standard and unslung-able, and created the oe feed for
-downloadable kernel modules. Updated the unsling script to support
-external rootfs.
-
-4.7:
-
-Enabled lots of traffic shaping modules. Enabled support for external
-disks on sda1, sda2, sdb1 and sdb2.
-
-4.8:
-
-Made Unslung *not* create ramdisk for /var and /dev when you've
-unslung to an external disk. Fixed nsswitch.conf. Updated the feed
-locations. Added /dev/st devices for tape drive support.
-
-4.9:
-
-Updated the unslung script to give feedback on the rootfs transfer,
-and to preserve an existing upkg database on the target disk. Added
-more device nodes to support the new downloadable kernel modules.
-
-4.10:
-
-Made Unslung wait until quota checking is complete before running
-package startup scripts. Simplified unsling to support disk1 and
-disk2 (data partitions) only.
-
-4.11:
-
-Removed /tmp ramdisk if unslung to an external disk. Now clears /tmp
-and /mnt/backup on each boot.
-
-4.12:
-
-Updated to the latest ipkg version.
-
-4.13:
-
-Added /dev/sdd and /dev/sde device nodes.
-Added support for alternate rootfs under expert user control.
-
-4.14:
-
-Added audio support to the kernel. Increased the USB disk startup
-wait to 10 seconds, and added the ability to divert rc.bootbin to the
-startup scripts.
-
-4.15:
-
-Added /dev/dsp and updated the README and NOTES files.
-
-4.16:
-
-Added the /sbin/slingover script for migrating packages from the 3.x locations.
-
-4.17:
-
-Developer-only release booting straight from jffs2 instead of using switchbox.
-
-4.18:
-
-A number of /linuxrc fixes. Removed support for alternate rootfs under expert
-user control (expert users can now just edit the /linuxrc in jffs2 directly).
-
-4.19:
-
-Removed all trace of switchbox from the firmware. This saves 128Kb of flash,
-and about 1MB of RAM.
-
-4.20:
-
-First public release of 4.x firmware.
-
-5.1:
-
-Upgraded to Linksys firmware V2.3R29, but kept telnetd.
-
-5.2:
-
-Removed the ipkg link, and made unsling put it back on an external disk.
-
-5.3:
-
-Replaced maintenance mode with code to allow entry into RedBoot Upgrade Mode.
-
-5.4:
-
-Removed all maintenance mode support, and also removed support for rootfs on
-jffs2 but packages on external disk (it's either all or nothing).
-Removed unused /mnt/sda1, /mnt/sda2, /mnt/sdb1, and /mnt/sdb2.
-Disabled the download process (superceded by upgrade mode).
-Disabled the generation of the "ourtelnetrescue" user (too insecure).
-Added disk auto-wait countdown to /linuxrc (courtesy of glc).
-
-5.5:
-
-First public release of 5.x firmware.
-
-6.0:
-
-First alpha release of 6.x Unslung firmware, based on Linksys V2.3R63 firmware.
-
-6.5:
-
-Unsling script now prompts for a root password to be used, additional sanity
-checks added to minimize the chance of an improper unsling. User feedback
-added to indicate the status (running from internal flash or booted up from
-an external drive) via /etc/motd, ipkg, as well as the main web page. Improved
-diagnostic messages from unsling. Added the Linksys custom code to the "mount"
-code in the slingbox version of mount.
-
-6.6:
-
-Changed the code that handles the ".ext3flash" functionality so that it can
-handle booting from either /dev/sda or /dev/sdb.
-Cleanup of the "telnet.htm" management page.
-Unsling now creates the wmtp and utmp files.
-Unsling now "edits" the .../conf/passwd file instead of replacing it.
-Ipkg dependencies fixed so that kernel-modules no longer need "force-install".
-Support for loopback mounting ISO images (loop.o and isofs.o are now created).
-The keyspan.o USB serial kernel-module is also created at build time.
-README file updated to reflect the new unsling script as well as the
-change in preferred port for the primary external disk.
-
-6.7:
-
-Added original "netconsole" code as a kernel module
-Fixed problem with password changing from the GUI and automatic mounting of
-drives and flash devices in port 1.
-Remove unnecessary directory /lib/modules/2.4.22-xfs/pcmcia.
diff --git a/packages/nslu2-binary-only/unslung-rootfs-2.3r63/README b/packages/nslu2-binary-only/unslung-rootfs-2.3r63/README
deleted file mode 100644
index 27dddeafbf..0000000000
--- a/packages/nslu2-binary-only/unslung-rootfs-2.3r63/README
+++ /dev/null
@@ -1,370 +0,0 @@
-Unslung-6.x Family Release README INSTALLATION
-
-You must follow the steps in this README *exactly*. Do not skip any steps, and
-do not skip ahead thinking you know what you are doing and that therefore you
-don't need to follow instructions step by step.
-
-If at any time you have any questions concerning the installation or operation
-of Unslung firmware, your first port of call should be the NSLU2-Linux wiki at:
-
- http://www.nslu2-linux.org
-
-If you are looking for further Unslung notes - including ipkg usage, diversion
-script details, or ChangeLog information, please consult the associated Unslung
-NOTES file.
-
--------------------------------------------------------------------------------
-
-There are three parts to completing the installation of the Unslung firmware:
-
- 1 - PRE-INSTALLATION CONSIDERATIONS
- 2 - FIRMWARE INSTALLATION DETAILS
- 3 - UNSLINGING DETAILS
-
-
-PRE-INSTALLATION CONSIDERATIONS
-
-1) You *must* test telnet Redboot access first before you flash the Unslung
- firmware. Failure to do so will mean you get no sympathy at all if you
- can't access Redboot when you need to recover from a bad flash. See
-
- http://www.nslu2-linux.org/wiki/HowTo/TelnetIntoRedBoot
-
- - Redboot is the bootloader that runs when the device is first started,
- loading things into memory and starting Linux. By testing your
- ability to telnet into Redboot, you are ensuring that if you injure
- your NSLU2 with a bad flash you should be able to follow the "How
- To Recover From A Bad Flash" instructions at
-
- http://www.nslu2-linux.org/wiki/HowTo/RecoverFromABadFlash
-
-2) If you want to install any packages, then you must have an external USB
- disk drive or an external USB flash disk. It is possible to make changes
- to the root filesystem in the internal flash storage, but the space is
- very limited. In fact, just running the "ipkg update" operation on an
- NSLU2 which does not have an external storage device of some sort attached
- will most likely render the NSLU2 unusable due to filling up its internal
- flash memory (if this happens then you will need to follow the recovery
- instructions in the previous step.) So unless you are an expert, use
- an external storage device. The remainder of these instructions assume
- that you have a suitable external disk or flash disk that you will be
- using for this purpose.
-
- A few words on selecting which port to use:
-
- Completely contrary to previous versions of Unslung, the preferred port
- for the Unslung external disk as of Unslung 6.x is often port 2. This
- will free up the far-more-flexible port number 1 for other uses.
-
- However, this "feature" (part of the Linksys R63 firmware) may cause some
- small consternation for users upgrading from earlier versions of Unslung.
- But in general, swapping the drives between the two ports will likely be
- the least painful solution. The basic challenge faced by upgraders is
- that *something* must change: if the drive remains in port 1, then it will
- remain mounted at "/share/hdd/..." but the drive nomenclature will change
- from "/dev/sda" to "/dev/sdb". On the other hand, if the drive is moved
- to port 2, then it will remain "/dev/sda" but it will then be mounted at
- "/share/flash/...". What difference this might make depends on each
- individual configuration; check the wiki for possible assistance for your
- particular configuration.
-
- For new users, the following guidelines can help:
- - if you have only a single drive that will be formatted by the NSLU2,
- use port 2.
- - if you have a single drive that will be formatted by the NSLU2, and
- all other drives or flash devices will be either FAT or NTFS, use
- port 2.
- - if you have two drives, and both will be formatted by the NSLU2, then
- unsling to the drive in port 1.
-
- If you unsling to port 2, and later add a drive in port 1 that will
- be formatted by the NSLU2, it will work as expected -- however, the
- drive to be added MUST be formatted by the unslung NSLU2 in question,
- and once formatted, the drive must NOT be removed. (The Linksys code
- will move it's "conf" datafiles to the drive in port 1 during the
- format operation, and thus will become dependent upon the presence of
- both drives for proper operation.)
-
-3) The external disk that you use as the target for package installation must
- be (or have previously been) formatted by the NSLU2.
-
- Since this point qualifies as a "frequently asked question", it is
- worth some clarification here. It is only possible to unsling to
- a disk that has been formatted by the NSLU2 - you cannot unsling to a
- FAT or NTFS disk. In fact, it is not sufficient to format the disk
- using another UNIX system -- in order to be recognized as a "Formatted
- (ext3)" disk by the NSLU2, and hence be suitable for unslinging, the
- disk must be specifically partitioned, formatted, and the partitions
- must contain a specific set of configuration files created by the
- NSLU2. So the simple rule is that if the NSLU2 web interface "Disk"
- page does not list the disk as "Formatted (ext3)", you will be unable
- to unsling to that disk.
-
- For upgrading users, it is possible to upgrade from all previous Unslung
- versions without reformatting your disk -- but not necessarily recommended.
- See the wiki article for recommended upgrade strategies:
-
- http://www.nslu2-linux.org/wiki/Unslung/UpgradingToUnslung6
-
- The unsling script will not touch anything in /unslung or /opt on your
- disk, so make sure all your file modifications are in those directories,
- as you were warned in the README file in all previous Unslung versions :-)
-
-4) If you want to use a flash disk as the target for package installation,
- ensure that it is at least 256MB, and formatted as above via the
- Linksys web interface.
-
-5) Please verify that any disks you are going to connect to the NSLU2 are
- recognized and working properly *before* updating your firmware (including
- any shares and data you had previously stored.) If not, DO NOT CONTINUE.
- You may want to check out "How To Troubleshoot A Drive Missing Condition"
- at:
-
- http://www.nslu2-linux.org/wiki/HowTo/TroubleshootADriveMissingCondition
-
- - The only exception to this, of course, are those enclosures that the
- stock firmware does not support, but the Unslung firmware does
- support.
-
-6) If you are upgrading your firmware, you should make a configuration backup
- via the Linksys web interface. The configuration backup can be found
- under "Administration", "Advanced", and then "Backup." The top section of
- that webpage is titled "Config Backup" and "Download" should be used to
- save your NSLU2 Users, Groups and Shares setup to a disk file.
-
-
-FIRMWARE INSTALLATION DETAILS
-
-1) Shutdown the NSLU2, and remove any disks that you may have plugged into the
- NSLU2. Power back up the NSLU2.
-
- - Firmware upgrades must always be performed with *no* hard disks or flash
- disks attached. This CANNOT be emphasized enough. Are you sure you
- unplugged the disks before powering up? If so, you may continue.
-
-2) Access the Web interface. Note that you should use the username "admin" and
- password "admin" for the web interface at this point (as no disks are
- attached, the default username and password is the only way to access the
- Management web pages).
-
- 2-a) If you are installin