Table Of Contents 1 Installation of BubbleUPnPServer QPKG on QNAP NAS .............................................................................. 4 1.1 Introduction ......................................................................................................................................... 4 1.2 Requirements ...................................................................................................................................... 4 1.2.1 Java QPGK .................................................................................................................................... 4 1.2.2 QNAP Firmware ........................................................................................................................... 5 1.3 Install the BubbleUPnPServer QPKG ................................................................................................... 6 1.4 Upgrade an existing BubbleUPnPServer QKPG ................................................................................... 7 1.5 Upgrade BubbleUPnPServer Server .................................................................................................... 7 1.6 Start and Stop the BubbleUPnPServer ................................................................................................ 8 1.6.1 Checks before starting BubbleUPnPServer ................................................................................. 8 1.6.2 Start ............................................................................................................................................. 8 1.6.3 Stop .............................................................................................................................................. 8 1.6.4 Autostart ...................................................................................................................................... 8 1.6.5 Configuration of BubbleUPnPServer ........................................................................................... 9 1.7 Uninstalling BubbleUPnPServer QPKG .............................................................................................. 10 1.8 Troubleshooting and known problems ............................................................................................. 11 1.8.1 [BubbleUPnPServer] - JRE QPKG is installed but disabled. Please enable the JRE QPKG! ........ 11 1.8.2 [BubbleUPnPServer] - JRE QPKG is NOT installed. Please install JRE QKPG! ............................. 11 1.8.3 Stopping and Starting BubbleUPnP Server QKPG from command line (ssh) ............................ 11 1.8.4 Problems during installation...................................................................................................... 11 2 Additional Information .............................................................................................................................. 12 2.1 Optional: install ffmpeg version that has libmp3lame support ........................................................ 12 3 DISCLAIMER ............................................................................................................................................... 13 Version History: Version Date Changes v0.5.5 07.06.2012 • Initial Version • QKPG with BubbleUPnP Server 0.5.5 v0.6 15.08.2012 • Updated QPKG with BubbleUPnP Server 0.6 • Modified start script not to write any logs per default: otherwise this will prevent the HDDs of QNAP NAS to go into standby mode • Modified stop script to do a kill -9 after 10sec to make sure BubbleUPnP Server is really stopped • Updated documentation how to enable logs • Updated documentation with new link to BubbleUPnP Server website v0.6.1 19.08.2012 • Updated QPKG with BubbleUPnP Server 0.6.1 v0.6.1v2 25.08.2012 • No change in BubbleUPnP Server 0.6.1 • Changes to start & stop script: o added -Djava.io.tmpdir=... to startup command. Otherwise BubbleUPnP Server will use /tmp for image transcoding which is very limited in space on QNAP systems o Seems like one of the new firmwares of QNAP introduced a bug in QKPG handling: also uninstalled QPKGs will still receive a stop command. BubbleUPnP Server QKPG will write a system log entry in that case. To work around this bug and in addition a system log message when package is disabled and rebooted: All commands that create a QNAP system entry log have been removed from stop/start procedure except checks on JAVA QKPG status during startup. o No checks for Java QPKG status done anymore at shutdown o In case there are problems with PID file a 2nd approach to stop BubbleUPnP Server is used: via fuser command from Optware QKPG. Process accessing BubbleUPnPServer.jar will be killed. For this Optware QKPG needs to be installed, for BubbleUPnP Serve QKPG Optware is optional since it usually works with PID file. • Update to documentation: o Optware QKPKG (optional) o Removed the error messages in troubleshooting part that were removed in stop / start script. o Added chapter how to start / stop the QPKG from command line v0.6.2 12.09.2012 • Updated QPKG with BubbleUPnP Server 0.6.2 v0.6.3 15.11.2012 • Updated QPKG with BubbleUPnP Server 0.6.3 v0.6.4 18.02.201 3 • Updated QPKG with BubbleUPnP Server 0.6.4 v0.6.5 01.05.2013 • Updated QPKG with BubbleUPnP Server 0.6.5 ... ... • v0.8.2 23.03.2014 • Updated QPKG with BubbleUPnP Server 0.8.2 v0.9 13.11.2014 • Updated QPKG with BubbleUPnP Server 0.9 • Big change in QPKG: since BubbleUPnP Server 0.9 the server itself (not the QPKG) has an auto update function. This is now supported with this QPKG Version. • Changes to startup script to support the new BubbleUPnP Layout • Changes to installation script to remove obsolete files and folders(<= v0.8.3) • Changes to installation script to download latest BubbleUPnP Server version at time of installation • Removed the 2 nd approach in stop procedure using the fuser/kill commands 1 Installation of BubbleUPnPServer QPKG on QNAP NAS 1.1 Introduction This documentation describes how you can install the BubbleUPnP Server (http://www.bubblesoftapps.com/bubbleupnpserver/ ) on a QNAP NAS. To make installation of the BubbleUPnPServer on QNAP NAS easier the BubbleUPnPServer QPKG was created. The QPKG is a framework around the BubbleUPnPServer that takes control of installation, uninstallation, start & stop of BubbleUPnPServer on a QNAP NAS. The BubbleUPnPServer QPKG consists of: • The BubbleUPnPServer itsself ( http://www.bubblesoftapps.com/bubbleupnpserver/ ) • The QNAP special integration in the QNAP App Center for easy installation, uninstallation, start & stop. Important: Until BubbleUPnP Server v0.9 the BubbleUPnP Server was part of the QPKG. This means: every time a new BubbleUPnP Server was released it was also needed to create a new QPKG containing the new BubbleUPnP Server binaries. Because of that the Version of the QPKG displayed in the App center also matched the Version of the BubbleUPnP Server (displayed on the BubbleUPnP Server webpage). Starting with BubbleUPnP Server v0.9 the auto update function was added to BubbleUPnP Server. This means that the Server can be upgraded to a new version without touching the QPKG. Because of that, from now on, the BubbleUPnP Server Version will be different from the Version of the QPKG. E.g. BubbleUPnP Server v0.9 was released together with the QPKG v0.9. When a new BubbleUPnP Server is released the Version will change (e.g. to v0.91) but the Version of the QPKG will still stay on v0.9. The Version of the QPKG will only change in case there are changes made to the install or start / stop procedure of the QPKG. 1.2 Requirements 1.2.1 Java QPGK BubbleUPnPServer is written in JAVA. Therefore you need a Java Runtime Environment (JRE) installed on the QNAP NAS. Depending on which CPU Type (ARM or INTEL) is installed in your QNAP you have to choose a different installation for the JRE. If you don’t know the CPU Type of your QNAP NAS please check on http://www.qnap.com . 1.2.1.1 ARM based NAS Install the JRE QPKG via your QNAPS Web Administration page. Choose: App Center –> All Apps Select the “JRE_ARM” Package and install it. 1.2.1.2 Intel x86 based NAS Install the JRE QPKG via your QNAPS Web Administration page. Choose: App Center –> All Apps Select the “JRE” Package and install it. 1.2.2 QNAP Firmware Please make sure you’re running the latest firmware for your QNAP NAS. Otherwise (in case you run older versions) some functionality in the QNAP QPKG Center might be missing. 1.3 Install the BubbleUPnPServer QPKG There are three different QPKG available for BubbleUPnP Server. Please download the version that meets the CPU Type of your NAS to your PC: BubbleUPnPServer_<Version>_arm-x09 .qpkg BubbleUPnPServer_<Version>_arm-x19 .qpkg BubbleUPnPServer_<Version>_x86 .qpkg Logon to the QNAP Web Administrator and choose: App Center –> All Apps -> Install Manually Here browse to the path to the BubbleUPNPServer QPKG on your PC. Then press the install button to install the QKPG. Installation should only run for some seconds. The installer install the QPKG and download the latest available BubbleUPnP Server. Afterwards BubbleUPnPServer will appear on the “My Apps” Tab: After the installation BubbleUPnPServer might be stopped. Please see “1.6 Start and Stop the BubbleUPnPServer” for details on starting the BubbleUPnPServer. For problems and troubleshooting please see “1.8 Troubleshooting and known problems” 1.4 Upgrade an existing BubbleUPnPServer QKPG This chapter describes how you can update the BubbleUPnPServer QPKG -> this means only the framework for