Update の適用に失敗する場合の確認点

このページではColdFusion のUpdateの適用時にエラーなどが発生した際の対応について解説します。

ColdFusion Administratorの「パッケージマネージャー＞パッケージ」のページを開き、『コアサーバー』の[使用可能なバージョン]を選択して、[ダウンロードしてインストール]や[インストール]ボタンを押しても、そこから先に進まない
- Windows サーバー上の Internet Explorer を使用していませんか？IEはすでに古いブラウザであり、JavaScriptの動作等が正常に行われないため、更新に失敗します
  - → 代わりにEdgeブラウザや Google Chrome ブラウザを使用してください
- Windows OS の場合、「ColdFusion 2023|2021 Application Serverサービス」の起動を、デフォルトの「ローカルシステムアカウント」から、任意のアカウントに変更して起動していませんか？任意のアカウントを指定している場合、そのアカウントはOSのサービスを停止する権限が無く、サービスを停止することができません。
  - → 一旦、ローカルシステムアカウントに変更してColdFusion を起動し直すか、手動でUpdateを適用してください
    - https://cfassociates.samuraiz.co.jp/index.cfm/faq/cftech/cfupd-manually/
- ColdFusion 2023でColdFusion Administratorの「サーバーの設定＞設定」の『シリアル化用の構造体キーで大文字小文字が保持されます。』を有効にしていると、Updateの処理でキーの取得に失敗して処理が進まなくなります
  - →Updateを適用する際は『シリアル化用の構造体キーで大文字小文字が保持されます。』を無効にして（Updateの適用が終わったら元の戻して）ください。
- Java 17.0.8以降（ColdFusion 2023の場合）や Java 11.0.20以降（ColdFusion 2021の場合）を使用していると、古いUpdate（ColdFusion 2023はUpdate 5以下、2021はUpdate 11以下）の適用に失敗します
  - →古いUpdateの適用は止めるか、または、問題が発生しないリビジョン（Java 17.0.7以前・Java 11.0.19以前）のJavaを使って手動でUpdateを適用してください
    - https://cfassociates.samuraiz.co.jp/index.cfm/faq/etc/update-error-after-2023july-java/
ColdFusion AdministratorからのUpdateに失敗し、再試行しようとした際に、コアのUpdateの説明欄に以下のエラーメッセージが表示される。
このアップデートの以前のインストールでエラーが発生しました。フォルダー内のログを参照してください /usr/local/ColdFusion2021/bundles/updateinstallers/ and fix the root cause before re-applying the hotfix again.
- このエラーが発生するほとんどの原因は、Linuxの場合はファイル・フォルダの権限が不足している事、Windowsの場合は、内部のツール（例えばパッケージマネージャー cfpm を起動中にUpdate を適用したため、プロセスが使用中でファイルの置き換えができなかった、などとなります。
  - 特に Linux の場合は、手動でUpdateを適用した際は、新たに追加されたファイルや置き換えられたファイル・フォルダについては rootユーザーで作成されます。rootユーザーの権限で追加されたファイルやフォルダをそのまま放置していると、後の Update で ColdFusion Administratorから適用しようとしても、rootユーザーの権限で追加されたファイルやフォルダを移動することができず、正しくファイルを置き換えることができなくなり、このエラーになります
    - 以下のFAQの手順14に書かれているコマンド等を使用して、ColdFusionのインストールフォルダ内のファイル・フォルダの権限を ColdFusion実行ユーザーと同じユーザーに変更してから、Updateを適用してください。
      https://cfassociates.samuraiz.co.jp/index.cfm/faq/cftech/cfupd-manually/
      - 原因が分からない場合は、手動で Update を適用してください。
  - Windows環境の場合も。「ColdFusion 2023|2021 Application Serverサービス」の起動を、デフォルトの「ローカルシステムアカウント」から、”管理者権限を持たない”任意のアカウントに変更して起動している場合に同じ問題となる恐れがあります。
    - 手動で Update を適用してください
  - Windows環境で、任意のツール実行したままUpdateを実行すると、ツールのプロセスが起動していることでUpdateの適用が失敗する場合があります
    - [cf_root]/{インスタンス(cfusion等)}/hf-updates/hf-202x-000xx-xxxxxx フォルダ（xxxの部分はバージョンやUpdate番号・ビルド番号が入ります）の中に、インストールログ（Adobe_ColdFusion_202x_Update_xx_インストール_月_日_年_時_分_秒.log）が生成されています。そのファイルを確認したら、以下のようなエラーが確認できます。
      - 要約
        ----
        
        インストールの開始: 失敗。
        
        1718 成功
        0 警告
        0 非致命的エラー
        4 致命的エラー
        
        アクションメモ:
        
        ファイル移動の失敗 :: 以前のホットフィックスファイルのバックアップに失敗しました。サーバーが実行中でないこと、またはファイルがサーバーによってロックされていないことを確認してからインストールを再試行してください。
        
        ファイル移動の失敗 :: 以前のホットフィックスファイルのバックアップに失敗しました。サーバーが実行中でないこと、またはファイルがサーバーによってロックされていないことを確認してからインストールを再試行してください。
        
        ....

記事公開日：2024年12月27日
最終更新日：2024年12月27日

Sample Modal Window

This is just a sample…