Installing the J2EE configuration with JRun on UNIX

Installing the J2EE configuration with JRun on UNIX

This section explains how to install Macromedia JRun 4 and the ColdFusion MX 6.1 J2EE configuration on UNIX.

To install the J2EE configuration with JRun on UNIX:

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 Ensure that your operating system meets the system requirements described in “System requirements for UNIX”

3 Review the “Installation considerations for UNIX”

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

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

6 Log in as root.

7 Copy the installation file that is appropriate for your platform and locale from the CD or Macromedia website, and save it to a directory on your local disk.

The installation files for supported server configuration platforms are as follows:

■ coldfusion-61-lin.bin

■ coldfusion-61-sol.bin

■ coldfusion-61-other.jar

8 Using the cd command, go to the directory with the installation file.

9 Start the installation with the following command:

./<filename>

The installation program starts.

Note: To run the UNIX installer in GUI mode, type ./ -i gui

10 Follow the instructions in the installation wizard. Make sure that you select 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.

Caution: For security reasons, it is crucial that you do not use root for the runtime user.

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

11 Start the JRun cfusion server:

jrun_root/bin/jrun start cfusion

12 If you specified external web server settings when running the installation wizard, run the jrun_root/bin/cfmx-connectors.sh shell script. The script runs the Web Server Configuration Tool, which configures the web server for use with ColdFusion MX. The web server should also be running. If there are problems running this script, review the configuration and bin directory specifications, modify as necessary, and rerun the script. You can also configure your web server using the scripts in jrun_root/bin/connectors, or through java –jar jrun_root/lib/wsconfig.jar, as appropriate.

Note: This step is important, because if you specified the use of an external web server when running the installation wizard, the CFIDE and cfdocs directories are placed under that web server’s root directory, and you must successfully configure the web server before opening the ColdFusion MX Administrator.

13 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.

14 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.

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

16 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 /opt/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.