KELP Compiling and Installation - JBuilder


Table of Contents

1. Instructions
2. Building Kelp classes using jakarta-ant
3. Implemeting KELP in JBuilder
Specify j2sdk1.4.x for JBuilder 6 and 7
Preparing jar archives
Changing JBuilder configuration file
Using allready developed applications

Chapter 1. Instructions

To compile and install KELP in JBuilder 5, JBuilder 6, JBuilder 7, JBuilder 8 or JBuilder 9 there have to be done:

  • Compile and create Toolbox archive file toolbox.jar (only for JBuilder 8 and JBuilder 9, previous versions use toolbox.jar from Enhydra),

  • Compile AddinCore files (for JBuilder 5, JBuilder 6 and JBuilder 7) or KelpAntCore (for JBuilder 8 and JBuilder 9) and

  • Compile and create KelpAddin archive file KelpAddinJBuilder6.jar (for JBuilder 5 and JBuilder 6) or KelpAddinJBuilder7.jar or compile and create kelp.jar (for JBuilder 8 and JBuilder 9).

  • Implemeting KELP in JBuilder

Chapter 2.  Building Kelp classes using jakarta-ant

Building of needded Kelp jar files is ant based process. To compile and build jars just start executive files in Kelp source root

configure

make

or

./configure

make

(depending on OS - Windows or Linux).

Executive file configure (.bat on Windows) configures kelp.properties file (and makes Makefile on Linux). For more detail just type

configure -help

You will then get more detailed informations about configure options.

For more infomations on (ant based) building options just type

make help

You will then get more detailed informations about make options.

Chapter 3. Implemeting KELP in JBuilder

Specify j2sdk1.4.x for JBuilder 6 and 7

For installing KELP in JBuilder (this is not neccesary for version 8 and upper (default java is 1.4)) it is necessery to configure JBuilder default java to be 1.4.x. You need to copy your j2sdk1.4.x (e.g. j2sdk1.4.1) into {JBuilder root} directory and edit {JBuilder root}/bin/jdk.config file to point to j2sdk1.4.x:

  • javapath ../j2sdk1.4.1/jre/bin/server/jvm.dll

  • addpath ../j2sdk1.4.1/lib/tools.jar

NOTE: In order to run Enhydra Application or DODS generator, you will have to set JDK (on j2sdk1.4.x (e.g. j2sdk1.4.1)) field in Project -->Project Properties dialog (Paths tab).

Preparing jar archives

For installing KELP in JBuilder it is necessery to have these jars: toolbox.jar, KelpAddin.jar, enhydra.jar, xmlc.jar, xercesImpl.jar, xml-apis.jar, tomcat.jar, core.jar, xhtml.jar, xmlc-wml.jar, xmlc-voicexml.jar and xmlc-chtml.jar.
Copy these jar files into your hard drive:

  • The location of toolbox.jar file is <Enhydra5.1 root>\lib\build directory and it could be for examle: C:\Enhydra5.1\lib\build

  • The location of KelpAddinJBuilder.jar (for JBuilder 5,6 or 7) or kelp.jar (for JBuilder 8 or 9) is not strictly determined too and it could be for example: C:\jbuilder5\kelp5\lib (KelpAntCore.jar for JBuilder 8 or 9 should be placed in (JBuilde8 example) C:\jbuilder8\lib)

  • The location of enhydra.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of xmlc.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of xercesImpl.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of xml-apis.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of tomcat.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of core.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of util.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of log4j.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\build

  • The location of ejen.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\dods\lib

  • The location of dods.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\dods\lib

  • The location of dods-runtime.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\dods\lib

  • The location of xhtml.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib

  • The location of xmlc-chtml.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib\dom

  • The location of xmlc-wml.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib\dom

  • The location of xmlc-voicexml.jar file has to be in Enhydra directory and it is for example: C:\Enhydra5.1\lib\dom

Changing JBuilder configuration file

For installing KELP in JBuilder, JBuilder configuration file has to be changed. That configuration file is: JBuilder.config file and it's location is in <JBuilder root> \bin directory

These lines have to be added there:

addpath C:\jbuilder5\kelp5\lib\KelpAddinJBuilder.jar (or kelp.jar)

addpath C:\Enhydra5.1\lib\build\toolbox.jar 

addpath C:\Enhydra5.1\lib\util.jar 

addpath C:\Enhydra5.1\dods\lib\dods-runtime.jar 

addpath C:\Enhydra5.1\dods\lib\dods.jar 

vparam -DDODS_HOME=C:\Enhydra5.1\dods

These lines have to be added before...
# Add all JAR files located in the patch, lib and lib/ext directory addjars

../patch addjars 

../lib addjars 

../lib/ext 

...lines. 

Copy Enhydra.library file into JBuilder/lib directory. Modify path of enhydra.jar file if necessary.

After this it is necessary to restart JBuilder.

Using allready developed applications

New Kelp 5.1 is compatible with old one and can be used instantly, only needed action is to set class paths properly, because of change in file structure of Enhydra Server 5.1 (see Enhydra 5.1 documentation for details).