Performance: Since Galleon runs using Java, performance is an obvious concern for the ReadyNAS. I have an ReadyNAS Ultra 2, and have observed no performance problems. Archiving and transferring of shows between ReadNAS and my 2 Tivos seem just as responsive as transfers between the Tivos. The CPU and memory utilization of Galleon Server and Java processes on the ReadNAS is not very high. However, my testing has been limited. This needs more stress testing (e.g., multiple simultaneous transfers).
The purpose of this thread is for ReadyNAS enthusiasts to share their experience installing and using Galleon on the ReadyNAS Ultra (x86). If there is sufficient interest, it should be possible to package Galleon as a ReadyNAS Add-on, making installation and configuration easier for future users.
Initial version of instructions for installing and configuring Galleon onto the ReadyNAS Ultra. I appreciate any corrections or feedback on these instructions. IRespond in this thread or PM me.
Overall Notes: Any lines starting with "#" means it is typed at the ssh linux prompt. Any lines starting with ">" means it is typed at the PC DOS prompt.
Instructions below assume you have an x86 ReadyNAS with latest firmware RAIDiator 4.2.19, and a Windows PC.
//////////////////////////////////////////////////////// ///////// Install SSH addon and Putty on your PC. ////////////////////////////////////////////////////////
Using your PC web browser, install ssh addon to ReadyNAS to enable root access: http://www.readynas.com/?cat=36 (Follow the general instrucitons for installing ReadyNAS addons)
Install putty.exe client on PC: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
Launch putty, enter the IP address of your ReadyNas, select SSH connection, and click "open". Make sure you are able to log into the ReadyNas username: root password: your frontview password
//////////////////////////////////////////////////////// ///////// Install the prerequisites on the ReadyNAS ////////////////////////////////////////////////////////
Log into ReadyNAS using putty username: root password: your frontview password
Enter the following at the command prompt (answer y to all prompts):
# apt-get install java6-runtime-headless # apt-get install make
//////////////////////////////////////////////////////// ///////// Install the latest Galleon Release (2.5.2) //////////////////////////////////////////////////////// # cd /c/addons-config # mkdir galleon_install # cd galleon_install # wget www.sourceforge.net/projects/galleon/files/galleon/2.5.5/galleon-2.5.5-linux.zip # unzip galleon-2.5.5-linux.zip # make install
//////////////////////////////////////////////////////// ///////// Install Jackohound's patch to Galleon "ToGo" application //////////////////////////////////////////////////////// // my observation is that Galleon 2.5.5 only will download shows from from TivoHD, // but not on TivoPremiere. This patch contains source TOT code from SourceForge // and rebuilt togo.jar. Seems to address the problem. The patched togo.jar is // provided in the forum thread, copy it to your ReadyNAS.
//////////////////////////////////////////////////////// ///////// Start Galleon Server on ReadNas //////////////////////////////////////////////////////// # cd /usr/share/galleon/bin # ./galleon start
//////////////////////////////////////////////////////// /////////Install Galleon GUI Client on your Windows PC //////////////////////////////////////////////////////// // (Should also be possible to run the GUI Client on a Linux PC, but // these instructions assume a WindowsPC) // - Go to http://sourceforge.net/projects/galleon/files/galleon/2.5.5/ and download the galleon-2.5.5.exe
- run the galleon-2.5.5.exe and complete the installation. -
open a DOS command prompt and enter the following commands:
//For WinXP and WindowsVista: > cd "c:/program files/galleon/bin" For Windows7 > cd "c:/program files (x86)/galleon/bin"
> copy gui.cmd gui_readnas.cmd > notepad gui_readynas.cmd - locate the line "java -Xms32m -Xmx32m org.lnicholls.galleon.gui.Galleon" - change to "java -Xms32m -Xmx32m org.lnicholls.galleon.gui.Galleon <your_readynas_ip> - exit notepad, saving the file.
//////////////////////////////////////////////////////////////////// ///// Launch the Galleon GUI Client on your Windows PC ///// and do initial configure //////////////////////////////////////////////////////////////////// ///// Initial configuration using a PC is required because Galleon encrypts ///// the Tivo MAK in the config file, and it can only receive the unencrypted ///// MAK from the Galleon Client. So, currently, you must enter the Tivo MAK ///// using the GUI client. ////////////////////////////////////////////////////////////////////
open a DOS command prompt and enter the following commands:
For Windows XP and Windows Vista PC: > cd "c:/program files/galleon/bin" For Win7 PC: > cd "c:/program files (x86)/galleon/bin"
> gui_readynas.cmd
- The Galleon 2.5.5 Application should open on your PC. These are the key settings: - File->Properties - Enable debug logging. - Set Recordings path to "/c/Tivo_Archive" - Enter your media access key. (get this from your Tivo) - File->ToGo - Make sure your Tivo(s) are listed. If not, you may need to manually enter them (I did). - save your settings and exit Galleon GUI.
//////////////////////////////////////////////////////////////////// /////////Fixup Galleon config file on the ReadyNas. //////////////////////////////////////////////////////////////////// This is required because the PC GUI does setup the encrypted MAK, but seems to mess up several other settings, using DOS paths instead of Linux ones. Also, whenever editing the config file, you need to restart the Galleon server as decribed below. //////////////////////////////////////////////////////////////////// In the Forum, i have provided a link to my working configure.xml file. This might serve as a reference if others have trouble getting a working configure.xml. ////////////////////////////////////////////////////////////////////
Log into ReadyNAS using putty username: root password: your frontview password
// edit the galleon config file. I assume you know how to use vi editor. If not // you may need to copy the file back to your PC for editing, or install nano or some // other basic linux editor on your ReadyNAS.
# cd /usr/share/galleon/conf # vi configure.xml
- looks closely over the configure.xml file. It should look like the reference provided. You most likely will need to edit several paths to fix them.
// re-start galleon # cd /usr/share/galleon/bin # ./galleon start
//////////////////////////////////////////////////////////////////// ///////// Connecting to Galleon from your Tivo ////////////////////////////////////////////////////////////////// Once Galleon is running on your ReadyNAS, you should be able to archive shows from your Tivo:
- From "Tivo Central", go to "Music, Photos, and Showcases" - Scroll down to the bottom, and you should see "ToGo". You will also probably see two entries in the list - If you dont see "ToGo", try restarting your Tivo. This often is needed for Tivo to recognize the Galleon Server. - Select ToGo, and you should see a list of all the recordings on all your Tivos. Select a recording and initiate the archive.
You can also transfer recordings on the ReadyNAS back to your Tivo for playing:
- From your "Now Playing" list, scroll all the way to the end. - You should see an entry for Galleon, but the name may not be obvious. It may just be the hostname of your readynas. You may also see an entry from ReadyDLNA running on the readynas.
//////////////////////////////////////////////////////////////////// /////////Wiping galleon database and restarting, while retaining your settings. //////////////////////////////////////////////////////////////////// //This might be needed if your galleon gets into a bad state and you need //to wipe it. I have seen reports that this may be needed on a semi-regular //basis, but i havent needed to do this. // # cp /usr/share/galleon/conf/configure.xml /c/addons-config/galleon_install/configure.xml.backup # cd /c/addons-config/galleon_install # make uninstall # make install # cp /c/addons-config/galleon_install/configure.xml.backup /usr/share/galleon/conf/configure.xml
Below are links to patched "ToGo.jar" application and a sample Galleon "configure.xml" file. Refer to the instructions link above for how to use these two files during the install process. I replaced my MAK and Tivo serial numbers with 'XXXX', but otherwise this is my working configure.xml file.
Thanks to mdgm for hosting these files on his server:
