Installing and Using ColdFusion MX for J2EE
Installing Macromedia ColdFusion MX for IBM WebSphere Application Server V5

Installing and deploying Macromedia ColdFusion MX

Before you can run ColdFusion applications, you must complete the following procedures to install and deploy ColdFusion MX to your application server:

1. Installing the ColdFusion MX files
2. Deploying ColdFusion MX on WebSphere
3. Running the startup wizard

Note:   This chapter describes how to install ColdFusion MX directly from the cfusion.ear file. You can also install ColdFusion MX as a WAR file, but the process is more complex. To install using a WAR file, you must expand the cfusion.ear file into its constituent WAR files and deploy the cfusion.war file, specifying a context root in the WebSphere Administrative Console. If you do not deploy ColdFusion at the / context root, you must also deploy the rds.war file and specify /CFIDE as its context root.

Installing the ColdFusion MX files

The specific file you use to install ColdFusion MX for J2EE depends on your operating system. The following table lists the supported operating systems and the files you use to install ColdFusion MX:

Operating system	Installation file
Windows	coldfusion-j2ee-win.exe
Linux	coldfusion-j2ee-linux.bin
Solaris	coldfusion-j2ee-solaris.bin
AIX	coldfusion-j2ee-java.jar

Use the following procedure to install the ColdFusion MX EAR file and installation documentation.

To install ColdFusion MX files:

1. Ensure that your system environment meets the system requirements described in Chapter 1, "Introduction".
2. Review the section "Installing ColdFusion MX for J2EE".
3. Read the Release Notes for any late-breaking information or updates.
4. Close any applications that are currently running on the computer to which you are deploying ColdFusion MX.
5. If you have the ColdFusion MX for J2EE CD-ROM, insert the CD. Otherwise, download the installer file for your platform from the Macromedia website or a designated network.
6. Start the installation program. Do one of the following, depending on your operating system:

   System	Procedure
   AIX	Set the working directory to the directory that contains the JAR file listed in the preceding table. Enter one of the following commands, replacing java_home with the path to the bin directory for your JRE installation: In GUI mode (you must have XWindows Display configured): java_home/java -jar coldfusion-j2ee-java.jar -i gui In console mode: java_home/java -jar coldfusion-j2ee-java.jar -i console
   Windows	Double-click the installer file.
   Solaris or Linux	Set the working directory to the directory that contains the installer file listed in the preceding table. In GUI mode (you must have XWindows Display configured), enter the installer file for your operating system, followed by the -i gui switch; for example: ./coldfusion-j2ee-linux.bin -i gui In console mode, enter the installer file for your operating system, followed by the -i console switch; for example: ./coldfusion-j2ee-linux.bin -i console

7. Follow the instructions in the installation program. Use the following information to complete certain sections of the installation program:
   • Before installing, determine the location of a working directory into which the ColdFusion MX for J2EE EAR file should be installed.
   • On the install wizard WAR or EAR file page, select EAR file (the default).
   • On the Context Root page, specify a name for the ColdFusion MX application context root.

     A context root is a container for ColdFusion MX; a web server uses this name to locate ColdFusion MX files. The default value is cfmx.

   • In the Administrator password page, enter the password for the ColdFusion MX Administrator.
   • Review the options in the Pre-Installation Summary section and accept them to complete the installation.

     The files are copied to the specified location.

   Note:   The installer creates the following log file: install_root/Macromedia_ColdFusion_MX_J2EE_InstallLog.log, where install_root is the directory that you specify when you install the ColdFusion MX files. If you contact Macromedia Technical Support for installation support, you must send them this log file.

Deploying ColdFusion MX on WebSphere

This section describes how to deploy ColdFusion MX on WebSphere 5.

To deploy ColdFusion MX on WebSphere 5:

1. Start the IBM Websphere Application Server, if it is not running.
2. Open the Run the IBM Websphere Administrative Console, if it is not running.
3. Open the Applications > Enterprise Applications page and click Install.
4. The Preparing Application Install page appears. Enter the path to the EAR file that you installed in the Installing the ColdFusion MX files procedure; for example C:\CFMXJ2ee\cfusion.ear.
5. Accept the default values on the Preparing Application Install page, if appropriate for your WebSphere configuration. Click Next.
6. Accept the default values in the Step 1: Provide Options to Perform the Installation panel of the Install New Application procedure, if appropriate for your WebSphere configuration. Click Next.
7. In Step 2: Map Virtual Hosts for Web Modules, select the virtual host or hosts in which to install the ColdFusion MX application and Remote Development Services (RDS) support. RDS must be on the same virtual host and port as ColdFusion. Click Next.
8. In Step 3: Map modules to Application Servers, if you have multiple application servers, select the application server in which to install the ColdFusion application and RDS support. Click Next.
9. In Step 4: Summary, review the installation configuration and click Finish.
10. Click the Save to Master Configuration link on the Installing page, and click the Save button on the Save page to save your workspace.
11. Start the ColdFusion Application in the Enterprise Applications panel, if necessary. Select the box next to Macromedia ColdFusion MX, and click Start.

Running the startup wizard

After you deploy ColdFusion MX, you run the startup wizard to configure ColdFusion MX. To run the startup wizard in your browser, enter the URL for the ColdFusion MX Administrator. The URL has the following form:

http://host:[port]/cf_context_root/CFIDE/administrator

for example:

http://localhost:9080/cfmx/CFIDE/administrator

For more information on specifying the Administrator URL, see "Accessing the ColdFusion MX Administrator".

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

• 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 "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.

When the wizard completes, login to the ColdFusion MX Administrator using the password you specified in the install procedure. Successful login to the Administrator confirms that the install procedure was successful. However, you must perform the tasks described in the "Enabling specific ColdFusion MX functionality" section before complete ColdFusion MX functionality is available.

ColdFusion 9 | ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | Bug Reporting

Version 6

Comments are no longer accepted for ColdFusion MX. ColdFusion 8 is the current version.

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6/Installing_CFMX_for_J2EE/install_Websphere52.htm

Add Comment