Installing ColdFusion MX

This section provides installation instructions for Windows and UNIX.

Installing ColdFusion MX in Windows

This section explains how to install ColdFusion MX in a Windows platform.

To install ColdFusion MX in Windows:

Read the online version of the Release Notes for any late-breaking information or updates. For more information, see http://www.macromedia.com/go/proddoc_releasenotes.
Make sure that your operating system meets the system requirements described in "System requirements for Windows".
Review the "Installation considerations for Windows".
Close any applications that are currently running on your computer.
Insert the CD-ROM, or download the setup file for your locale from the Macromedia website.
If you are installing from a network or a downloaded file, locate the coldfusionmx executable file for your locale (for example, coldfusionmx-win-us.exe file), and double-click it.
The installation wizard starts.
Follow the instructions in the wizard, and let it run to completion.
After the Pre-Installation Summary pane, the files are copied to your computer. After the installation is complete, the ColdFusion MX Administrator opens.
If you have an existing ColdFusion 5 installation, you are prompted to migrate your ColdFusion 5 settings to ColdFusion MX.
If you do not want to migrate now, click Skip.
To migrate later:
1. Close the ColdFusion MX Administrator, if it is not already closed.
2. Change the value of the following registry key from 0 to 1:
  HKEY_LOCAL_MACHINE\SOFTWARE\Macromedia\Install Data\ColdFusionMX\migrate
3. Restart the ColdFusion MX Administrator from the Windows Start menu.
  You are prompted again to migrate your ColdFusion 5 settings.
Caution: If you migrate your ColdFusion 5 settings later, you might overwrite new ColdFusion MX settings.
To configure Verity to search in a language other than English, follow the instructions in "Installing Verity Locales".
Configure and manage your system, as described in Chapter 2, "Configuring your System".
To learn about ColdFusion MX, read the documentation that is installed with ColdFusion MX, or download it from the ColdFusion MX documentation website.

Installing ColdFusion on UNIX

This section explains how to install ColdFusion MX on UNIX.

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

To install ColdFusion MX on UNIX:

Read the online version of the Release Notes for any late-breaking information or updates. For more information, see http://www.macromedia.com/go/proddoc_releasenotes.
Make sure that your operating system meets the system requirements described in "System requirements for UNIX".
Review the "Installation consideration for UNIX".
Log in as root.
(HP-UX only) Follow the instructions in "Mounting the CD-ROM drive on HP-UX".
Copy the install file that is appropriate for your platform and locale from the CD-ROM or Macromedia website, and save it to a directory on your local disk.
The install files for supported platforms in the English (US) locale are as follows:
- cfusionmx_linux_us.bin
- cfusionmx_solaris_us.bin
- cfusionmx_hp_us.bin
Using the cd command, go to the directory with the install file.
Modify the install file with the following command:
```
chmod 755 <filename>
```
Start the installation with the following command:
```
./<filename>
```
The installation program starts.
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 install file finishes, start ColdFusion MX with the following command:
/cf_root/bin/coldfusion start
To stop ColdFusion MX, use the following command:
/cf_root/bin/coldfusion stop
For more information on managing processes, see "Managing the ColdFusion MX process on UNIX," in Chapter 2.
(Optional) Open the ColdFusion MX Administrator in a browser, using the following URL: http://localhost:8500/CFIDE/administrator/index.cfm.
Note: If you are accessing ColdFusion MX from a remote computer, use the previous URL with the host name or IP address of the remote computer instead of localhost.
If you have an existing ColdFusion 5 installation, when you open the ColdFusion Administrator for the first time, you are prompted to migrate your ColdFusion 5 settings to ColdFusion MX.
If you do not want to migrate now, click Skip.
To migrate later:
1. Close the ColdFusion MX Administrator, if it is not already closed.
2. Create a file called upgrade (it can be blank) in your cf_root/bin directory.
  The user account under which ColdFusion MX runs must have read/write access to this file. (If you need to change the permissions for the file, use the chmod command.) The file will be deleted once the migration completes.
3. Start the ColdFusion MX Administrator.
  You are asked again if you want to perform the migration.
Caution: If you migrate your ColdFusion 5 settings later, you might overwrite new ColdFusion MX settings.
To configure Verity to search in a language other than English, follow the instructions in "Installing Verity Locales".
Configure and manage your system, as described in Chapter 2, "Configuring your System".
To learn about ColdFusion MX, read the documentation that is installed with ColdFusion MX, or download it from the ColdFusion MX documentation website.

Mounting the CD-ROM drive on HP-UX

To accommodate long filenames, Macromedia writes ColdFusion MX to the CD-ROM using the RockRidge format. This format is supported by HP-UX using the Portable File System (PFS) commands, not the standard HP-UX mount/umount commands. For more information on PFS commands, enter the following command: man pfs_mount.

To mount the CD-ROM drive on HP-UX using the HP PFS extensions:

Create a mount point for the CD-ROM drive; for example:
```
mkdir    /SD_CDROM
```
Create an entry in the PFS mount file, as follows:
1. Create or edit the file /etc/pfs_fstab, adding an entry like the following:
```
   /dev/dsk/c1t2d0  /SD_CDROM      pfs-rrip    xlat=unix  0
```
  (In this example, /dev/dsk/c1t2d0 is the <device_file>, /SD_CDROM is the <mount_point>, pfs-rrip is the <fs_type>, and xlat=unix 0 is the <translation_method>.)
2. In your entry, ensure that the path that you set in the device_file field is the device name of your CD-ROM drive, and that your mount_point is the name that you selected for the mount point in step 1.

Start the PFS processes, as follows:

nohup /usr/sbin/pfs_mountd &
nohup /usr/sbin/pfsd &

Mount the CD-ROM drive, as follows:
```
/usr/sbin/pfs_mount /SD_CDROM
```
The CD-ROM appears under /SD_CDROM.
When you finish using the CD-ROM, you can unmount it using the following command:
```
/usr/sbin/pfs_umount /SD_CDROM
```