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:
   
   
   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.