|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.
Disruptive macro trends in technology are impacting and dramatically changing the "art of the possible" relative to supply chain management practices through the innovative use of IoT, cloud, machine learning and Big Data to enable connected ecosystems of engagement. Enterprise informatics can now move beyond point solutions that merely monitor the past and implement integrated enterprise fabrics that enable end-to-end supply chain visibility to improve customer service delivery and optimize supplier management. Learn about enterprise architecture strategies for designing connected systems tha...
Oct. 2, 2014 06:15 AM EDT Reads: 1,068
The Internet of Things (IoT) is going to require a new way of thinking and of developing software for speed, security and innovation. This requires IT leaders to balance business as usual while anticipating for the next market and technology trends. Cloud provides the right IT asset portfolio to help today’s IT leaders manage the old and prepare for the new. Today the cloud conversation is evolving from private and public to hybrid. This session will provide use cases and insights to reinforce the value of the network in helping organizations to maximize their company’s cloud experience.
Oct. 2, 2014 06:00 AM EDT Reads: 1,229
Cultural, regulatory, environmental, political and economic (CREPE) conditions over the past decade are creating cross-industry solution spaces that require processes and technologies from both the Internet of Things (IoT), and Data Management and Analytics (DMA). These solution spaces are evolving into Sensor Analytics Ecosystems (SAE) that represent significant new opportunities for organizations of all types. Public Utilities throughout the world, providing electricity, natural gas and water, are pursuing SmartGrid initiatives that represent one of the more mature examples of SAE. We have s...
Oct. 2, 2014 06:00 AM EDT Reads: 1,026
IoT is still a vague buzzword for many people. In his session at Internet of @ThingsExpo, Mike Kavis, Vice President & Principal Cloud Architect at Cloud Technology Partners, will discuss the business value of IoT that goes far beyond the general public's perception that IoT is all about wearables and home consumer services. The presentation will also discuss how IoT is perceived by investors and how venture capitalist access this space. Other topics to discuss are barriers to success, what is new, what is old, and what the future may hold.
Oct. 1, 2014 10:00 PM EDT Reads: 1,829
Whether you're a startup or a 100 year old enterprise, the Internet of Things offers a variety of new capabilities for your business. IoT style solutions can help you get closer your customers, launch new product lines and take over an industry. Some companies are dipping their toes in, but many have already taken the plunge, all while dramatic new capabilities continue to emerge. In his session at Internet of @ThingsExpo, Reid Carlberg, Senior Director, Developer Evangelism at salesforce.com, to discuss real-world use cases, patterns and opportunities you can harness today.
Oct. 1, 2014 08:30 PM EDT Reads: 2,202
All major researchers estimate there will be tens of billions devices – computers, smartphones, tablets, and sensors – connected to the Internet by 2020. This number will continue to grow at a rapid pace for the next several decades. With major technology companies and startups seriously embracing IoT strategies, now is the perfect time to attend @ThingsExpo in Silicon Valley. Learn what is going on, contribute to the discussions, and ensure that your enterprise is as "IoT-Ready" as it can be!
Oct. 1, 2014 05:00 PM EDT Reads: 2,395
Noted IoT expert and researcher Joseph di Paolantonio (pictured below) has joined the @ThingsExpo faculty. Joseph, who describes himself as an “Independent Thinker” from DataArchon, will speak on the topic of “Smart Grids & Managing Big Utilities.” Over his career, Joseph di Paolantonio has worked in the energy, renewables, aerospace, telecommunications, and information technology industries. His expertise is in data analysis, system engineering, Bayesian statistics, data warehouses, business intelligence, data mining, predictive methods, and very large databases (VLDB). Prior to DataArcho...
Oct. 1, 2014 03:30 PM EDT Reads: 1,095
Software AG helps organizations transform into Digital Enterprises, so they can differentiate from competitors and better engage customers, partners and employees. Using the Software AG Suite, companies can close the gap between business and IT to create digital systems of differentiation that drive front-line agility. We offer four on-ramps to the Digital Enterprise: alignment through collaborative process analysis; transformation through portfolio management; agility through process automation and integration; and visibility through intelligent business operations and big data.
Sep. 30, 2014 10:30 AM EDT Reads: 1,604
There will be 50 billion Internet connected devices by 2020. Today, every manufacturer has a propriety protocol and an app. How do we securely integrate these "things" into our lives and businesses in a way that we can easily control and manage? Even better, how do we integrate these "things" so that they control and manage each other so our lives become more convenient or our businesses become more profitable and/or safe? We have heard that the best interface is no interface. In his session at Internet of @ThingsExpo, Chris Matthieu, Co-Founder & CTO at Octoblu, Inc., will discuss how thes...
Sep. 29, 2014 06:45 AM EDT Reads: 1,926
Last week, while in San Francisco, I used the Uber app and service four times. All four experiences were great, although one of the drivers stopped for 30 seconds and then left as I was walking up to the car. He must have realized I was a blogger. None the less, the next car was just a minute away and I suffered no pain. In this article, my colleague, Ved Sen, Global Head, Advisory Services Social, Mobile and Sensors at Cognizant shares his experiences and insights.
Sep. 28, 2014 09:45 AM EDT Reads: 1,567
We are reaching the end of the beginning with WebRTC and real systems using this technology have begun to appear. One challenge that faces every WebRTC deployment (in some form or another) is identity management. For example, if you have an existing service – possibly built on a variety of different PaaS/SaaS offerings – and you want to add real-time communications you are faced with a challenge relating to user management, authentication, authorization, and validation. Service providers will want to use their existing identities, but these will have credentials already that are (hopefully) ir...
Sep. 27, 2014 11:30 PM EDT Reads: 1,945
Can call centers hang up the phones for good? Intuitive Solutions did. WebRTC enabled this contact center provider to eliminate antiquated telephony and desktop phone infrastructure with a pure web-based solution, allowing them to expand beyond brick-and-mortar confines to a home-based agent model. It also ensured scalability and better service for customers, including MUY! Companies, one of the country's largest franchise restaurant companies with 232 Pizza Hut locations. This is one example of WebRTC adoption today, but the potential is limitless when powered by IoT. Attendees will learn rea...
Sep. 27, 2014 10:30 PM EDT Reads: 1,857
From telemedicine to smart cars, digital homes and industrial monitoring, the explosive growth of IoT has created exciting new business opportunities for real time calls and messaging. In his session at Internet of @ThingsExpo, Ivelin Ivanov, CEO and Co-Founder of Telestax, will share some of the new revenue sources that IoT created for Restcomm – the open source telephony platform from Telestax. Ivelin Ivanov is a technology entrepreneur who founded Mobicents, an Open Source VoIP Platform, to help create, deploy, and manage applications integrating voice, video and data. He is the co-founder ...
Sep. 27, 2014 10:30 PM EDT Reads: 2,320
The Internet of Things (IoT) promises to create new business models as significant as those that were inspired by the Internet and the smartphone 20 and 10 years ago. What business, social and practical implications will this phenomenon bring? That's the subject of "Monetizing the Internet of Things: Perspectives from the Front Lines," an e-book released today and available free of charge from Aria Systems, the leading innovator in recurring revenue management.
Sep. 27, 2014 09:45 PM EDT Reads: 2,543
The Internet of Things will put IT to its ultimate test by creating infinite new opportunities to digitize products and services, generate and analyze new data to improve customer satisfaction, and discover new ways to gain a competitive advantage across nearly every industry. In order to help corporate business units to capitalize on the rapidly evolving IoT opportunities, IT must stand up to a new set of challenges.
Sep. 27, 2014 08:45 PM EDT Reads: 2,423
There’s Big Data, then there’s really Big Data from the Internet of Things. IoT is evolving to include many data possibilities like new types of event, log and network data. The volumes are enormous, generating tens of billions of logs per day, which raise data challenges. Early IoT deployments are relying heavily on both the cloud and managed service providers to navigate these challenges. In her session at 6th Big Data Expo®, Hannah Smalltree, Director at Treasure Data, to discuss how IoT, Big Data and deployments are processing massive data volumes from wearables, utilities and other mach...
Sep. 27, 2014 01:00 PM EDT Reads: 2,087
P2P RTC will impact the landscape of communications, shifting from traditional telephony style communications models to OTT (Over-The-Top) cloud assisted & PaaS (Platform as a Service) communication services. The P2P shift will impact many areas of our lives, from mobile communication, human interactive web services, RTC and telephony infrastructure, user federation, security and privacy implications, business costs, and scalability. In his session at Internet of @ThingsExpo, Erik Lagerway, Co-founder of Hookflash, will walk through the shifting landscape of traditional telephone and voice s...
Sep. 26, 2014 11:45 PM EDT Reads: 1,611
While great strides have been made relative to the video aspects of remote collaboration, audio technology has basically stagnated. Typically all audio is mixed to a single monaural stream and emanates from a single point, such as a speakerphone or a speaker associated with a video monitor. This leads to confusion and lack of understanding among participants especially regarding who is actually speaking. Spatial teleconferencing introduces the concept of acoustic spatial separation between conference participants in three dimensional space. This has been shown to significantly improve comprehe...
Sep. 26, 2014 10:45 PM EDT Reads: 1,529
The Internet of Things is tied together with a thin strand that is known as time. Coincidentally, at the core of nearly all data analytics is a timestamp. When working with time series data there are a few core principles that everyone should consider, especially across datasets where time is the common boundary. In his session at Internet of @ThingsExpo, Jim Scott, Director of Enterprise Strategy & Architecture at MapR Technologies, will discuss single-value, geo-spatial, and log time series data. By focusing on enterprise applications and the data center, he will use OpenTSDB as an example...
Sep. 26, 2014 07:45 PM EDT Reads: 2,345
SYS-CON Events announced today that Gridstore™, the leader in software-defined storage (SDS) purpose-built for Windows Servers and Hyper-V, will exhibit at SYS-CON's 15th International Cloud Expo®, which will take place on November 4–6, 2014, at the Santa Clara Convention Center in Santa Clara, CA. Gridstore™ is the leader in software-defined storage purpose built for virtualization that is designed to accelerate applications in virtualized environments. Using its patented Server-Side Virtual Controller™ Technology (SVCT) to eliminate the I/O blender effect and accelerate applications Gridsto...
Sep. 26, 2014 06:15 PM EDT Reads: 1,725