ColdFusion

ColdFusion application servers can use either the .NET Corda® Embedder (Windows* only) or the Java* Corda Embedder (any supported platform). In both cases, the code looks almost exactly alike; however, the installation process differs.

For instructions on using the Corda Embedder in ColdFusion* pages, see ColdFusion in the Corda 7 Developer Reference or ColdFusion in the Corda 7 Highwire™ Guide.

Using the .NET Corda Embedder (Windows Only)

When using ColdFusion MX on Windows, be sure you have updated the server to the latest version using the ColdFusion MX Updater Release 1, available at http://www.macromedia.com/support/coldfusion/releasenotes/mx/releasenotes_mx_updater.html. Apply this update to fix a bug in ColdFusion MX that prevents it from accessing Window’s COM.

In order to use Corda Embedder in COM-aware environments such as ColdFusion, register the .NET Corda Embedder as a COM component. This lets you access the .NET Corda Embedder from ASPs or other Web Applications that rely on COM.

Prior to doing this, you must first install the .NET SDK and then install the .NET Corda Embedder using the instructions in the text file located at <product_root>\Server\dev_tools\embedder\dotnet\COMInteropInstall.txt.

Using the Java Corda Embedder (Any Platform)

Put <product_root>\Server\dev_tools\embedder\java\CordaEmbedder.jar in ColdFusion's Java classpath. The process for doing this varies, based on the version of ColdFusion you are using.

ColdFusion MX

To install the Corda Embedder with ColdFusion MX, include <product_root>\Resources\dev_tools\embedder\java \CordaEmbedder.jar in the ColdFusion classpath.

To add Corda Embedder to ColdFusion MX's Java Classpath

  1. Launch the ColdFusion Administrator .

  2. Select the Java and JVM option under Server Settings on the left.

  3. Enter the absolute path to the CordaEmbedder.jar file in the ClassPath textbox.

    If something is already entered in that textbox, append a comma to the end of the string and enter <product_root>\Resources\dev_tools\embedder\java\CordaEmbedder.jar.

  4. Click the Submit Changes button to save the settings.

  5. Restart ColdFusion for the changes to take effect.

Previous ColdFusion Versions

The installation process for previous versions is almost as easy.

To add Corda Embedder to older ColdFusion servers

  1. Launch the ColdFusion Administrator on the machine where you are installing the Corda Embedder.

  2. Once there, click the Java option under Server on the left-hand menu.

    This brings you to the Java Settings window.

  3. Make sure Load JVM when starting Cold Fusion has been checked.

    You may also need to specify the location of the Java VM on the server, if it hasn't already been specified. In Microsoft* Windows, look for jvm.dll. In UNIX*, look for libjvm.so. If you installed a Java VM with Corda 7, the appropriate file is in <product_root>\Resources \jre\bin\hotspot.

  4. Add the location (absolute path) of the CordaEmbedder.jar file to the Class Path variable, as shown in the following image.

    If other files are already in the classpath, make sure you separate the files with a semi-colon.

  5. Click the Apply button to save the changes.

  6. Restart ColdFusion for the changes to take effect.