• Windows - coldfusion-j2ee-win.exe
• Linux - coldfusion-j2ee-linux.bin
• Solaris - coldfusion-j2ee-solaris.bin
• Other platforms - coldfusion-j2ee-java.jar (run with java_home/java -jar coldfusion-j2ee-java.jar -i console)

If you purchased the ColdFusion MX for Sun ONE Web Server 6 box, you should use disk 2. You can download ColdFusion MX for J2EE installers from the Macromedia website.

Deploy the ColdFusion MX web application using the wdeploy utility. The wdeploy utility is in the sunone_root/servers/bin/https/httpadmin/bin directory. Use the following syntax:

wdeploy deploy -u uri_path -i instance -v vs_id [-d directory] war_file

UNIX example:
./wdeploy deploy -u /cfusion -i https-AUTOCLIENT4 -v https-AUTOCLIENT4 -d /usr/iplanet/servers/bin/https/webapps/cfusion /opt/CFMXJ2ee/cfusion.war

Windows example:
wdeploy deploy -u /cfusion -i https-AUTOCLIENT4 -v https-AUTOCLIENT4 -d C:\iPlanet\Servers\bin\https\webapps\cfusion c:\cfmxj2ee\cfusion.war

Deploy the RDS web application using the wdeploy utility. The wdeploy utility is in the sunone_root/servers/bin/https/httpadmin/bin directory. Use the following syntax:

wdeploy deploy -u uri_path -i instance -v vs_id [-d directory] war_file

UNIX example:
./wdeploy deploy -u /CFIDE -i https-AUTOCLIENT4 -v https-AUTOCLIENT4 -d /usr/iplanet/servers/bin/https/webapps/CFIDE /opt/CFMXJ2ee/rds.war

Windows example:
wdeploy deploy -u /CFIDE -i https-AUTOCLIENT4 -v https-AUTOCLIENT4 -d c:\iPlanet\Servers\bin\https\webapps\CFIDE c:\cfmxj2ee\rds.war

(Windows only) Configuring COM - Perform the following steps:

1. Select Start > Run. In the Run dialog box, type regedit, and click OK.
   
2. In the Registry Editor, open the following registry key for editing:
   \\HKEY_LOCAL_MACHINE\SOFTWARE\Netscape\Enterprise\6.0\NSES_JRE_RUNTIME_LIBPATH
   
3. Append the following directories to this key’s value, separating each directory with a semicolon character (;):
   cf_root\WEB-INF\cfusion\jintegra\bin
   cf_root\WEB-INF\cfusion\jintegra\bin\international
   
   The following is an example value for this registry key:
   C:\iPlanet\Servers\docs\cfmx\WEB-INF\cfusion\jintegra\bin;C:\iPlanet\Servers\docs\cfmx\WEB-INF\cfusion\jintegra\bin\international
   
4. Click OK and close the Registry Editor.
   
5. Restart Sun ONE Web Server.

(Windows and Linux-only) Configuring Verity support - To enable Verity (cfcollection, cfindex, and cfsearch tags), you must configure the library search path to find the Verity binary files. (The Verity files are in the cf_root/WEB-INF/cfusion/lib directory.)

Note: This functionality is not available on Solaris, due to an incompatibility between Sun ONE Web Server and the ColdFusion MX code that makes the underlying C code for the Verity search engine interoperable with Java.

Windows

1. Select Start > Run. In the Run dialog box, type regedit, and click OK.
   
2. In the Registry Editor, open the following registry key for editing:
   \\HKEY_LOCAL_MACHINE\SOFTWARE\Netscape\Enterprise\6.0\NSES_JRE_RUNTIME_LIBPATH
   
3. Append the following directories to this key’s value, separating each directory with a semicolon character (;):
   cf_root\WEB-INF\cfusion\lib
   cf_root\WEB-INF\cfusion\lib\_nti40\bin
   
4. Click OK and close the Registry Editor.
   
5. Restart Sun ONE Web Server.

Linux

1. Make a backup copy of the start script in the sunone_root/servers/https-computer_name directory (for example, /opt/iplanet/servers/https-fred/start).
   
2. Open the original file for editing, and add the following entry on a single, long line:
   LD_LIBRARY_PATH=${SERVER_ROOT}/bin/${PRODUCT_NAME}/lib:
   ${LD_LIBRARY_PATH}:cf_root/WEB-INF/cfusion/lib/:cf_root/WEB-INF/ cfusion/lib/_ilnx21/bin/
   
   For example:
   LD_LIBRARY_PATH=${SERVER_ROOT}/bin/${PRODUCT_NAME}/lib:
   ${LD_LIBRARY_PATH}:/home/iplanet/servers/docs/cfmx/WEB-INF/
   cfusion/lib/:/home/iplanet/servers/docs/cfmx/WEB-INF/cfusion/
   lib/_ilnx21/bin/
   
3. Save the file and restart Sun ONE Web Server.

You can now use Verity in ColdFusion MX on Linux.

(UNIX only) Configuring graphing support - Perform the following steps:

1. Make a backup copy of the JVM configuration file (jvm12.conf ) in the sunone_root/servers/https-computer_name/config directory (for example, /opt/iplanet/servers/https-fred/config/jvm12.conf ).
   
2. Open the original configuration file for editing, and add the following lines:
   
   jvm.option=-Xbootclasspath:jdk_home/lib/tools.jar:jdk_home/jre/lib/rt.jar:
   jdk_home/lib/dt.jar:jdk_home/jre/lib/i18n.jar:cf_root/WEB-INF/lib/
   webchartsJava2D.jar
   jvm.option=-Djava.awt.graphicsenv=com.gp.java2d.ExGraphicsEnvironment
   

   Note 1: For JDK 1.4.1, specify com.gp.java2d.ExHeadlessGraphicsEnvironment (ColdFusion MX Updater 3 required).
   Note 2: jdk_home is the location of the JDK that Sun ONE uses for ColdFusion MX;
   for example, /usr/java/jdk1.3.1_03.

3. Save the file.
   You can now use ColdFusion MX charting and graphing without any errors.

Configuring support for .NET web service consumption. To consume .NET WebServices, copy cf_root/WEB-INF/cfusion/lib/crimson.jar to sunone_root/bin/https/jar folder and restart Sun ONE Web Server.

(Solaris and Linux only) Enabling C++ CFX support - Perform the following steps:

1. Make a backup copy of the start script in the sunone_root/servers/https-computer_name directory (for example, /opt/iplanet/servers/https-fred/start).
2. Open the original file for editing, and add the following entry on a single, long line:
   
   LD_LIBRARY_PATH=${SERVER_ROOT}/bin/${PRODUCT_NAME}/lib:
   ${LD_LIBRARY_PATH}:cf_root/WEB-INF/cfusion/lib/
   
   The following is an example:
   LD_LIBRARY_PATH=${SERVER_ROOT}/bin/${PRODUCT_NAME}/lib:
   ${LD_LIBRARY_PATH}:/home/iplanet/servers/docs/cfmx/WEB-INF/
   cfusion/lib/
3. Save the file and restart Sun ONE Web Server.

You can now use CFX in ColdFusion MX.

Start the ColdFusion MX Administrator and run the startup wizard by entering the URL for the ColdFusion MX Administrator in a browser. The URL has the following form:

http://host:[port]/cf_root/CFIDE/administrator
for example:
http://localhost:81/cfusion/CFIDE/administrator

When you first access the Administrator, ColdFusion runs the startup wizard. You provide the following information in the wizard to configure ColdFusion MX:

• Your Administrator password, originally specified when running the installer.
• Your serial number. If you do not enter a serial number and click Continue in Trial Mode, you can use ColdFusion in a fully featured Trial mode for 30 days. After 30 days without a serial number, ColdFusion runs in Developer mode, which only supports requests from the local host and one remote IP address.
  If you do not enter a serial number in the wizard, you can supply one later using the Version Information panel of the ColdFusion MX Administrator.
• Whether to configure RDS support and, if you configure RDS support, the RDS password. To maximize security, do not install RDS on production servers. For more information on RDS, see the LiveDocs discussion, Using RDS.
• (Windows only) Whether to install support for ODBC data sources, such as Microsoft Access. If you select Yes, ColdFusion installs an additional database driver and a set of services for connecting to ODBC.
• The language for online Help in the ColdFusion MX Administrator and sample applications (if installed).
• Whether to install example applications. For security reasons, Macromedia recommends that you do not install example applications on production servers.

Successful login to the Administrator is a confirmation that the install procedure was successful. However, before complete ColdFusion MX functionality is available, you might have to perform additional, site-specific tasks, as described in the following LiveDocs sections:

• Installing Verity Search Packs for ColdFusion MX
• Enabling CORBA support
• Using a third-party JDBC database driver
  

Code and test ColdFusion MX CFM pages. Store these pages in the cfusion web application root, as described in the Using ColdFusion MX Applications
with J2EE Application Servers chapter in the Installing and Using ColdFusion MX for J2EE book. You access these pages using a URL of the form http://hostname[:portnumber]/cfusion/filename.cfm, as follows:

• hostname - The machine name, IP address, localhost, or 127.0.0.1.
• portnumber - The port number of the Sun ONE Web Server, typically 80 or 81.
• filename - The directory path and file to display. The path is relative to the cfusion directory.

For example, to display a CFM file located at C:\iPlanet\Servers\bin\https\webapps\cfusion\eisapp\index.cfm, you specify the URL as http://127.0.0.1:81/cfusion/eisapp/index.cfm.