Installing an EAR file or WAR files on UNIX

Installing an EAR file or WAR files on UNIX

This section explains how to install the ColdFusion MX 6.1 J2EE configuration on UNIX. If you are updating an existing deployment of ColdFusion MX for J2EE, see “Updating from ColdFusion MX for J2EE” before continuing.

By default, the ColdFusion MX 6.1 J2EE install places files into the /opt/cfmx directory. To install it into a different directory, you must create that directory before running the installation.

To install ColdFusion MX 6.1 on UNIX (J2EE configuration):

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 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 Log in as root.

6 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

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

8 Start the installation with the following command:

./<filename>

The installation program starts.

To use coldfusion-61-other.jar to install on a UNIX platform other than Solaris or Linux, enter the following command (for more information, see “Installation considerations for UNIX”):

java_home/bin/java -jar coldfusion-61-other.jar

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

9 Follow the prompts, and let the installation program run to completion.

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

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

10 Deploy ColdFusion MX 6.1 and configure Java settings, as required by your application server.

For more information, see “ColdFusion MX J2EE deployment and configuration”

11 Open the ColdFusion MX Administrator in a browser (http://hostname:portnumber/contextroot/CFIDE/administrator/index.cfm). 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.

12 Answer the questions asked by the Configuration Wizard. Completion of the Configuration Wizard and display of the ColdFusion MX Administrator indicate a successful install of ColdFusion MX.

Note: If you deployed the rds.war file, and a Configuration Wizard error message indicates that

RDS is not installed or not enabled, edit the rds.properties file to match the ColdFusion context

root, restart the application server, and re-open the ColdFusion MX Administrator.

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

14 Code and test ColdFusion MX CFM pages. Store CFM pages under the web application root (either cfusion-ear/cfusion-war or cfusion-war) and access these pages using a URL of the form http://hostname:portnumber/context-root/filename.cfm, as follows:

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

■ portnumber The port number used by your application server’s web server.

■ 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/default/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:8100/cfmx/eisapp/index.cfm.