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 java.net
  2. Setup build.properties file.
    Copy build.properties.sample from the ajax/ws/jmaki directory to the user directory such as C:\Documents and Settings\myusername\build.properties . Note the ".samples" extension is removed. Now Edit build.properties and change the following properties in build.properties:
    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
    javaee.server.name 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:

    AS_ADMIN_PASSWORD=<j2eesdk-admin-password>

    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.

    /path/to/passwordfile
    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.