Building from Source Howto

Introduction

• Conventions
• Software you need to build the jiplet container
• Download and install the source code
• Setup the build environment
• Run the build
• Ant options and targets

Conventions

1. We have used the term "directory" to specify a file location. This is a common Unix convention. In the Windows environment, the term "folder" is used to mean the same thing.
2. We have used the Unix directory naming convention in this document. In the Unix environment, a directory hierarchy is specified by the "/" separator. In the Windows environment, the "\" separator is used. In addition, Unix system do not use drive letters as in Windows. If you are using Windows, you will need to modify the commands accordingly. For example, if we stated $JIPLET_HOME/bin, if you are using Windows, it may translate to C:\jiplet-standalone\bin.
   
3. We have used $JIPLET_HOME or similar names to specify environmental variables. While installing/configuring, you will need to replace these variables with the actual values for your machine. For example, in this document, the variable $JIPLET_HOME has been used to specify the directory where the jiplet container code binary is installed. We have commonly used the following variables:
1. $JAVA_HOME - directory where the Java Runtime Environment (JRE) is installed.
2. $JIPLET_HOME - directory where the Jiplet Container software is installed.
3. $JBOSS_HOME - directory where JBOSS is installed.
   
4. $TOMCAT_HOME - directory where Tomcat is installed.
5. $HOST - host name/IP address of the system where the jiplet container is installed.
6. $RUN - the JBOSS run mode (default, minimal, all, etc.).
7. $ANT_HOME - the directory where Ant is installed.
8. $GWT_HOME - the directory where GWT (Google Web Toolkit) is installed.
   
4. Commands are specified using bold. You need to enter the command by typing/pasting the command and pressing the Enter/Return key. Although in the Unix world this may seem natural, in the Windows environment, lots of users are lost when it comes to entering a command. Also, the prompts "#" or "C:\>" are shown, do not enter them.

Software you need to build the jiplet container

1. Java Software Development Kit (JDK) version 1.5: You can download this software from http://www.java.com and install it using the instructions provided by the site.
2. Ant: You can download the latest stable release of Ant from http://ant.apache.org and install it as per the instructions provided by the site.
   
3. Google Web Toolkit (GWT): You can download it from http://code.google.com/webtoolkit/ and install it as per the instructions provided by the site. We use GWT 1.5. The Jiplet Console does not work with GWT 1.4.
   

Download and install the source code

1. Download the source package provided in a zip format. We have provided the source for the officially released versions in zip format that you can download along with the binary packages. The source package is called jiplet-src-x.x.x.zip where x.x.x is the version number you want to download. The documentation in this site only pertains to the latest stable version. So, if you decide to download an earlier version, there may be some differences between the documentation and the actual code in place and you need to figure how to handle it on your own.
   
•  On Windows, to unpack the distribution, you can use the tools that may be included with your operating system or use a commercially available tool like WINZIP.  You can also use the jar tool included with the JDK. If you are using Linux, you can use the unzip utility included with your Linux distribution or use the jar tool included with the JDK. Also, make sure you have about 100MB of free disk space. The following are the steps for unpacking:
  
• Create a directory called "cafesip". You can create it under your home directory (example: /home/amit/cafesip) on Linux. For windows, you can create it under your "My Documents" directory or you can create it under your C:\ root directory.
• Unpack the distribution under the cafesip directory. A new directory called jiplet will be created under the cafesip directory.
2. You can also download the latest snap-shot of the jiplet source code by accessing the Subversion code repository provided by Sourceforge.
   
• You will need a subversion client for downloading the software. If you are using Linux, a subversion client called "svn" is already provided. For Windows or other operating systems, you need to download a subversion client. Take a look at the Subversion site - http://subversion.tigris.org/ for options.
  
• Create a directory called "cafesip". You can create it under your home directory (example: /home/amit/cafesip) on Linux. For windows, you can create it under your "My Documents" directory or you can create it under your C:\ root directory.
• Create a sub-directory called "jiplet" under the "cafesip" directory.
• On Linux systems, run the command:
  
       $ cd $CAFESIP_HOME
       $ svn co http://cafesip.svn.sourceforge.net/svnroot/cafesip/jiplet/trunk jiplet
  
  Note: The latest source code in the trunk directory may not be stable and may not even compile. moreover, the document may not even match up. If you want to download the source code that we consider stable, download the software from the URL:  http://cafesip.svn.sourceforge.net/svnroot/cafesip/jiplet/labels/stable .
  
  If you are using Windows, you will have to run a procedure that is equivalent of the above command. The procedure will depend on the tool you are using. Take a look at the Eclipse Setup Howto for how to download the source using the Subclipse Eclipse plugin.
  

Run the build

1. Open a terminal. Use the "Command Prompt" utility on the Windows environment. On Linux, use an xterm.
   
2. Check if the environment variables are set properly. To check:
   
   On the Linux environment, run the "echo $VARIABLE" command where $VARIABLE is the name of the variable. The system should display the value for the variable.
   
   On the Windows environment, run the "echo %VARIABLE% command %VARIABLE% is the name of the variable. The system should display the value for the variable.
   
   If the variables are not set properly, please correct the problem before proceeding.
   
3. Change directory to the "jiplet" directory under the "cafesip" directory that you created above. Use the "cd" command.
4. Run the command:
   
          $ ant
   
   This command should take a few moments (about 2 minutes - will depend on the system you are using) and should complete without errors.
   
5. The build is now complete. You will find the packages in the ZIP format in the "jiplet" directory.
   

Ant options and targets

Search this website 

Send questions or comments about this web site to webmaster@cafesip.org.
Copyright © 2005, CafeSip.org.
Licensed under the CafeSip License.
The CafeSip.org projects, web site and web facilities have been sponsored by QUIK Computing

Top of page