Accessibility
 
Home / Products / ColdFusion / Support
J2EE Support

Installing and Deploying ColdFusion MX 6.1 on Sun ONE Application Server

Macromedia ColdFusion MX 6.1 supports a server configuration (which includes an embedded version of JRun) and a J2EE configuration (which lets you deploy ColdFusion MX as a Java application running on a Java 2 Enterprise Edition (J2EE) application server). When you run ColdFusion MX 6.1 in the J2EE configuration, you use the application server's deployment mechanism to deploy ColdFusion MX on a J2EE 1.3 compliant application server. The Installation Wizard lets you install ColdFusion MX as an enterprise application or as a web application.

About this document

Installing, deploying, and configuring ColdFusion MX 6.1

Usage notes

About this document

This document provides instructions for deploying and configuring ColdFusion MX in the J2EE configuration on Sun ONE Application Server 7. It refers to overview information in Installing and Using ColdFusion MX, which is available on LiveDocs (English and Japanese only).

Before continuing, you should read the ColdFusion MX 6.1 Release Notes. You should also read the first and third chapters of Installing and Using ColdFusion MX.

These instructions contain application server-specific instructions on installing a new copy of ColdFusion MX. For instructions on updating an existing ColdFusion MX J2EE Server installation to ColdFusion MX 6.1, and for configuration information that is common to all J2EE servers, see "Enabling and Using ColdFusion MX Features on Your J2EE Server" before continuing.

Conventions in this document

This document uses the following conventions to reference Sun ONE Application Server 7 and ColdFusion directories:

  • cfmx_install_directory - The directory that contains the files extracted by the ColdFusion MX for J2EE installer; for example, C:\cfmx or /opt/cfmx.
  • sunone_root - The directory that contains Sun ONE Application Server 7; for example, C:\Sun\AppServer7.
  • cf_root - The directory into which Sun ONE Application Server 7 deployed the ColdFusion MX web application; for example, C:\Sun\AppServer7\domains\domain1\server1\applications\j2ee-apps\cfusion_1\cfusion_war.
  • java_home - The root directory of your Java 2 software development kit (J2SDK); for example, C:\j2sdk1.4.1.

Installing, deploying, and configuring ColdFusion MX 6.1

You deploy ColdFusion MX 6.1 in the J2EE configuration on Sun ONE Application Server 7; using an EAR file.

Note: If you are updating a currently deployed version of ColdFusion MX on Sun ONE Application Server 7, see the instructions in Enabling and Using ColdFusion MX Features on Your J2EE Server before continuing.

To install ColdFusion MX 6.1 on Sun ONE Application Server 7:

  1. Run the ColdFusion MX 6.1 Installation Wizard after downloading the platform-specific installer:
    • Windows - coldfusion-61-win.exe
    • Linux - coldfusion-61-lin.bin
    • Solaris - coldfusion-61-sol.bin
    • Other platforms - coldfusion-61-other.jar (run with java_home/bin/java -jar coldfusion-61-other.jar -i console)

    These installers are available on the Macromedia website. There is no Sun ONE Application Server 7-specific installer; you can download any version that matches your platform.

  2. Answer the questions. When prompted, do the following:
    1. Select Enterprise, Developer, or Trial Edition.
    2. Select J2EE configuration/EAR file.
    3. Specify the installation directory.
    4. Specify a password for use with the ColdFusion MX Administrator.
    5. Specify a context root for ColdFusion MX.

      The Installation Wizard places the cfusion.ear file in the installation directory.

  3. Ensure that the Sun ONE Admin Server is started.
  4. Open the Sun ONE Administrative Console (typically http://localhost:4848).
  5. Go to App Server Instances > servername > Applications > Enterprise Apps.
  6. Click Deploy.
  7. Specify the fully-qualified path to the cfusion.ear file (cfmx_install_directory/cfusion.ear).
  8. Click OK.
  9. Click OK again.
  10. Stop the Sun ONE Application Server.
  11. Open the sunone_root/AppServer7/domains/domain1/servername/config/server.policy file in a text editor, comment out the restrictive permissions, and add permission java.security.AllPermission;, as the following example shows:

    ...
    // Basic set of required permissions granted to all remaining code
    grant {
      permission java.security.AllPermission;
      /*
      permission java.lang.RuntimePermission  "loadLibrary.*";
    ...
      permission java.io.FilePermission  "${INSTALL_ROOT}${/}instances${/}-", "delete";
      */
    };
    

  12. Start the Sun ONE Application Server.
  13. Configure JVM settings, as described in Configuring JVM settings.
  14. Restart the Sun ONE Application Server and monitor startup messages to ensure that all configurations were applied successfully.
  15. Start the ColdFusion Administrator and run the Configuration and Settings Migration Wizard. You start the Administrator using a URL of the form http://hostname:portnumber/cfusion/CFIDE/administrator/index.cfm, as follows:
    • hostname - The machine name, IP address, localhost, or 127.0.0.1.
    • portnumber - The port number of the web server (typically 80 or 81).
  16. Code and test ColdFusion MX (CFM) pages. Store these pages in the cfusion web application root directory. For example, to display a CFM file located at C:\Sun\AppServ7\domains\domain1\servername\applications\j2ee-apps\cfusion_1\cfusion_war\eisapp\index.cfm, you specify the URL as http://127.0.0.1:81/cfusion/eisapp/index.cfm.

Configuring JVM settings

ColdFusion MX requires JVM configuration because certain types of ColdFusion MX functionality require server-specific environment settings. Additionally, certain ColdFusion MX features use platform-specific binary files (that is, compiled C++ files, not Java bytecode), which are provided for Windows, Solaris, and Linux.

Note: If your JRun version runs on an operating system other than Windows, Solaris, or Linux, you can still run ColdFusion MX, but platform-specific functionality is unavailable.

In Sun ONE Application Server 7, you define JVM arguments through the Admin Console. This section describes what to do for the following functionality:

Accessing COM objects (Windows)

This section explains how to enable Component Object Model (COM) support in Windows after installing ColdFusion MX.

To enable COM support:

  1. Open the Sun ONE administrative console, go to Application Server Instances > servername > JVM Settings > Path Settings, and add the following libraries to either the Native Library Path Prefix or Native Library Path Suffix text box:
    cf_root/WEB-INF/cfusion/jintegra/bin 
    cf_root/WEB-INF/cfusion/jintegra/bin/international 
    
  2. Click Save.
  3. In the Sun ONE administrative console, go to Application Server Instances > servername > JVM Settings > JVM Options, and add the following:
    -DJINTEGRA_NATIVE_MODE -DJINTEGRA_PREFETCH_ENUMS
    
  4. Click the General tab, and then click Apply Changes. These changes take effect when you restart the Sun One Application Server.

Enabling charting and graphing

This section describes how to configure your application server to use ColdFusion MX charting and graphing (cfchart, cfchartdata, and cfchartseries tags).

To enable charting and graphing:

  1. Open the Sun ONE administrative console, go to Application Server Instances > servername > JVM Settings > JVM Options, and add the following line:

    -Xbootclasspath/a:cf_root/WEB-INF/cfusion/lib/webchartsJava2D.jar
    

  2. (UNIX-only) Add the following line:
    -Djava.awt.graphicsenv=com.gp.java2d.ExGraphicsEnvironment
    

    Note: For JDK 1.4.1 and later versions, specify com.gp.java2d.ExHeadlessGraphicsEnvironment instead of com.gp.java2d.ExGraphicsEnvironment.

  3. Click the General tab, and then click Apply Changes. These changes take effect when you restart the Sun One Application Server.

Supporting Verity searches

To use the Verity search engine and the cfcollection, cfindex, and cfsearch tags, you must enable Verity searching. To do searches in languages other than English, including European and Asian languages, you must also install language-specific Verity Search Packs, which is described in Enabling and Using ColdFusion MX Features on Your J2EE Server.

To enable Verity, 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 in Windows, and the cf_root/WEB-INF/cfusion/lib directory on UNIX.)

To configure Sun ONE for Verity:

  1. Open the Sun ONE administrative console, select Application Server Instances > servername > JVM Settings > Path Settings, and add the following libraries to the Native Library Path Prefix text box:

    cf_root/WEB-INF/cfusion/lib 
    cf_root/WEB-INF/cfusion/lib/platform/bin (where platform is _nti40 or _solaris) 
    

  2. Click Save.
  3. Click the General tab, and then click Apply Changes. These changes take effect when you restart the Sun One Application Server.

Usage notes

Disabling RDS

For security reasons, Macromedia recommends that you disable RDS on a production server. If you install and enable RDS support, you can disable it later by undeploying it.

Note: If RDS is disabled, the Browse Server button does not work in the ColdFusion MX Administrator (for example, on the ColdFusion Mappings page).

To disable RDS:

  1. Disable RDSServlet in the ColdFusion MX web application.
  2. If your ColdFusion MX application context root is not /, disable the RDS web application.

For instructions on disabling the RDS Servlet, see Enabling and Using ColdFusion MX Features on Your J2EE Server. The following procedure describes how to disable the RDS web application.

To disable the RDS web application:

  1. Open sunone_root/domains/domain1/server1/applications/j2ee-apps/cfusion_n/META-INF/application.xml in a text editor.
  2. Comment out the module element for RDS:

    <!-- <module>
      <web>
        <web-uri>rds.war</web-uri>
        <context-root>/CFIDE</context-root>
      </web>
    </module> -->
    

  3. Restart the Sun ONE Application Server.

Undeploying ColdFusion MX 6.1

To undeploy ColdFusion MX:

  1. (Windows only) If you installed the ColdFusion ODBC services, remove them by executing cf_root/WEB-INF/cfusion/db/SequeLink Setup/RemoveSequeLink.bat.
  2. Open the Sun ONE Administrative Console (typically http://localhost:4848).
  3. Go to App Server Instances > servername > Applications > Enterprise Apps.
  4. Select cfusion.
  5. Click Undeploy.
  6. Click OK to confirm the request.