[Looking for Charlie's main web site? or all posts?]

Solving a new problem as of CF2023 update 25 that can cause CF to not start

If you've suffered the problem of CF not starting since CF2023 update 25--because you're on Windows and have implemented FusionReactor or another monitor, in this post I offer first an explanation of the root cause problem (a bug, which Adobe will need to fix) and then an unobvious but effective workaround that will allow CF to run with FusionReactor (or another monitor), when otherwise CF would not start.

[....Continue Reading....]

Comments
Hi Charlie, thanks for this post. Your short-PATH workaround does fix the initial Java instrumentation startup error on my server.

I’m running ColdFusion 2023 Enterprise on Windows Server 2022, using an AWS Marketplace AMI supplied by Coalesce Solutions, with Oracle Java 17.0.14 and FusionReactor 2026.1.3.

Unfortunately, after getting past the JVM startup failure, Update 25 still fails to initialize ColdFusion’s license service. The first error is:

```text
Unable to install License package:
java.lang.NoClassDefFoundError: com/adobe/asneu/AsnException
```

The crypto and security services then fail because `LicenseService` is null, and the ColdFusion Administrator returns HTTP 500. This happens both through the Windows service and when starting directly with `cfstart.bat` in PowerShell using the short PATH.

Update 24 works correctly, and rolling back Update 25 restores normal operation. The update installer reported success, but reinstalling U25 reproduces the failure.

We searched the installed JARs and found `AsnException.class` inside:

```text
C:\ColdFusion2023\bundles\repo\flex-messaging-data-req-4.0.jar
```

So the class exists on disk, although it apparently isn’t accessible during license-service initialization. The installer log also mentions operations involving both `cfusion-req.jar` and `cfusion-req-cloud.jar`.

Given the Marketplace origin of this installation, I wonder whether this second failure could involve the cloud-specific licensing implementation or class loading in the Coalesce AMI. That’s still a hypothesis.

Have you seen this additional failure on AWS Marketplace installations, particularly those supplied by Coalesce Solutions?
# Posted By Salvatore | 9/30/26 5:17 AM
Salvatore, glad to hear that the fix got you past your first hump. As for your second, I've not heard of others experiencing it, but it may well be unique to using that Adobe CF AMI. I've heard over the years of some situations unique to them. First, has neither coalesce nor Adobe helped?

That said, your issue may instead be caused by any of a couple problems that are generic and not about the AMI.

One can be about an error during the first startup of cf after the update, when cf updates the packages. Have you confirmed there were none, in the coldfusion-out.log, on that first startup after the update?

Next, have you also tried stopping cf and clearing the felix-cache? It doesn't matter that the update says it does that BEFORE the update starts. This is about doing it AFTER those package updates during the subsequent cf startup. CF doesn't do that.

(I'd discussed those two practices above in previous blog posts about the cf updates. I stopped including that as it is now about a dozen updates per year and it was wordy redundancy. I've been meaning to pull them out into a separate post, to at least then point to that in each subsequent update post.)

Finally, still another possibility stems from a possible choice made on your end: how did you do the cf update? If by the "manual offline update", involving downloading the packages zip, it's easy to get that wrong by taking a shortcut and just extracting that zip to cf's bundles folder. Do not do that. Again, I've been meaning to do a post on that, as I hear occasionally from people who've made that mistake.

As always if you'd rather try to get to resolution more expeditiously (perhaps just minutes) rather than via back and forth here, note that I offer remote screenshare consulting. My minimum billable interval is only 15 mins, and I solve most problems in less than an hour. Regardless, you won't pay for time you don't find valuable.

For more on my rates, approach, satisfaction guarantee, online calendar, email, phone, and more, see the consulting page at carehart.org.

Either way, let us know your thoughts in response to the above, as other readers may share your interest.
Hey Charlie,

I ended up installing CFU25 the day it came out, and ran into this -- and implemented the temporary solution of adding the path to the windows environment vars PATH var and it worked. I also had to do a quick workaround in our powershell scripts that are executed via CF, because the full path was not available to them either.

I hate editing the registry, especially on servers, if I don't have to. And certainly not for something that is ultimately (IMNSHO) a bug that should be fixed ASAP. So... do you think Adobe will treat this as the bug it is, and issue a patch or update for it, so that we can revert our temporary workarounds eventually?
# Posted By Franc Amour | 9/30/26 10:35 AM
Glad to hear that it helped, Franc. I'll say again (as i do in the post) that this is indeed a trivial reg tweak, also easily removed once Adobe fixes it.

But as for whether they WILL treat it as a bug and WILL fix it, I cannot say. As I concluded in the post, it's been filed as a bug. Now we wait. I have no further influence on that than does anyone else, honestly.
Charlie, thanks for this update! Not sure if I should be happy I found a bug or not, ha! We'll be looking into our options and deciding how we are going to proceed, and definitely look at your approach first.
# Posted By BrianM | 9/30/26 4:40 PM
I'm new to this role — stepping in as DBA/software updater after the previous person retired, so please bear with me if I'm missing something obvious.

I successfully applied CF2023 Update 25. CF would not start, so after much research I first removed the FusionReactor agent, .jar and .dll from CF jvm.config file and CF would start. After more research I put those back into the jvm.config, and I cleared the Felix cache, and I confirmed the correct user has permissions on the FusionReactor instance folder. CF would then start fine.

However, FusionReactor Instance still will not start. Is this what others are experiencing? Are they leaving it not running?

My question: with the workaround in your Sept 29 post, were you able to get FusionReactor Instance actually running again (not just CF starting with the agent lines removed)? I want to make sure I'm chasing the right fix before I spend more time on permissions tweaks.

Thanks for all the detail you've posted on this — it's been a huge help getting oriented quickly.
# Posted By ctobey | 10/1/26 11:06 AM
@ctobey, to be clear: yes, the whole point of this Sep 29 post (that you're commenting on) and its offered workarounds was to ALLOW you to put FR (or any other monitor causing the problem) back into the CF jvm configuration (typically a javaagent, yes).

In fact I mention that at the end of each workaround. But in case someone else somehow could misconstrue things I have just added a few more words to the end of the opening paragraph. :-)

I see the challenge for you is that you have a DIFFERENT problem. You say that you put the FR javaagent "back into the jvm.config...and CF would then start fine. However, FusionReactor Instance still will not start."

So first, since your CF is now starting (with FR in place) but you don't say you applied either of the workarounds I propose in this post, I'm wondering: is your CF on something other than Windows? Perhaps Linux or Mac, or a container image, or in CommandBox? None of those had the problem I describe here, nor did they need the workaround I propose here.

In either case, since your CF is running but you say "FusionReactor Instance still will not start", do you mean the FR UI for the CF instance, like the default at port 8088? Or might you mean the FRAM instance, at port 8087? I just want to be clear.

Assuming you do mean the FR UI for the CF instance (like 8088), that can fail to work (even though CF starts, and when you have put the javaagent back in place) for any of a few unusual reasons, but they have nothing to do at all with what I describe in this post.

I would recommend you look at the startup logs for CF (coldfusion-out.log, coldfusion-error.log, or as shown on your terminal if started there) to see if during the startup you find it reporting a problem in its attempt to start FusionReactor. To be clear, FR runs INSIDE of the JVM alongside of CF. It's not a separate process. So if it fails to start then it's something you'll typically find logged in the CF startup logs.

And when you see the error, before you may share it to ask for help, just google it. You may well be shown a solution for that, which is documented by the FR folks. (There's one particular scenario I've seen where you're told to delete a folder deep inside the FusionReactor directory for the CF instance.)

Or another situation could be that the user running CF doesn't have permissions to modify that directory for the CF instance, within the FusionReactor folder. But since you imply things were working BEFORE the CF update, we should presume that is NOT your issue.

Finally, if all this is too much to try to connect dots/understand here in the blog comments, I'll repeat that this is the kind of thing I could likely help solve in less than 15 mins together in a consulting session. I realize some may feel they "can't get permission for such assistance", but honestly we can usually solve things SO much more easily in looking together rather than "playing battleship" in comments. :-)

But that's not directed to you specifically, presuming what you may feel. I say it for the sake of others reading along. Regardless, I'm here: ready to make the next move here in the comments. Hopefully we can "sink that battleship". (I'll take "dated 70's board games for $200, Alex". :-)
It was just brought to my attention that Adobe has now acknowledged this problem (of CF not starting "when certain Java agents or libraries are configured") as a "known issue" in the CF2023 update 25 technote. That's "good" to see...though I have a couple of concerns.

First I lament that they propose one of the solutions that I contend (above) is brittle, of putting the CF java bin folder as first in the path--and especially proposing to put that in the Windows *system path*. I can see that leading to other trouble, as I discussed above. I suspect they didn't read my post before proposing that. (If they ignored the concerns, that's its own worry.)

And now the FR folks also have posted a blog entry about the issue also (https://docs.fusionreactor.io/Troubleshooting/Known-Issues/CF2023-Update-25-Startup-Failure/). That too is good to see, and they mention my post here--but their first workaround (currently) follows Adobe's lead.

Then they mention the service solution (and my proposal to use xx for the path), but it will be confusing to readers since their first workaround follows Adobe's lead. I hope they may improve it (I've shared feedback).

Sadly, that cf update technote is what most will see. I guess this chips will fall where they may.

The saddest thing in all this is that now that it's simply documented by them as a "known issue" in that technote, they will likely NOT be issuing any update to address it soon. And sometimes "known issues" like this are NOT fixed in the next CF update (because that's an urgent "security update"). And that could continue for a couple more updates, before they finally roll up some bug fixes.

I say that to suggest that this issue will likely plague us for some months to come. Bummer. Oh well, I do what I can do.
As someone who is running CF2023, on Windows as a service, with FusionReactor... it again pays to have put off an update from Adobe until after Charlie has issued his own Adobe-created-issue workarounds :D You likely have saved me a couple hours of headache when I get around to installing this update.
# Posted By Paul | 10/2/26 3:37 PM
Thx, Paul. :-)
Going back to Paul's' kind comment of Friday, I should have added (in my reply of thanks) that I hope what he said was a BIT tongue-in-cheek ("it again pays to have put off an update from Adobe until after Charlie has issued his own Adobe-created-issue workarounds").

As I've discussed in the past security updates, it's important these days to not wait "too long", as there are bad guys who "take apart" each update to determine "what was changed"...so that they can attempt to exploit the vuln against those who have NOT yet applied the update.

And while some "good guy"/white hat hackers might do the same to try to warn folks of what to beware, that's not true for every update--and they are often not very detailed in their reporting of how to effect the exploit. It's always a balancing act for them.

And it's one for us, as well.
I installed update 25 on my dev server and all my cfhtmltopdf tags stopped working :( Tried to uninstall it and it didn't work. Just noticed that my Add-on service is not running and I cannot turn it back on now too :( Sure glad I didn't install on my prod server!
# Posted By Marlon | 10/5/26 6:11 PM
Marlon, that's not some problem unique to u25. There can be many reasons the add on service won't run, of course. But specific to updates, some folks have found that their cfusion/jetty folder can be missing a lib subfolder after cf updates. That shouldn't happen, but it has (though never to me).

While I've helped others recover, beware of simply restoring that folder from the "backup/jetty/lib" found the cfusion/hf-updates folderfor your u25.

That may seem to "work", but it's incomplete: there are still other jetty files that need to be restored. It also loses security improvements intended by updates to the folder (again,you're restoring from a backup cf took BEFORE that update).

The BEST thing would be to copy things from a working cf2023 u25 folder. That can be attempted on another machine.

I'll say I can help via a remote consulting session, likely in less than a half hour--though I can't commit to that. For more on my rates, approach, satisfaction guarantee, online calendar, email, phone, and more, see the consulting page at carehart.org.
Hi Charlie- You have a typo in your add and delete commands: reg add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ColdFusion 2023 Application Server" /v Envrionment /t REG_MULTI_SZ /d path=xx

Envrionment is misspelled
# Posted By Matt G | 10/6/26 9:58 AM
Matt, thanks so much (and apologies everyone)!

Corrected--and noted also in the "updates" section of the post.
Hi Charlie, a follow-up to my September 30 comment: Adobe Support’s suggestions worked, and we have now successfully applied Update 25 and started ColdFusion without problems.

Your short-PATH workaround had already resolved the initial Java instrumentation startup error. The remaining failure was during license-service initialization:
java.lang.NoClassDefFoundError: com/adobe/asneu/AsnException

This was followed by null LicenseService errors and HTTP 500 from the Administrator.

For that remaining problem, Adobe provided the following procedure, with Update 25 installed:
1. Stop ColdFusion
2. Move C:\ColdFusion2023\cfusion\lib\cfusion-req.jar to a separate backup folder
3. Copy cfusion-req.jar from C:\ColdFusion2023\cfusion\hf-updates\hf-2023-00025-330977\backup\lib into C:\ColdFusion2023\cfusion\lib
4. Start ColdFusion

Separately, for the Java instrumentation/FusionReactor issue, Adobe advised checking java.home in C:\ColdFusion2023\cfusion\bin\jvm.config and placing that Java installation’s bin directory first in the Windows system Path. Your cautions about the impact on other Java applications and future JVM changes still apply.

This worked on our ColdFusion 2023 Enterprise installation on Windows Server 2022, using the Coalesce Solutions AWS Marketplace AMI. The underlying cause of the license-service failure has not been confirmed, so I’m sharing the procedure that worked for our installation.

With this approach, we did not need a service-specific Environment registry value containing a PATH=... override.

Thanks again for your help!
# Posted By Salvatore | 10/7/26 3:23 AM
Salvatore's comment here refers back to the very first one offered above. And he's now confirming that the problem he faced (one not solved by but also not CAUSED BY my workaround) was indeed unique to his running the cf AWS AMI (as I had anticipated in my reply to him that day)

So first, thanks for sharing what you had to do, recovering a jar from the update's backup folder. Before asserting that everyone (on the AMI) would need to do that, I'd asked if there were any errors in the update logs. Assuming there were none, then yes we can let this stand as something others on the AMI may face in applying the update.

Only time will tell if it's something folks may need to repeat on subsequent updates, if Adobe doesn't solve the root cause problem for that. But to be clear, readers, this other issue seems ENTIRELY unrelated to the matter in this post.

Finally, as for his ALSO suffering the FR/instrument library problem, he shares that he opted instead to follow Adobe's suggestion to modify the system path, rather than the service definition tweak I propose here. He acknowledges that has the potential negatives as I'd outlined, but it's true that on an AWS AMI that's used for nothing BUT running CF, the risks to other apps of modifying the system path that way are less of a concern.

Even so, the other risk remains: if you later modify the cf Java home to point to a different Java version (such as for the Java update that Oracle will release the week after next), then you will HAVE to modify that system path to replace that Java home location if it changes. Otherwise cf startup will again fail, but now for that other error I noted in the post.

Forewarned is forearmed. Or, "don't say I didn't warn you", folks. :-)
For folks who haven't heard or tried it, I can report that the update that came out yesterday, Oct 13 (for CF2023 and 2025) DOES fix that problem discussed in this post. See my post on that here:
https://www.carehart.org/blog/2026/10/14/coldfusion_updates_released_oct_13_2026
Charlie, can confirm the latest update fixed the problem of CF no start on Windows. Thanks for confirming here!
# Posted By BrianM | 10/15/26 1:59 PM
Yep, and in case you missed it I had offered a comment here about it yesterday. :-) Sorry I didn't think to email you directly (as I know we had discussed it directly before I wrote this post).
Copyright ©2026 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
xByte cloud Hosting