Expressway 15.5.20及更高版本的升級清單

就緒性檢查已停止升級

當證書、TLS驗證或對等身份要求失敗時，安裝程式會在重新啟動之前停止。獨立節點通過對等身份檢查。

節點啟動後發出警報

集群資料庫重加密的突發，可能會引發集群通訊故障警報。讓它有時間完成。保持活動狀態時升級。

管理員無法登入

將此問題與安裝故障分開處理。過期、重用或首次登入密碼會阻止會話。它們並不意味著影象失敗。

證書或對等身份失敗

1. 從停止的節點下載完整的系統快照。在該快照的tmp目錄中開啟installimage.log。
2. 如果消息是關於對等體身份，請檢查IP地址和FQDN的組合或空對等體清單。使每個對等體都使用一種格式，等待複製，確認群集運行正常，然後重試。請勿在滾動升級過程中更改身份格式。
3. 如果訊息是關於憑證的，請將其與版本說明規則進行比較：系統FQDN必須位於SAN中，或僅在SAN為空時才位於CN中。不允許現有SAN回退到CN。
4. 使用正確的SAN型別中每個必需的DNS名稱重新頒發證書。拒絕包含嵌入式NUL的名稱。
5. 確認新證書已過期、受信任、RSA 2048+或P-256+並使用SHA-2簽名。不要將私鑰附加到案例。
6. 將TLS驗證設定為「實施」，確認集群運行正常，然後在已停止的節點上重試升級。
7. 只有在節點正常運行後才能繼續滾動升級。當一個節點在此檢查中暫停時，請勿升級剩餘節點。

升級期間或升級後不久發生的群集警報

1. 確認升級本身已完成，並且節點位於目標版本X15.5.20或X15.5.21上。
2. 在事件日誌中查詢有關重新加密ClusterDB欄位以及「將遷移的資料儲存到CDB」的developer.upgrade消息。
3. 等待警報清除。培訓資料說重新加密完成後，它會清除。
4. 如果保留該屬性，請從每個對等點收集群集狀態、警報和快照。請勿將群集cookie或關鍵材料複製到案例備註中。

節點啟動後的登入問題

• Web UI重定向到密碼更改。必須輸入當前密碼，並且新密碼必須不同。在安裝或出廠重置後第一次GUI登入時，以及本地密碼到期時，將會出現這種情況。
• SSH表示keyboard-interactive / PAM失敗，並且從不開啟外殼。必須更改過期的本地密碼。未授予舊會話。
• REST返回401。對於已過期的本地管理員，此值應為。事件日誌可以顯示API領域的Password Mismatch或taa-chkpasswd失敗。請更改密碼，然後重試。
• 新密碼被拒絕。它位於歷史記錄中（預設值為last 12），或者未通過當前的複雜性規則。
• LDAP管理員失去了預期的角色。將已配置的組與LDAP返回的正確組名進行比較。部分或子字串匹配不再授予該角色。只讀管理員無法編輯SAML IdP信任。
• 新安裝或出廠重置時沒有出廠預設根密碼。不要搜尋或分發預設憑據。升級不會清除當前的管理員密碼。

注意：出廠重置不是升級恢復步驟。刪除群集標識和群集cookie。解除群集後系統觸發的重置或不一致的群集資料庫會保留IP地址以及管理員和根密碼，清除其他配置和日誌，並將節點返回到其臨時證書。僅當發行說明呼叫它時才使用它，並且僅在存在備份之後才使用。

在需要TAC案例的情況下收集的證據

1. 每個節點的軟體版本和角色，以及哪個節點已停止。
2. 故障節點的完整系統快照，包括tmp/installimage.log。
3. 伺服器證書文本(openssl x509 -text -noout)。 無私鑰。
4. 群集狀態、警報以及xConfiguration群集TlsVerify顯示允許還是強制執行。
5. 升級的事件日誌行，以及sshd或httpd身份驗證失敗（如果相關）。密寫密碼和cookie。
6. 無論使用本地、LDAP還是SAML管理員，還是使用智慧許可和任何API自動化。

升級後

在每個節點上

1. 版本是預期的內部版本。當升級針對2026年10月的PHP漏洞時，請使用X15.5.21。X15.5.20不包括該修復。
2. 節點在其管理地址和Web UI載入上可訪問。
3. 未引發新的硬體、磁碟或應用程式警報。(重新加密後，群集通訊警報會清除。)
4. 在群集穩定後執行新的備份。

僅集群

1. 群集中的每個對等體都處於開啟狀態，複製工作正常。
2. 對等體在TCP 4371和4372上使用雙方TLS進行通訊。（沒有有效客戶端證書的連線必須失敗。）
3. 集群TlsVerify正在實施。

   不支援允許。舊版Permissive值仍然可見，但它不會繞過驗證。設定Enforcing並確認群集保持正常。

4.防火牆仍僅允許來自對等體地址的TCP 4371。

5.日誌或上載的快照註釋中不會顯示群集cookie或診斷金鑰。

服務檢查，按正在使用什麼