Llink:synology readme

# llink is copyrighted 2009 by Jorgen Lundman. It's free to use under the
# terms in the LICENSE file. For more information look at:
# http://www.lundman.net/


INSTALLATION INSTRUCTIONS FOR LLINK ON SYNOLOGY NAS
Written by dc11ab on the 16th of March 2008
Updated 27th of January 2009

Verified for llink version 2.0.5 build 730 on a CS-406 with firmware 590.
If no major changes has been introduced, this README should work as 
install guide regardless of version.

The guide describes how to install the llink media server on a Synology
NAS. The x06 compiled binary should work on the following models:
:: DS-101g+, DS-106j, DS-106e, DS-106, DS-106x , CS-406, RS-406, CS-406e
:: DS-107e, DS-107, DS-207, DS-207.128 and CS-407e

If you have another model, make sure you have downloaded the correct
binary, because llink "x06" will not work on the Marvell based x07 models 
and is not confirmed on the x08 models (DS-207+, CS-407, DS-408 etc.)
If you are unsure what model you have, please look here:
http://oinkzwurgl.org/diskstation_hardware


NOTES
* Replace <version> below with the version number of llink, example: 2.0.3
* When downloaded from lundman.net the inital character in the file name
  is Capitalized, e.g. Llink-2.0.3-synology_x06_ppc.tar.gz
  Linux is case sensitive so don't forget to have this in mind.
* The llink startup script survived a Synology firmware update from 518 to
  590 but future firmware upgrades may brake it. Normally it will not.


NOT TESTED
* Other llink skins than the defaults.
* Integration with web admin interface and startup, as of new Synology 
  firmware from June 2008.


PREREQUISITES
* Telnet or SSH enabled on the NAS.

In recent Synology firmware, dating from September 2008, it is
possible to enable in the web administration GUI:
http://<IP of your Synology NAS>:5000

On older firmware there exist Bootstrap methods. Google for them.


INSTALL
Enter the NAS with telnet or SSH using root or admin user.
The password of root and admin should be the same.

Place the llink-<version>-synology_x06_ppc.tar.gz file in the share: 
/volume1

This can be done in various ways. Here is one, if wget command is available:
> cd /volume1
> wget http://www.lundman.net/wiki/images/e/ec/Llink-2.2.0-synology_x06_ppc.tar.gz

Observing that the link points to the latest version of the correct binary.

Otherwise you can download it to your PC/mac, and the transfer the file to
the public folder (by FTP, NFS or SMB), and then move it:
> mv /volume1/public/Llink-2.2.0-synology_x06_ppc.tar.gz /volume1/

Next, untar the file:
> tar -xvzf Llink-<version>-synology_x06_ppc.tar.gz

This creates a directory: /volume1/llink-<version>-synology_x06_ppc

After a successful untar you can remove the tar.gz file:
> rm llink-<version>-synology_x06_ppc.tar.gz

Edit the conf files accordingly to specify ports, location of your
media and any other settings that you prefer and require: 
> vi /volume1/llink-<version>-synology_x06_ppc/llink.conf

If you are not familiar with the text editor "vi", you could just share
the newly created folder and access it from your PC/mac and open the conf
file with your favorite text editor.

Normally, we have media files in the default Synology shares:
/volume1/video
/volume1/music
/volume1/photo

Make sure the conf file ROOT's points to the correct shares, or any
other you wish to be available from llink. Comment out those that does
not apply, by adding # in front of the row. 


MANUAL START/STOP
Telnet or SSH to your Synology NAS as root or admin and enter:
> /volume1/llink-<version>-synology_x06_ppc/llink -d

To stop llink manually, enter: 
> killall llink


STARTUP
To enable autostart on boot, edit the rc.local file to point to the 
llink startup script:
> vi /etc/rc.local

This opens the file in the vi editor. If you don't understand how to 
use vi, type man vi, or find instructions in your favorite search engine.

Enter on a new line, press I and add:
/volume1/llink-<version>-synology_x06_ppc/S89llink.sh 
#Adding the llink media server to autostart, <your install date>

Then save and exit vi: press <esc><esc> :wq <enter>

Make sure the startup script has the right permissions:
> chmod 755 /volume1/llink-<version>-synology_x06_ppc/S89llink.sh

Now the installation is complete! Next time you reboot your NAS llink
starts automatically and appears as "llink-daemon" on your Syabas media
player interface. Enjoy your media!

Note: Using other skins, such as Jukebox and the SD skin requires a 
change in the startup script "S89llink.sh", if this is used. You can add:
 -f <skin conf file>  
after the llink path. (eg: -f jukebox.conf)

But the jukebox skins require more to be able to run properly. See more
instructions at the www.lundman.net wiki.


UNINSTALL
1. Enter your Synology with telnet/ssh and shut down llink:
> killall llink

2. Simply delete the install directory
> rm -rf /volume1/llink-<version>-synology_x06_ppc

3. Remove the line in the /etc/rc.local file.
(using 'vi', for instance)

Done.


TROUBLESHOOTING, TIPS AND TRICKS
If the installations doesn't work, it is very likely that the llink.conf
file is not correctly set. Make sure your ROOT folders for the media are
properly written. Some Windows users forget to use "/ instead of "\".

More help concerning llink may be found on www.lundman.net and the
Syabas forum Networkedmediatank.com (UPnP Server section).

If you want a log/debug output of llink, stop it manually (see above) 
and start it manually with:
> ./llink -v 60

Using -v 255 instead of 60 will generate all the details. And that's a lot.
Other verbose options can be found at the www.lundman.net wiki.

This will generate output in the terminal where llink tells us what it
tries to do. Very useful for debugging.

If you want to connect your Syabas media player with your Synology NAS
you can also use both Samba (SMB/CIFS) or NFS. Performance should be OK 
for either one when viewing high-bitrate content such as HD movies, but 
it depends a lot upon your network environment.

You'll find several guides and HowTo's at Synology.com forum and wiki,
as well as on Syabas forum and wiki at Networkedmediatank.com for general
setups and troubleshooting. 

God's speed!

(eof)