Home Feedback Contents SearchInstallation Instructions

 

 
  1. Create a ‘treehouse’ working directory on your local hard drive.
  2. Extract treehouse.jar, cgjsapi.jar, jaxb-impl.jar, jaxb-libs.jar, swingx.jar, x10.jar and the cgjaspi162.dll files from treehouse.zip to your <jdk1.x>/jre/lib directory
  3. Extract LicenseManager.exe, cginstaller.dll and cginstaller.jar in your 'treehouse' working directory.
  4. Ensure all (r)equired files are located in your <jdk1.x>/jre/lib directory:
     

    FILENAME

    OBTAINED FROM DESCRIPTION
    treehouse.jar (r) edtreehouse.com TreeHouse Automation Console
    cgjaspi.jar (r) edtreehouse.com CloudGarden Java Speech API
    cgjsapi162.dll (r) edtreehouse.com CloudGarden JNI Dynamic Link Library
    x10.jar (o) edtreehouse.com Jesse Petersons' X10 API
    jaxb-impl.jar edtreehouse.com JAXB jar file
    jaxb-libs.jar edtreehouse.com JAXB jar file
    swingx.jar (r) edtreehouse.com Java Swing Extensions
    comm.jar (r) java.sun.com Java Communications API
    mail.jar (o) java.sun.com Java Mail API
    jmf.jar (o) java.sun.com Java Media Framework

Start-Up

To start TreeHouse as a Server, two parameters are specified at the command line:
java -jar <jdk1.?>/jre/lib/treehouse.jar Server <port> <path>

<port> - An even number between 1 and 65536 where the rmi registry will listen for client connections.
Depending on your Operating System, this value may need to be greater than 1024.
The application will default the HTTP Server Port to <port>+1. (see treehouse.properties to override)

<path> - The complete path to the working directory for the application. (created in Step 1 above)

To start TreeHouse as a Client, four parameters are specified at the command line:
java -jar <jdk1.?>/jre/lib/TreeHouse.jar Client <server location> <client listening port> <path>

<server location> - is the server host and port where the rmi registry (or the Server instance of TreeHouse)
is listening (on the same or a remote machine). The URL must be in the following format: rmi://<host>:<port>
<host> can be in the format of a web address (www.imac.com) or IP Address (134.563.22.45).
<client listening port> - The port where the client will receive server notifications.
<path> - The complete path to the working directory for the application.

Start-Up Options
-c Displays the Application Log during run-time
-novoice Disables Voice Recognition/Text to Speech Features
-nojmf Disables Audio Video Features
-nocs Disables Client Server Features
-notapi Disables Server-Side TAPI Features
-nosr Disables Speech Recognition Only

-noui Disables User Interface at startup.

Files

tree<instance>.log - Application Log File - Both instances of the application will create an application log file in the working directory.  This file is appended to each time the application is re-started.  When the application is started with the -c option, the log file is displayed in a console window during run-time.

treehouse.properties - created by the user. It contains platform specific class files for use by the application, as well as overrides of command line specified <port> params:
AudioVideoHandler = JMFHandler #enables Video Capturing/Streaming capabilities for Windows
VoiceHandler = CGVoiceHandler #enables Speech to Text/Speech Recognition capabilities for Windows
TAPIHAndler = OCXamTapiHandler #enables TAPI capabilities for Windows
WaveHandler = OCXamWaveHandler #enables Telephony WAVE capability for Windows
rmiServerPort = <port> #overrides command line server port.
httpServerPort = <port> #overrides default http server port.

treehouse.stream - This file contains the state of all nodes within the application.  The file is re-created each time application data is saved to disk.  The default save interval is every 15 minutes.  This value can be changed by specifying 'saveInterval = <min>' in the properties file.  This file is encrypted when an Application Password is defined by the user.

treehouse.store - This file contains encrypted evaluation and registration keys.

treehouse.xml - This file is created each time application data is saved to disk.

treehouse.html - This file is created each time application data is saved to disk, when user has specified postHTML to web server (from Settings Tab).

weatherXML.xml - This file is created in 30 minute intervals and contains location specific weather conditions.

weatherForecast.xml - This file is created in 2 hour intervals and contains location specific weather forecasts

weatherLinks.xml - This file is created in 12 hour intervals and contains location specific weather links.
 

 

Home ]

**Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. or other countries *ViaVoice is a registered trademark of International Business Machines, in the U.S. or other countries. ***X10 and all logos are trademarks or registered trademarks of X10 Wireless Technology Inc.  INSTEON is a registered trademark of SmartLabs, Inc.  Echelon, LonWorks, Neuron and the Echelon logo are registered trademarks of Echelon Corporation registered in the U.S. and other countries.  Microsoft, Windows and all Windows-based trademarks and logos are trademarks or registered trademarks of Microsoft Corporation, in the U.S. or other countries.
Copyright © 2001-2006 edTreeHouse.com
Last modified: 10/19/08