ColdFusion MX アップデータリリース 3
リリースノート パート 1 -
既に知られている問題とインストール手順
2003 年 3 月 19 日

このドキュメントには ColdFusion MX アップデータリリース 3 に関する情報が記載されています。アップデータリリース 3 は、ColdFusion MX サーバーおよび ColdFusion MX for J2EE Application Servers と機能します。アップデータ 3 は、入手可能なすべての ColdFusion MX エディションとリリースに使用できる最初のアップデータリリースです。

この ColdFusion MX アップデータのリリースは、IBM Passport ライセンシングプログラムから購入された ColdFusion MX for IBM WebSphere のバージョンをサポートしません。Passport を通して ColdFusion MX を購入された場合は、直接 IBM からアップデータのコピーを入手する必要があります。

アップデータリリースは累積パッチです。アップデータ 3 にはアップデータ 1 と 2 からのフィックスがすべて含まれています。そのため、アップデータ 3 をインストールする前にアップデータの 1 と 2 をインストールする必要はありません。「パート 2 -- このアップデータリリースで修正された問題」 と 「パート 3 -- 以前のアップデータリリースで修正された問題」にリストされているバグは、アップデータ 3 でも修正されています。

• アップデータについての詳細は、FAQ for ColdFusion MX connector configuration をご覧ください。
  
• アップデータ 3 がインストールされているかどうかを確認する場合は、ColdFusion MX Administrator を開き、ページの最上部付近にあるバージョン情報リンクをクリックしてください。「バージョン情報」ページにあるサーバーの詳細リストは、アップデータ 3 を持つ ColdFusion MX Servers をバージョン 6,0,0,58500 として示し、アップデータ 3 を持つ ColdFusion MX for J2EE Application Servers をバージョン 6,0,0,58096 として示します。

このリリースノートは長いため、4 パートに分かれています。

このアップデータには、以下の既に知られている問題があります。これらの問題は既にリストされているものへの追加です。ColdFusion MX の既に知られている問題についての詳細は、ColdFusion MX テクニカルノート「Known ColdFusion MX issues」を参照してください。

Windows での ColdFusion MX サーバーアップデートのインストール

このセクションでは、Windows プラットフォームに ColdFusion MX アップデートをインストールする手順を説明します。アップデータをインストールする前に「インストーラの注意」をお読みください。

Windows で ColdFusion MX アップデートをインストールするには

1. 必ず ColdFusion MX 用の最新のアップデータをインストールしてください。詳細は、http://www.macromedia.com/jp/support/coldfusion をご覧ください。



2. コンピュータで現在実行中のアプリケーションをすべて閉じます。



3. 次のサービスを停止します。
   
   • ColdFusion MX Application Server
   • ColdFusion MX ODBC Agent
   • ColdFusion MX ODBC Server
   • (ColdFusion MX 用の Web サーバーとして IIS を使用している場合) World Wide Web Publishing Service
   • (IIS または ColdFusion MX のビルトイン Web サーバー以外の Web サーバーを使用している場合)
     その Web サーバー


4. cfmx_updater_windows_r3.exe を実行します。インストールウィザードが開始します。
   


5. ウィザードの指示に従い、完了します。
   
   メモ: 手順 3 で IIS をシャットダウンしなかった場合は、ColdFusion はサイトを個別にシャットダウンし、アップデートのインストール後それらを再起動しようとします。多数のサイトがある場合は、長時間かかることがあります。



6. [プリインストールの要約] 後、アップデートされたファイルがコンピュータにコピーされ、設定されている Web サーバーコネクタがすべてアップグレードされます。



7. インストールの完了後、手順 3 で停止したサービスを再起動します。また、アップデータの実行後、Web サーバーを再起動する必要がある場合もあります。
   

UNIX での ColdFusion MX サーバーアップデートのインストール

このセクションでは、UNIX に ColdFusion MX アップデートをインストールする手順を説明します。アップデータをインストールする前に「インストーラの注意」をお読みください。

メモ: この手順で一般的に使用される cfmx_updater_file とは、アップデータファイルのことです。専用のアップデータ 3 ファイル名は、次のように、オペレーティングシステムにより異なります。

UNIX で ColdFusion MX アップデートをインストールするには

1. 必ず ColdFusion MX 用の最新のアップデータをインストールしてください。詳細は、http://www.macromedia.com/jp/support/coldfusion をご覧ください。



2. root としてログインします。



3. 次のコマンドで ColdFusion MX を停止します。
   /cf_root/bin/coldfusion stop



4. 使用中の Web サーバーを停止します。
   


5. cd コマンドを使用して、Cold Fusion MX アップデータファイルのあるディレクトリへ移動します。



6. 次のコマンドでアップデータファイルを修正します。
   chmod 755 cfmx_updater_file



7. 次のコマンドでインストールを開始します。
   ./cfmx_updater_file
   インストールプログラムが開始します。
   


8. プロンプトに従い、プログラムを完了します。



9. アップデータプログラムの終了後、Web サーバーを起動します。
   


10. 次のコマンドで ColdFusion MX を起動します。
    /cf_root/bin/coldfusion start

ColdFusion MX サーバーインストールの注意

以下の注意で、cf_webroot とは ColdFusion MX CFIDE ディレクトリが含まれているディレクトリのことです。通常、このディレクトリは、使用中の Web サーバーのルートドキュメントディレクトリです。たとえば、ColdFusion MX の内蔵 Web サーバーの場合、このディレクトリは cf_root\wwwroot です。ColdFusion MX が Microsoft IIS や Apache などの他の Web サーバーを使用する場合は、ディレクトリへのパスが異なる可能性があります。アップデータのインストールプログラム手順のひとつで、このディレクトリの位置を指定してください。

• アップデータは次の情報ファイルを cf_root directory に書き込みます。
  
  

  Macromedia_ColdFusion_MX _Updater_InstallLog.log	インストールされたファイルを含めた詳細なインストール情報が記録されるログファイル。
  cfmx_updater_installer_debug.txt	詳細なデバッグ情報。



• アップデータは、アップデートをインストールする前に、次のファイルの存在を確認します。いずれかのファイルでも欠けている場合は、アップデータはエラーを報告し、アップデートをインストールしません。
  
  

  Windows:	cf_root\bin\cfstart.bat cf_root\lib\cfusion.jar cf_webroot\CFIDE\administrator\Application.cfm
  UNIX:	cf_root/bin/coldfusion cf_root/lib/cfusion.jar cf_webroot/CFIDE/administrator/Application.cfm



• 更新されるすべてのファイルの元のバージョンのコピーが cf_root/cfmx_updater/cfmx_updater_XX ディレクトリツリーにコピーされます。(XX は 01 のような番号で、バックアップファイルを保存したアップデートを指すために使用されます。) このディレクトリ内の各ファイルの位置は、cf_root ディレクトリに相対する元のファイルの位置を反映します。
バックアップファイルを既に作成したアップデートを再インストールしても、元のバックアップファイルは上書きされません。


• アップデータ 3 でのコンパイラの変更のため、ColdFusion アプリケーションコードを適切に機能させるために、再コンパイルが必要です。この操作を確実にするために、cf_root\wwwroot\WEB-INF にある既存の cfclasses フォルダの名前は、アップデータインストーラにより cfclasses_backup に変更されます。
  
  cf_root\bin 内にインストールされた updater_compile スクリプトを使用して、ColdFusion アプリケーションを再コンパイルできます。アプリケーションを再コンパイルすると、初回ページリクエスト時間が短縮されますが、ColdFusion アプリケーションの機能が改善されるわけではありません。次のコマンドを使用して、このスクリプトを実行します。

  Windows:
updater_compile.bat cf_web_root [cf_app_file_dir]
  
  UNIX:
  ./updater_compile.sh -cfuser username -webroot cf_web_root
                    [-dir cf_app_file_dir]

  cf_web_root は Web ルートディレクトリを指します (たとえば、C:\inetpub\wwwroot)。
  
  cf_app_file_dir はコンパイルする CFML ファイルが置かれているディレクトリを指します。Web ルートディレクトリの下にある必要があります。この属性を省略すると、スクリプトは Web ルートディレクトリとそのサブディレクトリ内のすべての coldfusion ページを再コンパイルします。
  
  UNIX コマンドでは、username は ColdFusion ランタイムユーザーを指定し、ColdFusion MX をインストールしたユーザー (通常は nobody) に対応する必要があります。
  
  再コンパイルとアプリケーションのテストの成功後、このインストールで作成された cfclasses_backup フォルダを削除できます。

• アップデータはすべての設定された Web コネクタを自動的にアップグレードします。場合によっては、たとえば、セキュリティパッチのインストール後など、アップデータとは別に、すべての設定されたコネクタをアップグレードする必要がある場合があります。Windows でコネクタをアップグレードする場合は、cf_root\bin\connectors\Upgrade_all_connectors.bat スクリプトを実行してください。スクリプトは引数を使用しません。

ColdFusion MX for J2EE アップデートのインストール

このセクションでは、ColdFusion MX for J2EE Application Servers を実行しているシステム上での ColdFusion MX アップデートのインストール手順を説明します。この手順はすべてのオペレーティングシステムと現在までにリリースされた ColdFusion MX for J2EE のすべてのバージョンに適用されます。これらのバージョンには、Macromedia JRun 4、IBM WebSphere 4、および Sun One Web Server 6 にのみ機能する最初の Phase 1 リリースと、アーカイブとしてデプロイイする 第 2 の Phase 2 リリースが含まれます。

ColdFusion MX for J2EE 用のアップデータは、現在の ColdFusion MX for J2EE インストールを完全に置き換えます。アップデータは、既存の設定と ColdFusion アプリケーションファイルをバックアップし、更新された ColdFusion MX for J2EE をインストールします。インストール後、設定と ColdFusion アプリケーションファイルを復元してください。

メモ：

• これらの手順では、ご使用のアプリケーションサーバーの ColdFusion MX for J2EE インストール手順を参照します。インストール手順は、http://www.macromedia.com/go/cfmxj2ee-cert_jp でオンラインで参照できます。「サポートされる J2EE アプリケーションサーバー」表の「アーカイブファイルのインストール」欄には、サポートされるサーバーに適したインストール手順へのリンクがあります。(「統合されたインストーラ」欄にあるリンクを使用してはいけません。)「アーカイブインストールでサポートされないアプリケーションサーバー」セクションには、追加サーバーをインストールする手順へのリンクがあります。
  


• アップデータは、ColdFusion MX for J2EE の Phase 1 バージョンを Phase 2 形式のインストールと置き換えます。その結果、Phase 1 に適用されるインストールマニュアルはもう適用されません。代わりに、Phase 2 インストール手順を使用してください。

• 必ず ColdFusion MX for J2EE 用に入手可能な最新のアップデータをインストールしてください。詳細は、http://www.macromedia.com/jp/support/coldfusion をご覧ください。

• JRun 4 をアプリケーションサーバーにしている ColdFusion MX for J2EE 上でアップデータ 3 をインストールする場合は、「既に知られている問題」セクションのバグ 49694 にリストされている方法のいずれかを使用して、ColdFusion の Web サービスを有効にする必要があります。
  


• JRun 4 をアプリケーションサーバーにしている ColdFusion MX for J2EE 上でアップデータ 3 をインストールする場合は、JRun 4 SP1a リリースノートに記載されている、ColdFusion を JRun 4 上で実行するための特別な手順に従う必要はありません。
  

ColdFusion MX for J2EE でのアップデータのインストール

1. コンピュータで現在実行中のアプリケーションをすべて閉じます。



2. Windows を実行しており、ODBC データソース用のサポートをインストールした場合は、次のサービスを停止します。
   
      ColdFusion MX ODBC Agent
      ColdFusion MX ODBC Server



3. アプリケーションサーバーにより異なりますが、ColdFusion アプリケーションと RDS アプリケーション (実行中の場合) を停止するか、アプリケーションサーバーを停止します。
   


4. ColdFusion MX for J2EE アップデータを実行します。
   Windows、Linux、または Solaris の場合は、次の実行可能ファイルをダウンロードして、実行します。
   
   

   Windows	coldfusion-j2ee-win.exe
   Linux	coldfusion-j2ee-linux.bin
   Solaris	coldfusion-j2ee-solaris.bin

   
   他のプラットフォームの場合は、次のコマンドを使用して、coldfusion-j2ee-java.jar ファイルを実行します。
   
      java_home/java -jar coldfusion-j2ee-java.jar -i console



5. アップデータで、ColdFusion MX for J2EE のアーカイブファイルインストール用の手順に従います。インストール手順は、http://www.macromedia.com/go/cfmxj2ee-cert_jp でオンラインで参照できます。以前にアーカイブファイルインストール (Phase 2 インストールとも呼ばれる) を使用した場合は、ColdFusion MX for J2EE をインストールする際に使用した手順に従います。たとえば、J2EE サーバーの必要に応じて、EAR ファイルデプロイか WAR ファイルデプロイを選択してください。
   
   アップデータには、元の Phase 2 ColdFusion MX for J2EE インストーラの手順に追加される次のような手順があり、それらは ColdFusion MX for J2EE インストール手順に記載されていません。
   
   
   1. ご使用の configuration ファイルと custom ファイルのバックアップを作成するかどうか尋ねられたら、[Yes (はい)] を選択します。
      
   
   
   2. バックアップファイルを置くディレクトリを選択します。アップデータは、安全に置き換えることのできない、ColdFusion J2EE アプリケーションディレクトリツリーにあるすべてのファイルをこのディレクトリ内に保存します。これらのファイルには、設定ファイルと ColdFusion インストールの一部ではないすべてのファイルが含まれます。手順 9 で、これらのファイルを ColdFusion MX アプリケーションへコピーして戻してください。
      
   
   
   3. ColdFusion MX for J2EE がデプロイされるディレクトリを指定します。ColdFusion インストール手順では、このディレクトリは通常 cf_root として示されます。このディレクトリには、CFIDE ディレクトリと WEB-INF ディレクトリ (WEB-INF\cfusion を含む)、また、ColdFusion サンプルをインストールした場合は cfdocs ディレクトリが含まれます。アプリケーションサーバーによっては、ColdFusion アプリケーションコンテキストルートと同じ名前を持つものがあります。
   
   


6. ご使用のアプリケーションサーバー用の標準のアンデプロイ手順に従い、アプリケーションサーバーから ColdFusion MX J2EE アプリケーションをアンデプロイします。
   


7. 手順 5 で作成した EAR ファイルまたは WAR ファイルを、以前に使用したアプリケーションサーバー上の同じディレクトリ内にデプロイします。ご使用のアプリケーションサーバー用の ColdFusion MX for J2EE インストール操作にあるデプロイ手順に従います。インストール操作にあるデプロイ手順のみを行ってください。特に以下に注意してください。
   
   
   
   • ColdFusion MX Administrator を開いたり、スタートアップウィザードを実行してはいけません。
     
   • セキュリティ設定や Verity サポートの設定など、ColdFusion MX for J2EE のデプロイ後の手順を実行する必要はありません。
     
   
   
8. ColdFusion J2EE アプリケーションが実行中の場合は、それを停止します。アプリケーションサーバーによっては、J2EE アプリケーションサーバーを停止する必要がある場合があります。
   


9. 手順 5b で指定したバックアップディレクトリ内のファイルを cf_root にコピーして戻します。バックアップディレクトリツリーからのファイルが、cf_root ディレクトリツリー内の同じ名前のファイルをすべて上書きすることを確認してください。
   


10. アプリケーションサーバーによっては、cf_root\WEB-INF\cfusion\lib\tools.jar ファイルの名前を他の名前に変更する必要がある場合があります (たとえば tools.old など)。この手順を実行する必要があるかどうかを判断する場合は、ご使用のアプリケーションサーバー用の ColdFusion MX for J2EE インストール手順を参照してください。
    


11. Phase 1 サーバー (Run 4、WebSphere Application Server バージョン 4、または Sun ONE Web Server 6) 上で実行中の ColdFusion MX for J2EE を更新する場合、WEB-INF/cfusion/lib/wizzardconfig.xml ファイルをテキストエディタで開き、runsetup 値を true から false に変更します。
    


12. ColdFusion J2EE アプリケーションまたは J2EE サーバーを再起動します。
    


13. 手順 3 でサービスを停止した場合は、それを再起動します。また、アップデータの実行後、Web サーバーを再起動する必要がある場合があります。
    

Apache Web サーバーでのアップデートのインストール

2.0.43 より以前のバージョンの Apache Web サーバーを ColdFusion MX サーバーか ColdFusion MX for J2EE および JRun と併用している場合は、ColdFusion MX を使用する前に Apache の新しいバージョンをインストールする必要があります。そのため、アップデータ 2 と Apache 2.0.43 をインストールする場合をのぞき、Apache の新しいバージョンをインストールする必要があります。

1. Web サーバーコネクタをアンインストールします。コマンドプロンプトで、次の行を実行します。
   Windows:
   cf_root\runtime\jre\bin\java -jar cf_root/runtime/lib/wsconfig.jar -v -u
   UNIX:
   cf_root/jre/bin/java -jar cf_root/runtime/lib/wsconfig.jar -v -u
   


2. ColdFusion MX を停止します。
   


3. Apache 2.0.43 かそれ以降をインストールします。インストールするバージョンには、バージョン 2.0.43 と同じ MODULE_MAGIC_NUMBER_MAJOR (Apache マジックナンバー) 値が必要です。
   


4. ColdFusion MX アップデータをインストールします。
   


5. ColdFusion MX を再起動します。
   


6. 次の行を使用して、新しい Apache Web サーバーインストールに Web サーバーコネクタをインストールします。
   Windows:
   cf_root\runtime\jre\bin\java -cp cf_root/lib -jar cf_root/runtime/lib/wsconfig.jar -ws Apache -dir Apache_conf_dir -v -map .cfm,.cfc.,.cfml -coldfusion
   On UNIX:
   cf_root/jre/bin/java -cp cf_root/lib -jar cf_root/runtime/lib/wsconfig.jar -ws Apache -dir Apache_conf_dir -v -map .cfm,.cfc.,.cfml -coldfusion

メモ: Apache マジックナンバーを確かめる場合は、次のコマンドのいずれかを実行します。

Windows:
apache_root\bin\Apache.exe -V

UNIX:
apache_root/bin/httpd -V | grep "Magic Number"