|By Charlie Arehart, Jeffry Houser||
|September 11, 2003 12:00 AM EDT||
The world of ColdFusion application servers is quite interesting at the moment. Macromedia's recent update to CFMX 6.1 promises to add a lot of stability and speed to the product. BlueDragon, New Atlanta's alternate CFML runtime engine continues to gain momentum. Yet despite these two great products, much of the development out there is still based on ColdFusion 5 (or earlier).
What if you're interested in running one or more of these at once? Perhaps you're going to upgrade an app from one server to another? How do you test your current applications for compatibility among the other servers without reconfiguring your development machine? If you're a consultant, or work for a consulting firm, there's a good chance you'll have multiple clients, each with different server requirements. How do you handle the changing requirements without reconfiguring your server every time?
The good news is that you can install all three products at once to test them, but they each support slightly different versions of CFML. How do you set things up so that you can test a set of CFML templates against each server, while keeping the CFML code in one place?
This article answers those questions by showing you how to run all the application servers off of a single instance of Microsoft IIS 5 on Windows 2000, and will make it easy to test for cross-compatibility in your code. Normally, if you set up a ColdFusion (or BlueDragon) server to use IIS, it will replace any prior IIS settings for running CFML templates. We'll show you how to resolve that.
Even if you use Apache, iPlanet, IIS on a Windows Server edition, or some other external Web server, the concepts here will generally apply (though they may be even more flexible). If you already have CF5, CFMX, or BlueDragon installed, just follow along to learn a couple of interesting points to enable setup of IIS to run all three servers at once, pointing to the same directory of CFML code. It's a great way to do testing against all three servers.
Installing/Configuring ColdFusion 5
The first step is to install and configure ColdFusion 5 on your machine. If you already have it installed and configured to use IIS, you can skip to the next paragraph. ColdFusion 5 can currently be downloaded from the Macromedia Web site, at Click Here!. It can also be found on your ColdFusion Studio 5 CD or included in Ben Forta's CF5 Web Application Construction Kit book and others. Install it to the default directory, C:\Cfusion. During the install process you should let the installer set itself up for IIS.
You can test the success of your installation by running the ColdFusion Administrator (such as http://localhost/cfide/administrator/index.cfm) or by creating and running a page using the code below:
Save the page in your IIS webroot (\inetpub\wwwroot\), perhaps as cfversion.cfm, and load the page in your browser with http://localhost/cfversion.cfm. You'll see that the product version is 5,0,0,0, the name is ColdFusion Server, and the level is either Professional or Enterprise.
The install process will create two mappings in IIS, one for cfm pages and one for dbm pages. To see these, open up your Internet Services Manager (found at Start-->Settings-->Control Panel-->Administrative Tools), right-click on the Default Web Site, and choose Properties. Click on Home Directory and Configuration. (If the Configuration button is not selectable, close that window and right-click on the computer name above the Default Web Site, choose Properties, choose Edit for the Master Properties of the WWW Service, then choose Home Directory and Configuration.) You should see a cfm extension mapping listed on the app mappings tab, like that shown in Figure 1.
The mapping should point to "C:\Cfusion\BIN\ISCF.DLL". That's the name of CF5's IIS adapter. We're next going to install CFMX and eventually cause it to overwrite this IIS configuration for CF 5, so you should write down the mapping information as you'll need it later.
You'll also want to make backup copies of the ColdFusion 5 Administrator (cfide) and documentation (cfdocs) directories that were installed by default in the IIS webroot (\inetpub\wwwroot), as they will also be overwritten in a later step. A simple way to do this is by renaming them to cfide5 and cfdocs5. We'll show you how to make them accessible again later.
Installing/Configuring ColdFusion MX
Our next step will be to install/configure ColdFusion MX. If you already have it installed and configured to use its built-in Web server, you can skip the next two paragraphs. If you are already configured to use IIS, skip to the next subsection, "you are checking the IIS Configuration for CFMX".
You can download the latest version of ColdFusion MX from the Macromedia Web site, at www.macromedia.com/software/coldfusion/trial. ColdFusion MX will install into the CFusionMX directory by default. Just be sure not to install into the same directory as your ColdFusion 5 installation.
In fact, the installer will detect that ColdFusion 5 is already installed. Tell it you want it to coexist and install ColdFusion MX using its built-in Web server. You could tell it during the install to implement its IIS connection, but we want the article to help those who may have already installed CFMX with its built-in Web server, who will want to follow the next steps.
Once the installation is done, you can confirm that the installation was successful by running the CFMX Administrator. By default, CFMX will set up its built-in Web server at port 8500, so the URL would be http://localhost:8500/cfide/administrator/index.cfm.
Next, or if you had previously installed CFMX using its built-in Web server, we will want to manually set up CFMX to work via IIS. Using Windows Explorer or My Computer, look in the C:\CfusionMX\runtime\lib directory and double click on wsconfig.jar. (In CFMX 6.1, there is also a new menu option, Start-->Programs-->Macromedia-->Macromedia ColdFusion MX-->Web Server Configuration Tool.) The screen shown in Figure 2 will come up.
Click the add button and you'll see the screen shown in Figure 3.
If you find that you can't launch the JAR file (such as if it tries to open it like a ZIP file), or if it doesn't work for any other reason, look at the CFMX documentation, Installing ColdFusion MX and its section, "Configuring Web Servers" in Chapter 2.
Assuming things are working for you as shown in the figures, select your IIS Web site, click the Configure Web Server for ColdFusion MX Applications button and then click OK. You will be asked to restart the Web server.
Checking the IIS Configuration for CFMX
The ColdFusion MX mappings are now created on IIS. As was described in the CF5 step, open up your Internet Services Manager and bring up properties on the Default Web Site (or the Master Properties, if necessary). Click on Home Directory and Configuration. You should see a bunch of mappings, including cfm and cfc, listed on the app mappings tab, similar to the one shown in Figure 4.
You'll also see jsp, jws, and cfml mappings listed. The mappings probably point to "C:\CFusionMX\runtime\lib\wsconfig\1\jrun.dll". Write down this value to use in a later step. Take note, as well, that CFMX's installation of the IIS adapter actually builds the file named in that mapping. It's not enough to skip this step and just use the aforementioned DLL name in the later step.
You can run the CF Admin or our test code from above to verify that IIS is now sending pages to ColdFusion MX. In either case, you'd no longer want to use the port 8500 on the URL to test against CFMX. Instead, use the same URL you used above to test CF5. The Product Name is still ColdFusion Server, the Product Level should still be Enterprise or Professional (or may now be Standard, in CFMX 6.1). The version should start with "6" and be something like 6,1,0,63239. Again, installing ColdFusion MX has removed your ColdFusion 5 mappings from IIS, but don't worry about that for now. We'll show you shortly how to reactivate ColdFusion 5 via IIS.
Note that the earlier installation of CFMX (using the built-in Web server) installed the CFMX documentation and Administrator in the "C:\CFusionMX\wwwroot". If you want to be able to easily access these by way of IIS, you will need to copy the ColdFusion MX Administrator (cfide) and documentation (cfdocs) directories into the IIS Web root "C:\inetput\wwwroot". This is why we had you rename those directories when they had been installed with CF5.
Finally, we want to install BlueDragon Server. Even if you don't know about it, there's no harm in installing it. It can run alongside both CF5 and CFMX. In simplest terms it's just another server for running your CFML, as you will see. You can learn more about it, including other benefits and features, at www.newatlanta.com/bluedragon/.
Installing BlueDragon Server is easy. It's downloadable from the New Atlanta Web site. Get the Server JX version, which like CF is available as a 30-day, full-featured trial that reverts to a single-IP developer edition after that. There is also a Server version, which is free for both development and deployment, without a time limit (though not free for redistribution). It lacks a few features available in the BlueDragon Server JX (and BlueDragon/J2EE) edition, but is much more full-featured than was the previous free edition of ColdFusion from Allaire in the 4.5 timeframe, called CF Express.
While you can install BlueDragon into its default directory (C:\Program Files\New Atlanta\BlueDragon_Server), for the purposes of this article it may be preferable to install it instead to a C:\Bdragon directory, for reasons explained later. And again, let's install BlueDragon using its built-in Web server, just as you did for ColdFusion MX. If you already installed it in its default directory, don't worry. We'll explain this issue later.
It's worth noting that like CF, you could instead have installed BlueDragon to integrate with IIS (or other Web servers like Apache and IPlanet). You could also easily add IIS integration after installing it using the BlueDragon Administrator. For the purposes of this article, we'll instead be manually setting up IIS to connect to BlueDragon. Indeed, we'll create a special virtual directory for each server in the next section.
You can confirm that BlueDragon is working by running its Administrator. It's accessible only by using the BlueDragon built-in Web server, which by default would be available at http://localhost:8080/bluedragon/admin.cfm. (Unlike CF, for security reasons the BlueDragon Administrator is accessible only from the localhost, from the machine on which it was installed. Therefore, even if you had installed it with IIS, or later configured it to use IIS, there's no point in trying to copy the admin to the IIS webroot as we did with CFMX.)
You are now ready to start configuring IIS.
Let's take stock of what you've done to your machine thus far. ColdFusion 5, ColdFusion MX, and BlueDragon are installed. Only ColdFusion MX is set up to run using IIS. All CFML templates in all directories run though IIS will execute by way of CFMX. BlueDragon will run only in stand-alone mode using its built-in Web server. ColdFusion 5 won't work at all because its mappings were replaced by ColdFusion MX. We now want to accomplish our goal of having everything run off of our single instance of IIS, pointing to the inetpub/webroot.
The solution is to create virtual directories for each server that point to the webroot, but run the templates through the desired CFML server. The key is in those extension mappings that we referred to before. In fact, we can create different virtual directories that each use a different mapping for CFML templates. You can do this from the Internet Services Manager. Follow these instructions:
1. Right-click on the Default Web Site and select Virtual Directory from the New menu.
2. Name the first virtual directory something like CF5. When asked to enter the path containing the Web content, use the available Browse button to point to inetpub\wwwroot. Now the virtual directory is created.
3. Bring up that new virtual directory's properties by right-clicking it and selecting Properties. Click on the Configuration button on the virtual directory tab. It will probably have inherited mappings (for the .cfm and .cfml extensions) that point to the ColdFusion MX IIS DLL, because CFMX was configured to use IIS integration in that previous CFMX install step. We will want to override this mapping. Change the cfm and cfml mappings to point to C:\Cfusion\BIN\ISCF.DLL, the value you wrote down earlier in this article during the CF5 setup.
4. Now, templates executed with the new /CF5 URL will execute via CF5 instead. You can confirm that your new setup is working by using the URL http://localhost/CF5/ to run some CFML templates in the inetpub\wwwroot. If you followed the recommendation of renaming the CFDOCS directory that had been installed with CF5, the URL would now be http://localhost/cf5/cfdocs5/dochome.htm. The CF5 Administrator would be http://localhost/cf5/cfide5/administrator/index.cfm. Admittedly, not all the images will work correctly and some links may not work as expected, but at least it's better than having lost the CF 5 Admin and docs if we'd installed CFMX directly to the IIS webroot and had overwritten them entirely.
Now, what about CFMX? Though it's already set up to serve docs in the webroot, you may want to create another virtual directory, named CFMX, to parallel what you did for CF5. You can follow steps similar to those above to create a virtual directory named CFMX, using the CFMX version of the IIS DLL mappings we had taken note of earlier.
The final step is to create a BD virtual directory. Again, use the same steps above, but in this case the DLL file we want to point the cfm mappings to is located in that BDragon directory we installed it to, at C:\BDragon\bin\isapi\BlueDragon_Adapter.dll, as shown in Figure 5.
Now we can explain why we chose to install BlueDragon to a BDragon directory rather than Program Files\New Atlanta. It's due to a limitation in the IIS Internet Services Manager dialogue we've been using for associating a DLL to an extension mapping. The problem is that it will not accept a directory path containing spaces.
This wouldn't be an issue if we were to choose IIS integration at installation of BlueDragon, or if we selected it afterward using the BlueDragon Administrator. In those cases, BlueDragon uses a programmatic API to set the extension mapping and the path to its DLL, where the spaces don't matter.
If you've already installed BlueDragon and want to try this manual approach to setting up a new virtual directory, and you don't want to reinstall BlueDragon, you can still point to your existing directory here. You'll just have to convert the path to the Windows 8.3 format. On our test machine, that path name would be C:\Progra~1\NewAtl~1\BlueDr~1\bin\isapi\BlueDragon_Adapter.dll. This will vary on your machine depending on other directories you may have in the Program Files or New Atlanta directories. If you're comfortable using the DOS command line, you can determine the 8.3 name for a given path using the DIR command's /X switch.
Finally, note that unlike CFMX, we did not need to install the IIS adapter in order to use that BlueDragon_Adapter.dll. As in CF5, it's simply placed there automatically during the install process along with all the other external Web server adapters.
Now you can browse code in your webroot and serve it via all three application servers just by changing the virtual directory in your URL.
And notice that while we've created the virtual directories to point to the IIS webroot, you could just as easily create three sets of virtual directories to point to another content directory outside the webroot.
Maybe someone out there would like to take this concept and extend it to offer similar instructions for doing this in Apache, iPlanet, or IIS 6 on Windows Server 2003. Again, the concepts are similar, and sometimes even easier on those Web servers.
In any case, for those on IIS, jumping between projects, clients, and application servers just became much easier.
|Charlie Arehart 01/09/04 01:25:20 PM EST|
This is Charlie here, Jon. When you refer to 6.1, do you mean CFMX 6.1? Or BlueDragon 6.1? I'll assume from your subject line that you mean CFMX.
I'm afraid I can't think of what your install of CFMX 6.1 did to clobber port 80 on IIS. Just to clarify further, you're not referring to changes you did as a result of this article, right?
First I'd confirm that IIS is running at all. Then, does it serve HTML files from port 80 and out of the default inetpubwwwroot? Is your problem with attempts to browse files there or via a virtual directory pointing to another physical location for the code?
There are just lots of things that could be impacting you, and they may be due to IIS config, or something CFMX 6.1 did. Maybe someone else will have other thoughts.
|Jon 01/01/04 03:07:18 PM EST|
I have XP professional with CF5 and CFMX installed. After I updated to 6.1, my port 80 IIS stopped working, the port 8500 works fine. XP professional only has one web server and no matter what I have done to date, port 80 does not work. Any ideas what 6.1 did to port 80?
|free beachler 12/01/03 02:12:23 PM EST|
As soon as I read the first few paragraphs I realized this was exactly what I wanted to do on our dev server. Immediately implementing the steps illustrated in the article I soon found problems.
SYS-CON Events announced today that Super Micro Computer, Inc., a global leader in Embedded and IoT solutions, will exhibit at SYS-CON's 18th International Cloud Expo®, which will take place on June 7-9, 2016, at the Javits Center in New York City, NY. Supermicro (NASDAQ: SMCI), the leading innovator in high-performance, high-efficiency server technology, is a premier provider of advanced server Building Block Solutions® for Data Center, Cloud Computing, Enterprise IT, Hadoop/Big Data, HPC and ...
May. 31, 2016 03:15 PM EDT Reads: 949
18th Cloud Expo, taking place June 7-9, 2016, at the Javits Center in New York City, NY, will feature technical sessions from a rock star conference faculty and the leading industry players in the world. Cloud computing is now being embraced by a majority of enterprises of all sizes. Yesterday's debate about public vs. private has transformed into the reality of hybrid cloud: a recent survey shows that 74% of enterprises have a hybrid cloud strategy. Meanwhile, 94% of enterprises are using some...
May. 31, 2016 03:00 PM EDT Reads: 3,303
Cloud computing delivers on-demand resources that provide businesses with flexibility and cost-savings. The challenge in moving workloads to the cloud has been the cost and complexity of ensuring the initial and ongoing security and regulatory (PCI, HIPAA, FFIEC) compliance across private and public clouds. Manual security compliance is slow, prone to human error, and represents over 50% of the cost of managing cloud applications. Determining how to automate cloud security compliance is critical...
May. 31, 2016 03:00 PM EDT Reads: 1,998
SYS-CON Events announced today that IBM Cloud Data Services has been named “Bronze Sponsor” of SYS-CON's 18th Cloud Expo, which will take place on June 7-9, 2016, at the Javits Center in New York City, NY. IBM Cloud Data Services offers a portfolio of integrated, best-of-breed cloud data services for developers focused on mobile computing and analytics use cases.
May. 31, 2016 02:45 PM EDT Reads: 1,722
SYS-CON Events announced today that ContentMX, the marketing technology and services company with a singular mission to increase engagement and drive more conversations for enterprise, channel and SMB technology marketers, has been named “Sponsor & Exhibitor Lounge Sponsor” of SYS-CON's 18th Cloud Expo, which will take place on June 7-9, 2016, at the Javits Center in New York City, New York. “CloudExpo is a great opportunity to start a conversation with new prospects, but what happens after the...
May. 31, 2016 02:30 PM EDT Reads: 1,488
The IoT is changing the way enterprises conduct business. In his session at @ThingsExpo, Eric Hoffman, Vice President at EastBanc Technologies, discuss how businesses can gain an edge over competitors by empowering consumers to take control through IoT. We'll cite examples such as a Washington, D.C.-based sports club that leveraged IoT and the cloud to develop a comprehensive booking system. He'll also highlight how IoT can revitalize and restore outdated business models, making them profitable...
May. 31, 2016 02:00 PM EDT Reads: 3,130
Customer experience has become a competitive differentiator for companies, and it’s imperative that brands seamlessly connect the customer journey across all platforms. With the continued explosion of IoT, join us for a look at how to build a winning digital foundation in the connected era – today and in the future. In his session at @ThingsExpo, Chris Nguyen, Group Product Marketing Manager at Adobe, will discuss how to successfully leverage mobile, rapidly deploy content, capture real-time d...
May. 31, 2016 01:45 PM EDT Reads: 1,790
What a difference a year makes. Organizations aren’t just talking about IoT possibilities, it is now baked into their core business strategy. With IoT, billions of devices generating data from different companies on different networks around the globe need to interact. From efficiency to better customer insights to completely new business models, IoT will turn traditional business models upside down. In the new customer-centric age, the key to success is delivering critical services and apps wit...
May. 31, 2016 12:30 PM EDT Reads: 1,398
As cloud and storage projections continue to rise, the number of organizations moving to the cloud is escalating and it is clear cloud storage is here to stay. However, is it secure? Data is the lifeblood for government entities, countries, cloud service providers and enterprises alike and losing or exposing that data can have disastrous results. There are new concepts for data storage on the horizon that will deliver secure solutions for storing and moving sensitive data around the world. ...
May. 31, 2016 12:00 PM EDT Reads: 1,506
Join us at Cloud Expo | @ThingsExpo 2016 – June 7-9 at the Javits Center in New York City and November 1-3 at the Santa Clara Convention Center in Santa Clara, CA – and deliver your unique message in a way that is striking and unforgettable by taking advantage of SYS-CON's unmatched high-impact, result-driven event / media packages.
May. 31, 2016 12:00 PM EDT Reads: 2,624
In his keynote at 18th Cloud Expo, Andrew Keys, Co-Founder of ConsenSys Enterprise, will provide an overview of the evolution of the Internet and the Database and the future of their combination – the Blockchain. Andrew Keys is Co-Founder of ConsenSys Enterprise. He comes to ConsenSys Enterprise with capital markets, technology and entrepreneurial experience. Previously, he worked for UBS investment bank in equities analysis. Later, he was responsible for the creation and distribution of life ...
May. 31, 2016 11:45 AM EDT Reads: 2,128
SYS-CON Events announced today that MobiDev will exhibit at SYS-CON's 18th International Cloud Expo®, which will take place on June 7-9, 2016, at the Javits Center in New York City, NY. MobiDev is a software company that develops and delivers turn-key mobile apps, websites, web services, and complex software systems for startups and enterprises. Since 2009 it has grown from a small group of passionate engineers and business managers to a full-scale mobile software company with over 200 develope...
May. 31, 2016 10:15 AM EDT Reads: 2,926
SoftLayer operates a global cloud infrastructure platform built for Internet scale. With a global footprint of data centers and network points of presence, SoftLayer provides infrastructure as a service to leading-edge customers ranging from Web startups to global enterprises. SoftLayer's modular architecture, full-featured API, and sophisticated automation provide unparalleled performance and control. Its flexible unified platform seamlessly spans physical and virtual devices linked via a world...
May. 31, 2016 09:00 AM EDT Reads: 2,448
SYS-CON Events announced today that BMC Software has been named "Siver Sponsor" of SYS-CON's 18th Cloud Expo, which will take place on June 7-9, 2015 at the Javits Center in New York, New York. BMC is a global leader in innovative software solutions that help businesses transform into digital enterprises for the ultimate competitive advantage. BMC Digital Enterprise Management is a set of innovative IT solutions designed to make digital business fast, seamless, and optimized from mainframe to mo...
May. 31, 2016 08:45 AM EDT Reads: 2,425
"What we see what happens when you have a completely networked society and the potential to now drive the value creation and the collaboration and the ecosystems that are possible when you start to be able to connect people and industries together in ways that have never been possible before," explained Esmeralda Swartz, VP of Marketing Enterprise & Cloud at Ericsson, in this SYS-CON.tv interview at @ThingsExpo, held November 3-5, 2015, at the Santa Clara Convention Center in Santa Clara, CA.
May. 31, 2016 08:15 AM EDT Reads: 1,872
Companies can harness IoT and predictive analytics to sustain business continuity; predict and manage site performance during emergencies; minimize expensive reactive maintenance; and forecast equipment and maintenance budgets and expenditures. Providing cost-effective, uninterrupted service is challenging, particularly for organizations with geographically dispersed operations.
May. 31, 2016 08:00 AM EDT Reads: 2,360
The Internet of Things (IoT) is growing rapidly by extending current technologies, products and networks. By 2020, Cisco estimates there will be 50 billion connected devices. Gartner has forecast revenues of over $300 billion, just to IoT suppliers. Now is the time to figure out how you’ll make money – not just create innovative products. With hundreds of new products and companies jumping into the IoT fray every month, there’s no shortage of innovation. Despite this, McKinsey/VisionMobile data...
May. 31, 2016 07:45 AM EDT Reads: 1,871
The IoTs will challenge the status quo of how IT and development organizations operate. Or will it? Certainly the fog layer of IoT requires special insights about data ontology, security and transactional integrity. But the developmental challenges are the same: People, Process and Platform. In his session at @ThingsExpo, Craig Sproule, CEO of Metavine, will demonstrate how to move beyond today's coding paradigm and share the must-have mindsets for removing complexity from the development proc...
May. 31, 2016 06:00 AM EDT Reads: 2,041
SYS-CON Events announced today TechTarget has been named “Media Sponsor” of SYS-CON's 18th International Cloud Expo, which will take place on June 7–9, 2016, at the Javits Center in New York City, NY, and the 19th International Cloud Expo, which will take place on November 1–3, 2016, at the Santa Clara Convention Center in Santa Clara, CA. TechTarget is the Web’s leading destination for serious technology buyers researching and making enterprise technology decisions. Its extensive global networ...
May. 31, 2016 05:45 AM EDT Reads: 3,388
SYS-CON Events announced today that MangoApps will exhibit at SYS-CON's 18th International Cloud Expo®, which will take place on June 7-9, 2016, at the Javits Center in New York City, NY. MangoApps provides modern company intranets and team collaboration software, allowing workers to stay connected and productive from anywhere in the world and from any device. For more information, please visit https://www.mangoapps.com/.
May. 31, 2016 05:45 AM EDT Reads: 1,227