Access Keys:
Skip to content (Access Key - 0)

Install OpenRemote 2.0 Controller

Before using iPhone, iPod Touch or Android panel with OpenRemote, you need to install a controller. You can install a controller on your existing computer hardware. We currently test OpenRemote distributions with Microsoft Windows XP, Mac OS X Snow Leopard and Debian-based Linux distributions. For additional instructions for other operating system variants, please use the OpenRemote User Forums for community support.

Windows XP

1. Install Java

You may already have Java installed on your system. Make sure it is version 6 or higher. You can do this by going to the "Start" menu and choosing "Run..." and then enter 'cmd', see Image 1 below.

Image 1: Start Command Shell in Windows XP

In the terminal window that opens, type:

 > java -version
 java version "1.6.0_18"
 Java(TM) SE Runtime Environment (build 1.6.0_18-b07)
 Java HotSpot(TM) Client VM (build 16.0-b13, mixed mode, sharing)

If you see any version of Java 6 installed, you don't need to install Java. Otherwise, continue with Java installation:

Save the binary on your desktop. Double-click on the icon and follow the installation instructions.

2. Set Up Your Environment

From your desktop, open the Start menu and select Control Panel. From Control Panel, double-click the "System" icon. In the System window, click on Advanced tab and then click "Environment Variables". In Environment Variables, in the User Variables section, click New.

Enter "JAVA_HOME" as variable name and path to root of the Java Runtime directory (installed in step 1) as the value.

Click Ok and continue to step 3.

3. Install OpenRemote

Unpack the zip file on your filesystem. Start CMD shell from Start menu by selecting Run and enter 'cmd'. Change to the unpacked OpenRemote bin\ directory and enter 'openremote run' on the command line.

Avoid installing OpenRemote into a directory path that contains white spaces. This is known to cause issues.

Also, if may need to restart your command shell after setting the JAVA_HOME system property for the changes to take effect.

You should see OpenRemote starting up. Validate your installation by typing into your web browser the following address: http://localhost:8080/controller

4. Customize Panel Interface

Create your custom user interface using OpenRemote 2.0 Designer.

Once done, download your configuration on your desktop, and upload it to OpenRemote via the upload page of your controller.

Start your iPhone Console and configure it for your OpenRemote Controller.

Mac OS X 10.6 (Snow Leopard)

Uncompress the zip file on your desktop. Start the Terminal application and change to your Desktop directory. From your Desktop change to OpenRemote bin directory and execute ./openremote.sh run

You should see OpenRemote starting up. Validate your installation by typing into Safari the following address: http://localhost:8080/controller

Customize Panel Interface

Create your custom user interface using OpenRemote Designer.

Once done, download your configuration on your desktop, and upload it to OpenRemote via the upload page of your controller.

Start your iPhone Console and configure it for your OpenRemote Controller.

Mac OS X 10.5 (Leopard)

1. Set Up Your Environment

Start the Terminal application and make sure you are using Java version 6.

 > java -version
 java version "1.6.0_20"
 Java(TM) SE Runtime Environment (build 1.6.0_20-b02-279-10M3065)
 Java HotSpot(TM) 64-Bit Server VM (build 16.3-b01-279, mixed mode)

If you have Java 6 installed but Java version 5 is showing up, make sure to set up your JAVA_HOME environment variable (change the path name to your Java 6 location):

  > export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home

2. Install OpenRemote

Uncompress the zip file on your desktop. Change to OpenRemote '/bin' directory and execute './openremote.sh run'

 > cd Desktop/OpenRemote-Boss-2.0.0         // OpenRemote directory name may vary
 > cd bin
 > ./openremote.sh run

You should see OpenRemote starting up. Validate your installation by typing into Safari the following address: http://localhost:8080/controller

Avoid installing OpenRemote into a directory path which contains white spaces. This is known to cause issues.

Customize Panel Interface

Create your custom user interface using OpenRemote Designer.

Once done, download your configuration on your desktop, and upload it to OpenRemote via the upload page of your controller.

Start your iPhone Console and configure it for your OpenRemote Controller.

Synology NAS

OpenRemote 2.0 How To - Controller on Synology NAS

Netgear ReadyNAS

OpenRemote 2.0 How To - Controller on Netgear ReadyNAS

Added by Administrator , last edit by Administrator on Oct 19, 2011 23:26

Search:

Comments (7)

 

  1. Mar 12, 2011

    Torbjörn Österdahl says:

    The following is my experience with installing the controller on my Ubuntu-based...
    The following is my experience with installing the controller on my Ubuntu-based home server.

    Unzipped the application into /opt/openremote/version-XXX/ and started the application using the 'openremote.sh' script

    >sudo ./openremote.sh run

    This resulted in a clash with an existing tomcat6 installation since both wanted port 8080. After consulting the controller readme file I decided to copy the controller webapp to the webapps folder of the tomcat instance. (Note: I later noticed that I could had changed the controller port in the config file /opt/openremote/version-XXX/webapps/WEB-INF/classes/config.properties)

    >sudo cp -R /opt/openremote/version-XXX/webapps/controller /var/lib/tomcat6/webapps/controller

    Now I could check out the controller ui in the browser (http://my-server:8080/controller)

    Tried to upload my config that I had created in the designer (openremote.zip).

    Resulted in an error message. ('null') -> Poor error message

    Found out this is bacause the controller webapp was not allowed to write in the default location for config files ('webapps/controller').

    Rather than changing file permissions of the controller folder I created the folder '/opt/openremote/config' and made it belong to the user 'tomcat6'.

    >sudo mkdir /opt/openremote/config

    >sudo chown tomcat6:tomcat6 /opt/openremote/config

    Next now controller did not start. Problem beeing that it tried to create a logfile in /opt/openremote/logs. -> If logs are supposed to be located relative to the config directory i suggest this should be mentioned in the readme file! Anyway, created also the logs directory.

    >sudo mkdir /opt/openremote/logs

    >sudo chown tomcat6:tomcat6 /opt/openremote/logs

    Now it was possible to start the controller and upload the config (openremote.zip).

    For verification it would had been very nice at this step if the web console had been integrated in the controller. Instead I proceeded with installing the Android console app from Android Market. The Android console finds the controller without further config. Chooses 'Cable' from the list of devices I have created. I am very pleased as notice that I can shift channels using the HTTP device I have created for my Dreambox DM 800 cable receiver. From first impression it is swift and reliable compared to than the sluggish IR remote delivered with the dreambox. This is extremely exiting and I am very pleased!

    1. Nov 03, 2011

      Mike Scher says:

      This is useful information. It answered a few questions which I had. Thanks.

      This is useful information. It answered a few questions which I had. Thanks.

  2. Dec 24

    yodn says:

    What is the password to unzip the file ?

    What is the password to unzip the file ?

    1. Dec 24

      Juha Lindfors says:

      It shouldn't be password protected?

      It shouldn't be password protected?

      1. Dec 24

        yodn says:

        Thank for your answer when I unzip the file after 80% it stop and says: file 'a...

        Thank for your answer

        when I unzip the file after 80% it stop and says:
        file 'applicationProtocolDataUnit$ is password protacted.Please enter the password in the box below.
        What am I doing wrong?

        1. Dec 24

          Juha Lindfors says:

          Could be a zip format incompatibility error. Maybe try a different tool for unzi...

          Could be a zip format incompatibility error. Maybe try a different tool for unzipping the file. What are you using?

          1. Dec 24

            yodn says:

            You are absolutely right !!! I was using win xp default extractor . When I used...

            You are absolutely right !!!

            I was using win xp default extractor .
            When I used 7zip there was no problem at all

            Thanks a lot

            Jay

© 2008-2011 OpenRemote Inc. OpenRemote is a trademark of OpenRemote, Inc.
Adaptavist Theme Builder (3.3.3-conf210) Powered by Atlassian Confluence 2.10.3, the Enterprise Wiki.
Free theme builder license