IMPORTANT: HyperDE is now based on Rails 1.1 which requires Rake 0.7. Please update your gems by typing gem update.

Requirements

For development use:

• Ruby language - version 1.8.2 (NOT 1.8.3 or 1.8.4)
• IMPORTANT: Java installed (JDK 1.4 or superior). DO NOT FORGET to set the JAVA_HOME environment variable to point to the Java installation directory. You may install only the JRE as well, but you'll have to do a quick hack to make it work: create a folder named 'jre' under the root of your JRE installation and copy the folders 'lib' and 'bin' into it.

(Optional) For remote Sesame databases:

• A J2EE application - Apache Tomcat recommended
• Sesame RDF database
• Iconv library

For production use:

• Sorry, HyperDE is not ready for production use, yet!

Installation

The following instructions apply mainly for the Windows platform. If you are lucky enough to be running MacOS or a good Linux distribution, please make the necessary adjustments. Also, we're assuming that you're installing the dependencies with default options.

1. Download and install the latest version of the One-Click Ruby Installer from  http://rubyforge.org/projects/rubyinstaller/. Copy the attached RBridge.class file to the <ruby installation>\share\rjb directory, which must be created.
2. Get the latest HyperDE trunk tree from  http://server2.tecweb.inf.puc-rio.br:8000/svn/hyperde/trunk/ (You'll need Subversion or TortoiseSVN (on Windows) to do this) or download an archived snapshot from DownloadArchives.
3. If you wish, you can edit the config\database.yml file to point to your Sesame installation and to the default repository. The included installation file has the standard default values for Sesame. You can also change it, see BasicSesameConfiguration for details. In the default configuration, you RDF databases will be stored in the /tmp directory of the drive where you installed HyperDE. There is also an example database included in that page.
4. Inside an MS-DOS Prompt, go to your HyperDE directory and type: r script\server
5. If you didn't get an error message on the previous command (lucky!), point your browser to  http://localhost:3000/
6. Voila, you should get the 'Select Repository' page showing in the browser.
7. Take a break for a cup of coffee, and get ready to build your first HyperDE application.

Optional Remote Sesame Database

1. Download and install the latest version of Tomcat from  http://jakarta.apache.org/tomcat/
2. Download and install the latest version of Sesame from  http://www.openrdf.org/. Take a look at BasicSesameConfiguration.
3. Get a suitable Iconv library binaries (for Windows this can be found in the zip file attached to this page or follow the instructions about iconv at  http://wiki.rubyonrails.com/rails/show/Rails+0.11+Upgrade+Problems). UPDATE: Use the second zip file, as it contains the DLL and the Ruby bindinds (.so) that you also need to place in the \ruby\lib\ruby\1.8\i386-mswin32 directory.
4. After successfully installing Sesame within Tomcat, start Tomcat
5. At this point you should be able to point your browser to  http://localhost:8080/sesame/ and see the Sesame web-interface
6. Drop the iconv.dll in your Windows\System32 folder if you're in Windows