===== Install Debian Sarge - by Mike Gore =====
**Please feel free to update, cleanup or correct this page**

**What is this?** 
  This document shows how to setup Debian on the DNS-323.

Note: this technique installs a Debian environment into the existing system, and does not require you to reflash or hack the NAS.

==== 1. prerequisites =====

You should already have [[Telnet]] access to your device.

Or better, install ssh and disable Telnet.  See:

http://www.penoycentral.net/linuxnix/configuring-ssh-and-rsync-in-dlink-dns-323/

==== 2. base system ====

You have two options to proceed. You can either download a preconfigured image or create your own.

=== 2A. download a minimal image ===

  * Debian Sarge 3.1 - [http://wopr.levring.nu/sarge.tar] (83Mb) 
  * Debian Etch 4.0 - [http://dev.skcserver.de/dns323/etch.tar] (169 Mb) 
  * Debian Etch 4.0 (U.S. mirror) - [http://www.bfaber.com/dl/etch.tar]

If you wish to use one of these, simply download it and proceed to step 3 below.

=== 2B. create a minimal image ===
** You will need a Debian Linux x86** system to create the install image. 
(My system is a Ubuntu Dapper x86 system)

Make sure you have **cdebootstrap smbfs** installed 
<code bash>
apt-get install cdebootstrap smbfs
</code>

**Note - I called my DNS-323 "disk"**

We will now mount the DNS-323 on the host Debian system. Your system has to be formatted with an admin password. I will use **disk** for the DNS-323 and **/mnt** for the mount points in this document - you can use whatever you like.

<code bash>
mount -t cifs  //disk/Volume_1 /mnt -o username=admin
</code>
**Or** use the IP address of the DNS-323
<code bash>
mount -t cifs  //10.0.0.1/Volume_1 /mnt -o username=admin
</code>

We will now "bootstrap" an ARM debian system using our x86 debian system
**note it will error out at the final install phase - this is just fine**
This process will create an ARM debian environment under a directory called **sarge**
<code bash>
cdebootstrap -aarm sarge sarge ftp://ftp.debian.org/debian
</code>
For the current stable (**etch**) you should use the following
When you use this line, you should replace all "sarge" texts with "**etch**".
<code bash>
cdebootstrap -aarm etch etch ftp://ftp.debian.org/debian
</code>

*update by Explisit (22rd Feb 08) - Etch source for arm architecture are not available from ftp://ftp.debian.org/debian try different mirror for instance ftp://ftp.bg.debian.org/debian

Archive the **sarge** directory we created with the bootstrap
<code bash>
tar cf sarge.tar sarge
</code>

Copy this tar file to **/mnt<del>/HD_a2</del>** (Update 20 jan 2008, Stefan: The /HD_a2 is not needed because we mounted /Volume_1 in /mnt)
<code bash>
cp sarge.tar /mnt
</code>

==== 3. finalizing installation ====

*update by Berry (26th March 08) - If you have firmware 1.04 then make sure to turn off Oplocks now on the web interface before you untar (Advanced / Network access)

# On the host x86 system reboot the DNS-323 using the web interface

# Telnet or ssh to the DNS-323
telnet disk

**Note We are now logged into the DNS-323**

# CD to the hard disk we just copied everything to
<code bash>
cd /mnt/HD_a2
</code>

# At this point, you should untar the {sarge,etch}.tar file that you made above
<code bash>
./lnx_bin/busybox3 tar -xf sarge.tar
</code>

Or for firmware 1.04:
<code bash>
tar -xf sarge.tar
</code>

# Replace sarge.tar with etch.tar above if you built an etch install

# chroot into the partly bootstrapped sarge debian root
<code bash>
./lnx_bin/busybox3 chroot sarge /bin/bash
</code>

Or for firmware 1.04:
<code bash>
chroot sarge /bin/bash
</code>

# At this point you should have a shell in the new debian root

# Fix the broken packages caused by the failed cdebootstrap - above
** Note - 08 dec 2007 by Chris - I think before proceeding you want to be sure that /proc, /dev, and friends all contain 
 something reasonable - for example as set up by the mount commands in the fun_plug listed at the bottom of this page.
 Some of the installers seem to get confused when they can't find fstab, /dev, etc. **

*update by Richard (23rd Dec 07) I think Chris (above) is right, go through the fun_plug and type in the commands by hand. Also, do dpkg*deb first (below), then libc6.

*update by Paul (18 Apr 08) This all seems much simpler with 1.04.  no need to do any of those things afaict.
<code bash>
cd /var/cache/bootstrap
dpkg --force-all -i libc6*deb
dpkg --force-all -i dpkg*deb
dpkg --force-all -i libc6*deb
</code>
# repeat next step several times until no more errors\\
(if you are using the downloaded sarge package the .deb files are located in "/var/cache/apt/archives" not in "/var/cache/bootstrap"!)\\
<code>
dpkg -iGREB . 
</code>
# check remaining dpkg errors if any

#



*update by Richard (23rd Dec 07) I had to delete /var/mail to get base_files to install properly

*update by Michael (20th June 08) I had to delete /var/mail in sarge.  etch was fine.





==== customizing ====

# Edit your /etc/resolv.conf so that the system can find the Debian servers: See this [[howto:chroot_debian:resolv.conf|sample]]

# Edit your /etc/apt/sources.list so that includes some servers.  For instance:
<code>
deb http://ftp1.ca.debian.org/debian stable main contrib non-free
deb http://security.debian.org stable/updates main contrib non-free
</code>

# Update packages
<code bash>
apt-get install debian-archive-keyring
apt-get update
apt-get dist-upgrade
</code>


# make root password
<code bash>
passwd root
</code>

# Go nuts installing packages
<code bash>
apt-get install gcc
apt-get install make
apt-get install unzip
apt-get install flex bison
apt-get install g++
</code>
# etc ....



===Create a **fun_plug** script===

If you would like Debian to automatically begin after it is installed, you will need to add some commands to your startup (fun_plug) script.

[[.:chroot_debian:fun_plug|Download the Debian Fun Plug Script here]]

Copy this fun_plug to /mnt  **we assume you still have the DNS-323 mounted**
On the DNS-323
<code bash>
cd /mnt/HD_a2
chmod 755 fun_plug
</code>

Create a **linuxrc** script
[[.:chroot_debian:linuxrc|Download the Debian linuxrc Script here]]

Copy this linuxrc to /mnt  (we assume you still have the DNS-323 mounted*
On the DNS-323
<code bash>
cd /mnt/HD_a2/sarge
chmod 755 linuxrc
</code>
# Note: be sure to install both the linuxrc script *and* the fun_plug script before rebooting!

** Reboot the DNS-323 and test **

=== Manual chroot to a Debian etch when using fonz funplug ===

To do a manual chroot to a "fresh" extracted Debian etch,
use the following command:

<code bash>
env -i TERM=vt102 USER=root $SBINDIR/chroot /mnt/HD_a2/etch /bin/bash -ls
</code>

(Try this if you get errors such as "sh: /mnt/HD_a2/fun_plug.d/bin/ls: No such file or directory" or 
"dpkg - error: PATH is not set")

If there are still issues like "dpkg - error: PATH is not set" export PATH into your chrooted system. First change to a bash shell of your etch/sarge by typing the previous command. The use export PATH:

<code bash>
env -i TERM=vt102 USER=root $SBINDIR/chroot /mnt/HD_a2/etch /bin/bash -ls
etch /> export PATH
</code>


[[howto:crosscompile|Cross Compile Software for the DNS-323]]