[Looking for Charlie's main web site?]

CF911: CF 8 Server Monitor reports "ColdFusion Server is unavailable" (solution)

Note: This blog post is from 2008. Some content may be outdated--though not necessarily. Same with links and subsequent comments from myself or others. Corrections are welcome, in the comments. And I may revise the content as necessary.
Here's another entry in my CF911 series. If you try to open the CF8 server monitor and get the error "ColdFusion Server is unavailable", the problem may be in your web server configuration. In this entry, I help you confirm if you're getting the problem I refer to here, and of course I show the solution (3 actually), with a caveat.

Here's a screenshot of what you may see:

Note that this is not an error related to logging in. You do need to fill in a username to log into the Server Monitor, even if CF is set to only ask for a password when logging into the Admin. Just use "admin". This and other facets about the CF8 Server Monitor are covered in a 4-part series of articles I did in the Adobe Dev Center, starting here.

Confirming this is the cause of your Monitor challenge

From my observation, this error is related to a problem with the Flex client being able to talk to the server using a URL it needs to use, and the problem is web server related.

You can confirm if what I'm about to describe is your issue by trying to access the URL that the server monitor tries to use to access the Flex Gateway for CF, such as:


Actually, you should use whatever domain name/port you're using to access your CF Admin, which is then used when you ask it to open the CF8 monitor, which may be a URL like this:


Anyway, if that test attempt to open the /flex2gateway/ url comes back with a "file not found" (or 404) error, as opposed to a blank page, then you likely have the problem I'm describing, whereby your web server is mistakenly looking to verify that a file exists for the path you're specifying. You have 2 solutions.

First, let me note that this flex2gateway URL is not a file, nor a directory. It's a value intercepted by a servlet filter defined within CF. You need to tell your web server not to check for any existing file (it's trying to use one of the "default documents" that are used when only a path to the web server is provided.) Before launching into how to fix your web server, you may want to consider one other possibly simpler alternative.

Changing to use the Internal Web Server

Some will note that I've used no port above in the URL. That's why I point out for you to try whatever URL is used to access your Admin. In the case above (and the people who have reported this problem so far that I've seen, they've been trying to access the CF admin using their external web server, IIS.

If instead you were to use the CF internal web server to access the CF Admin, you'd have a port in the URL, like this:


(or it could be 8300, or 8301: whatever is the port for accessing the built-in web server for CF, if you chose to implement that when CF was installed, and you are accessing the Admin that way.)

Well, I'd propose that if you DO use the internal web server, you probably won't get this error at all. The problem seems related to using IIS to access the Admin (and the CF 8 Server Monitor).

That said, I'll suggest that one quick solution folks can try is to see if indeed they can access their CF Admin (and monitor) using the internal web server. (If you can't or won't use it, I have the solution for getting it to work with IIS, in a moment.)

You just need to know what port to use to access the internal web server, if it's enabled.

First, you may find that if (on Windows) you use Start>Programs>Adobe>ColdFusion 8>Administrator that it will open using the built-in web server. If it does, see if using that gets you around this whole problem.

If that opens it with external web server (doesn't use a port like those above), or if you aren't on Windows and have no Start menu, you can also get the web server port (and indeed enabled it, if disabled) by way of the jrun.xml file. Rather than detail it here, I'll point you to a couple of resources:

Configuring the Macromedia ColdFusion MX built-in web server is an old technote, but the info still applies. Where it talks about disabling the internal web server, you'd want to reverse that, of course. There can be more subtleties and challenges to running the CF admin on the internal web server, if you don't configure it that way at the start, such as where are the /CFIDE files? Are they in the [cf]/wwwroot? or in your web server doc root, like inetpub/wwwroot? The built-in web server will look for them in the [cf]/wwwroot, so you may need to copy the CFIDE into this directory, or add a mapping to the built-in web server to point to the path as being located externally.

Making the change in IIS

Or you could just fix IIS to let you access the server monitor via IIS. The problem may be due to a setting in IIS (verify that files exist) that you may have caused to be set. (I don't know if it's set by default when CF is configured to integrate with a site, but I wouldn't think it was, so maybe this affects those who add new sites or configure things manually.)

And since this problem may affect other Flash/Flex apps trying to talk to CF, it may be worth doing for all such users. But this does come with a caveat to be aware of, if you might be using NTLM security to control access to files requested via IIS. More in a moment.

I offer the solution for IIS 6 and 7. I don't know if the same problem can affect Apache. If so, and anyone can offer the solution for there, please do comment.

Making the change in IIS 6

For IIS 6, launch the IIS Manager and select the web site which has the CF Admin you're trying to use. (It may be that you've also configured IIS so that ALL web sites are configured for CF, in which case this setting would be not at the site-level but at the root server-level, so you'd select the server name instead in the left IIS pane.)

From there, right-click and choose properties, and then select the "home directory" tab, then in the "application settings" area click the "configuration" button, and in the "wildcard mappings" section you should see something like "C:\ColdFusion8\runtime\lib\wsconfig\1\jrun_iis6_wildcard.dll" (which will be different, of course, for the JRun4-based Multiserver deployment).

This value is implemented here during the install of CF if you tell it to integrate with IIS, or by your running the CF Web Server Configuration tool after the fact.

Select it, and choose Edit, and if the "Verify that file exists" option is checked, un-check it. This setting can be confusing: you may think it means "verify that the named executable exists", but it doesn't. It refers to whether files requested and passed through this handler should be checked to confirm if THEY exist. Here's a depiction of the setting and how to get there.

Now try the URL above, and it should no longer give a 404. Then try again to login into the Admin. (Actually, you may find that you can just click the "cancel" button and it will login, even if the values for username and password are blank. I find this helpful when the CF server is temporarily unresponsive too, and the Monitor login screen pops up.) Hopefully the server monitor now works for you.

Note that this was NOT about changing the handler mapping for .cfm files, which also offers an option to control the "verify that file exists".

A caveat about access via IIS to NTLM secured files, and another alternative

Thanks to Mike Gillespie for the following notice and clarification. If you use NTLM security (windows integrated authentication in IIS) to secure files accessed via IIS, then you DO NOT WANT TO make the above change for your IIS site. I share below what he offered to me.

But I'd point out again that even with that issue, you could still use the built-in web server is a solution. Or, sticking with IIS, you could also create a new IIS site just for accessing the CF admin and monitor, and make the change above for that site only.

Anyway, if you do use NTLM security to control access to sites requested via IIS, consider the following:

The check that file exists option is required if you want to use NTLM perms to secure .cfm files. http://www.adobe.com/go/tn_18516 (Steps 1-4)

If you have a secure folder on your webserver put a .htm file and a .cfm file in it. Do not give your ID access to that folder. In IIS turn on clear text and NTLM auth.

With the "check that File Exists" option unchecked, try this test.

Try to access the .htm file in the browser - access denied

Try to access the .cfm file in the folder, - access GRANTED - so much for NTLM perms

Now check the box and try again (you will need to recycle cf and IIS)

Try to access the .htm file in the browser - access denied

Try to access the .cfm file in the folder, - access denied as it should be - but flash forms and server monitor are dead.

So "fixing" the Server Monitor problem on an authenticated server just broke the security of the server for the sake of monitoring... [frown>]

In a nutshell.

If you implement this so that CF pages can be authenticated against Windows Security http://www.adobe.com/go/tn_18516, then Flash forms break (and the server monitor too). So to get flash forms (and the server monitor) working, you have to implement this, which fixes flash forms (though every user gets their own personal file on disk on the server that has to be cleaned up) but it does not fix the server monitor.

It is the "check that file exists" selection that breaks the Server Monitor (and flash forms).

On a cf webserver that grants anonymous access there is no reason to check the "check that file exists" box. However, on a server that does authenticate users for NTLM file access, that box should be checked.

This section above was added after the entry was first posted.

The change for IIS 7. None needed?

For IIS 7, it's a little different. I actually run IIS 7 (Vista) and am not sure how/where the wildcard mapping equivalent got created (I may have fudged it manually), but it's now listed as a "Handler Mapping" (in the properties for a web site). In my case, it's labeled "AboMapperCustom-32635", but just look at those listed as handling "*" meaning all requests. It's listed with a value of IsapiModule in the Handler column. (If you're looking at a specific site, and the "Entry type" column says "Inherited", then there is another mapping at the server level, so select your server name in the left IIS panel, and repeat.)

Even so, I see no option to control "verify that file exists", so maybe this problem can't happen in IIS 7. I will say, FWIW, that there is indeed a an equivalent to that "verify that file exists" option, at least for specific extension handler mappings. Look a the one for .cfm, for instance. Double-click it to see its properties, and note a new button called "request restrictions". It has an option, "Invoke handler only if request is mapped to", and an option of "file". Again, though, this does not affect requests to non-cfm requests like that for the /flex2gateway/ URL.

About other Flex/Flash apps

As I said, it may be that the info above will help other Flex apps having trouble talking to CF (the CF8 monitor is a Flex app), but I'll note that this problem doesn't affect all Flex apps: only those that connect to CF via IIS.

For instance, on this same server where this problem occurred, there was never any problem using FusionReactor (which is also a Flex app). It was working fine the whole time. But then its default behavior is also to use its own Built-in web server, so requests weren't going through IIS. If I did try to use IIS to access FusionReactor, then it too failed (with a file not found), and the fix above solved that.

For more content like this from Charlie Arehart: Need more help with problems?
  • If you may prefer direct help, rather than digging around here/elsewhere or via comments, he can help via his online consulting services
  • See that page for more on how he can help a) over the web, safely and securely, b) usually very quickly, c) teaching you along the way, and d) with satisfaction guaranteed
I'll point out that after I posted this, I got a really useful comment by email from someone. I decided to fold his comments in above, rather than write a comment for him. It's important enough that I want to make sure all readers see it (and not all readers read bloc comments.) See the new section, "A caveat about access via IIS to NTFS secured files, and another alternative".

While I'm at it, I'll also point out that there's one reason why you may see the checkbox enabled intentionally, if taking advantage of using it for missing template handler via IIS. See this Adobe technote: http://www.adobe.com... At least one blogger has also written about it (http://www.coldfusio...). If you (or your site's users) use that, then you need to consider one of the other alternatives I offer above.
# Posted By Charlie Arehart | 11/7/08 9:45 PM
I have been working with Adobe's engineers on this very problem (expect a tech Note soon?). If you must have the "Check that file exists" box checked; then all you have to do to get the server monitor working after implementing the 2 tech notes above is to create a folder in your web root called "flex2gateway" (Case matters). No need to stop/start IIS or CF; the server monitor will start right up. It should be stressed that if you think that you have locked the box down using windows auth, you better make sure that "check that file exists is checked"; without it, cf is right now serving pages to whomever is requesting them using the account that CF is running under! This affects CFMX 6.1, 7 and 8
# Posted By Mike Gillespie | 11/13/08 9:08 PM
Awesome, Mike. Thanks for the follow-up.
# Posted By Charlie Arehart | 11/13/08 9:33 PM
Hi Charlie - I also found another related blog post that addresses the 404 flex2gateway issue here: http://www.danlance....

This is something we tried on CF 8, and it still works. We can now use the server monitor after this change.

Just thought someone else might find this useful.

# Posted By Ciaran Archer | 11/17/08 7:49 AM
problem solved

You can still get teh server monitor working without disabling file exists

step 1) follow the adobe technote which applies to cfform type=flashfor cf7
step 2) acces via ip and not domain name
Step 3) enable https for flex (the monitor is flex) -see link below
Step 4) add flex2gateway folder in your web root and inside of this folder create a folder called cfamfsecure
# Posted By ryan wagener | 11/26/08 4:03 PM
Solution above requires you to flip over cf or do a re-boot

also if you only are required to use http with ntlm and using file exists then you only need to add the following with no re-boot flip

1) add flex2gateway folder in your web root
# Posted By ryan wagener | 11/26/08 4:39 PM
Thanks, Ciaran and Ryan, for your thoughts. BTW, Ryan, on your last comment of creating a flex2gateway folder, I'll note that this is something mike Gillespie had proposed also in his comment just before Ciaran's, on 11/13.
# Posted By Charlie Arehart | 11/27/08 10:49 AM
There's a new technote from Adobe addressing this:


Also, Mike, from reading it, I see that where you in your note were referring to "ntfs", you meant "ntlm". I've corrected my entry above where I had incorporated the update you had offered.
# Posted By charlie arehart | 12/13/08 12:01 AM
Flex2Gateway error 404 was happening on my development machine, OS=Vista, IIS=7, CFusion=7.02. added the handler as described, pointing to CFusionMX7\runtime\lib\wsconfig\1\jrun_iis6_wildcard.dll. THAT FIXED IT. Thanks!!
That was after getting CF to work on IIS7 (Thanks Heidi: http://www.community... )
- Mark
# Posted By Mark Starr | 2/18/09 2:58 PM
Charles(proxy) is your friend http://www.charlespr...
# Posted By ryan wagener | 9/2/09 2:30 PM
Hey Ryan, that comment seems out of the blue. :-) I don't quite see how it relates either to the blog content or earlier comments from others (including your last one from Nov 08). Can you offer a little more context? Were you referring to someone's comment?

Since the problem seemed related to a server (IIS) configuration, I'm not sure what Charles (or any other proxy) would have done. I'll say, though, that I am of course a big fan of proxies and besides Charles, I list several more at my CF411 list, http://www.cf411.com...
# Posted By Charlie Arehart | 9/2/09 3:07 PM

Yes the comment is out of the blue. Part of the solution that I gave came from Charles proxy as it listed what was causing issues(see step 4 in my solution). Charles actually stated what folders were needed.WireShark is also good...

As I do not have the ability to post my comment before the IIS comment it had to come after

Part of the reason I made the comment as well is that Charles has been a life saver on many occasions and anybody that does not know the product that does software/web should...
# Posted By Ryan Wagener | 9/12/09 9:48 PM
Thank you for the useful information. It was helpful for me.
# Posted By Silvia | 8/31/20 3:54 AM
Copyright ©2021 Charlie Arehart
Carehart Logo
BlogCFC was created by Raymond Camden. This blog is running version 5.005.
(Want to validate the html in this page?)

Managed Hosting Services provided by
Managed Dedicated Hosting