Building jMaki from the CVS Source

This document details how to setup a workspace to build and use jMaki. The assumption is that you have downloaded Glassfish.

  1. Download the CVS repository from
  2. Setup file.
    Copy from the ajax/ws/jmaki directory to the user directory such as C:\Documents and Settings\myusername\ . Note the ".samples" extension is removed. Now Edit and change the following properties in
    Property Name Description Examples
    javaee.home The directory where the GlassFish, the Java EE 5 SDK, is installed. c:/Sun/AppServer for windows, and /home/username/SUNWappserverfor unix Host name of the server where the J2EE SDK is installed localhost
    javaee.server.port The port number for the server you chose while installing GlassFish, the Java EE 5 SDK 8080
    javaee.server.username The administrator username specified for the serve while installing GlassFish, the Java EE 5 SDK admin
    javaee.server.passwordfile The path to a file containing the admin password for the J2EE SDK. The password file needs to be in the following format:


    Where you will replace <j2eesdk-admin-password> with the admin password for the GlassFish, the Java EE 5 SDK. We recommend you use adminadmin as the password since it is the default for glassfish app server.

    javaee.adminserver.port The port number for admin server you chose while installing GlassFish, the Java EE 5 SDK 4848
  3. set ANT_HOME and path to use ant version 1.6.5 and put ANT_HOME\bin in PATH
  4. set JAVA_HOME and JAVA_HOME\bin in PATH
  5. build main project, all the jMaki apps. Go to the directory ws/jmaki/; and run ant with no arguments.
  6. Build is complete
  7. Test the build
  8. Start the GlassFish app server, the Java EE 5 SDK app server
  9. Deploy and test the apps onto the GlassFish, the Java EE 5 SDK app server. Usually by running "ant app war deploy". This will build the jMaki applicaiton and deploy it to http://localhost:8080/jmaki/

Building a Single application

When you dont want to build all the apps in project go to the specific widget directory under ws/jmaki/widgets and run ant run to build and deploy any individual application.

Using and Developing Components

If you want to see how to use jMaki components see: Using jMaki and jMaki Application Structure.

If you want to develop your own widgets using jMaki please see jMaKi for the widget developer.