Linux Daemon Installation Upgrade

These instructions document how to upgrade an existing installation of Haromonium running as a Linux daemon. If you do not yet have Harmonium installed, please refer to the installation instructions.

TiVo Requirements

  • A network enabled Series 2, Series 3, or HD TiVo.
    Note
    Configuring your TiVo to connect to your network is beyond the scope of these instructions. For help see the TiVo website.
  • The TiVo must be enabled for Home Network Applications. To do this, perform the following:
    1. From TiVo Central, go to Music, Photos, & More.
    2. Select Enable Home Network Applications...
    3. Press THUMBS UP three times, then press ENTER to enable local HME applications.
    4. Return to TiVo Central, then Music, Photos, & More. The option should now appear as Disable Home Network Applications...

Server Requirements

  • A version of Harmonium must already be installed as a daemon, as per these instructions.
  • Processor: 32-bit x86 CPU (Intel Pentium, Celeron, Xeon, etc.; AMD Athlon, etc.)
  • Operating System: any LSB compliant distribution of Linux. (Debian, Ubuntu, Red Hat, Fedora, Slackware, etc.)
  • Java runtime evironment version 5 or later.
    Tested
    • Sun Microsystems Java SE Runtime Environment, version 6, update 6
    • Sun Microsystems Java 2 Runtime Environment, Standard Edition, version 5, update 15
  • Connected to same network as TiVo.
    Note
    The server's networking subsystem must be initialized before starting Harmonium. In particular, the server's network interface must have an IP address assigned before Harmonium is started. This might be an issue if your computer uses Gnome Network Manager to manage your computer's network interface.

Upgrade Instructions

  1. Uncompress the installation file to a temporary location.
    Example
    $ cp harmonium.tar.gz /home/userid
    $ cd /home/userid
    $ tar zxvf harmonium.tar.gz
  2. Stop the Harmonium daemon.
    Example
    $ sudo /etc/init.d/harmonium stop
  3. Copy the new Harmonium.jar file to the installation directory.
    Example
    $ sudo cp /home/userid/Harmonium/Harmonium.jar /usr/local/Harmonium
  4. Delete all JAR files from the lib directory within the Harmonium installation directory.
    Example
    $ sudo rm /usr/local/Harmonium/lib/*.jar
  5. Copy new JAR files to the lib directory within the Harmonium installation directory.
    Example
    $ sudo cp /home/userid/Harmonium/lib/*.jar /usr/local/Harmonium/lib
  6. Restart the Harmonium service.
    Example
    $ sudo /etc/init.d/harmonium start