Installing ColdFusion MX 6.1 on UNIX

Installing ColdFusion MX 6.1 on UNIX

This section explains how to install ColdFusion MX 6.1 on UNIX.

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

Note: The UNIX installer defaults to running ColdFusion MX 6.1 as user nobody. However, this is not allowed on HP-UX, so you must change the default value. On HP-UX, it is best to run as the same user as the web server runs under. To install ColdFusion MX 6.1 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. Make sure that your operating system meets the system requirements described in “System requirements for UNIX”

3. Review the “Installation considerations for UNIX”

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

5. (Upgrade install only) Shut down the ColdFusion server.

6. Log in as root.

7. (HP-UX only) Follow the instructions in “Mounting the CD drive on HP-UX”

8. 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-hpux.bin

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

10 Start the installation with the following command:

./<filename>

The installation program starts.

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

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

12 (Update from ColdFusion MX) Copy the files in the backup directory that you specified when running the installer back into your ColdFusion MX directory structure. Ensure that files from the backup directory tree overwrite any files with the same name in the ColdFusion MX directory structure.

13 Start ColdFusion MX 6.1 with the following command:

/cf_root/bin/coldfusion start

If you specified the use of an external web server when running the installer, ColdFusion MX automatically runs the cf_root/bin/cfmx-connectors.sh script when starting for the first time. This shell script runs the Web Server Configuration Tool using the settings you specified during the installation. 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 cf_root/bin/connectors, as appropriate.

To stop ColdFusion MX 6.1, use the following command:

/cf_root/bin/coldfusion stop

For more information on managing processes, see Chapter 4, “Managing the ColdFusion MX process on UNIX,”

14 Open the ColdFusion MX Administrator in a browser, using

http://localhost/CFIDE/administrator/index.cfm if you configured an external web server and http://localhost:8500/CFIDE/administrator/index.cfm if you are using the built-in 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.

15 Run the Configuration Wizard.

If you are upgrading from ColdFusion 4.5 or 5, you can optionally migrate settings later. To migrate later:

a Close the ColdFusion MX Administrator, if it is not already closed.

b Open cf_root/lib/adminconfig.xml in a text editor , change runmigrationwizard (migrate ColdFusion 5 settings) and runmxmigrationwizard (migrate the ColdFusion MX ODBC services to ColdFusion MX 6.1) to true, as necessary, and save the file.

c Restart the ColdFusion MX Administrator.

You are prompted again to migrate your settings.

Caution: If you migrate your ColdFusion 5 settings later, you might overwrite new ColdFusion MX

settings.

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

17 To learn about ColdFusion MX 6.1, read the documentation, which is accessible through the Documentation link at the top of the ColdFusion MX Administrator.