Produkcyjny ColdFusion 2025 za współdzielonym Apache: instalacja trwa 34 sekundy, szczegóły wymagają uwagi

Żadnego z pięciu punktów poniżej nie ma w instrukcji instalacji, a każdy kosztuje popołudnie, gdy przychodzi jako niespodzianka.

Błąd 503, choć ColdFusion działa: localhost to nie zawsze 127.0.0.1

Po podpięciu konektora Apache zwracał 503 Service Unavailable, a sam ColdFusion odpowiadał poprawnie. wsconfig wpisuje jako adres serwera ColdFusion nazwę localhost. Konektor rozwiązał ją na adres IPv6 ::1, a konektor AJP w Tomcacie ColdFusion nasłuchuje tylko na 127.0.0.1. Log konektora mówi wprost, czego szukać:

connect to ::1:8024 failed (errno=111)
(cfusion) connecting to backend failed. Tomcat is probably not started or is listening on the wrong port (errno=111)

Rozwiązaniem jest adres 127.0.0.1 w definicji workera i w pliku właściwości, w którym wsconfig przechowuje parametry konektora, żeby ponowne uruchomienie narzędzia nie przywróciło nazwy. Na nowej instalacji narzędzie przyjmuje adres jako opcję. Czego nie robić: otwierać portu AJP na wszystkich interfejsach. Otwarty AJP to znany wektor ataku, Ghostcat, CVE-2020-1938.

Konektor sięga do wszystkich hostów wirtualnych

Żadnego objawu, i właśnie to jest problem: nic się nie psuje, dopóki inny serwis na tym samym Apache nie użyje ścieżki, którą konektor uważa za swoją. wsconfig w ColdFusion 2025 kopiuje mapowania do każdego hosta wirtualnego, a obejmują one więcej niż pliki CFML:

/rest/* = cfusion
/restapps/* = cfusion
/mcs = cfusion
/cffileservlet/* = cfusion
/*.jsp = cfusion

Aplikacja PHP z API pod /rest/ na tym samym serwerze mogłaby trafić do ColdFusion. Przed restartem przejrzeliśmy logi dostępowe pozostałych serwisów pod kątem tych ścieżek, nie znaleźliśmy nic i zapisaliśmy ich kody HTTP; po restarcie porównaliśmy. Gdy kolizja jest realna, narzędzie potrafi skonfigurować konektor tylko dla jednego hosta wirtualnego.

Konektor zmienia więcej, niż widać

Na Debianie narzędzie kopiuje moduł i tworzy jego konfigurację bezpośrednio w katalogu Apache, a dwa kolejne pliki lądują w katalogu ColdFusion. Dopisuje dwie linie include na końcu głównej konfiguracji Apache i dodaje sekret do konektora AJP w konfiguracji serwera ColdFusion, więc ColdFusion też trzeba zrestartować. Debiana nie rozpoznaje, co okazuje się niegroźne. Wniosek: pliki konektora leżą w dwóch miejscach, więc kopie zapasowe, zarządzanie konfiguracją i aktualizacje muszą obejmować oba.

Zgłoszenia o awariach Apache po instalacji konektora

Na forum Adobe użytkownicy ColdFusion 2025 zgłaszali, że Apache na Ubuntu losowo nie startuje po dodaniu konektora. Wykonaliśmy pięć pełnych cykli stop i start na Apache 2.4.67 z modułem konektora z buildu z kwietnia 2026, stan na 2026-10: każdy cykl zakończył się poprawnym startem i odpowiedzią strony testowej, a w dzienniku systemowym nie było żadnej awarii. Na serwerze współdzielonym taki test należy do instalacji, a nie do pierwszego restartu po aktualizacji systemu.

Profil serwera to nie formalność

Szablon konfiguracji JVM w instalatorze zawiera domyślną stertę i równoległy garbage collector. Instalacja z profilem deweloperskim dopisuje na początku argumentów JVM agenta debuggera, którego w szablonie nie ma. Na produkcji wybieramy profil Production i Secure, a po instalacji czytamy konfigurację JVM, zamiast zakładać, że jest domyślna. Z tego samego powodu nigdy nie przenosimy tego pliku ze środowiska testowego na produkcję. Jak zachowuje się sterta za mała na obciążenie, pokazuje inny projekt.