Lucee/GTMJI Connector

Owned by John Willis
Last updated: Dec 05, 2019

< Previous

Railo/GTMJI Connector

Next >


Prerequisites

  • GT.M must be configured, and the GTMJI interface must be built and installed. 
  • Lucee must be installed. We recommend "Lucee Installer".


Installing CFMumps


CFMumps Code


  • Copy the downloaded file (ex. cfmumps-0.03-0-g6b7a5fb.tar.gz) to your Railo web root
  • Expand the file:
bash
$ tar xzf cfmumps-0.03-0-g6b7a5fb.tar.gz


Tomcat Configuration


Modify your Tomcat setenv.sh file (ex.: /opt/railo/tomcat/bin/setenv.sh) to contain the following lines BEFORE the line containing "export JAVA_OPTS;":

bash
export gtm_dist=/path/to/gt.m
export gtmgbldir=/path/to/gld/file/gldfilename.gld
export gtmroutines="${gtm_dist} /path/to/objects(/path/to/routines)"
export LD_LIBRARY_PATH=${gtm_dist}/plugin
export CLASSPATH=${gtm_dist}/plugin/gtmji.jar:/path/to/document/root/java
export GTMCI=/path/to/document/root/java/cfgtm.ji

CFMumps and gtmroutines

Note that /path/to/document/root/mumps must be present in your $gtmroutines environment variable. The file _cfmumpsCallinAPI.m contains the %cfmumpsCallinAPI routine for GT.M, which is the underlying routine used by the GTMJI connector.


CFMumps Configuration


Edit lib/cfmumps/cfmumps.ini in your document root to set mcCFGtm as the CFMumps connector component:

[General]
component=lib.cfmumps.mcCFGtm


The rest of cfmumps.ini may be left in its default configuration.


Restart Railo


Restart Railo and Tomcat with the following command:

bash
# service railo_ctl restart


You are now ready to begin developing CFMumps applications!