Installing ColdFusion MX
Configuring your System

Enabling CORBA support

ColdFusion MX 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 system requirements for enabling CORBA support, and explains how to install and configure Visibroker to work with ColdFusion MX.

System requirements

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

• Borland Visibroker 4.5.1 for Java
• Java Runtime Environment (JRE) 1.2 for the Visibroker Interface Repository
• JRE 1.3 or later for ColdFusion MX (this JRE is installed with ColdFusion MX)

Installing Visibroker for CORBA connections

To install Visibroker for CORBA connections:

1. Install Visibroker on the CORBA server side, if you have not already done so.

   For more information, see the Borland Visibroker documentation.

2. Add the vbjorb.jar file to the ColdFusion MX classpath, as follows:
   1. In the ColdFusion Administrator, select Server Settings > Java and JVM.
   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 only need the jar file on the computer that is running ColdFusion MX; you do not need the full Visibroker installation.)

   3. Click Submit Changes.
3. Configure a Visibroker connector in ColdFusion MX, 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:\CFusionMX\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. If you plan to use the Naming Service, start it by entering a command like the following:

         nameserv namingroot 
      

      Note:  IThe 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 MX for your changes to take effect.

   For more information, see "Managing ColdFusion MX".

You can now make CORBA invocations from ColdFusion MX. For more information about integrating CORBA objects into ColdFusion MX, see Developing ColdFusion MX Applications with CFML.

Copyright © 2002, Macromedia Inc. All rights reserved.

Comments