• You need to have Java installed
  
• download OpenMocha
• extract the downloaded archive
• execute ./start.sh (or start.bat on Windows)
• create an admin account at http://localhost:8080/exampleapp/register
• copy the authentication code to the server.properties file
• login at http://localhost:8080/exampleapp/login
  

 

Prerequisites and System Requirements

To run OpenMocha a Java Virtual Machine 1.4 or better is required.

For FreeBSD and other operating systems with ports collection you may install a JRE or JDK from the ports collection. For Windows, Linux and Solaris you can get a Java runtime or development kit from http://java.sun.com/j2se/downloads/. If you are on Mac OS X then you already have a Java runtime that will work well with OpenMocha.

While you can integrate OpenMocha with other tools such as Apache and MySQL, you do not have to. OpenMocha is pre-configured to be deployed on its own and comes with a built-in object oriented database and web server.

Getting started with OpenMocha

On the e4xd.org site, you should be able to find a working build to download and simply start with ./start.sh

• http://e4xd.org/

For FreeBSD, Linux, Solaris, Mac OS X and other Unix flavors, start the Helma framework by invoking ./start.sh from the command line. On Windows, invoke start.bat instead.

If the java command can not be found, make sure the JAVA_HOME environment variable is set to the location of your Java installation.

With Helma running, you should be able to connect using your browser and the URL http://127.0.0.1:8080/ or http://localhost:8080/

To initialize the setup, complete the user registration form at http://127.0.0.1:8080/exampleapp/register and follow the instructions to copy the security information into the server.properties file. You may then login to your new OpenMocha server via http://127.0.0.1:8080/exampleapp/login and start configuring and deploying your web applications.

Installing jhino modules in a existing Helma setup

In addition to the full openmocha build, there is also a build that contains only the jhino modules and patched jar files, in order to add jhino to your own helma install. You would need to replace the helma.jar and rhino.jar in your Helma install with the patched versions. The "objectengine" and "jhino" modules are expected to be placed in Helma's modules directory and the exampleapp would normally go into Helma's apps directory. You could then start the example app from your manage application or add it to the apps.properties file to have it start automatically.

• http://localhost:8080/exampleapp

More info and help

Other than what you find on the (possibly not yet existing) e4xd.org website, the best places to get in touch are the openmocha mailing list and google group or the #helma@irc.freenode.net IRC channel .

• http://groups.google.com/group/openmocha
• irc://irc.freenode.net/helma
• http://helma.zumbrunn.com/hopbot/

Also, in case you are new to Helma, you of course need to add the helma.org website and mailing lists to the top of that list.

• http://helma.org/

To get in touch with me directly, you should find additional contact information on the zumbrunn.com site.

Chris Zumbrunn < chris@zumbrunn.com > http://zumbrunn.com