Prerequisites

GT.M must be configured, and the GTMJI interface must be built and installed.
Railo must be installed. We recommend "Railo Server with Tomcat"

Installing CFMumps

CFMumps Code

Download the latest CFMumps release from http://www.coherent-logic.com/cm/products/cfmumps

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!