Install Guide

Requirements

The nerd.vision java agent requires:

  • java 1.7+

Download

Download the latest agent from maven central - please check the name of the file after it is downloaded

Warning

The file name after download will include the version number. Please ensure you rename the file to match that which is added to the jvm.config file.

Adobe Coldfusion (10 / 11 / 2016 / 2018)

To install nerd.vision you need to add the javaagent argument to the java options used by the Coldfusion server. To install please follow these steps:

  1. Navigate to the following directory: {ColdFusion-Home}/cfusion/bin
  2. Locate and open the jvm.config file with a text editor of your preference.
  3. Add the nerd.vision Java agent at the end of the line after "# Arguments to VM". Please make sure that all the Java Arguments are on the same line.
  4. Save the changes made.

Here is an example of a jvm.config:

...
# Arguments to VMx
java.args=-server -Xms256m -Xmx512m -XX:MaxPermSize=192m -Xbatch -Dcoldfusion.home={application.home} -Djava.awt.headless=true -Dcoldfusion.rootDir={application.home} -Djava.security.policy={application.home}/lib/coldfusion.policy -Djava.security.auth.policy={application.home}/lib/neo-jaas.policy -Dcoldfusion.classPath={application.home}/lib/updates,{application.home}/lib,{application.home}/lib/axis2,{application.home}/gateway/lib/,{application.home}/wwwroot/WEB-INF/cfform/jars,{application.home}/wwwroot/WEB-INF/flex/jars,{application.home}/lib/oosdk/lib,{application.home}/lib/oosdk/classes -Dcoldfusion.libPath={application.home}/lib -Dorg.apache.coyote.USE-CUSTOM-STATUS-MSG-IN-HEADER=true -javaagent:/full/path/to/nerdvision.jar=api.key=[API_KEY] 

Lucee Coldfusion (5.3.6)

To install nerd.vision you need to add the javaagent argument to the java options used by the Lucee server. To install please follow these steps:

  1. Navigate to the following directory: {Lucee-Home}/bin`
  2. Locate (or create) and then open the setenv.sh file with a text editor of your preference.
  3. Add the following to the file:
    export JAVA_OPTS="${JAVA_OPTS} -javaagent:/full/path/to/nerdvision.jar=api.key=[API_KEY]"
    
  4. Save the changes made.

Note

Lucee uses tomcat to run, for further information on configuring tomcat see Apache Tomcat