The only tested and supported method of installing Firefly on the MSS/MSS+ is using the OpenMSS firmware. The general procedure is to install the OpenMSS firmware, configure it to retrieve software from the Firefly software repository, disable the existing media server software, and then proceed to configuration.

Installing OpenMSS

Obtain the OpenMSS firmware from the OpenMSS web site (http://www.openmss.org/Firmware/Download). Currently, installation has only been verified using the following firmware versions:

• MSS 2.6.2 OpenMSS1-rc2

Other firmware versions may work, but have not been verified. Success or failure with specific firmware versions should be reported to the Firefly Media Server forums athttp://forums.fireflymediaserver.org.

Once the firmware has been downloaded, install the firmware using the Firmware update page on the MSS administration web page (http://mss/advanced/advanced_systemmaintenance_systemupdate_1.asp, where "mss" is the name or ip address of your MSS server).

Once the server has rebooted as part of the firmware upgrade, go back into the administrative web pages and disable the built-in media server. You can find the page to disable the media server by following the links for "Shared Folders Management", then "Manage Digital Photos, Music, Video", then selecting "Disable Media Server" and selecting "Next".

Installing Firefly Media Server

Next, from a terminal session on Mac, or using a telnet program like Putty telnet to the mss by executing the following command:

telnet mss

(where mss is the name or ip address of your MSS server) You should then be connected to the mss server and be presented with a logon banner that may look something like this:

Connected to mss.
Escape character is '^]'.
BusyBox v1.00-pre2 (2006.02.01-23:21+0000) Built-in shell (msh)
Enter 'help' for a list of built-in commands.
#

The cursor should be sitting just after the "#" prompt. At the prompt, enter the following commands:

# echo "src nslu2 http://ipkg.nslu2-linux.org/feeds/optware/mss/cross/unstable" > /opt/etc/ipkg.conf
# echo "src firefly http://ipkg.fireflymediaserver.org/mipsel" >> /opt/etc/ipkg.conf
# ipkg update
# ipkg install mt-daapd
# ipkg install mss-libhelper
# ipkg install mss-ld-so

Do not type the leading "#" character, that is just to illustrate the prompt that the mss server should be giving you. Be sure to type each line exactly as it is written here. In particular, there is one ">" sign in the first line, and two ">" signs in the second line. Also not that if viewing or printing this page shows the lines being broken or wrapped, do not press enter until you have entered everything up to the next "#" sign.

At this point, mt-daapd is installed. The only remaining thing is to clean up a couple things that are specific to the MSS. One is to fix the startup script. To do that, one must install an editing program, then edit a couple configuration files.

# ipkg install ncursesw nano
# LD_LIBRARY_PATH=/opt/lib /opt/bin/nano /opt/etc/init.d/S60mt-daapd 

The first line installs the editor (a program called nano), and the second uses the nano editor to edit the startup script. You should see a file in the editor. Use the cursor keys to position the cursor at the start of the line that reads "/opt/sbin/mt-daapd -c /opt/etc/mt-daapd/mt-daapd.conf". Type the following: "/opt/lib/ld.so.1 ", so that the entire line reads:

/opt/lib/ld.so.1 /opt/sbin/mt-daapd -c /opt/etc/mt-daapd/mt-daapd.conf

Write the file by pressing CTRL-O, "enter" to save the file, and CTRL-X to exit the editor. Should you make a mistake, and the file is damaged or incorrect, you can exit the editor by pressing CTRL-X, and answering "NO" to not save changes. Then you can type the editor command again and edit the file properly. A handy thing to do now (although not necessary) is to turn off the advertising that is built in to the MSS so it doesn't appear twice on your soundbridge or iTunes share list. You can do that by editing the file that controls bonjour advertising:

# LD_LIBRARY_PATH=/opt/lib /opt/bin/nano /shares/mss-hdd/__bonjour/etc/rendezvous.conf

Find the group of lines mentioning "_daap._tcp" and delete them using the CTRL-K key. Once the lines are deleted, save the file using CTRL-O, "enter" to save, and CTRL-X to exit. Again, if you make a mistake editing the file, press CTRL-X and answer NO when asked to save changes. Then edit the file again.

Once the bonjour advertising is fixed, type "exit" to exit the shell and then reboot the MSS by powering it off from the front panel and back on again. Once it has rebooted, telnet into the mss server again, and execute "/opt/etc/init.d/S60mt-daapd":

C:> telnet mss
Connected to mss.
Escape character is '^]'.
BusyBox v1.00-pre2 (2006.02.01-23:21+0000) Built-in shell (msh)
Enter 'help' for a list of built-in commands.
# /opt/etc/init.d/S60mt-daapd
pidof: not found
# exit

You can ignore the spurious error message. At this point, the server is running and sharing music. From an iTunes client or a Soundbridge client, you should be able to see a server named something like "firefly svn-1433 on mss". If you connect, though, there won't be any songs. That's because the server doesn't know where to look for music.

The music directory can be set using the web interface. Using Firefox or another web browser, browse to http://mss:3689, where mss is the name or ip address of your mss server. You will be prompted for a username and password. Use the username "admin" and the password "mt-daapd".

Select the "configuration" tab on the left side, then change your "Music Folder" to the location your music is at. If you are using the paths set up by the MSS, it might be "/shares/mss-hdd/Public/Our Music".

Once you have entered that, push the "save" button to save the configuration, then go to the "status" page on the web interface. Push the "full scan" button and wait for your music to be indexed. Once the button is no longer gray, connect with an iTunes or Soundbridge client and enjoy your music.

Tip for iTunes playlists: If you are using a Network Attached Server for your music library, in order to get iTunes playlists working you will need to export a copy of the Library from iTunes to the folder on the NAS where your music is stored, and then rename the "Library.xml" to "iTunes Library.xml" in order for Firefly to process it.

You can also continue to configure your server using the web interface, as described in the "Web Based Configuration" section of this manual.