IntelliHome Installation and Configuration

Manual Downloads

  1. Raspberry Pi (Includes Tomcat 7): Intellihome 0.3.4
  2. Linux (Includes Tomcat 7): Intellihome 0.3.4
  3. Windows: Intellihome 0.3.4

Raspberry Pi

The easiest setup for Intellihome is on a Raspberry Pi. You can install on any other Linux system (such as a NAS device) as well, but you will need to use the different package (above) because the Raspberry Pi requires a specific sqlite library for its ARM-based architecture.

  1. Download and install Raspbian.
  2. Log in to the Pi.
  3. Go to the root:
    cd \
  4. Download the package:
    sudo wget http://homeautomationguru.com/wp-content/uploads/intellihome-0.3.4-pi.tar.gz
  5. Uncompress it (this will create a folder called /apps):
    sudo tar -xvf intellihome-0.3.4.tar.gz
  6. Start Tomcat:
    sudo /apps/apache-tomcat-7.0.64/bin/startup.sh
  7. Open Intellihome in a browser: http://PI_IP_ADDRESS:8080/.
  8. Click the Settings folder, then Settings icon.
  9. Fill in the settings (at least for the ISY), and click Save Settings.
  10. Click the Settings folder, then Jobs icon.
  11. Enable the “ISYQuery” and “ISYStatus” jobs.
  12. Back on the Pi, we now need to restart Tomcat to connect to the ISY:
    sudo /apps/apache-tomcat-7.0.64/bin/shutdown.sh
    sudo /apps/apache-tomcat-7.0.64/bin/startup.sh
  13. On first startup when connecting to the ISY it may take a minute or so to load all the objects, but you should now be able to click on the ISY994i module and see your devices.
  14. Next we will configure tomcat to autostart. Open an editor to create a file:
    	cd /etc/init.d
    	sudo nano tomcat7
    
  15. Paste the contents of the following into the editor:
    #!/bin/bash
    
    ### BEGIN INIT INFO
    # Provides:        tomcat7
    # Required-Start:  $network
    # Required-Stop:   $network
    # Default-Start:   2 3 4 5
    # Default-Stop:    0 1 6
    # Short-Description: Start/Stop Tomcat server
    ### END INIT INFO
    
    PATH=/sbin:/bin:/usr/sbin:/usr/bin
    
    start() {
     sh /apps/apache-tomcat-7.0.64/bin/startup.sh
    }
    
    stop() {
     sh /apps/apache-tomcat-7.0.64/bin/shutdown.sh
    }
    
    case $1 in
      start|stop) $1;;
      restart) stop; start;;
      *) echo "Run as $0 <start|stop|restart>"; exit 1;;
    esac
    
  16. Hit CTRL-O to save the file, then CTRL-X to exit
  17. Register the startup script
    sudo update-rc.d tomcat7 defaults

Windows

The Windows setup requires manually installing Tomcat:

  1. Install Tomcat
    1. Download and Install the latest Java Runtime Environment (JRE)
    2. Download Tomcat (32-bit/64-bit Windows Service Installer)
    3. Run the Tomcat Installer, choosing the following options:
      tomcat-installer-1
      tomcat-installer-2
      Change the destination folder to c:\intellihome\Tomcat7 (it doesn’t matter where you install it, but for this guide we’ll keep all IntelliHome files in the same folder)
  2. Install IntelliHome
    1. Extract the contents of intellihome.zip into C:\intellihome\, preserving the directory contents. In this folder you should now see a single folder called app, and Tomcat7 if you put it there as well.
    2. Create a file called ROOT.xml in C:\intellihome\Tomcat7\conf\Catalina\localhost\ (you will probably have to create the Catalina and localhost folders as well). ROOT.xml should have a single line:
    3. <Context path="" docBase="E:\intellihome\intellihome-standalone\app\" reloadable="true"></Context>
    4. There should be a Tomcat icon in the system tray. Right-click it, then stop the service. Right-click again and start.
    5. Open a browser and point to http://localhost:8080/. Nothing should work at this point since you haven’t set up any of the services, but you should see the UI.
    6. Click the Settings folder, then Settings icon.
    7. Fill in the settings (at least for the ISY), and click Save Settings.
    8. Click the Settings folder, then Jobs icon.
    9. Enable the “ISYQuery” and “ISYStatus” jobs.
    10. Restart Tomcat again to load the ISY settings.
    11. On first startup when connecting to the ISY it may take a minute or so to load all the objects, but you should now be able to click on the ISY994i module and see your devices.

3 comments on “IntelliHome Installation and Configuration
  1. Matt says:

    Hi, trying to get intellihome up and running on my windows box and talking to my ISY but I think there is an issue accessing variables.
    I am running the ISY 5.02 BETA firmware which allows you to specify a variable decimal precision. I have a number of variables with a precision set to 1 i.e. 0.0 and I think this is crashing the ISY query.
    See below from the intellihome log file (State var 73 is one of the variables with the evenhanded precision):

    28 Dec 2015 21:29:08,201 ERROR com.homeautomationguru.intellihome.isy.ISYManager – NEW ISY Variable (updateValue) – need to re-call processVariableNames! 2_73
    28 Dec 2015 21:29:08,201 ERROR com.homeautomationguru.intellihome.isy.MyISYInsteonClient – Exception processing state variable in trigger: null
    java.lang.NullPointerException
    at com.homeautomationguru.intellihome.isy.ISYManager.updateVariableState(ISYManager.java:477)
    at com.homeautomationguru.intellihome.isy.MyISYInsteonClient.onTriggerStatus(MyISYInsteonClient.java:315)
    at com.udi.isy.jsdk.ISYClient.onTriggerStatus(Unknown Source)
    at com.universaldevices.upnp.UDControlPoint.deviceStateChanged(Unknown Source)
    at com.universaldevices.upnp.UDProxyDevice$EventsHandler.commonEventsHandling(Unknown Source)
    at com.universaldevices.upnp.UDProxyDevice$EventsHandler.processUDIEvent(Unknown Source)
    at com.universaldevices.upnp.UDProxyDevice$EventsHandler.run(Unknown Source)

    • Matt Chiste says:

      Thanks for the update Matt – I haven’t done any testing with the ISY 5.0 beta version yet, but it looks like this may indeed be a problem with the new decimal precision capabilities of the new ISY software. I’ll add it to the list to test out on my end once I get a chance to check out the 5.0 beta!

  2. steve says:

    Nice, now I gotta learn how to build this into an Unraid docker…..

Leave a Reply

Your email address will not be published. Required fields are marked *

*

 Subscribe to HomeAutomationGuru.com
    Add to Google Reader or Homepage

Enter your email address to subscribe: