Accessibility
 
ホーム / 製品 / ColdFusion / サポート
J2EE Support
 

Sun ONE Web Server バージョン 6 上での ColdFusion MX for J2EE のインストール

目次

概要
ColdFusion MX のインストール、デプロイ、設定
他の問題


概要

ColdFusion MX は J2EE アプリケーションです。通常、J2EE アプリケーションのデプロイは、EAR ファイルか WAR ファイルを使用するアーカイブファイルのデプロイを介して行います。Sun ONE Web Server バージョン 6 をサポートする ColdFusion MX for J2EE のファーストリリースには、アーカイブファイルデプロイを使用しないインストーラが含まれていました。アーカイブファイルデプロイと Sun ONE Web Server バージョン 6 とのテストが完了しましたので、Sun ONE Web Server バージョン 6 上で ColdFusion MX for J2EE を実行する際に、今後は標準のデプロイ方法を使用してください。Sun ONE Web Server バージョン 6 でアーカイブファイルデプロイを使用すると、作業が柔軟でポータブルになり、ColdFusion MX の更新も単純化されます。

さらに、アーカイブファイルデプロイには次のような利点があります。

直列化可能な ColdFusion セッションデータをサポートします。これは、クラスタ化されたサーバー内のセッションフェイルオーバーをサポートするために必要です。
デベロッパーや管理者はアプリケーションそのものをデプロイできます。

このドキュメントには、Sun ONE Web Server 6 上の ColdFusion MX for J2EE のセカンドリリースをデプロイする手順が記載されています。ここでは、CD にある『Macromedia ColdFusion MX for J2EE のインストールと使用』マニュアルの概要情報を参照します。

このページの後半では、Sun ONE Web Server 6 上の ColdFusion MX WAR ファイルのデプロイと設定について説明します。続行する前に、必ず ColdFusion MX for J2EE の「リリースノート」をお読みください。また、『Macromedia ColdFusion MX for J2EE のインストールと使用』の最初と最後の章もお読みください。

Sun ONE Web Server 6 上で ColdFusion MX for J2EE を実行する場合は、JDK 1.3.x を使用する必要があります。


目次に戻る

 

ColdFusion MX のインストール、デプロイ、設定

デプロイユーティリティと WAR ファイルを併用して、Sun ONE Web Server 6 上で ColdFusion MX for J2EE をデプロイします。

Sun ONE Web Server 6 上に ColdFusion MX for J2EE をインストールする場合は、以下の手順に従ってください。

1.
プラットフォーム特有のインストーラをダウンロードし、実行して、ColdFusion MX for J2EE インストール操作を行います。
  • 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 で実行)

ColdFusion MX for Sun ONE Web Server 6 のボックスを購入された場合は、ディスク 2 を使用してください。ColdFusion MX for J2EE インストーラは、Macromedia Web サイトからダウンロードできます。

2.
質問に答え、インストールディレクトリを選択します。EAR ファイルか WAR ファイルを選択するように求められたら、WAR を選択します。
3.
Sun ONE Web Server が起動中であることを確認します。
4.
ColdFusion MX Administrator をデプロイするディレクトリを作成します。
たとえば、UNIX では /usr/iplanet/servers/bin/https/webapps/cfusion を、Windows では C:\iPlanet\Servers\bin\https\webapps\cfusion を作成します。
5.
IWS_SERVER_HOME 環境変数をサーバールートに設定します。
たとえば、UNIX では export IWS_SERVER_HOME=/usr/iplanet/servers を、Windows では SET IWS_SERVER_HOME=c:\iPlanet\Servers を指定します。パスに末尾のスラッシュを付けませんので、注意してください。
6.

wdeploy ユーティリティを使用して、ColdFusion MX Web アプリケーションをデプロイします。wdeploy ユーティリティは、sunone_root/servers/bin/https/httpadmin/bin ディレクトリにあります。次のシンタックスを使用します。

wdeploy deploy -u uri_path -i instance -v vs_id [-d directory] war_file

UNIX の例:
./wdeploy deploy -u /cfusion -i https-AUTOCLIENT4 -v https-AUTOCLIENT4 -d /usr/iplanet/servers/bin/https/webapps/cfusion /opt/CFMXJ2ee/cfusion.war

Windows の例:
wdeploy deploy -u /cfusion -i https-AUTOCLIENT4 -v https-AUTOCLIENT4 -d C:\iPlanet\Servers\bin\https\webapps\cfusion c:\cfmxj2ee\cfusion.war

7.
RDS をデプロイするディレクトリを作成します。必ずこのディレクトリに CFIDE (すべて大文字) の名前を付け、cfusion ディレクトリと同じレベルに置きます。
8.

wdeploy ユーティリティを使用して、RDS Web アプリケーションをデプロイします。wdeploy ユーティリティは、sunone_root/servers/bin/https/httpadmin/bin ディレクトリにあります。次のシンタックスを使用します。

wdeploy deploy -u uri_path -i instance -v vs_id [-d directory] war_file

UNIX の例:
./wdeploy deploy -u /CFIDE -i https-AUTOCLIENT4 -v https-AUTOCLIENT4 -d /usr/iplanet/servers/bin/https/webapps/CFIDE /opt/CFMXJ2ee/rds.war

Windows の例:
wdeploy deploy -u /CFIDE -i https-AUTOCLIENT4 -v https-AUTOCLIENT4 -d c:\iPlanet\Servers\bin\https\webapps\CFIDE c:\cfmxj2ee\rds.war

9.
(UNIX のみ) ColdFusion MX がデプロイされるサーバーに、デプロイされる CFMX アプリケーションの全ファイルとディレクトリにアクセスするための許可があることを確認します。
10.
テキストエディタで cf_root/WEB-INF/web.xml ファイルを開き、<welcome-file-list> 要素の id 属性を削除します。
11.

(Windows のみ) COM の設定 - 以下の手順を実行します。

  1. [スタート] > [ファイル名を指定して実行] を選択します。[ファイル名を指定して実行] ボックスで、regedit と入力し、[OK] をクリックします。
  2. レジストリエディタで、以下に示すレジストリキーを開いて編集します。
    \\HKEY_LOCAL_MACHINE\SOFTWARE\Netscape\Enterprise\6.0\NSES_JRE_RUNTIME_LIBPATH
  3. このキーの値に以下に示すディレクトリを追加します。各ディレクトリをセミコロン文字 (;) で区切ってください。
    cf_root\WEB-INF\cfusion\jintegra\bin
    cf_root\WEB-INF\cfusion\jintegra\bin\international

    次にこのレジストリキーの例を示します。
    C:\iPlanet\Servers\docs\cfmx\WEB-INF\cfusion\jintegra\bin;C:\iPlanet\Servers\docs\cfmx\WEB-INF\cfusion\jintegra\bin\international
  4. [OK] をクリックし、レジストリエディタを閉じます。
  5. Sun ONE Web Server を再起動します。
12.

(Windows と Linux のみ) Verity サポートの設定 - Verity (cfcollection タグ、cfindex タグ、cfsearch タグ) を有効にするには、ライブラリ検索パスを設定して、Verity バイナリファイルを見つける必要があります。(Verity ファイルは cf_root/WEB-INF/cfusion/lib ディレクトリにあります。)

メモ: この機能は Solaris にはありません。Sun ONE Web Server と ColdFusion MX コード (Verity 検索エンジン用の基本 C コードを Java と併用できるようにする) 同士の非互換性が原因です。

Windows

  1. [スタート] > [ファイル名を指定して実行] を選択します。[ファイル名を指定して実行] ボックスで、regedit と入力し、[OK] をクリックします。
  2. レジストリエディタで、以下に示すレジストリキーを開いて編集します。
    \\HKEY_LOCAL_MACHINE\SOFTWARE\Netscape\Enterprise\6.0\NSES_JRE_RUNTIME_LIBPATH
  3. このキーの値に以下に示すディレクトリを追加します。各ディレクトリをセミコロン文字 (;) で区切ってください。
    cf_root\WEB-INF\cfusion\lib
    cf_root\WEB-INF\cfusion\lib\_nti40\bin
  4. [OK] をクリックし、レジストリエディタを閉じます。
  5. Sun ONE Web Server を再起動します。

Linux

  1. sunone_root/servers/https-computer_name ディレクトリ (たとえば、/opt/iplanet/servers/https-fred/start) にある起動スクリプトのバックアップコピーを作成します。
  2. 編集するために元のファイルを開き、次の項目を単一の長い 1 行で追加します。
    LD_LIBRARY_PATH=${SERVER_ROOT}/bin/${PRODUCT_NAME}/lib:
    ${LD_LIBRARY_PATH}:cf_root/WEB-INF/cfusion/lib/:cf_root/WEB-INF/ cfusion/lib/_ilnx21/bin/

    例:
    LD_LIBRARY_PATH=${SERVER_ROOT}/bin/${PRODUCT_NAME}/lib:
    ${LD_LIBRARY_PATH}:/home/iplanet/servers/docs/cfmx/WEB-INF/
    cfusion/lib/:/home/iplanet/servers/docs/cfmx/WEB-INF/cfusion/
    lib/_ilnx21/bin/
  3. ファイルを保存し、Sun ONE Web Server を再起動します。

これで、Linux 上で ColdFusion MX の Verity を使用できるようになります。

13.

(UNIX のみ) グラフ作成サポートの設定 - 以下の手順を実行します。

  1. sunone_root/servers/https-computer_name/config ディレクトリ (たとえば、/opt/iplanet/servers/https-fred/config/jvm12.conf) にある JVM 設定ファイル (jvm12.conf) のバックアップコピーを作成します。
  2. 編集するために元の設定ファイルを開き、以下に示す行を追加します。

    jvm.option=-Xbootclasspath:jdk_home/lib/tools.jar:jdk_home/jre/lib/rt.jar:
    jdk_home/lib/dt.jar:jdk_home/jre/lib/i18n.jar:cf_root/WEB-INF/lib/
    webchartsJava2D.jar
    jvm.option=-Djava.awt.graphicsenv=com.gp.java2d.ExGraphicsEnvironment

    メモ 1: JDK 1.4.1 の場合、com.gp.java2d.ExHeadlessGraphicsEnvironment を指定してください (ColdFusion MX アップデータ 3 が必要です)。
    メモ 2: jdk_home は、Sun ONE が ColdFusion MX 用に使用する JDK の位置です。
    たとえば、/usr/java/jdk1.3.1_03 など。

  3. ファイルを保存します。
    これで、ColdFusion MX のチャートとグラフ作成をエラーなしに使用できるようになります。
14.

.NET Web サービスを利用するためのサポートを設定します。.NET WebServices を利用するために、cf_root/WEB-INF/cfusion/lib/crimson.jar を sunone_root/bin/https/jar フォルダにコピーし、Sun ONE Web Server を再起動します。

15.

(Solaris と Linux のみ) C++ CFX サポートの有効化 - 以下の手順を実行します。

  1. sunone_root/servers/https-computer_name ディレクトリ (たとえば、/opt/iplanet/servers/https-fred/start) にある起動スクリプトのバックアップコピーを作成します。
  2. 編集するために元のファイルを開き、次の項目を単一の長い 1 行で追加します。

    LD_LIBRARY_PATH=${SERVER_ROOT}/bin/${PRODUCT_NAME}/lib:
    ${LD_LIBRARY_PATH}:cf_root/WEB-INF/cfusion/lib/

    例:
    LD_LIBRARY_PATH=${SERVER_ROOT}/bin/${PRODUCT_NAME}/lib:
    ${LD_LIBRARY_PATH}:/home/iplanet/servers/docs/cfmx/WEB-INF/
    cfusion/lib/
  3. ファイルを保存し、Sun ONE Web Server を再起動します。

これで ColdFusion MX 内で CFX を使用できるようになります。

16.
Sun ONE Web Server を起動します。
17.

ColdFusion MX Administrator を再起動し、ブラウザに ColdFusion MX Administrator 用の URL を入力して、スタートアップウィザードを実行します。URL には次の形式があります。

http://host:[port]/cf_root/CFIDE/administrator
例:
http://localhost:81/cfusion/CFIDE/administrator

Administrator に初めてアクセスすると、スタートアップウィザードが起動します。ウィザードに以下の情報を入力して、ColdFusion MX を設定します。

  • インストーラを実行したときに指定した元の Administrator パスワード。
  • シリアル番号。シリアル番号を入力せず、[トライアルモードで継続] をクリックした場合は、ColdFusion をフル機能のトライアルモードで 30 日間使用できます。シリアル番号なしに 30 日たつと、ColdFusion はローカルホストと 1 つのリモート IP アドレスからのリクエストのみをサポートするデベロッパーモードになります。
    ウィザードでシリアル番号を入力しなくても、後で ColdFusion MX Administrator のバージョン情報パネルを使用して番号を入力できます。
  • RDS サポートを設定するかどうか。そして、RDS サポートを設定する場合は、RDS パスワード。セキュリティを最大限にするために、本番サーバー上に RDS をインストールしてはいけません。RDS についての詳細は、『Macromedia ColdFusion MX for J2EE のインストールと使用』マニュアルの「RDS の使用」を参照してください。
  • (Windows のみ) Microsoft Access のような ODBC データソースのサポートをインストールするかどうか。[はい] を選択すると、追加データベースドライバと ODBC に接続するためのサービスのセットがインストールされます。
  • ColdFusion MX Administrator のオンラインヘルプとサンプルアプリケーション (インストールする場合) の言語。
  • サンプルアプリケーションをインストールするかどうか。セキュリティ上の理由で、サンプルアプリケーションを本番サーバー上にインストールしないようにしてください。

Administrator へのログインの成功は、インストール操作に成功したことを意味します。しかし、ColdFusion MX が完全に機能する前に、以下の LiveDocs セクションの説明に従い、さらに、サイト特有の作業を行わなければならない場合があります。

  • ColdFusion MX 用 Verity 検索パックのインストール
  • CORBA サポートの有効化
  • サードパーティ JDBC データベースドライバの使用
18.

ColdFusion MX CFM ページのコードを調べ、テストします。これらのページを cfusion Web アプリケーションルートに保存します。『Macromedia ColdFusion MX for J2EE のインストールと使用』マニュアルの「J2EE アプリケーションサーバーと ColdFusion MX アプリケーションの使用」の章の説明に従ってください。通常は、以下のように、http://hostname[:portnumber]/cfusion/filename.cfm の URL を使用してこれらのページにアクセスします。

  • hostname - マシン名、IP アドレス、localhost または 127.0.0.1。
  • portnumber - Sun ONE Web Server のポート番号で、通常は 80 か 81。
  • filename - 表示するディレクトリパスとファイル。パスは cfusion ディレクトリへの相対パスです。

たとえば、C:\iPlanet\Servers\bin\https\webapps\cfusion\eisapp\index.cfm にある CFM ファイルを表示する場合は、URL を http://127.0.0.1:81/cfusion/eisapp/index.cfm のように指定します。

他の問題

このセクションでは、Sun ONE Web Server 6 上で ColdFusion MX for J2EE を実行する際の関連問題をリストします。ColdFusion MX for J2EE の既に知られている問題の完全リストは、http://www.macromedia.com/go/cfmxj2ee-known_issues_jp にあります。

  • RDS の無効化 - セキュリティ上の理由で、本番サーバー上では RDS を無効にするようにしてください。RDS を無効にする場合は、以下の手順を実行します。
    • ColdFusion MX Web モジュール RDS サーブレットを、『Macromedia ColdFusion MX for J2EE のインストールと使用』マニュアルの「RDS の使用」の説明に従い、無効にします。
    • RDS Web アプリケーションをアンデプロイします。

    メモ: RDS が無効な場合は、ColdFusion MX Administrator の [サーバーのブラウズ] ボタンは機能しません (たとえば、「ColdFusion マッピング」ページなど)。

  • ColdFusion MX for J2EE のアンデプロイ - 以下の手順を実行してください。
    1. Sun ONE Web Server を停止します。
    2. (Windows のみ) ODBC サポートをインストールした場合は、ODBC Windows サービスを削除します。cf_root\WEB_INF\cfusion\db\SequeLink セットアップディレクトリへ移動し、RemoveSequeLink.bat ファイルを実行してください。
    3. Sun ONE Web Server を起動します。
    4. Sun ONE Web Server Administrator を使用して、cfusion と RDS Web アプリケーションをアンデプロイします。
    5. Sun ONE Web Server を停止します。
    6. COM サポートを有効化した場合は、レジストリエディタを使用して、インストール操作の手順 11 で \\HKEY_LOCAL_MACHINE\SOFTWARE\Netscape\Enterprise\6.0\NSES_JRE_RUNTIME_LIBPATH キーに追加された値を削除します。
    7. Verity サポートを有効化した場合は、レジストリエディタを使用して、インストール操作の手順 12 で \\HKEY_LOCAL_MACHINE\SOFTWARE\Netscape\Enterprise\6.0\NSES_JRE_RUNTIME_LIBPATH キーに追加された値を削除します。
    8. インストール操作の手順 13 でグラフ作成用に JVM オプションを追加した場合は、JVM 設定ファイル (jvm12.conf ) のバックアップコピーを sunone_root/servers/https-computer_name/config ディレクトリ内に復元するか、テキストエディタで JVM 設定ファイルを開き、vm.option 行から ColdFusion 行を削除します。
    9. sunone_root/bin/https/jar ディレクトリから crimson.jar を削除します。
    10. (Windows のみ) インストール操作の手順 15 で C++ CFX サポートを有効化した場合は、起動スクリプトのバックアップコピーを sunone_root/servers/https-computer_name ディレクトリ内に復元するか、テキストエディタで起動スクリプトを開き、LD_LIBRARY_PATH 行から ColdFusion 行を削除します。
    11. Sun ONE Web Server を起動します。
  • XMLSearch - xmlSearch() 関数は、検索文字列の最後にスラッシュ文字 (/) があると、例外を投げます。たとえば、次のような検索を実行すると、例外が発生します。

    xmlSearch (mydoc, '/breakfast_menu/food/')

    これは、Sun ONE Web Server 6 に旧バージョンの xalan.jar が付随するためです。この問題を避けるために、xalan.jar を最新バージョンの xalan.jar と xml-apis.jar に置き換えてください (Apache at http://www.apache.org にあります)。

目次に戻る