TechNote (Archived)

ColdFusion MX 6.1 for BEA WebLogic (Unix only): Configuring cfchart functionality

Issue

When running Macromedia ColdFusion MX 6.1 for WebLogic on Unix platforms, charting must be configured before thecfchart tag can be used. The following errors will appear when using cfchart if ColdFusion has not been properly configured:

In the WebLogic startup console:

 Exception thrown by error-handling template:  coldfusion.graph.GraphingServiceImpl$GraphingEngineException: The  chart could not be generated due to an error in the graphing engine.

In the application.log file:

 Can't connect to X11 window server using ':0.0' as the value of the  DISPLAY variable.

The browser output consists of all HTML before thecfchart tag and the rest of the page would be blank.

Solution

Use the following steps to configure charting on ColdFusion MX 6.1 for WebLogic on Unix:

Stop the WebLogic server.
Make a backup of the startWebLogic.sh start script in the root directory of your WebLogic server installation.

Add the following Java options to thestartWebLogic.sh script:

-Xbootclasspath/a:cf_root/WEB-INF/cfusion/lib/webchartsJava2D.jar
-Djava.awt.graphicsenv=com.gp.java2d.ExGraphicsEnvironment

*For JDK 1.4.1 and later versions, specify com.gp.java2d.ExHeadlessGraphicsEnvironment instead of com.gp.java2d.ExGraphicsEnvironment.

Example:

 # Set JAVA_OPTIONS to the java flags you want to pass to the vm. If  # there are more than one, include quotes around them. For instance:  # JAVA_OPTIONS="-Dweblogic.attribute=value -Djava.attribute=value"  JAVA_OPTIONS="-Dweblogic.security.SSL.trustedCAKeyStore=/opt/  bea/weblogic700/server/lib/certs -Xbootclasspath/a:/opt/bea/  user_projects/cfmx61_domain/applications/cfmx/WEB-INF/cfusion/lib/  webchartsJava2D.jar -Djava.awt.graphicsenv=  com.gp.java2d.ExGraphicsEnvironment"

Save startWebLogic.sh.
Restart the server.

Similar steps are required for all supported J2EE application servers on Unix platforms. Instructions for each can be found through the deployment links in the J2EE documentation.