ColdFusion のカスタムパッチの適用(2021 リリース)

概要

ColdFusion で問題の修正や jar で提供される新しい機能の確認を行うために、カスタムパッチの適用が必要になることがあります。

このドキュメントでは、ColdFusion(2021 リリース)でパッケージにカスタムパッチを適用する方法について説明します。

前提条件

カスタムパッチには JSON と一緒に 1 つ以上の jar が含まれています。

JSON

例えば、パッケージ ftp のパッチを適用する場合の JSON は次のようになります。

{  
    "bundle": "ftp",     "minimumcoreserverupdaterequired": 0,     "version": "2021.0.0.324000",     "description": "The ftp package",     "dependencies": [         { "name" : "jsch" , "version" : "0.1.55", "embedded" : false},         { "name" : "commons-net" , "version" : "3.6", "embedded" : false}     ],     "awsserverless": true  
} 

この JSON の内容:

  1. パッケージ名は ftp です。
  2. キー minimumcoreserverupdaterequiredには、このパッチを実行するために必要な ColdFusion サーバーアップデートのアップデート番号が指定されています。
  3. dependencies キーには、このパッケージの依存関係が記述されています。この依存関係は、パッケージで必要な jar を表しています。パッチでは jar の新しいバージョンを提供する場合もあれば、新しい依存関係を追加する場合もあります。
  4. キー versionの値は、パッチを各 jar ファイルにマッピングするために内部的に使用されます。

パッチの適用

  1. JSON の内容を [CF ホーム]\bundles ディレクトリの bundlesdependency_custom.json ファイルにコピーします。

    既に別の JSON パッチが存在する場合は、次のようにバンドルを追加します。

    bundlesdependency_custom.json
    bundlesdependency_custom.json

    注意:

    変更内容に応じて 1 つ以上の jar が提供されています。この例で、新しいバージョンの jsch jar も提供されている場合、jar は次のようになります。

    1. ftp-2021.0.0.324000.jar
    2. jsch-0.1.55.jar

    commons-net jar は変更されていないので、提供されていません。

  2. 次の jar をコピーします。

    1. ftp-2021.0.0.324000.jar[CF ホーム]\bundles にコピーします。
    2. jsch-0.1.55.jar[CF ホーム]\bundles\repo にコピーします。
  3. cfpm ツールを起動します。

    1. [CF ホーム]\[C インスタンス]\bin ディレクトリに移動します。
    2. コマンドラインまたはターミナルを使用して、cfpm.bat/cfpm.sh を起動します。
  4. listall コマンドを実行します。  ftp パッケージの古いビルド番号と新しいビルド番号の両方が表示されます(古いビルドがインストールされている場合、古いビルドは緑色で表示されます)。

    cfpm>listall

    adminapi, versions : [2021.0.0.323925]

    administrator, versions : [2021.0.0.323925]

    ftp, versions : [2021.0.0.324000, 2021.0.0.323925]

  5. ftp パッケージをインストールします。

    cfpm>install ftp

  6. listall コマンドを再度実行します。

    cfpm>listall

    ftp パッケージの新しいビルド番号が緑色で表示されます。

これで、サーバを再起動せずに ColdFusion サーバに新しいパッチが適用されました。

上記の手順を行うと、ColdFusion(2021 リリース)でパッケージにパッチを簡単に適用できます。

注意:

従来の方法で ColdFusion サーバにパッチを適用することもできますが、

パッケージ固有のパッチの場合、この方法では上手く適用できません。

お問い合わせ

問題が発生した場合は、以下にお問い合わせください。

ヘルプをすばやく簡単に入手

新規ユーザーの場合