Installing the J2EE configuration with JRun

Installing the J2EE configuration with JRun

When deploying ColdFusion MX as an enterprise application and installing JRun 4 as part of the installation procedure, the installation wizard performs the following actions:

• Installs JRun 4.

• Creates a JRun server named cfusion (in addition to the default, admin, and samples JRun servers, which are part of the default JRun installation).

• (Windows) Creates and starts Windows services for the admin, default, and cfusion JRun servers.

• Deploys the ColdFusion MX EAR in the JRun cfusion server.

• Configures jrun_root/bin/jvm.config, as appropriate for the platform.

• (Optional) Configures the JRun cfusion server for use with an external web server. In Windows, the installation wizard runs the Web Server Configuration Tool. On UNIX, the installation wizard creates a shell script that you can run to execute the Web Server Configuration Tool with the settings specified in the installation wizard.

Note: The default JRun web server port for the cfusion server is 8300.

Installing the J2EE configuration with JRun in Windows This section explains how to install Macromedia JRun 4 and the ColdFusion MX 6.1 J2EE

configuration in a Windows platform.

Note: The Windows installer requires a computer that supports at least 256 colors.

To install the J2EE configuration with JRun in Windows:

1 Read the online version of the Release Notes for any late-breaking information or updates. For more information, see www.macromedia.com/go/proddoc_releasenotes.

2 Make sure that your operating system meets the system requirements described in “System requirements”

3 Review the “Installation considerations for Windows”

4 Determine and record environment information, as described in “Preparing to install using the J2EE configuration”

5 Close any applications that are currently running on your computer.

6 If you plan to configure an external web server, ensure that the web server is running.

7 Insert the CD or download the setup file from the Macromedia website.

8 If the installation wizard does not start automatically when you insert the CD, locate setup.exe on the CD and double-click it. If you are installing from a network or a downloaded file, locate the ColdFusion MX 6.1 installation executable file (coldfusion-61-win.exe) and double-click it. The installation wizard starts.

9 Follow the instructions in the installation wizard. Be sure to start by selecting Install New Version of ColdFusion MX, then J2EE Configuration (ColdFusion MX with JRun 4).

Tip: The installation wizard disables the ColdFusion MX with JRun 4 option if JRun 4 is already

installed on the computer.

After the Pre-Installation Summary pane, the files are copied to your computer.

10 Open the ColdFusion MX Administrator in a browser, using http://localhost/contextroot/CFIDE/administrator/index.cfm (external web server) or http://localhost:8300/contextroot/CFIDE/administrator/index.cfm (built-in JRun web server). Because opening the ColdFusion MX Administrator for the first time automatically invokes the Configuration Wizard, it is best to open the Administrator at this time.

Note: If you are accessing ColdFusion MX 6.1 from a remote computer, use the previous URL with the host name or IP address of the remote computer instead of localhost.

11 Answer the questions asked by the Configuration Wizard.

Completion of the Configuration Wizard and display of the ColdFusion MX Administrator indicates a successful install of ColdFusion MX.

12 Configure and manage your system, as described in Chapter 4, “Configuring Your System,”

Tip: If you do not plan on using the default JRun server, you can conserve system resources by opening the Services control panel and setting the Macromedia JRun default server service to Manual or Disabled.

13 Code and test ColdFusion MX CFM pages. If you configured an external web server, store CFM pages under your web root directory. If you are using the built-in web server, store CFM pages under the web application root (jrun_root/servers/cfusion/cfusion-ear/cfusion-war) and access these pages using a URL of the form http://hostname:8300/context-root/filename.cfm, as

follows:

■ hostname The machine name, IP address, localhost, or 127.0.0.1.

■ contextroot The context root for the ColdFusion MX web application. For more information, see “Context root”

■ filename The directory path and file to display. The path is relative to the cfusion-war directory.

For example, to display a CFM file located at C:\JRun4\servers\cfusion\cfusion-ear\cfusionwar\eisapp\index.cfm using the built-in JRun web server and a context root of cfmx, you specify the URL as http://127.0.0.1:8300/cfmx/eisapp/index.cfm.