Skip to main content
A
ACS LLC
Inspiring
September 4, 2018
Answered

Why do I need to run the Web Configuration Tool?

  • September 4, 2018
  • 1 reply
  • 1694 views

While working through my migration from Windows Server 2008 to Windows Server 2016 (clean install) I came across a problem, none of my CFM files would load, I just got a 404 error.

I was running IIS, my root was the default innetpub/wwwroot for the CF2016 install, but my web sites are in another directory.

When I installed my 2008 server some time ago everything went fine. I did recently notice the two mappings for CF_scripts and Jakarta, and wondered where they came from. I'm pretty sure CF was installed and then I went to IIS to add my sites.

This time things were different, after pulling my hair out for an hour or two I realized that those mappings were not present. I ran the Web Site Configuration Tool, removing the ALL setting and then putting it back, and all of the mappings were now present and the sites were now working fine.

The question I have is, why am I now having to run this when I didn't have to do it before and does this mean I'll need to run it every time I add a new site?

Is there anything I can/should do when installing the IIS or ColdFusion so I can forget about this issue in the future and make it work when I just add a site in IIS?

Thanks

Mark

This topic has been closed for replies.
Correct answer Charlie Arehart

Mark, it's a simple problem on one hand, but definitely confuses people.

To answer your last question, you can just add the jakarta virtual directory yourself. You don't necessarily NEED to run the wsconfig tool.

The CF installer has always offered the option to configure the connection to IIS (or Apache) near the end of the installation process, or you could run the wsconfig tool at any time. Both options let one configure either "all sites" or individual sites.

And in CF10 and above, that does 3 things in IIS: it creates an ISAPI filter, several handler mapppings, and a jakarta virtual directory. These all point to a folder created in the CF config/wsconfig folder. If it's configured for "all sites", then the ISAPI Filter and Handler mappings are configured at the IIS "server" level and can be inherited by any new sites (as was the case in CF9 and before).

The problem is that IIS has no means to create auto-create the jakarta virtual directory. That's why you find things "not working".

So again, you can just add the vd yourself (especially in a case where you have only configured "all sites" to be connected to CF, as there is only 1 folder under config/wsconfig to point to). Or you can re-run the wsconfig if you want to. In the case of such an "all sites" setup, then yes, as you note it will remove the settings (and the VD from all sites), and then it will add them back to all sites PRESENT THEN.

And to be clear, all this also adds not just the jakarta VD but also the CFIDE vd (in CF 10 and 11) or the cf_scripts folder in CF2016 or 18.

(And if one wants to create a new connector for one or more sites, then you would run the wsconfig tool to create that connector for each additional individual site. And CF2016 even added a new feature in the wsconfig tool to configure EACH then-existing to use its own connector. Discussing that choice is beyond the scope of your question.)

Does that make more sense now? Any remaining questions?

1 reply

Charlie Arehart
Charlie ArehartCorrect answer
Adobe Expert
September 5, 2018

Mark, it's a simple problem on one hand, but definitely confuses people.

To answer your last question, you can just add the jakarta virtual directory yourself. You don't necessarily NEED to run the wsconfig tool.

The CF installer has always offered the option to configure the connection to IIS (or Apache) near the end of the installation process, or you could run the wsconfig tool at any time. Both options let one configure either "all sites" or individual sites.

And in CF10 and above, that does 3 things in IIS: it creates an ISAPI filter, several handler mapppings, and a jakarta virtual directory. These all point to a folder created in the CF config/wsconfig folder. If it's configured for "all sites", then the ISAPI Filter and Handler mappings are configured at the IIS "server" level and can be inherited by any new sites (as was the case in CF9 and before).

The problem is that IIS has no means to create auto-create the jakarta virtual directory. That's why you find things "not working".

So again, you can just add the vd yourself (especially in a case where you have only configured "all sites" to be connected to CF, as there is only 1 folder under config/wsconfig to point to). Or you can re-run the wsconfig if you want to. In the case of such an "all sites" setup, then yes, as you note it will remove the settings (and the VD from all sites), and then it will add them back to all sites PRESENT THEN.

And to be clear, all this also adds not just the jakarta VD but also the CFIDE vd (in CF 10 and 11) or the cf_scripts folder in CF2016 or 18.

(And if one wants to create a new connector for one or more sites, then you would run the wsconfig tool to create that connector for each additional individual site. And CF2016 even added a new feature in the wsconfig tool to configure EACH then-existing to use its own connector. Discussing that choice is beyond the scope of your question.)

Does that make more sense now? Any remaining questions?

/Charlie (troubleshooter, carehart. org)
A
ACS LLCAuthor
Inspiring
September 5, 2018

Thanks for the in-depth reply Charlie.

What I can't understand is why I never ran into this problem when I set up my previous 2008 server. I can only think that I either added the sites to IIS before I installed CF, or I did an upgrade over the top of my CF8 and therefore the sites were already in IIS, I just can't for the life of me remember.

I do always select IIS on the CF install, so I guess that it seems that every time I add a new site I must remember to either manually add the Jakarta virtual directory, or re-run the Web Configuration tool?

A
ACS LLCAuthor
Inspiring
September 5, 2018

Again, yes to both paragraphs.


Something odd is going on. I ran the web config tool, and all is well, the sites were working fine. All of a sudden they stopped working. 'Connection reset'. No CFM files will come up, it'll serve HTML, and HTM but not CFM, I didn't change anything I was testing a site and all of a sudden this issue came up

I can't see anything wrong, the virtual directories are there. The CF administrator also works.

Any ideas?

Terms & ConditionsAccessibility statement
Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices