Installing and Configuring ColdFusion Server
Basic ColdFusion Server Administration

Extensions

You use the Extensions pages of the Administrator to configure ColdFusion Server to work with other technologies, such as Java and CORBA. These pages make up the Administrator Extensions section:

• JVM and Java Settings
• Java Applets
• CFX Tags
• Custom Tag Paths
• CORBA Connectors

JVM and Java Settings

The JVM and Java Settings page lets you specify settings that enable ColdFusion Server to work with Java

Setting	Description
Java Virtual Machine Path	The absolute file path to the location of the Java virtual machine (JVM): jvm.dll in Windows or jvm.so in Solaris, Linux, and HP-UX
Initial Heap Size	JVM initial heap memory size
Max Heap Size	JVM maximum heap memory size
Load JVM When Starting ColdFusion	Loads the JVM when ColdFusion Server starts up. If not selected, the JVM loads on the first client request that requires Java.
Class Path	The file paths to the directories that contain the Java classes used by ColdFusion Server: separate paths by semi-colons in Windows, or colons in Solaris, Linux, and HP-UX
System Options	Standard JVM initialization options, as name-value pairs: separate options by semi-colons in Windows and colons in Solaris, Linux, and HP-UX
Implementation Options	Implementation-specific JVM initialization options, as name-value pairs separated by spaces
CFX Jar Path	File path to the ColdFusion cfx.jar file that contains interfaces used by Java CFX tags

:

When finished, click Submit Changes.

Java Applets

The Java Applets page of the Administrator lets you register applets, modify applet registrations, and delete applet registrations. Before you can use Java applets in your ColdFusion applications, you must register them in the Java Applets page.

When your applet is registered with ColdFusion Server, using the cfapplet tag in your CFML code is very simple, because all parameters are predefined. Simply enter the applet source and the form variable name you want to use.

To register a Java applet:

1. On the Java Applets page, click Register New Applet. The Add/Registered Applet page displays.
2. Enter options for the following settings:

   Setting	Description
   Applet Name	Applet name
   Code	Name of the file that contains the applet subclass. Must be relative to the code base URL. The class extension is not required.
   Code Base	The base URL of the applet: the directory that contains the applet components. The applet class files must be located within the Web server root directory, such as http://servername/classes
   Archive	File name for the applet archive
   Method	Method name in the applet that returns a string value. You use this method name in the NAME attribute of the cfapplet tag to populate a form variable with the method value. If the applet has no method, leave this field blank.
   Height	Applet height, in pixels
   Width	Applet width, in pixel
   VSpace	Measurement, in pixels, for the space above and below the applet
   HSpace	Measurement, in pixels, for the space on each side of the applet
   Align	Applet alignment
   Not Supported Message	Message to display if the user's Web browser does not support Java applets. To override this message, specify a different one in the cfapplet tag notsupported attribute.
   Parameter Name	Name for a required applet parameter, typically provided by the applet.
   Value	Default value for parameter

The Java applet displays in the Registered Java Applets table on the Java Applets page.

To modify a Java applet registration:

1. In the Registered Java Applet page, click a Java applet name.
2. In the Add/Registered Java Applet page, change any setting.
3. Click Submit Changes.

The modified applet displays in the Registered Java Applets table on the Java Applets page.

To delete a Java applet registration:

In the Registered Java Applets table, click the Delete Applet icon in the Controls column in the row of the applet you want to delete. The applet disappears.

CFX Tags

Before you can use a CFX tag in ColdFusion applications, you must register it. You use the CFX Tags page to register and manage ColdFusion custom tags built with C++ and Java.

You build CFX tags:

• Using C++ as a dynamic link library (DLL) in Windows; as shared objects (so/sl) on Solaris, Linux, and HP-UX
• Using Java interfaces defined within cfx.jar

To register a C++ CFX tag:

1. On the CFX Tags page, click Register C++ CFX. The Add/Edit C++ CFX Tag page displays.
2. Enter options for the following settings:

   Setting	Description
   Tag Name	Tag name, which must be prefaced with CFX_
   Server Library (.DLL/.SO/.SL)	File path for the library or shared object
   Procedure	Procedure name that implements the tag, which must correspond with the procedure name in the library or shared library
   Keep Library Loaded	Prevents ColdFusion Server from reloading the library into memory each time it is accessed
   Description	Description for the CFX tag

3. Click Submit Changes.

The CFX tag displays in the Registered CFX Tags table on the CFX Tags page.

To register Java CFX tag:

1. On the CFX Tags page, click Register Java CFX. The Add/Edit Java CFX tag page displays.
2. Enter options for the following settings;

   Setting	Description
   Tag Name	Tag name, which must be prefaced with CFX_
   Class Name	File name for the Java class with no .class extension
   Description	Description for the CFX tag

   
   

   Note The class file must be accessible from the Class Path set in the JVM and Java Settings page.

   
   
3. Click Submit Changes.

The CFX tag displays in the Registered CFX Tags table on the CFX Tags page.

To modify a CFX tag registration:

1. On the CFX Tags page, click a CFX tag name in the Registered CFX Tags table.
2. In the Add/Edit CFX/Java CFX Tag page, change any setting.
3. Click Submit Changes.

The modified CFX tag appears in the Registered CFX Tags table on the CFX Tags page.

To delete a CFX tag registration:

In the Registered CFX Tags table, click the Delete Applet icon in the Controls column of the row for the CFX tag you want to delete. The CFX tag disappears.

CFX tag samples

Source code and compiled versions of two sample CFX tags are installed with ColdFusion Server. You must first compile this code before registering the DLLs or shared objects in the Administrator. The examples can be found in:

• /opt/coldfusion/cfx/examples, in Solaris, Linux, and HP-UX
• cfusion\cfx\examples, in Windows

The CFX tag examples installed with ColdFusion Server are:

• directorylist - returns a directory listing
• nt_userdb - modifies Windows NT and Windows 2000 user permissions

Custom Tag Paths

You use the Custom Tag Paths page of the Administrator to add and delete custom tag directory paths. You must register the directories that contain custom tags.

To add a custom tag path:

1. On the Custom Tag Paths page, enter the file path to the directory that contains custom tags, or click Browse Server to navigate to the directory.
2. Click Add Path.

The path displays on the Custom Tag Paths page.

To delete a custom tag path:

1. Select a tag path to delete.
2. Click Delete.

The path disappears.

CORBA Connectors

You use the CORBA Connectors page of the Administrator to register, modify, and delete CORBA connectors. You must register CORBA connectors before using them in your ColdFusion applications.

ColdFusion Server loads Orb libraries dynamically using a connector, which does not tie ColdFusion customers to a specific Orb vendor. The connectors depend on the Orb runtime libraries provided by the vendor. The connectors are located in the bin directory in Windows and the lib directory in Solaris and HP-UX. Ensure that the appropriate libraries reside in the load library search path for the ColdFusion executable.

The following table contains information about the libraries and connectors:

Operating System	Vendor	Orb	ColdFusion Connector	Orb Libraries
Windows NT 4.0	Inprise	VisiBroker 3.3	cf_vb33.dll	orb_r.dll name_r.dll
Solaris 7	Inprise	VisiBroker 4.0	cf_vb40.so	liborb_r.so libcosnm_r.so libvport_r.so
HP-UX 11.0	Inprise	VisiBroker 3.3	cf_vb33.sl	liborb_r.so libname_r.so

To add a CORBA connectors:

1. On the CORBA connections page, click Register CORBA Connector.The New CORBA Connector page displays.
2. Enter options for the following settings:

   Setting	Description
   ORB Name	Orb name (alphanumeric characters only)
   DLL Path	File path to the DLL that the ORB uses
   ORB Initialization Options	Options that are necessary to initialize the ORB, separated by spaces

3. Click Submit Changes.

The ORB connector displays in the Registered CORBA Connectors table on the CORBA Connectors page.

To modify a CORBA connector registration:

1. In the Registered CORBA Connectors table on the CORBA Connections page, click a CORBA Connector name. The CORBA Connector page displays.
2. Change any setting.
3. Click Submit Changes.

The modified CORBA connector displays in the Registered CORBA Connector table.

To delete a CORBA connector registration:

In the Registered CORBA Connectors table, click the Delete Connector icon in the Controls column of the row for the CORBA connector to delete. The CORBA connector disappears.

Copyright © 2001, Macromedia Inc. All rights reserved.

---