Skip to content

Server Installation

Introduction

This section will guide users through the process of installing NerdVision into their environment and based on the application server they are using.

Servers

Apache Tomcat (7 / 8 / 9)

To install NerdVision into an Apache Tomcat instance add the javaagent config to the Java arguments for the tomcat server. Please refer to the Apache Tomcat Guide to see how.

-javaagent:/full/path/to/nerdvision.jar=api.key=[API_KEY]

Eclipse Jetty (7 / 8 / 9)

To install NerdVision please refer to the start configuration files documentation from Eclipse Jetty Guide. Ensure that the --exec flag is defined in the ini before the javaagent for NerdVision.

--exec
-javaagent:/full/path/to/nerdvision.jar=api.key=[API_KEY]

Adobe ColdFusion (10+)

To install NerdVision 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 NerdVision 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. 
    -javaagent:/full/path/to/nerdvision.jar=api.key=[API_KEY]
    Replace the [API_KEY] (including the []) with your API key from accounts
  4. Save the changes made.

Here is an example of a jvm.config: 

...
# Arguments to VM
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 NerdVision 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. Replace the [API_KEY] (including the []) with your API key from accounts

  5. Save the changes made.

Tomcat configuration

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