ChartDirector for ColdFusion is implemented as a Java class library, and requires ColdFusion MX (Ver 6.0) or above. For earlier versions of ColdFusion, it is recommended you use ChartDirector for ASP/COM/VB and access ChartDirector through COM.

ChartDirector for ColdFusion is distributed as a zip file. The distribution contains the ChartDirector for ColdFusion library, comprehensive documentation, and numerous CFM sample scripts.

To install ChartDirector for ColdFusion:

• Extract the files from the ChartDirector distribution to any directory.
  
  
• Copy the file "ChartDirector/lib/ChartDirectorCF.jar" to a directory in the ColdFusion Java class path. You may determine the Java class path of your system using the ColdFusion Administrator (select "Server Settings / Settings Summary").
  
  
  
  
• Alternatively, you may add"ChartDirector/lib/ChartDirectorCF.jar" to the ColdFusion class path. To do this, from the ColdFusion Administrator, select "Server Settings / Java and JVM", and enter "[install_path]/ChartDirector/lib/ChartDirectorCF.jar" in the ColdFusion class path field ([install_path] is the directory which you extract ChartDirector to).
  
  
  
  
• Restart the ColdFusion server for the modification to take effect.
  

ChartDirector for ColdFusion comes with numerous CFM sample scripts in "ChartDirector/cfdemo". They are excellent examples and tutorials on how to use ChartDirector.

To run the ChartDirector CFM sample scripts, simply copy the entire "cfdemo" subdirectory to the ColdFusion web directory, then access the index page using:

If you have purchased a license to use ChartDirector, you should have a license key delivered to your via email and postal mail.

If your license key is for upgrading from a previous version of ChartDirector, you need to append the upgrade license key to the previous version license key, and use the combined license key.

There are two alternative methods to install the license key.

• Create a one-line ASCII file using Notepad or other text editor, and put the license key in that line. The whole file should contain only the license key. Name that file "chartdir.lic" and put the file in a directory in the Java class path. Please refer to the section "Installing ChartDirector for ColdFusion" above on how to determine the Java class path of your system..
  
  If the license file appears to have no effect (does not disable the yellow banner line), and you are running on a web server environment, please make sure the web server "anonymous user" has read access to the "chartdir.lic" file. You may copy the file "ChartDirector/cfdemo/cdinfo.cfm" to your web server and access it using a browser. It will display a diagnostic page explaining why the license cannot be loaded.
  
  
  Make sure your license file is called "chartdir.lic". In particular, Notepad may automatically append ".txt" to the file name when creating a new file. So even if the file is saved as "chartdir.lic", it may end up as "chartdir.lic.txt". If this is the case, please rename the file back to "chartdir.lic".
  
  
• An alternative method is to hard code the license key into the source code by using the ChartDirector.CFChart.setLicenseCode API. This method is recommended if your are redistributing ChartDirector, because your customer will then be unable to see the license key (unless your software is open source).
  
  
  cd = createObject("java", "ChartDirector.CFChart");
  cd.setLicenseCode(".....your-license-key.....");