====== How to fun_plug ======



===== Background info =====

On startup TS-I300 will run /etc/rc.sh which will mount the various filesystems and initialize the drive.

<code>...

touch /tmp/boot_finished

/usr/sbin/chk_fun_plug &



</code>



/usr/sbin/chk_fun_plug will check for file called fun_plug on the disks root and then executes it.

<code perl>

#!/bin/sh



sleep 30



Dir_Len=28

Filename_Len=26

CUSTOMIZEHDPATH=/sys/custom/shared_name/HD



file=$(find "$CUSTOMIZEHDPATH"/*)

HD_Path=`expr substr "$file" "$Dir_Len" "$Filename_Len"`

HD_Path=$HD_Path"a2"



if [ -e /mnt/$HD_Path/fun_plug ]; then

        echo "function plug enable"

        /mnt/$HD_Path/fun_plug

fi



</code>





===== Installing fun_plug =====

There are 5 ways to setup a working fun_plug file:

  - To a new hard drive using Linux

  - To a already partitioned hard drive using Linux

  - To a already partitioned hard drive using Linux and Samba

  - To a already partitioned hard drive using Windows and cygwin

  - To a running TS-I300 using FTP from any Operating System







==== 1. To a new hard drive using Linux ====

  - Connect your new hard drive to a Linux (ext3 supported) PC.

  - Run terminal as root user.

  - Fire up fdisk using following command ''fdisk /dev/hdx'' or ''fdisk /dev/sdx'' if you have SATA or USB hard drive. The x is your hard drive position, for example Primary Master is a, Primary Slave is b, Secondary Master is c and Secondary Slave is d. SATA and USB hard drives are most cases a.

  - Now we are going to make a swap partition.

  - When you are inside fdisk then press ''n''

  - Then ''p''

  - And then ''1''

  - And then ''Enter key''

  - And finally ''+512M''

  - Now we are going to make a ext3 partition for your files. You can also make more than one partition for your files. For example if you do not want to store your files to ext3 partition and you want to use fat32 instead, or if you want to use chroot environment and want to avoid [[http://forum.dsmg600.info/t19-Updated-28092006-Bugs.html|chmod bug at bootup]].

  - Press ''n''

  - Then ''p''

  - Then ''2''

  - Then press ''Enter key''

  - And now press ''Enter key'' if you want to make only one ext3 partition. If you are not sure what to do then you should press ''Enter key''. But if you want to make one or more extra partitions then you must figure out how you are going to spread your drive space between all those partitions you are going to make. For example if you want to store most of your files to FAT32 partition then you should enter ''+100M'' to make 100MB ext3 partition.

  - If you did choose to make more than one partition, to your files, then proceed with setp 17, otherwise go to step 18.

  - Now press ''n'' then ''p'' after that ''3'' and now ''Enter key'' and ''Enter key'' to one more time.

  - Now we are going to setup a file system type to swap partition.

  - Press ''T''

  - Then ''1''

  - And then ''82''

  - If you did choose to make more than one partition to your files then proceed with setp 23, otherwise go to step 24.

  - Now you have to choose a file system to your extra partition. You can leave it to ext3 or change it to FAT32. To change it FAT32 then press ''T'' then ''3'' and then ''c''

  - Now you can review your partition table by pressing ''p'', if it looks good then press ''w'' to write changes to hard disk. If you think something went wrong then press ''q'' and start again, starting with step 3.

  - Now we are going to format newly created partitions.

  - To format swap partition run ''mkswap /dev/hdx1''

  - Next we are going to format ext3 partition with following command line ''mke2fs -j /dev/hdx2''

  - And if you did choose to make a second partition to your files then we must format this one also. If you did choose it to be FAT32, before at the 23rd step, then you must run ''mkdosfs /dev/hdx3''

  - And finally we are going to make fun_plug file to your ext3 partition.

  - We need first mount ext3 partition with this command line ''mkdir /mnt/TSI300disk || mount /dev/hdx2 /mnt/TSI300disk''

  - Now create empty fun_plug file with this command ''touch /mnt/TSI300disk/fun_plug''

  - And now we are going to make it an a executable with this command ''chmod 777 /mnt/TSI300disk/fun_plug''

  - Now run ''ls -la /mnt/TSI300disk/fun_plug'' to make sure that we did it correctly. You should see <code>-rwxrwxrwx 1 root root 0 some-date-and-time /mnt/TSI300disk/fun_plug</code>

  - Optionally if you like you can also install [[:howto:telnet|telnet]] here.

  - Now we are almost done, just need to unmount ext3 partition with ''umount /mnt/TSI300disk'' command.

  - And now you can take out your hard drive from your computer and install it to in your TS-I300.





==== 2. To a already partitioned hard drive using Linux ====

  - Take your hard disk out of your TS-I300.

  - Connect your already partitioned hard drive to a Linux (ext3 supported) PC.

  - Run terminal as root user.

  - We need first mount ext3 partition with this command line ''mkdir /mnt/TSI300disk || mount /dev/hdx2 /mnt/TSI300disk''. The x is your hard drive position, for example Primary Master is a, Primary Slave is b, Secondary Master is c and Secondary Slave is d. SATA and USB hard drives are most cases a.

  - Now create empty fun_plug file with this command ''touch /mnt/TSI300disk/fun_plug''

  - And now we are going to make it an a executable with this command ''chmod 777 /mnt/TSI300disk/fun_plug''

  - Now run ''ls -la /mnt/TSI300disk/fun_plug'' to make sure that we made it correctly. You should see <code>-rwxrwxrwx 1 root root 0 some-date-and-time /mnt/TSI300disk/fun_plug</code>

  - Optionally if you like you can also install [[:howto:telnet|telnet]] here.

  - Now we are almost done, just need to unmount ext3 partition with ''umount /mnt/TSI300disk'' command.

  - And now you can take out your hard drive from your computer and install it back to your TS-I300.



==== 3. To a already partitioned hard drive using Linux and Samba ====

  - Boot up your DSM-TS-I300.

  - Mount TS-I300 share using following command line ''mount -t smbfs -o username=admin //<insert TS-I300 IP here>/HDD_a /mnt/somedir''

  - Enter your password you specified for admin user in web interface.

  - Run ''touch /mnt/somedir/fun_plug'' and ''chmod 777 /mnt/somedir/fun_plug''

  - Optionally if you like you can also install [[:howto:telnet|telnet]] here.

  - Finally run ''umount /mnt/somedir'' and reboot your TS-I300.





==== 4. To a already partitioned hard drive using Windows and cygwin ====

  - ...

\\

\\







==== 5. to a running TS-I300 using FTP from any Operating System ====



  - You will have to enable FTP through the admin pages and set up an ftp user.

  - Create a test fun_plug on your system. 

  - Connect to your TS-I300 using a command line ftp client (in windows: start / run / ftp)

  - change to the right directory:     cd /HD_a2

  - upload your fun_plug:   put fun_plug

  - make it executable:  chmod 777 fun_plug

  - quit ftp:   quit



and your done. You may edit the fun_plug via samba (windows share) from now on, the permissions will stick.





===== Using fun_plug  =====



Windows users should note that the fun_plug file must be in unix file format (LF for newline) and not in Windows (CR LF for newline). One suggested editor for Windows is UltraEdit which let you save the file in both formats.

To test out if fun_plug works, you can simply add following lines to your fun_plug and reboot.

<code perl>

#!/bin/sh

dmesg > /mnt/HD_a2/dmesg.out</code>

After boot up you should see dmesg.out file at the root of your TS-I300 hard disk.\\

If you have not familiarly with Unix shell scripting then I suggest you to read some [[http://www.dreamsyssoft.com/unix-shell-scripting/intro-tutorial.php|docs]] about it.