Related posts:

• Twitter Updates for 2012-01-10
• Twitter Updates for 2012-01-08
• Twitter Weekly Updates for 2011-08-14
• Twitter Weekly Updates for 2011-05-15
• Twitter Weekly Updates for 2011-06-19

Fun_plug allows the user to start additional programs and tools on the NAS. A Berlin-based developer named “Fonz” created a package called “ffp” (Fonz fun_plug), which includes the script and some extra software which can be invoked by fun_plug.

Installation of fun_plug is easy and takes only a few steps. These steps should be performed carefully, as they depend on typed commands and running with “root” privileges.

Contents

• Purpose, risks, and benefits
  • Responsibility
  • Benefits
  • Technical synopsis
• Steps for installing fun_plug
  • Download
  • Option: view the fun_plug script
  • Reboot
  • Option: view ffp.log
  • Connect via telnet
  • Change root password
  • Activate SSH
  • Logging in using SSH
  • Now what?
• Notes
  • Fun_plug and user accounts

Purpose, risks, and benefits

Fun_plug is essentially a technique to stepwise turn a NAS with fixed out-of-the-box functionality into an open Linux machine on which you can install additional software packages and, if you want, learn a bit about Linux.

Responsibility

This also implies that you are (temporarily or permanently) turning a stable turnkey system into a system that the respective vendors no longer supports. This is similar to buying a notebook with Microsoft software, and installing Linux on it. The shop where you bought it can no longer help you if you claim the audio no longer works. Although there is a Tutorial on how to disable and even remove fun_plug, and although the authors have tested their recipes, checked the wording and added warnings, these are advanced tools which can, if you experiment more than your own know-how can handle, give advanced problems.

Risks involved in all this are not so much damaging your hardware (shouldn’t be possible), but loss of reliability of the NAS (you bought a file server to reliably store files, didn’t you). This risk may be acceptable because the software was preintegrated and tested by competent people. But you yourself are, at the end of the day, responsible for deciding to use this.

Possibly a less obvious, but more real risk is that some kind of extensions to the NAS (e.g. adding a server) imply that you may decide to open your local network a bit to the outside world. For example, to allow others to view your holiday videos stored on the device. The out-of-the-box NAS can already have this problem (via the ftp server). The point here is that you are responsible for the security of your device and entire network. This site doesn’t even have tutorials on basic security issues like firewalls, etc. because these are all NAS independent and the tutorials would never be foolproof anyway. So when used wrongly, the NAS and firewall obviously do allow others to read more data than you intended. Or to delete your valuable data. Or to replace software by other software (chance is small, but the impact is high).

Conclusion: as the NAS is a powerful networked device, and as these tutorials can help you make it even more powerful, you are responsibility for having the basic understanding of networked security. Again, this also applies to an out-of-the-box NAS. But the more you mess with it, the more you need to apply some common sense. This is incidentally the reason why we provide some explanation on what you are doing in the tutorials, rather than just telling you what to type

Benefits

The main reason why people go this route is to extend their NAS with servers such as BitTorrent clients or Web servers. Other typical uses are to add extensions which fix current limitations of the device (e.g. time accuracy, fan noise).

Technical synopsis

In a first step, we install a script named fun_plug that provides a hook to extend the boot process of Linux on the NAS. That hook was intentionally added by the vendor to enable this. But the vendors do not document or support all of this.

An initial set of packages (downloaded as a single compressed archive) gives you enough tools to get started and, if you are curious about the machine or its software, to carefully look around.

This set of tools gives you the ability to install even more software packages (typically servers) from trusted sources. These packages should obviously all have been compiled for the processor in the NAS and should have been tested on the device (or a very similar device) by a software expert.

Steps for installing fun_plug

Preparation

The NAS needs to have a valid network configuration. Check the gateway & dns-servers to be valid. If the NAS receives the network configuration via DHCP it should be correct in most cases. If you receive the error “wget:bad address `wolf-u.li`” (or similar / other domains) the configuration needs to be checked.

Determination of the correct fun_plug

Fonz has decided to build to version of the fun_plug for different devices. The Types are “EABI” and “OABI” which you can determine by clicking on the description of your device here. Then search for “Application binary interface” in the details.

Download

Download the latest files:

• fun_plug
• fun_plug.tgz
  • Version “ARM” for EABI-devices (like the DNS-320/325/345 and CH3MNAS)
  • Version “OARM” for OABI-devices (like the DNS-323 and CH3SNAS)

Place both files in the topmost directory of Volume_1 of your NAS. If you use Windows Explorer it could look like this or this or similar.

Option: view the fun_plug script

For fun, you may want to open the file fun_plug by left-clicking here. Alternatively you can open it in Windows’ Wordpad or, better, Notepad++ under Windows. Please be careful not to accidentally modify it. Avoid using Windows’ Notepad for viewing/editing Linux text files: Windows and Linux use different end-of-line conventions.

The script fun_plug is an ASCII file with commands which are executed by the Linux command interpreter (sh for “shell”).

Lines starting with “#” are comments (“#!/bin/sh” is a special case).

You might be able to decode that the program creates a log file called ffp.log (an ASCII file used here to capture the lines which start with “echo”).

Firstly, a number of named constants are defined for various file names and fragments of file names (the lines like “FFP_SOMETHING=...“).

You can see that Fonz developed it for a D-Link DNS-323 (rather than a Conceptronic CH3SNAS, but this doesn’t matter as Uli, PeterH and others have tested in on the CH3SNAS).

The command date will copy the current date and time to the log file.

Next, a first script setup.sh is run if it is found in the expected /mnt/HD_a2/.bootstrap/ folder. Initially it will not be found.

Then a new directory “ffp” is created (mkdir) and the fun_plug.tgz file is unpacked (tar) into that directory. This step is a bit more complex than normal due to a problem with the tar version supplied with the NAS. As a workaround tar is run twice (first the older version, and then the tar version which was untarred from fun_plug.tgz).

If all went well, the log file gets an extra “OK” string. And the tarball input file is deleted (rm). This obviously only happens once (the script skips the unpacking if the tarball file is not found using the if [condition]; commands fi construct).

The “chown” is about changing ownership for a program called busybox. And “chmod” is about changing access privileges.

Then, a script file /ffp/etc/fun_plug.init (“containing the ffp-scripts package”) is executed if it is detected.

Next, a script file /ffp/etc/fun_plug.local is executed if it is detected. It can be used to add your own startup commands: it will not be overwritten by package updates.

Finally, a script file /ffp/etc/rc is run if it exists.

Reboot

Reboot the NAS by holding down the power button 5 seconds or via the web interface (Mostly ”Tools” -> ”System” -> ”Reboot” or similar somewhere in the menu of the webinterface). This causes the NAS to go and find the file fun_plug on Volume_1 and execute it.

Option: view ffp.log

If you are interested, you will find that the fun_plug.tgz tarball has disapeared, and has been unpacked into the newly created ffp directory.

You will also find the ffp.log file created during execution of the fun_plug script and while executing some of its commands. It is longish (e.g. 47 KBytes) because the tar program generates a lot of warnings about repairing links (this only happens once). You can view the log file with WordPad or NotePad++.

From now on, whenever the NAS is rebooted and thus the fun_plug script is re-executed, the script appends about 15 extra text lines to the end of this log file. These contain the date/time of reboot and the status of various servers which you may enable in the future (see below). This appending of information to ffp.log gives you one way to determine whether fun_plug is really running: if you last reboot of the NAS is listed, fun_plug and any servers that it actives are running.

Note that the end of the initial log file already states that a server called telnetd is already running. We will use Telnet in the next step.

Connect via telnet

Telnet Session

Windows users can use an open-source telnet client called PuTTY. PuTTY is a self-contained program: the PuTTY.exe file can be stored wherever convenient and executed without any prior installation. In the PuTTY configuration screen you need to set the following before pressing Open:

• Host name (or IP address): use the name of the share (e.g. CH3SNAS) or its IP address
• Select Connection type “Telnet” (which defaults to port 23)

Now you can press Open (PuTTY can save these settings under a default or name if you want, but you will likely be using ssh instead of telnet later on). In PuTTY these setting could look like this:

Linux users are “supposed to be” familiar with how to use telnet.

After connecting to the device, the first line telnet will show:

/ #

Or

sh-4.1#

If this doesn’t show up, type “5784468″ to get this prompt.

If you can see the prompt, you are logged in. This command “prompt” is where you can type in commands. The prompt shows you are in the root directory. Note that Linux command lines are not very communicative. These Rambo-like social skills are generally attributed to Linux’ resource-deprived childhood.

Change root password

We proceed with updating /etc/shadow by using the program pwconv. It uses /etc/passwd to generate the necessary lines in the shadow-file. Also the default shell will be changed. Additionally the home-directory of root is changed to a permanent one:

usermod -s /ffp/bin/sh root
mkdir -p /ffp/home/root/
sed -ie 's#:/home/root:#:/ffp/home/root:#g' /etc/passwd
pwconv

This could look like this:

Hints:

• If the following error comes up when using “usermod”: "usermod: no changes", just ignore it. In this case the shell is already set to the correct one.
• If the following error comes up when using “pwconv”: "pwconv: failed to change the mode of /etc/passwd- to 0600" just ignore it and proceed.

Now we need to change the password of user “root” to prevent unauthorized access.
Run the passwd command and enter a new password twice (note that Linux passwords are case-sensitive):

passwd

Now check if everything went right using:

login

This could look like:

If this was successful, proceed to the next step, otherwise return to “passwd“.

Store the password in the NAS. This step is essential, otherwise your password will be cleared on the next reboot! Also when you change the password of any user using the commandline, run the following store-passwd.sh again!

wget http://wolf-u.li/u/172/ -O /ffp/sbin/store-passwd.sh
store-passwd.sh

This could look like this:

Activate SSH

Now activate SSH (secure shell: telnet has major security limitations). Such lines can best be copied line-by-line or together into PuTTY:

chmod a+x /ffp/start/sshd.sh
sh /ffp/start/sshd.sh start

First Connection with SSH

As shown in one of the pictures, the first time you connect to this new (as far as ssh is concerned) machine, you will get a stern warning from ssh. This is because ssh expects to be connecting to this machine through an encrypted connection (now and likely in the future). But ssh wants to be sure that you are connecting to the intended machine rather than to an imposter (“man-in-the-middle”) and has no way of knowing if this is the case. Assuming that you are connecting to via your own (safe) LAN, you don’t need to worry whether the presented identification (public-key fingerprint) is the right one. If you need to connect over the internet (very unlikely) or are paranoid (unlikely), you can follow the confirmation procedure described in this website.

Note that this step associates the name and IP number of your NAS with this public key (this is stored on your computer). This means that during future ssh sessions to this machine the confirmation of the public key is done automatically.

Logging in using SSH

Now you can try to login using an ssh session as user root. This involves starting a second copy of PuttY.

Once you were logged in sucessfully, you can deactivate telnet using:

chmod -x /ffp/start/telnetd.sh

SSH Session

Note that at this point telnet is actually still running, but it will stop working the next time you reboot the NAS. Once you have tested that the ssh server and the associated root password, and encryption keys are working fine you can reboot the NAS: from then on your NAS appliance has essentially been turned into a (somewhat) general purpose Linux computer which you can tweak via “normal” (sic) ssh command line sessions.

Now what?

Congratulations! With the last step, you’ve installed your fun_plug

You can now follow additional tutorials or (carefully) look around using the command line!

Notes

Fun_plug and user accounts

Note that the initial execution of the fun_plug script creates a new user group utmp.

The script that installs the ssh server creates a new user named sshd and adds the user to utmp. This user is for internal use only, and has no ability to login. It is standard procedure when installing OpenSSH, and believed to be safe.

On a NAS, user sshd also shows up as having read-only ftp access to Volume_1. Although it is doubtful that this user really can access ftp, this seems to be a bug and is being investigated.er group utmp.

The script that installs the ssh server creates a new user named sshd and adds the user to utmp. This user is for internal use only, and has no ability to login. It is standard procedure when installing OpenSSH, and believed to be safe.

On a NAS, user sshd also shows up as having read-only ftp access to Volume_1. Although it is doubtful that this user really can access ftp, this seems to be a bug and is being investigated.

Related posts:

• Tutorials
• Installation of the Conceptronic fun_plug on the Conceptronic CH3HNAS
• Installation of Twonkymedia Server 6 on the Conceptronic CH3MNAS and the D-Link DNS-320, DNS-321, DNS-325 and DNS-343
• Installation of Optware on the D-Link DNS-320, DNS-321, DNS-325, DNS-343, DNS-345 and Conceptronic CH3MNAS
• Installation of Optware on the D-Link DNS-323 and Conceptronic CH3SNAS

This tutorial requires an installed fun_plug!

Please check if your NAS is listed here and have a look at the package name, you’ll need it below:

Now go to the download page of Twonky Server, search for the package name and replace the link to the package with the link below after the “wget“-Command. As an example the link for the Kuro box Pro package is placed below. Please execute the following commands in the commandline of your NAS-device:

mkdir -p /ffp/opt/twonky/data/
cd /ffp/opt/twonky
wget http://www.twonkyforum.com/downloads/7.0.8-Special/twonky-kurobox-pro-special-7.0.8.zip
unzip twonky-*.zip
rm twonky-*.zip
chmod +x twonkyserver twonkystarter plugins/* cgi-bin/*
wget http://wolf-u.li/u/449 -O /ffp/start/twonky.sh
wget http://wolf-u.li/u/448 -O /ffp/opt/twonky/twonkyserver-default.ini
[[ $(ls -1 /mnt|grep -c HD_a2) -eq 0 ]] && sed -i -e 's!/HD_a2!/HD/HD_a2!g' -e 's!/HD_b2!/HD/HD_b2!g' /ffp/opt/twonky/twonkyserver-default.ini

Now test if it works:

sh /ffp/start/twonky.sh start

If this command was executed fine, check port 9000 under the address of your NAS. (e.g. at http://192.168.133.7:9000/).

If you want to start Twonky on every boot of your device, enable it permanentely:

chmod a+x /ffp/start/twonky.sh

Related posts:

• Installation of Twonkymedia Server 6 on the Conceptronic CH3MNAS and the D-Link DNS-320, DNS-321, DNS-325 and DNS-343
• Update of Twonkymedia Server 6 on the Conceptronic CH3MNAS, D-Link DNS-320,DNS-321,DNS-325 and DNS-343
• Update of Twonkymedia Server 6 on the Conceptronic CH3SNAS and the D-Link DNS-323
• Installation of Twonkymedia Server 6 on the Conceptronic CH3SNAS and the D-Link DNS-323
• Tutorials

How to add this repository?

Automatic

The repository can be added quickly using uwsiteloader:

wget http://wolf-u.li/u/441 -O /ffp/bin/uwsiteloader.sh
chmod a+x /ffp/bin/uwsiteloader.sh
uwsiteloader.sh

In the Menu, choose “Uli”:

Manually

What can i find in the repository?

As this changes a lot, just take a look into the list here.

Related posts:

• DNS-345
• D-Link DNS-345
• Installation of wget on fun_plug 0.5 for CH3SNAS, CH3MNAS, DNS-323 and many more
• Installation of nano on fun_plug 0.5 for CH3SNAS, CH3MNAS, DNS-323 and many more
• D-Link DNS-325

How is it installed?

wget http://wolf-u.li/u/441 -O /ffp/bin/uwsiteloader.sh
chmod a+x /ffp/bin/uwsiteloader.sh

To update the site-definitions, run uwsiteloader.sh:

uwsiteloader.sh

How does to tool look like?

If you have a site that you want to see added here, please do not hesitate to contact me!

Related posts:

• Announcement of Ulis repository for fun_plug 0.7
• Tutorials
• Installation of the Conceptronic fun_plug on the Conceptronic CH3HNAS
• Installation of Optware on the D-Link DNS-320, DNS-321, DNS-325, DNS-343, DNS-345 and Conceptronic CH3MNAS
• Installation of Optware on the D-Link DNS-323 and Conceptronic CH3SNAS

First you need a working Fonz fun_plug which you can install with these instructions. Then enter the following commands:

wget http://wolf-u.li/u/238 -O /ffp/start/optware.sh
chmod a+x /ffp/start/optware.sh
/ffp/start/optware.sh start

This downloads the Optware-Script for fun_plug, marks it as executable (which leads to a start on every boot, as you’ve already learned) and starts the script once. This may take a while as the NAS is downloading Optware. After the successful download, you should reboot you NAS to see if it works and to set the correct enviroment-variables automatically.

The usage of ipkg (The package manager for Optware (like funpkg for fun_plug)) is shown if you enter “ipkg” in your Terminal. The current list of packages is loaded when entering “ipkg update“, a package is installed with “ipkg install [packagename]“.

Related posts:

• Tutorials
• Installation of Optware on the D-Link DNS-320, DNS-321, DNS-325, DNS-343, DNS-345 and Conceptronic CH3MNAS
• Conceptronic CH3SNAS
• Installation of the Conceptronic fun_plug on the Conceptronic CH3HNAS
• Update of Twonkymedia Server 6 on the Conceptronic CH3SNAS and the D-Link DNS-323

Related posts:

• Twitter Updates for 2012-01-08
• Twitter Updates for 2012-05-04
• Twitter Weekly Updates for 2011-08-14
• Twitter Weekly Updates for 2011-05-15
• Twitter Weekly Updates for 2011-06-19

Related posts:

• Twitter Updates for 2012-01-10
• Twitter Updates for 2012-05-04
• Twitter Weekly Updates for 2011-08-14
• Twitter Weekly Updates for 2011-05-15
• Twitter Weekly Updates for 2011-06-19

1. [Bug Fix] Port redirection issue of GUI.
2. [Bug Fix] P2P seeding function is broken.
3. [New Feature] Support 3TB Disk.
4. [Bug Fix] Apple Finder failed to browse file through Samba issue.
5. [New Feature] Support Amazon S3 Cloud Backup.
6. [Bug Fix] Support WD My Book Essential 2TB USB 2.0.
7. [Bug Fix] P2P shared folder able to invisible via FTP.
8. [Bug Fix] “Blocking unauthorized login of nobody, root and etc special users”.
9. [Bug Fix] Block Raid Migration from DNS-323 (causing corrupted data).
10. [New feature] WebDAV support Open Mode.
11. [Bug Fix] System time will be +1 hour after restart.
12. [Bug Fix] If you apply a Samba share to FTP service, you are no way to disable it individually besides deleting the whole share from “Network Share”.
13. [Bug Fix] Print server does not work when custom shares are configured.
14. [Bug Fix] Workgroup Name is to restrictive and does not allow legitament characters.
15. [Bug Fix] printserver does not work when custom shares are configured.
16. [Bug Fix] Fan non-stopping issue.
17. [Bug Fix] Cannot copy files bigger than 200MB to USB drive.
18. [Bug Fix] External Drive with NTFS partiton support Read/Write.
19. [New Feature] Time Machine fails to work on Mac OS X 10.7 Lion issue.
20. [New Feature] Support Samsung D2 version Nand Flash.
21. [Bug Fix] System Time drift issue.
22. [Bug Fix] FTP backup issue with 722/726.
23. [Bug Fix] Support IE9.

You can download the Firmware here (or from my mirror)

Related posts:

• D-Link releases updated Firmware 2.02 for the DNS-320
• Firmware Versions of the Conceptronic CH3SNAS
• Flashing the Conceptronic CH3SNAS with the Firmware of the D-Link DNS-323
• Twitter Weekly Updates for 2011-08-14
• Twitter Updates for 2012-01-08

1. [New Feature] Support 3TB Disk.
2. [Bug Fix] Apple Finder failed to browse file through Samba issue.
3. [New Feature] Support Amazon S3 Cloud Backup.
4. [Bug Fix]Support WD My Book Essential 2TB USB 2.0.
5. [Bug Fix]P2P shared folder able to invisible via FTP.
6. [Bug Fix]“Blocking unauthorized login of nobody, root and etc special users”.
7. [Change]Block Raid Migration from DNS-323 (causing corrupted data).
8. [New Feature] Support WebDAV.
9. [New Feature] WebDAV support Open Mode.
10. [Bug Fix] System time will be +1 hour after restart.
11. [Bug Fix] If you apply a Samba share to FTP service, you are no way to disable it individually besides deleting the whole share from “Network Share”.
12. [Bug Fix] Print server does not work when custom shares are configured
13. [Bug Fix] Workgroup Name is to restrictive and does not allow legitimate characters
14. [Bug fix] Fan non-stopping issue.
15. [Bug fix] Cannot copy files bigger than 200MB to USB drive.
16. [Bug Fix]External Drive with NTFS partiton support Read/Write.
17. [New Feature] Time Machine fails to work on Mac OS X 10.7 Lion issue.
18. [New Feature] Support Samsung D2 version Nand Flash.
19. [Bug Fix] System Time drift issue.
20. [Bug Fix] FTP backup issue with 722/726.
21. [Bug Fix] Support IE9.
22. [Bug Fix] Solve Language Pack missing translation issue
23. [Bug Fix] FTP/HTTP Downloads and Local Backups pages are not displayed correctly in IE8
24. [Bug Fix] Scan Disk: There is no volume selectable after create 2 standalone volumes

You can download the Firmware here (or from my mirror)

Related posts:

• D-Link releases updated Firmware 1.02 for the DNS-325
• Firmware Versions of the Conceptronic CH3SNAS
• Flashing the Conceptronic CH3SNAS with the Firmware of the D-Link DNS-323
• Twitter Weekly Updates for 2011-08-14
• Twitter Updates for 2012-01-08