Welcome to Coldfusion MX 6.1 - Installing the ColdFusion MX 6.1 Server
(Page 5 of 5 )
You can install ColdFusion MX 6.1 MX on several different operating systems: Windows, Mac OS X, Linux, Solaris, and HP-UX. It also has the advantage of having a built-in web server, so you can test and develop on a system that does not have a server already installed. In this section, we explain how to install ColdFusion MX 6.1 server onto a Windows-based system.
Before you begin the installation, we strongly recommend that you make sure that your computer system meets the minimum hardware requirements as specified by Macromedia. You can find these system requirements athttp://livedocs.macromedia.com/coldfusion/How to Install ColdFusion MX 6.1
- Start the install procedure. After agreeing to the end-user license agreement, you will be taken to the Customer Information dialog box. This is where you enter details like your name and organization name. You can also enter a serial number if you have purchased a license for ColdFusion MX or ColdFusion MX 6.1. If you leave the serial number text field blank, you will install the 30-day trial version. There is a bullet for opting to immediately install the developer version, which is a single-IP address fully-functional version (if you install the 30-day trial and let the trial expire, it becomes a developer edition anyway). In addition to the license type, you choose the install type. Several options are available. In this book we focus on the standalone version, but be aware that ColdFusion MX 6.1 is a Java 2 Platform Enterprise Edition (J2EE) application, and as such it runs on top of a J2EE server. There are options to install ColdFusion MX 6.1 on top of JRun 4, or to deploy it on an existing J2EE application server as either a.earor .warfile. If you don’t know what all of that means, don’t worry about it right now. Just know that ColdFusion runs as a Java application and that there are many options for how ColdFusion MX 6.1 can be configured and deployed. You can read more about installing the J2EE version of CFMX 6.1 athttp://livedocs.macromedia.com/ coldfusion/6.1/htmldocs/ installj.htm#wp109411.
- Next, the installer detects which web servers you currently have installed and gives you the option of using any of these or Macromedia’s standalone web server. Macromedia recommends that you use the standalone server only for developmental purposes and not on production systems. Note that by default the standalone server runs on port 8500. So, if you are connecting to your local machine, you must always append :8500onto the domain in the URL. For example, to access the ColdFusion MX 6.1 Administrator, you would need to enterhttp://localhost:8500/ CFIDE/administrator/in the address bar of your web browser. If you are using Internet Information Server (IIS) or Apache (or any other web server) with the default HTTP port (80), you will connect to the local machine ashttp://localhost/CFIDE/administrator/. Choose one of these options and click the Next button.
- Now you define the paths to which you want to install the program files and web files. By default, ColdFusion MX 6.1 installs to theC:\CFusionMX\ directory. When finished, click the Next button.
- The next step of the install procedure allows you to choose what components are installed. The first component is the application server itself, which must be installed. The second component is the Documentation and sample applications, and these are optional.
In a production environment, do not install the documentation or sample applications, because they may be exploited by malicious Web users. When you have finished making your decision, click on the Next button.
TIP You can access the most recent documentation at http://livedocs.macromedia.com/, and users can actually add comments and notes to most pages for other people to read. These comments often contain useful tips or workarounds for bugs.
Next, you choose passwords for the administration web site and for users connecting through Remote Development Services (RDS). RDS is one way that HomeSite and Dreamweaver MX 2004 can connect remotely to the ColdFusion MX 6.1 server and edit files. If you wish to use the same password for both, simply click the “Use the same password as above” checkbox and enter a password into both of the upper text fields. Click the Next button after you are finished.
The final step is a confirmation screen. This allows you to check all settings before actually installing the files. You can go back and make changes before returning and clicking on the Install button. ColdFusion MX 6.1 will then take several minutes to install before the wizard completes.
Once the installation wizard has successfully completed, it will launch the ColdFusion MX 6.1 Administration web site, which we walk you through later in this chapter. Once you log in to the Administrator, click on Version Information near the top right, and you will see a brief summary of the server details and the Java Virtual Machine (JVM) details.
A text field near the top of this page lets you enter a new serial number. If you installed the Developer or 30-day trial edition of ColdFusion MX 6.1 and later want to upgrade to the Professional or Enterprise edition, simply return to this page and enter your serial number. ColdFusion MX 6.1 will remove the connection limitations of the Developer edition.
Before getting started with ColdFusion MX 6.1, update your software to the latest version. At the time of writing, the latest update offered by Macromedia is ColdFusion MX 6.1. As new bug fixes and features are released, hotpatches and sometimes even updaters are made available for download. You can check for new patches and updates athttp://www.macromedia.com/support/coldfusion/. Changing the Port Number for ColdFusion MX 6.1
If using the Macromedia standalone web server with ColdFusion MX 6.1, you can also change the port from 8500 to 80 or any other available port.
Simply open the install directory:\CFusionMX\runtime\servers\default\SERVER-INF\jrun.xmlfile and search for<attribute name="port">8500</attribute>, which is near the bottom of the document. Change the port number from 8500 to the available port you wish to use, such as port 80, and save this file. Stop and restart the ColdFusion MX 6.1 MX Application server service from the Services window at the Control Panel-> Administrative Tools->Services interface. You will now be able to access your ColdFusion MX 6.1 Administrator and pages on the new port that you specified. More information about configuring the built-in web server appears athttp://www.macromedia.com/support/coldfusion/ adv_development/config_builtin_webserver/.