[Looking for Charlie's main web site?]

Livedocs for CF8: They're here, they're faster, with commenting working, and more

Note: This blog post is from 2007. 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.
I want to share some news with those who may have noticed recent challenges with the Adobe LiveDocs, especially for CF8, and a challenge in commenting in them. All is resolved now. I've been working in the background with the Adobe gent in charge of this (who may prefer I don't share his name) and he's been great about attending to and resolving these. There's also good news: they seem faster (to me) than the CF7 livedocs.

First, you CAN now get to the livedocs...

As some noticed, there was a brief time in recent days when you couldn't get to the livedocs at all (for CF8 or otherwise). You'd get stuck in a loop on a main docs page. That's since been fixed.

But note that you may need to take a (good) detour...

But about that "main docs page", yep, it's worth noting that trying to go livedocs.adobe.com will no longer send you to the livedocs front page but rather will go instead to a new page I'll call the main Adobe docs page.

There, you have to pick which doc you want to see from a select control, and further the page you're taken to offers both a link to the livedocs and to the PDF docs. (It was the link from there to the livedocs that was broken last week, sending you right back to this page.)

Now, some may be annoyed that they get sent here. I just want to get to the livedocs. Well, if you know the URL for your product, you can, such as for CF8 or CF7.

There's more than the livedocs: PDF; and the print versions you can buy

But I do myself like that they've sent people to the main docs page first, if they don't know a short-cut. So many people never knew of the PDFs. They're nice to have sometimes.

Also, that page offers a link to the printed docs (for now, only the CF7 docs are for sale, as the CF8 docs may not be available until late August).

I've blogged about buying the printed docs before. I think for many it's the best $50 bucks they'll spend for 2500 pages of content.

New look for the CF8 docs...and faster

If you do go to the CF8 livedocs, you'll find that they have a new look compared to the CF7 docs. Also, at least it seems to me, they're much faster.

Yes, they're still a framed interface, but that's not the end of the world--and if you need them all as one, remember the PDFs, and the HTML form available on your machine where CF is installed (C:\ColdFusion8\wwwroot\cfdocs\htmldocs on my machine).

Some docs retired...

I will point out that sadly, one book from the CF7 livedocs doesn't seem to have been updated for CF8, the "Getting Started Building ColdFusion MX Applications". Again, this was a hidden gem that I think many missed and would get great value from. If you're moving from 5 or 6 to 8, please do take time to read this 150 page guide. It's really quite good.

Also, two that were available in HTML/PDF form (not on livedocs) that also seem to have been retired are the "CFML Quick Reference" and the awesome 60-page "Migrating Applications to ColdFusion MX 7". Again, if you're skipping 7 (or used it but never really took full advantage of it), check out those docs.

And yes, Virginia, you can now make comments...

Finally, and perhaps best of all, some may have noticed if they DID get to the CF8 livedocs that for some reason, the ability to comment was gone. That, too, is finally fixed. Thanks, Randy! :-) (Doh! Ok, I'll use his first name. He knows who he is, and some of you. If he wants to speak up and identify himself, I'd welcome it.)

So get out there and start commenting away. Let's share what we learn as we pour through the CF8 docs, whether online, in print, in PDF, or in HTML.

I'll have a little more to share about the commenting system and some related features in an upcoming note.

Testing code in CF8 and earlier releases--in the same code directory

Note: This blog post is from 2007. 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.
As folks contemplate moving to CF8 from 6 or 7, they may know that they can run these releases alongside each other--as long as you use a separate web server (or web site in servers that support it) configured to hand CFML requests to each CF server. Since CF6, CF has included a built-in web server to help with this very issue, especially on servers (like IIS on XP) where you can't have more than one site.

But what if you want to test some code in a single directory against one or more editions? Is that possible? I mean, let's say you have CF7 setup against IIS, and your code is in the c:\inetpub\wwwroot? And you've installed CF 8 for testing using its built-in web server, which runs on port 8500 (or whatever you chose) and finds its code in, for instance, c:\coldfusion8\wwwroot.

How would you have CF8 look at the code you've long had running in the IIS root? (or Apache, or a virtual directory you've setup for use by either external web server). Do you have to move the code around among these directories to test it on different versions of CF? No, you don't.

The trick is in the jrun-web.xml, which you can find in cfusionmx_home]\wwwroot\WEB-INF\jrun-web.xml . You can add a new "virtual-mapping" entry there, naming a new "alias" which points to files outside the normal CF-based wwwroot:

<virtual-mapping>
<resource-path>/inet/*</resource-path>
<system-path>C:/inetpub/wwwroot/</system-path>
</virtual-mapping>

So now a request for http://localhost:8500/inet/ will look instead in the inetpub/wwwroot, or wherever you point it.

Update: Note that when you use the resource-path, it's case-sensitive, even on Windows, so http://localhost:8500/INET/ would not be the same.

Of course, this works also if you set up CF8 to run via your built-in web server, but setup CF 7 or 6 to run on its own built-in web server. And of course, if you're savvy enough you may figure out how to run things so that you can run all 3 using an external web server.

There are a couple of potential challenges with this technique. For one thing, if your code has hard-coded references (such as hyperlinks, images, CFLOCATIONS, etc.) to either run on a particular host (without the port) or at a particular root-relative path, then this introduction of a new port or the /inet/ alias may hamper it working. That's not a "CF" problem but rather a coding one. Your stuck then.

But it certainly works well for testing individual files. I do it all the time and have for years. Indeed, I'll share, for the sake of posterity, that this modifying of the jrun-web.xml is something I first wrote about back in 2002, but many may have missed when such info was being shared.

I'm going to go back and reprise a lot of those "oldies but goodies", spread across a few different blogs I've had over the past several years. I think I'll call them "carehart classics".

My new Adobe DevNet articles on the CF8 Monitor

Note: This blog post is from 2007. 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.
If you'd not seen it, there are a slew of new CF8 articles on the Adobe CF Developer Center, including one I've done that's the first of a 4-part series on the CF8 monitor. The first both introduces the monitor and focuses on its uses first in development:

ColdFusion 8 server monitoring - Part 1: Using the Server Monitor in development

It's 8 pages printed, so lots of info there. I hope you'll get value from it. Since there's no feedback mechanism there, I'd appreciate if you'd share comments here of what you think of it. We writers get precious little feedback on our work, most times.

For now, it's even listed as a front-page article on the CF8 Dev Center. (FWIW, note that the URLs say "devnet" while the site itself uses the phrase "Developer Center".)

Future articles in my CF8 Monitor series will focus on using the monitor in production, then using the multi-server monitor, alerts, and snapshots, and finally several miscellaneous features and tips in part 4.

I should say finally, since many know I've talked a lot about FusionReactor and SeeFusion in the past, that, no, I don't think the CF8 monitor is a death knell for those tools (nor do I think the CF8 debugger will kill off FusionDebug). There's a place for both (especially if you're not yet on 8, and even afterwards possibly), and since the monitor is only in CF8 Enterprise, that especially keeps the other monitors in the running. I've written a more complete discussion of my perspective on these things:

Scorpio Debugger and Monitor: What's it mean for FusionDebug, FusionReactor, and SeeFusion?

Now, about it being in Enterprise, that's something I couldn't say in either my past entries or even in the current article on the DevCenter, as those were all written before the final release of CF8. I'm sorry if they read as if everyone using CF8 could use them. I really had no way to say otherwise.

That said, with the CF8 monitor being free in CF8, and especially with it giving us access to some awesome new info (which even the other monitors could now provide access to), it's worth learning what's possible. There's a lot more to it than you may think.

See the other entries I've done on the monitor. Some of them have info I couldn't fit into the DevCenter articles, or that may not be published for a few weeks.

Some really cool free tools, which almost every CFer can use

Note: This blog post is from 2007. 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.
Recently I was pointed to a useful (and free) tool from Quest (SQL Log Reader), and I noticed that I'd had a couple others already installed (Toad and Benchmark Factory). That led me to start looking into what else they had, and I was impressed with the number of free and very professional tools. It wasn't as straightforward to find them as it may seem. I thought I'd share my observations.

The range of free tools is amazing, from tools for working with databases (like Toad or Knowledge Expert for SQL Server, MySQL, or Oracle), to tools for generating load tests for databases (Benchmark Factory), to tools for managing/monitoring Windows or J2EE servers, Active Directory, and lots more.

As you review the list below, note that some of the pages show links to "evaluation" editions but I've only listed pages where I found it to say the tool was free (somewhere on the page, even if it shows an "evaluation download").

It seems some have no time limit at all (true freeware). With some, the license is time-limited and you must return for a new key (see Spotlight® on WebSphere, for instance). With others, you must uninstall and reinstall (see Object Restore for AD, for instance). I suppose it's better than a trial, in that with most trials you couldn't uninstall/reinstall. Others list a duration with no indication of whether you must uninstall (and I found one note on a forum that said you could just register for a new license key for at least one of them).

Some tools are also indicated as windows only (such as Spotlight on MySQL), but I've not paid attention here to which run on what.

The thing is, curiously, they have a page of freeware (http://www.quest.com/free-tools/) , but it doesn't list all that I've found elsewhere on the site. In fact, there's an "a-z" product page (http://www.quest.com/solutions/allproducts--atoz.asp) which indicates which are freeware, but it too does not list them all.

There were also some other Quest tools that were free in the past but are no longer, but those old versions can still be found elsewhere (sites like download.com) and though perhaps a couple of years old or more may still be useful:

I'll share more about a couple of these later.

Copyright ©2024 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