Read the Release Notes for any late-breaking information or updates.
Close any applications that are currently running on the computer to which you are deploying ColdFusion MX.
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. The installer files for ColdFusion MX for J2EE are called coldfusion-j2ee-win.exe for Windows, coldfusion-j2ee-linux.bin for Linux, and coldfusion-j2ee-solaris.bin for Solaris.
Start the installation program. Do one of the following, depending on your operating system:
System
Procedure
Windows
Double-click the installer file.
Solaris or Linux
Set the working directory to the directory that contains the installer file. 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
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 files should be installed.
On the install wizard WAR or EAR file page, select WAR file.
On 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 on WebLogic Server
This section describes how to deploy ColdFusion MX on WebLogic Server.
To deploy ColdFusion MX on WebLogic Server:
Determine the domain in which to deploy ColdFusion MX using one of the following methods:
Existing domain Deploy ColdFusion MX to an existing domain; for example, weblogic_root/weblogic700/samples/server/config/examples).
New domain Create a new domain. On Windows, select Start > Bea WebLogic > Domain Configuration Wizard and follow the instructions to create a new domain using the WLS Domain template. On UNIX, run weblogic_root/weblogic700/common/bin/dmwiz.sh.
When creating the new domain, write down the port numbers, user ID, and password specified during domain creation. You will need them when starting the server and when accessing the ColdFusion MX Administrator.
The domain to which ColdFusion MX is deployed is referred to as wldomain_root.
Create a directory under wldomain_root to contain the ColdFusion MX web application. The name of this directory serves as the ColdFusion MX web application context root and is referred to as cf_root.
Using either jar xf or WinZip, expand cfusion.war into the directory you created for the ColdFusion MX web application.
Start the WebLogic Server for the newly created domain by running (or double-clicking) wldomain_root/startWebLogic.cmd (Windows) or wldomain_root/startWebLogic.sh (Unix). WebLogic prompts you for the user ID and password specified during domain creation.
Open the WebLogic Administration Console (http://hostname:portnumber/console) and select domainname > Deployments > Web Applications.
Click Configure a new Web Application.
If necessary, navigate to the directory that contains the expanded ColdFusion WAR file. Click the [select] link when you reach that directory.
The Configure Application or Component window appears.
Select the target server, optionally modify the default name, and click Configure and Deploy.
WebLogic deploys the ColdFusion MX web application. Depending on your server, this might take a few minutes.
Tip: You can also deploy the ColdFusion MX web application using auto-deploy or any other WebLogic deployment mechanism.
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:
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 Administrator using the password specified in the install procedure. Successful login to the Administrator is a confirmation that the install procedure was successful. However, you must perform the tasks described in "Enabling specific ColdFusion MX functionality" before complete ColdFusion MX functionality is available.