ColdFusion 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.

System requirements

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

• Borland Visibroker 4.5.1 for Java
• Java Runtime Environment (JRE) 1.2 for the Visibroker Interface Repository
• JRE 1.4 or later for ColdFusion 8

Installing Visibroker for CORBA connections

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 classpath, as follows:
   1. In the ColdFusion 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). You must add -Xbootclasspath/a:"C:/Inprise/vbroker/lib/vbjorb.jar", to the JVM Args text box.

      You require only the JAR file on the computer that is running ColdFusion; you do not need the full Visibroker installation.

   3. Click Submit Changes.
3. Configure a Visibroker connector in ColdFusion, as follows:
   1. In the ColdFusion 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.

      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:\ColdFusion8\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 
      
      

   4. When you finish editing the page, click Submit.

      The CORBA Connectors page appears.

   5. 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.

4. 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:

      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>
      
      

   2. 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:

      irep myir MyIDLFile.idl 
      
      

   3. (Optional) Start the Naming Service by entering a command like the following:

      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.

   4. Start Visibroker on your CORBA server.

      For more information, see the Borland Visibroker documentation.

5. Restart ColdFusion for your changes to take effect.

   For more information, see Managing ColdFusion services in Windows and Managing the ColdFusion process in UNIX.

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