|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.
DevOps at Cloud Expo, taking place Nov 1-3, 2016, at the Santa Clara Convention Center in Santa Clara, CA, is co-located with 19th Cloud Expo and will feature technical sessions from a rock star conference faculty and the leading industry players in the world. The widespread success of cloud computing is driving the DevOps revolution in enterprise IT. Now as never before, development teams must communicate and collaborate in a dynamic, 24/7/365 environment. There is no time to wait for long dev...
Sep. 29, 2016 07:00 AM EDT Reads: 3,482
The Internet of Things 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 and how we integrate our thinking to solve complicated problems. In his session at 19th Cloud Expo, Craig Sproule, CEO of Metavine, will demonstrate how to move beyond today's coding paradigm ...
Sep. 29, 2016 07:00 AM EDT Reads: 3,408
Fact is, enterprises have significant legacy voice infrastructure that’s costly to replace with pure IP solutions. How can we bring this analog infrastructure into our shiny new cloud applications? There are proven methods to bind both legacy voice applications and traditional PSTN audio into cloud-based applications and services at a carrier scale. Some of the most successful implementations leverage WebRTC, WebSockets, SIP and other open source technologies. In his session at @ThingsExpo, Da...
Sep. 29, 2016 06:45 AM EDT Reads: 1,671
Cognitive Computing is becoming the foundation for a new generation of solutions that have the potential to transform business. Unlike traditional approaches to building solutions, a cognitive computing approach allows the data to help determine the way applications are designed. This contrasts with conventional software development that begins with defining logic based on the current way a business operates. In her session at 18th Cloud Expo, Judith S. Hurwitz, President and CEO of Hurwitz & ...
Sep. 29, 2016 06:45 AM EDT Reads: 3,178
SYS-CON Events announced today that Roundee / LinearHub will exhibit at the WebRTC Summit at @ThingsExpo, which will take place on November 1–3, 2016, at the Santa Clara Convention Center in Santa Clara, CA. LinearHub provides Roundee Service, a smart platform for enterprise video conferencing with enhanced features such as automatic recording and transcription service. Slack users can integrate Roundee to their team via Slack’s App Directory, and '/roundee' command lets your video conference ...
Sep. 29, 2016 05:45 AM EDT Reads: 1,502
Digital transformation is too big and important for our future success to not understand the rules that apply to it. The first three rules for winning in this age of hyper-digital transformation are: Advantages in speed, analytics and operational tempos must be captured by implementing an optimized information logistics system (OILS) Real-time operational tempos (IT, people and business processes) must be achieved Businesses that can "analyze data and act and with speed" will dominate those t...
Sep. 29, 2016 05:15 AM EDT Reads: 1,245
IoT is fundamentally transforming the auto industry, turning the vehicle into a hub for connected services, including safety, infotainment and usage-based insurance. Auto manufacturers – and businesses across all verticals – have built an entire ecosystem around the Connected Car, creating new customer touch points and revenue streams. In his session at @ThingsExpo, Macario Namie, Head of IoT Strategy at Cisco Jasper, will share real-world examples of how IoT transforms the car from a static p...
Sep. 29, 2016 05:00 AM EDT Reads: 1,640
Internet of @ThingsExpo, taking place November 1-3, 2016, at the Santa Clara Convention Center in Santa Clara, CA, is co-located with the 19th International Cloud Expo and will feature technical sessions from a rock star conference faculty and the leading industry players in the world and ThingsExpo Silicon Valley Call for Papers is now open.
Sep. 29, 2016 04:30 AM EDT Reads: 4,683
The Transparent Cloud-computing Consortium (abbreviation: T-Cloud Consortium) will conduct research activities into changes in the computing model as a result of collaboration between "device" and "cloud" and the creation of new value and markets through organic data processing High speed and high quality networks, and dramatic improvements in computer processing capabilities, have greatly changed the nature of applications and made the storing and processing of data on the network commonplace.
Sep. 29, 2016 04:00 AM EDT Reads: 1,214
Almost two-thirds of companies either have or soon will have IoT as the backbone of their business in 2016. However, IoT is far more complex than most firms expected. How can you not get trapped in the pitfalls? In his session at @ThingsExpo, Tony Shan, a renowned visionary and thought leader, will introduce a holistic method of IoTification, which is the process of IoTifying the existing technology and business models to adopt and leverage IoT. He will drill down to the components in this fra...
Sep. 29, 2016 04:00 AM EDT Reads: 1,816
SYS-CON Events announced today that ReadyTalk, a leading provider of online conferencing and webinar services, has been named Vendor Presentation Sponsor at the 19th International Cloud Expo, which will take place on November 1–3, 2016, at the Santa Clara Convention Center in Santa Clara, CA. ReadyTalk delivers audio and web conferencing services that inspire collaboration and enable the Future of Work for today’s increasingly digital and mobile workforce. By combining intuitive, innovative tec...
Sep. 29, 2016 03:30 AM EDT Reads: 3,038
I'm a lonely sensor. I spend all day telling the world how I'm feeling, but none of the other sensors seem to care. I want to be connected. I want to build relationships with other sensors to be more useful for my human. I want my human to understand that when my friends next door are too hot for a while, I'll soon be flaming. And when all my friends go outside without me, I may be left behind. Don't just log my data; use the relationship graph. In his session at @ThingsExpo, Ryan Boyd, Engi...
Sep. 29, 2016 03:30 AM EDT Reads: 1,380
SYS-CON Events announced today that Pulzze Systems will exhibit at the 19th International Cloud Expo, which will take place on November 1–3, 2016, at the Santa Clara Convention Center in Santa Clara, CA. Pulzze Systems, Inc. provides infrastructure products for the Internet of Things to enable any connected device and system to carry out matched operations without programming. For more information, visit http://www.pulzzesystems.com.
Sep. 29, 2016 03:15 AM EDT Reads: 1,908
IoT offers a value of almost $4 trillion to the manufacturing industry through platforms that can improve margins, optimize operations & drive high performance work teams. By using IoT technologies as a foundation, manufacturing customers are integrating worker safety with manufacturing systems, driving deep collaboration and utilizing analytics to exponentially increased per-unit margins. However, as Benoit Lheureux, the VP for Research at Gartner points out, “IoT project implementers often ...
Sep. 29, 2016 03:15 AM EDT Reads: 3,585
There is growing need for data-driven applications and the need for digital platforms to build these apps. In his session at 19th Cloud Expo, Muddu Sudhakar, VP and GM of Security & IoT at Splunk, will cover different PaaS solutions and Big Data platforms that are available to build applications. In addition, AI and machine learning are creating new requirements that developers need in the building of next-gen apps. The next-generation digital platforms have some of the past platform needs a...
Sep. 29, 2016 03:00 AM EDT Reads: 1,888
If you’re responsible for an application that depends on the data or functionality of various IoT endpoints – either sensors or devices – your brand reputation depends on the security, reliability, and compliance of its many integrated parts. If your application fails to deliver the expected business results, your customers and partners won't care if that failure stems from the code you developed or from a component that you integrated. What can you do to ensure that the endpoints work as expect...
Sep. 29, 2016 02:45 AM EDT Reads: 1,721
As ridesharing competitors and enhanced services increase, notable changes are occurring in the transportation model. Despite the cost-effective means and flexibility of ridesharing, both drivers and users will need to be aware of the connected environment and how it will impact the ridesharing experience. In his session at @ThingsExpo, Timothy Evavold, Executive Director Automotive at Covisint, will discuss key challenges and solutions to powering a ride sharing and/or multimodal model in the a...
Sep. 29, 2016 02:30 AM EDT Reads: 543
Is your aging software platform suffering from technical debt while the market changes and demands new solutions at a faster clip? It’s a bold move, but you might consider walking away from your core platform and starting fresh. ReadyTalk did exactly that. In his General Session at 19th Cloud Expo, Michael Chambliss, Head of Engineering at ReadyTalk, will discuss why and how ReadyTalk diverted from healthy revenue and over a decade of audio conferencing product development to start an innovati...
Sep. 29, 2016 02:30 AM EDT Reads: 2,182
WebRTC adoption has generated a wave of creative uses of communications and collaboration through websites, sales apps, customer care and business applications. As WebRTC has become more mainstream it has evolved to use cases beyond the original peer-to-peer case, which has led to a repeating requirement for interoperability with existing infrastructures. In his session at @ThingsExpo, Graham Holt, Executive Vice President of Daitan Group, will cover implementation examples that have enabled ea...
Sep. 29, 2016 02:00 AM EDT Reads: 1,597
SYS-CON Events announced today that Numerex Corp, a leading provider of managed enterprise solutions enabling the Internet of Things (IoT), will exhibit at the 19th International Cloud Expo | @ThingsExpo, which will take place on November 1–3, 2016, at the Santa Clara Convention Center in Santa Clara, CA. Numerex Corp. (NASDAQ:NMRX) is a leading provider of managed enterprise solutions enabling the Internet of Things (IoT). The Company's solutions produce new revenue streams or create operating...
Sep. 29, 2016 01:45 AM EDT Reads: 2,058