[oe-commits] org.oe.dev Unslung: Updated README for the 6.10 release.
mwester commit
openembedded-commits at lists.openembedded.org
Mon Dec 31 00:04:07 UTC 2007
Unslung: Updated README for the 6.10 release.
Author: mwester at openembedded.org
Branch: org.openembedded.dev
Revision: f13835dcbbe231c4dc9fc9458bd35cd69768d8ae
ViewMTN: http://monotone.openembedded.org/revision/info/f13835dcbbe231c4dc9fc9458bd35cd69768d8ae
Files:
1
packages/nslu2-binary-only/unslung-rootfs/README
Diffs:
#
# mt diff -r979a55125ead86c89f13880949dfb83dbedac237 -rf13835dcbbe231c4dc9fc9458bd35cd69768d8ae
#
#
#
# patch "packages/nslu2-binary-only/unslung-rootfs/README"
# from [7317daabbdc813eacd82e1fed65976d665bbeb95]
# to [9333318f5c1cdd9d9bf5875ae94c1d975edfc071]
#
============================================================
--- packages/nslu2-binary-only/unslung-rootfs/README 7317daabbdc813eacd82e1fed65976d665bbeb95
+++ packages/nslu2-binary-only/unslung-rootfs/README 9333318f5c1cdd9d9bf5875ae94c1d975edfc071
@@ -1,370 +1,177 @@
-Unslung-6.x Family Release README INSTALLATION
+ Unslung-6.10 README
-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
+ 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.
+Additional information, including ChangeLog information can be found in the
+associated Unslung NOTES file as well as on the NSLU2-Linux wiki.
-------------------------------------------------------------------------------
There are three parts to completing the installation of the Unslung firmware:
- 1 - PRE-INSTALLATION CONSIDERATIONS
- 2 - FIRMWARE INSTALLATION DETAILS
- 3 - UNSLINGING DETAILS
+ 1 - PRE-INSTALLATION CONSIDERATIONS
+ 2 - FIRMWARE INSTALLATION DETAILS
+ 3 - UNSLINGING DETAILS
+1) PRE-INSTALLATION CONSIDERATIONS
-PRE-INSTALLATION CONSIDERATIONS
+a) You *must* confirm that you can enter "upgrade mode" using the Reset Button
+method. This is necessary because once you install Unslung, you will be unable
+to use the web GUI to reflash the device; the Reset Button technique will be
+required to install new firmware, upgrade, or recover from a bad flash:
-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/UseTheResetButtonToEnterUpgradeMode
- http://www.nslu2-linux.org/wiki/HowTo/TelnetIntoRedBoot
+To upload the firmware, use either the Sercomm Update Utility (for Windows
+users) or the UpSlug2 Utility (for Linux and MacOS X users):
- - 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/Main/SercommFirmwareUpdater
+ http://www.nslu2-linux.org/wiki/Main/UpSlug2
+ http://www.nslu2-linux.org/wiki/Main/UpSlug2onOSX
- http://www.nslu2-linux.org/wiki/HowTo/RecoverFromABadFlash
+b) You must have an external USB disk drive or an external USB flash device.
+There are a number of considerations to take into account in selecting the size
+and type of external device as well as which of the two USB ports to use:
-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.
+ http://www.nslu2-linux.org/wiki/Unslung/StorageBasics
+ http://www.nslu2-linux.org/wiki/Unslung/WhichUSBPortforUnslung6
- A few words on selecting which port to use:
+It is important to make sure that the device you intend to use is functional
+with the standard Linksys firmware before you attempt to use it with Unslung.
- 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.
+c) Review any known issues and errata:
- 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.
+ http://www.nslu2-linux.org/wiki/Unslung/KnownProblems
- 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.
+(Hint: read the wiki pages carefully to determine the firmware release to which
+they apply; many of the pages contain information pertaining to older versions
+of Unslung, or even to other firmware entirely.)
- 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.)
+2) FIRMWARE INSTALLATION DETAILS
-3) The external disk that you use as the target for package installation must
- be (or have previously been) formatted by the NSLU2.
+The installation process is simple, but each step is important. The most
+common problems reported are a result of skipping one of the steps in this
+process, so be careful. In particular, having a disk or flash device plugged
+in when it shouldn't be can mean the difference between success and failure.
- 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.
+a) Preparation
- 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:
+- Install either the Sercomm (Windows) or the UpSlug2 (Linux and MacOS X)
+ utilities on the system you'll be using to upload the firmware.
- http://www.nslu2-linux.org/wiki/Unslung/UpgradingToUnslung6
+- Access the Linksys web GUI, and record your network settings.
- 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 :-)
+- Shutdown the NSLU2 and unplug all USB cables and devices.
-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.
+b) Flashing the New Firmware
-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:
+- Enter upgrade mode, using the Reset Button technique.
- http://www.nslu2-linux.org/wiki/HowTo/TroubleshootADriveMissingCondition
+- Use either the Sercomm or UpSlug2 Utility to upload the new firmware.
- - The only exception to this, of course, are those enclosures that the
- stock firmware does not support, but the Unslung firmware does
- support.
+c) Verifying the New Firmware
-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.
+- The NSLU2 will restart itself after the firmware in installed.
+- Access the Linksys web GUI. The new firmware version will be displayed on
+ the "Home" screen.
-FIRMWARE INSTALLATION DETAILS
+3) 'UNSLINGING' DETAILS
-1) Shutdown the NSLU2, and remove any disks that you may have plugged into the
- NSLU2. Power back up the NSLU2.
+"Unslinging" is the process of copying the firmware to an external disk, and
+configuring that external disk for installation of packages. In order to
+perform this operation, you need to log in to the NSLU2 using telnet, and you
+need a suitable external disk or flash device.
- - 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.
+This procedure is made a bit more complicated because the behavior of the NSLU2
+can change depending on the presence of an external disk. Specifically, when
+an external storage device is plugged in, the NSLU2 will switch over to using
+the passwords and configuration information stored on that external disk, if
+possible. Since we don't know the root password originally written to that
+device, you must be very careful to perform the following steps in precisely
+the specified order, or you'll lock yourself out of your own device.
-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).
+a) Gain Telnet Access
- 2-a) If you are installing Unslung 6.x onto an NSLU2 unit with Linksys
- standard firmware already installed, flash unslung-6.x.bin as you
- normally would flash new firmware (using the web interface
- "Upgrade Firmware" page). See your NSLU2 user manual for details
- if you don't know how to do this.
+- Power up the NSLU2 without any disks connected.
- - During firmware flashing, the top LED - Ready/Status - flashes
- red and green (approximately 5 minutes, but can be much longer).
+- Enable telnet by going to the NSLU2's web GUI and clicking on the "Manage
+ Telnet" link (right-hand side), then on the "Enable" button to turn on the
+ telnet service.
- - The NSLU2 will reboot after the flashing is complete.
+- Use your telnet utility to telnet into the NSLU2, and log in using the
+ username root and password uNSLUng (upper/lower case is significant).
- 2-b) If you are installing Unslung 6.x onto an NSLU2 unit with an
- existing version of nslu2-linux.org firmware already installed,
- you must first put the NSLU2 into RedBoot Upgrade Mode.
+- Do not logout before you go to the next step, or you'll have to start this
+ step over again.
- - The NSLU2 should still be powered off at this point. If not,
- shut it down again before proceeding.
+b) Gain Access to the External Storage
- - Using a paper clip, push and hold in the reset button which is
- located on the back of the NSLU2 near the power socket.
+- Identify the drive or flash device to which you will be unslinging, and plug
+ it in to the desired USB port.
- - While holding in the reset button, press and release the power
- button.
+- Wait for a minute or two while the disk is mounted.
- - Watch the Ready/Status LED, and as soon as it turns red quickly
- release the reset button.
+- Check the web GUI to make sure that the disk has been recognized by the
+ Linksys software
- - You should now be in upgrade mode which is indicated by the
- Ready/Status LED alternating between red and green.
+- If the disk has not been previously formatted on the NSLU2, then now is the
+ time to do that.
- - Use either the Linux UpSlug2 tool or the Windows SerComm Upgrade
- tool to upload the new firmware - you can find download links at
- http://www.nslu2-linux.org/wiki/HowTo/InstallUnslungFirmware
+- Be patient - it might take several minutes for the NSLU2 to recognize the
+ hardware, mount the partitions, and verify that the drive is correctly
+ configured to be considered "Formatted".
- - During firmware flashing, the top LED - Ready/Status - flashes
- red and green (approximately 5 minutes, but can be much longer).
+- Do not continue if the drive is not marked as "Formatted (ext3)" in the
+ NSLU2 web GUI.
- - The NSLU2 will reboot after the flashing is complete.
+c) Unsling
-3) Shutdown the NSLU2 (again), attach disk(s), and power it back up.
+- In the telnet session, run "unsling disk2" if your device is on the USB port
+ labeled "DISK 2", or "unsling disk1" if it's on the port marked "DISK 1".
-4) Verify your NSLU2 is working normally again at this point in the web
- interface. In particular, you should ensure that all your disks are still
- recognized as they were before you updated the 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:
+- When prompted, enter a new root password - this password will replace the
+ uNSLUng password.
- http://www.nslu2-linux.org/wiki/HowTo/TroubleshootADriveMissingCondition
+- When the unsling is complete, reboot the NSLU2.
- - If you are not "unslinging", you can stop at this point. *HOWEVER!*,
- the only reason for not unslinging would be in the case of a re-flash
- of the SAME firmware. Even if this is a point firmware upgrade, you
- will need to unsling.
+d) Confirm That Your NSLU2 is Unslung:
- ***** If you do not choose to do the unslinging procedure described below,
- DO NOT install packages unless you are SURE you know what you are
- doing! "Bricking" your NSLU2 by not un%s
>>> DIFF TRUNCATED @ 16K
More information about the Openembedded-commits
mailing list