Difference between revisions of "Install Debian 5.0 (Lenny) On Buffalo Linkstation Mini"

Revision as of 19:29, 17 July 2010

WARNING! There is a possibility that you could brick your NAS with these instructions. Please make sure that you read the entire page carefully. These instructions may void your warranty. Proceed at your own risk.

Linkstation Mini

Prerequisites

1. Buffalo LinkStation Mini running stock firmware
   • If your device has already been modified to run another operating system and/or firmware, you can revert to stock firmware
   • This process was tested with model LS-WS1.0TGL/R1, but other models may work as well
2. Ubuntu 10.04 Desktop Edition CD-ROM (download and burn this ISO file)
3. Computer which can boot the Ubuntu 10.04 Desktop Edition CD-ROM and access the network successfully (most modern computers meet this requirement)

Overview

1. Use ACP Commander to establish Telnet session with device
2. Uncouple secondary drive partitions from existing RAID configuration
3. Partition and format secondary drive, install Debian 5.0, and prepare for initial boot
4. Reboot device, establish SSH session with device, and complete installation

Procedure

Note: Do not attempt to execute the following commands as a single script Instead, copy and paste each block of commands into a shell window and monitor the resulting output for errors

Prepare Device

1. Disconnect power cable from device
2. Move device switch to "on" position
3. Attach device to network
4. Connect power cable to device
5. Wait for device to finish booting (no blinking lights)
6. Open device web interface (factory default address is http://192.168.11.150, or use the IP address assigned by DHCP)
7. Login (user = admin, password = password)

WARNING! The next step will erase all data on your Linkstation Mini. It is recommended that you backup your existing data. Proceed at your own risk.




8. Remove existing RAID configuration (Disk Management | RAID Setup | RAID Array 1 | Change RAID Array ...)
9. Create new RAID1 (mirroring) array (Disk Management | RAID Setup | RAID Array 1 | RAID Mode: RAID1 ...)
10. Wait for "Building RAID Array" to complete

You may proceed immediately after the array has been built (you do not need to wait for the drive check to complete)'

11. Boot Ubuntu 10.04 Desktop Edition CD-ROM on computer
12. Select language as desired (English)
13. Click on "Try Ubuntu 10.04 LTS" (to use Ubuntu without making any changes to your system)
14. Open a new terminal window (Applications | Accessories | Terminal )
15. Start a new bash shell with root privileges

    sudo bash
    

16. Install OpenJDK (for running ACP Commander software)

     apt-get update
     apt-get -q -y install openjdk-6-jre
    

17. Download ACP Commander software (acp_commander.jar)

     wget http://downloads.nas-central.org/TOOLS/ALL_LS_KB_ARM9/ACP_COMMANDER/acp_commander.jar
    

18. Determine IP address of device and assign it to environment variable (substitute appropriate IP address)

     export IP_ADDRESS=192.168.11.150
    

19. Instruct device to enable Telnet and remove root password

     java -jar acp_commander.jar -t ${IP_ADDRESS} -o
    

20. Establish Telnet session with device

     telnet ${IP_ADDRESS}
    

21. Login as root (no password required)
22. Set recent date and time (prevent error messages about file dates, format=MMDDhhnnYYYY)

     date 071720032010
    

23. Kill all unnecessary processes

     kill -9 $(ps | grep -vE '\[.*\]|(init)|(syslogd)|(klogd)|(getty)|(telnetd)|(-sh)|(ps)|(VmSize)|(grep)|(kill)|(awk)' | awk '{print $1}')
    

WARNING! Your device will no longer boot after the next step. You must complete all of the steps in this entire section before your device will boot again.




24. Free secondary drive (/dev/sdb) partitions from RAID configuration

     mdadm --manage /dev/md0  --fail /dev/sdb1
     mdadm --manage /dev/md1  --fail /dev/sdb2
     mdadm --manage /dev/md10 --fail /dev/sdb5
     mdadm --manage /dev/md2  --fail /dev/sdb6
    
     mdadm --manage /dev/md0  --remove /dev/sdb1
     mdadm --manage /dev/md1  --remove /dev/sdb2
     mdadm --manage /dev/md10 --remove /dev/sdb5
     mdadm --manage /dev/md2  --remove /dev/sdb6
    

25. Make sure secondary drive is not in use

     if hdparm -z /dev/sdb ; then echo; echo "SECONDARY DRIVE READY (/dev/sdb)"; echo; else grep sdb /proc/mounts /proc/mdstat; echo "Please check that /dev/sdb is not in use"; fi;
    

The following commands will delete all existing partitions on the secondary drive and reconfigure it as follows...

Partition	Mount	Size	Type	Description
1	/boot	128MB	fd	linux raid autodetect
2	swap	256MB	82	linux swap
3	/ (root)	12GB	fd	linux raid autodetect
4	/srv	100%	fd	linux raid autodetect

26. Repartition secondary drive (substitute partition sizes as desired)

     PARTITION1_SIZE=128MB
     PARTITION2_SIZE=256MB
     PARTITION3_SIZE=12GB
     echo -e "d\n1\nd\n2\nd\n3\nd\n4\nn\np\n1\n\n+${PARTITION1_SIZE}\nn\np\n2\n\n+${PARTITION2_SIZE}\nn\np\n3\n\n+${PARTITION3_SIZE}\nn\np\n\n\nt\n1\nfd\nt\n2\n82\nt\n3\nfd\nt\n4\nfd\nw\n" | fdisk /dev/sdb
    

27. Create and activate swap partition

     mkswap /dev/sdb2
     swapon /dev/sdb2
    

28. Create RAID volumes

     echo "y" | mdadm --create --verbose /dev/md11 --level=1 --raid-devices=2 missing /dev/sdb1
     echo "y" | mdadm --create --verbose /dev/md13 --level=1 --raid-devices=2 missing /dev/sdb3
     echo "y" | mdadm --create --verbose /dev/md14 --level=1 --raid-devices=2 missing /dev/sdb4
    

29. Format RAID volumes

     mkfs.ext3 -F /dev/md11
     mkfs.ext3 -F /dev/md13
     mkfs.ext3 -F /dev/md14
    

30. Mount RAID volumes

     mkdir -p                /mnt/lsmini
     mount -t ext3 /dev/md13 /mnt/lsmini
     mkdir -p                /mnt/lsmini/boot
     mount -t ext3 /dev/md11 /mnt/lsmini/boot
     mkdir -p                /mnt/lsmini/srv
     mount -t ext3 /dev/md14 /mnt/lsmini/srv
    

    
    

    Install Debian System

31. Install root filesystem (from archive of debootstrap stage 2 files)

     cd /mnt/lsmini
     wget http://downloads.buffalo.nas-central.org/Users/rpinchbeck/lsmini/debian/5.0/bootstrap-debian-5.0.5-armel-stage2.tar.gz
     tar --extract --verbose --same-permissions --gzip --file /mnt/lsmini/bootstrap-debian-5.0.5-armel-stage2.tar.gz
    

32. Install custom kernel (Debian 5.0 backported kernel 2.6.32-15)

     cd /mnt/lsmini
     wget http://downloads.buffalo.nas-central.org/Users/rpinchbeck/lsmini/debian/5.0/kernel-2.6.32-15-debian-lsmini.tar.gz
     tar --extract --verbose --same-permissions --gzip --file kernel-2.6.32-15-debian-lsmini.tar.gz
    

33. Install custom boot loader (force boot from /dev/md13)

     cd /mnt/lsmini
     wget http://downloads.buffalo.nas-central.org/Users/rpinchbeck/lsmini/initrd-md13-armv5tejl-softfloat-1.0.tar.gz
     tar --extract --verbose --same-permissions --gzip --file /mnt/lsmini/initrd-md13-armv5tejl-softfloat-1.0.tar.gz
    

34. Prepare host settings (adjust host name and IP addresses as needed)

     export HOST_NAME=lsmini
     export HOST_ADDRESS=192.168.1.77
     export HOST_NETMASK=255.255.0.0
     export HOST_GATEWAY=192.168.1.1
    

35. Configure network interface (/etc/network/interfaces)

     echo "# Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or"  >/mnt/lsmini/etc/network/interfaces
     echo "# /usr/share/doc/ifupdown/examples for more information."          >>/mnt/lsmini/etc/network/interfaces
     echo "#"                        >>/mnt/lsmini/etc/network/interfaces
     echo "auto lo eth0"             >>/mnt/lsmini/etc/network/interfaces
     echo "iface lo inet loopback"   >>/mnt/lsmini/etc/network/interfaces
     echo "iface eth0 inet static"   >>/mnt/lsmini/etc/network/interfaces
     echo " address ${HOST_ADDRESS}" >>/mnt/lsmini/etc/network/interfaces
     echo " netmask ${HOST_NETMASK}" >>/mnt/lsmini/etc/network/interfaces
     echo " gateway ${HOST_GATEWAY}" >>/mnt/lsmini/etc/network/interfaces
    

36. Configure host name (/etc/hostname)

     echo "${HOST_NAME}" >/mnt/lsmini/etc/hostname
    

37. Configure mapping from address to host name (/etc/hosts)

     echo "127.0.0.1 localhost"           >/mnt/lsmini/etc/hosts
     echo "${HOST_ADDRESS} ${HOST_NAME}" >>/mnt/lsmini/etc/hosts
    

38. Configure mount points (/etc/fstab) WARNING: Do not modify the last column... any value other than zero will cause the device to hang (at the console) on disk errors. Don't find out the hard way.

     echo "/dev/sdb2   none      swap   sw,pri=1                     0  0"  >/mnt/lsmini/etc/fstab
     echo "/dev/md13   /         ext3   noatime,errors=remount-ro    0  0" >>/mnt/lsmini/etc/fstab
     echo "/dev/md11   /boot     ext3   noatime,errors=remount-ro    0  0" >>/mnt/lsmini/etc/fstab
     echo "/dev/md14   /srv      ext3   noatime,errors=remount-ro    0  0" >>/mnt/lsmini/etc/fstab
     echo "shm         /dev/shm  tmpfs  noatime,nodev,nosuid,noexec  0  0" >>/mnt/lsmini/etc/fstab
    

39. Configure network name resolution (/etc/resolv.conf)

     cp -a /etc/resolv.conf /mnt/lsmini/etc/resolv.conf
    

40. Change root password (new password = lsmini)

     export SED_FILE='/mnt/lsmini/etc/shadow'
     export SED_SEARCH='^\s*root\:\*?\:'
     export SED_REPLACE='root:$6$bmlbpJYn$xAgZr6KxoRLjDcPZNDBcnMF52gZrU7xkib43LhSlAvzVS4OqmiHaxB0GInPtoaPQ2FguHQQuxM95cMfvUnYn31:'
     sed -r "s/${SED_SEARCH}/${SED_REPLACE}/" -i ${SED_FILE}
    

41. Prepare for reboot (Overwrite factory installed boot files with custom ones)

     cd /mnt/lsmini
     rm -rf /boot/*
     cp -a /mnt/lsmini/boot/* /boot/
    

42. Wait for RAID synchronization to complete

     while egrep -iq '(recovery)|(resync)' /proc/mdstat; do
         clear
         cat /proc/mdstat
         sleep 5
     done
     clear
     cat /proc/mdstat
     sync
    

43. Unmount RAID volumes

     sync
     cd /mnt
     umount /mnt/lsmini/boot
     umount /mnt/lsmini/srv
     umount /mnt/lsmini
    

44. Reboot device

     reboot; logout
    

    
    

    Configure Debian System

45. Wait for device to finish booting (no blinking lights)
46. Assign new IP address to environment variable

     export IP_ADDRESS=192.168.1.77
    

47. Use SSH to login as root (password = lsmini)

     ssh root@${IP_ADDRESS}
    

48. Change root password to something hard to guess

     passwd root
    

49. Configure package sources (/etc/apt/sources.list)

     echo "deb     http://ftp.debian.org      lenny         main contrib"  >/etc/apt/sources.list
     echo "deb-src http://ftp.debian.org      lenny         main contrib" >>/etc/apt/sources.list
     echo "deb     http://security.debian.org lenny/updates main contrib" >>/etc/apt/sources.list
     echo "deb-src http://security.debian.org lenny/updates main contrib" >>/etc/apt/sources.list
    

50. Update package lists

     apt-get update
    

51. Select timezone

     dpkg-reconfigure tzdata
    

52. Ensure that date and time are correct

     date
    

53. Make sure primary drive is not in use (/dev/sda)

     if hdparm -z /dev/sda ; then echo; echo "PRIMARY DRIVE READY (/dev/sda)"; echo; else grep sda /proc/mounts /proc/mdstat; echo "Please check that /dev/sda is not in use"; fi;
    

54. Repartition primary drive (must have same partition sizes as secondary drive)

     PARTITION1_SIZE=128MB
     PARTITION2_SIZE=256MB
     PARTITION3_SIZE=12GB
     echo -e "d\n1\nd\n2\nd\n3\nd\n4\nn\np\n1\n\n+${PARTITION1_SIZE}\nn\np\n2\n\n+${PARTITION2_SIZE}\nn\np\n3\n\n+${PARTITION3_SIZE}\nn\np\n\n\nt\n1\nfd\nt\n2\n82\nt\n3\nfd\nt\n4\nfd\nw\n" | fdisk /dev/sda
    

55. Format and activate swap partition on primary drive

     mkswap /dev/sda2
     swapon /dev/sda2
    

56. Automatically mount swap partition at boot

     echo  "/dev/sda2   none      swap   sw,pri=2                     0  0"  >>/etc/fstab
    

57. Add primary drive partitions to RAID volumes (/dev/md11, /dev/md13, and /dev/md14)

     echo "y" | mdadm --manage /dev/md11 --add /dev/sda1
     echo "y" | mdadm --manage /dev/md13 --add /dev/sda3
     echo "y" | mdadm --manage /dev/md14 --add /dev/sda4
    

58. Add user (never login as root again, use sudo command instead)

     export USER_NAME=visitor
     adduser ${USER_NAME}
    

59. Allow user to become super user (using sudo command)

     echo "${USER_NAME}    ALL=(ALL) ALL" >>/etc/sudoers
    

60. Wait for RAID synchronization to complete

     while egrep -iq '(recovery)|(resync)' /proc/mdstat; do
         clear
         cat /proc/mdstat
         sleep 5
     done
     clear
     cat /proc/mdstat
     sync
    

61. Restart device

     reboot; logout;
    

    Congratulations! You should now have a working Debian 5.0 server running on a Buffalo Linkstation Mini.

See Also

• Revert Buffalo Linkstation Mini To Stock Firmware
• Install Ubuntu 9.04 On Linkstation Mini
• Install Gentoo On Linkstation Mini
• GenLink for ARM9

References

• Debian website
• Installing new Debian systems using debootstrap
• Custom initrd which boots from /dev/md13