Enabling CORBA support

ColdFusion MX 7 supports third-party Object Request Brokers (ORBs) through its integration with Borland Visibroker. However, you must acquire the Common Object Request Broker Architecture (CORBA) software separately from Borland.

This section describes the following topics:

System requirements

You must have all of the following components installed on your computer before you can make CORBA invocations from ColdFusion MX 7:

Installing Visibroker for CORBA connections

To install Visibroker for CORBA connections:

  1. Install Visibroker on the CORBA server side.

    For more information, see the Borland Visibroker documentation.

  2. Add the vbjorb.jar file to the ColdFusion MX 7 classpath, as follows:
    1. In the ColdFusion MX Administrator, select Server Settings > Java and JVM. When using the J2EE configuration, you add the vbjorb.jar file to the J2EE application server classpath, using the server-specific method.
    2. On the Java and JVM Settings page, in the Class Path text box, enter the path to your vbjorb.jar file (for example, C:\Inprise\vbroker\lib\vbjorb.jar). If you are using JVM version 1.4 or later, you must add -Xbootclasspath/a:"C:/Inprise/vbroker/lib/vbjorb.jar", to the JVM Args text box.
    3. You only need the JAR file on the computer that is running ColdFusion MX 7; you do not need the full Visibroker installation.

    4. Click Submit Changes.
  3. Configure a Visibroker connector in ColdFusion MX 7, as follows:
    1. In the ColdFusion MX Administrator, select Extensions > CORBA Connectors.
    2. In the CORBA Connectors page, click Register CORBA Connector.
    3. In the CORBA Connector page, enter information for the connector.
    4. The following is an example of a correctly configured connector:

Field Value

ORB Name

visibroker

ORB Class Name

coldfusion.runtime.corba.VisibrokerConnector

Classpath

(none)

ORB Property File

C:\CFusionMX7\lib\vbjorb.properties

The ORB Property File points to a Java properties file that contains the correct ORB settings for Visibroker.

The contents of the vbjorb.properties file look like the following:

org.omg.CORBA.ORBClass=com.inprise.vbroker.orb.ORB org.omg.CORBA.ORBSingletonClass=com.inprise.vbroker.orb.ORB SVCnameroot=namingroot
  • When you finish editing the page, click Submit.
  • The CORBA Connectors page appears.

  • Select the radio button to the left of your new CORBA connector and click Select ORB Connector.
  • This sets the new connector to be the default.

  • Prepare your CORBA server side, as follows:
    1. Start your Visibroker osagent service or process, if it is not already running, by entering the following command:
    2. 	osagent
      

      Note: If you must connect to an osagent in another subnetwork, include the following lines in the vbjorb.properties file:

      vbroker.agent.addr=<IP address of machine running OSAGENT> vbroker.agent.port=<port>
    3. Start the Interface Repository and load it with the IDL file that you plan to use, by entering an irep command, as in the following example:
    4. 	irep myir MyIDLFile.idl 
      
    5. (Optional) Start the Naming Service by entering a command like the following:
    6. 	nameserv namingroot 
      

      Note: The name of the Naming Service (namingroot in the previous example) must match the value for SVCnameroot in the vbjorb.properties file.

    7. Start Visibroker on your CORBA server.
    8. For more information, see the Borland Visibroker documentation.

  • Restart ColdFusion MX 7 for your changes to take effect.

    For more information, see Managing ColdFusion MX 7.

    You can now make CORBA invocations from ColdFusion MX 7. For more information about integrating CORBA objects into ColdFusion MX 7, see ColdFusion MX Developer's Guide.


    View comments in LiveDocs