Join David Gassner for an in-depth discussion in this video Installing ColdFusion 9 on Mac OS X, part of ColdFusion 9 Essential Training.
To get started with ColdFusion 9 on Mac OS X, go to the Adobe website at www.adobe.com/go/coldfusion and follow the links to download the evaluation software. After you've downloaded the evaluation software for Mac OS X, extract and run the installer application. The installer application takes just a few moments to get started on Mac OS X. Read the introduction screen and click Next. Then read through the license agreement, and if you agree with it, click the appropriate radio button and then click Next again.
On this screen, you're asked for a serial number. If you don't have a ColdFusion serial number, you can choose either the 30-day trial or the Developer Edition. If you choose the 30-day trial, which is a full copy of the Enterprise Server, after 30 days, if you don't set up your serial number, it will revert to the Developer Edition. The Developer Edition allows you to make requests from the local machine and from two other computers that are connected over the Internet or your Local Area Network. I'll select the Developer Edition from the beginning, and click Next. On this screen, you're asked which configuration you want to use.
There are three available. The Server configuration, which is the simplest and the default, is a self-contained server installation that includes an embedded J2EE, or Java Enterprise Edition server. Specifically, it's a limited version of Adobe's JRun Server. If you're familiar with how to use Java Enterprise Edition servers, you can choose one of the other options. The Enterprise Multiserver configuration allows you to set up multiple instances of JRun and ColdFusion that are kept separate from each other on the system.
You can start and stop them individually without affecting the others. The J2EE configuration lets you wrap up the ColdFusion server as either an EAR file. That's an Enterprise Archive or a WAR file, a Web Archive. If those terms aren't familiar to you, you probably don't want to use those configurations. In fact, I'm going to be using the default Server configuration throughout this video series. So if you want to see the same mappings and URLs that I'm seeing, choose the Server configuration and click Next. This is the subcomponent installation screen.
It asks you which additional parts of ColdFusion you want to install. The first option refers to the ColdFusion 9 Solr services. I'll move my cursor over the item so I can see the description, and you'll see that Solr is a full text indexing engine. ColdFusion has been delivered with Verity for a long time, a full text indexing engine, but Verity was ideally suited for Windows. The Solr full text indexing engine is available on Mac. You'll also want to select the ColdFusion 9 documentation for this video series. The documentation includes the documentation, but also includes a set of sample databases and a lot of great sample code.
When you install ColdFusion on your production server, don't install the documentation there. The last option on Mac asks whether you want to start ColdFusion as your system starts up. I usually deselect this option on Mac and then when I start up the machine and I want to work with ColdFusion, I start it up from the ColdFusion folder. And I'll show you how to do that later. After making your selections on this screen, click Next. Now you're asked where to install the ColdFusion software. I'll accept the default location: /Applications/ColdFusion9, and click Next.
On this screen I'm asked whether earlier versions of ColdFusion were installed on this computer. If you have earlier versions, such as ColdFusion MX 7 or ColdFusion 8, and you want to migrate data sources, mappings and other configurations, click Yes. Otherwise, leave the default setting of No, and click Next again. On this screen, you're asked whether you want to configure a web server connector. A web server connector allows you to call ColdFusion functionality from any industry-standard web server. For example, if you wanted to install ColdFusion to work with the Apache Server that's included with Mac OS X, you would leave this radio button selected and click Add.
For this video series, I'm going to be using the built-in web server. The built-in web server is a small web server, designed for development use only, that listens on port 8500. If you're following along with the video series and you want to see exactly the same web addresses I'm seeing, choose the built-in web server like I did, and click Next again. On this screen, you're asked whether you want to configure OpenOffice. OpenOffice is an open-source, free, set of productivity applications that can open and work with files that are compatible with Microsoft Office.
ColdFusion 9 has the ability to work with Word documents and PowerPoint files, using commands that are new to the ColdFusion Markup Language. On Mac, you need to install OpenOffice. If you already have OpenOffice installed on your system, you can click the option here to configure it and then indicate the directory where it's installed. If you don't have OpenOffice installed, and I don't right now, leave the option deselected. You'll be able to configure OpenOffice later through the ColdFusion Administrator application. I'll leave that option deselected and click Next.
Now I'm asked for a password. You must provide a ColdFusion Administrator password. If you don't want to protect your ColdFusion Administrator application on your local system with a password, you'll be able to turn it off later, but you must enter a password at this point. Type in a password that you will remember later on. Twice. And click Next. On this screen you're asked whether you want to enable RDS. RDS is the Remote Development Service, a protocol that's been part of ColdFusion for a long time that allows you to communicate with ColdFusion from your developer tool, whether you're using ColdFusion Builder, the new IDE, Dreamweaver or even the older home site.
When you're doing local development, you typically want to turn RDS on, but when you create a production server it's recommended that you disable RDS for security reasons. I'll enable RDS and, once again, enter a password that I'll remember. I'll enter it twice and then click Next. This is the summary screen telling you all of the choices that you've made. When you click the Install button, the first phase of the installation will proceed. When the first phase of the installation is complete, you'll see a screen prompting you to go to the configuration wizard.
I'm going to end this video at this point and then take a look at the video describing the use of the configuration wizard, which is exactly the same for both Mac and Windows. Click the Install button and your installation will start.
- Using ColdFusion Builder to define a default page template
- Defining a data source with ColdFusion Administrator
- Creating data access ColdFusion Components (CFCs) in ColdFusion Builder
- Using ColdFusion ORM (Object Relational Mapping)
- Applying dynamically developed URLs to datasets
- Validating data entry forms and defining client-side validation rules
Skill Level Beginner
Q: While trying to build a dynamic site as instructed in the ColdFusion 9 Essential Training title, an error occurred when setting up the Date & Services > Data Sources page as shown in the "Defining a data source in ColdFusion Administrator" movie:
Connection verification failed for data source: dw_bookstore. com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException: Could not create connection to database server. Attempted reconnect 3 times. Giving up.
Also, attempts to connect to the database using phpMyAdmin were not successful. Is there a fix to this problem?
A: If the connection to phpMyAdmin is not working, starting over with the installation of MySQL is the best bet. Uninstall WampServer, then reinstall and set up the database again. If that software is not working, the connection to the database from will not be possible from ColdFusion.