ColdFusion Builder でのサーバーの管理

ColdFusion Builder の包括的なサーバー管理機能を使用すると、1 つのサーバービューから、ColdFusion サーバーの起動や停止、再起動を実行したり、ColdFusion Administrator やサーバーモニターにアクセスしたりできます。サーバービューの使用方法について詳しくは、「サーバービューの使用」を参照してください。

プロジェクト内のファイルをデバッグしたりプレビューしたりするには、サーバーを追加してプロジェクトに関連付けます。また、ColdFusion Builder に付属する拡張機能をインストールして実行する場合も、サーバーをプロジェクトに関連付けます。サーバーの追加方法について詳しくは、「ColdFusion サーバーの追加」を参照してください。

サーバーをセットアップして管理する前に、以下のトピックに目を通して、マニュアルで使用されている Web サーバーの用語と概念について理解しておいてください。

Web サーバーの詳細と、Web サーバーを ColdFusion で使用できるように設定する方法について詳しくは、『ColdFusion の設定と管理』の Web サーバーの管理を参照してください。

ドキュメントルート

ドキュメントルートという用語は、Web サーバーから Web ページを提供するときに使用されるファイルシステムディレクトリを指します。この用語はサーバーの種類によって異なる場合がありますが、大部分の Web サーバーには同じ概念が当てはまります。

URL 接頭辞

URL 接頭辞は、ローカルファイルシステムのリソースを URL にマップします。

ColdFusion Builder では、Web ルートまたはドキュメントルートの外にあるプロジェクトをプレビューまたはデバッグする場合に、URL 接頭辞を使用します。

URL 接頭辞は、サーバーの作成時に指定することも、既存サーバーの設定を編集して指定することもできます。詳細については、「URL 接頭辞」を参照してください。

既存のプロジェクトまたはフォルダーに対する URL 接頭辞を指定することもできます。詳細については、「URL 接頭辞の設定」を参照してください。

使用例

「Project1」という名前のプロジェクトがあります。Project1 は、server1 に対して設定されています。server1 のドキュメントルートは C:¥server1¥MyDocs にあり、URL は  http://www.example1.com です。Project1 の中には「 xyz 」という名前のリンクフォルダーがあります。フォルダー xyz は server2 のドキュメントルート C:¥server2¥MyDocs にリンクされており、このフォルダーにアクセスするための URL は http://www.example2.com です。リンクフォルダー xyz 内のすべてのファイルを ColdFusion Builder でプレビューしたいとしましょう。このシナリオでは、リンクフォルダー xyz 内のファイルをプレビューするには、URL 接頭辞を作成します。URL 接頭辞を作成するには、次の情報を指定します。

• 絶対パス：C:¥server2¥MyDocs¥
• フォルダー xyz にアクセスするための URL：http://www.example2.com

仮想ホスト

仮想ホストという用語は、単一の Web サーバー上で複数の Web サイト（ドメイン名）をホストする方法を指します。複数の Web サイトは、識別可能なホスト名によって区別されます。例えば、単一の IP アドレスで www.example1.com、www.example2.com、および www.example3.com という Web サイトを運用できます。

ColdFusion Builder の場合は、単一の ColdFusion サーバーを使用して、IIS や Apache などの外部 Web サーバー上の仮想ホストとして設定された複数の Web サイトを運用できます。

Web サーバーで仮想ホストを設定する方法については、各 Web サーバーのマニュアルを参照してください。

プロジェクトを仮想ホストに関連付けると、ColdFusion Builder の機能（プレビュー、デバッグ、コンテンツアシスト、拡張機能の作成など）が、プロジェクト内のすべてのフォルダーとサブフォルダーに適用されます。

仮想ディレクトリ

仮想ディレクトリという用語は、ドキュメントルートに物理的には含まれていないものの、サーバー URL を通じてアクセス可能なフォルダーを指します。仮想ディレクトリを作成するには、フォルダーのパスのエイリアスを URL で指定します。エイリアス名は、フォルダー内のリソースにアクセスするために使用されます。

Web サイト（www.example.com）のドキュメントルートが c:¥xyz¥docs であり、Web サイトにコンテンツを提供するフォルダーが d:¥abc¥content にあるとします。その場合は、このフォルダーのエイリアスを content という名前で定義します。これにより、/http://www.example.com/content/ という URL を使用して、Web サイトにアクセスできるようになります。

ColdFusion サーバーの追加

ColdFusion Builder ワークスペース内に作成したプロジェクトやアプリケーションをテストするには、ColdFusion サーバーを追加します。この ColdFusion サーバーは、本稼動サーバーにデプロイする前にアプリケーションをテストして実行するための開発サーバーとして使用できます。ローカルとリモート両方の ColdFusion サーバーを追加できます。

ローカルサーバーの追加

サーバービューで、次のいずれかの操作を行います。

• 右クリックして「サーバーの追加」を選択します。
• をクリックします。

新規 ColdFusion サーバーセットアップウィザードで次の情報を入力します。

一般設定

• サーバー名：ColdFusion サーバーの名前。
• 説明：（オプション）サーバーの説明。

• アプリケーションサーバー：ドロップダウンリストを選択して「JRun」を選択するか、「その他」を選択して JRun 以外 の サーバーを設定します。

• ホスト名：ColdFusion サーバーホストの名前。例えば、localhost や 127.0.0.1 のように入力します。
• 「ローカル」を選択します。

その他の設定

• Webserver ポート：設定する ColdFusion サーバーインスタンスのポート番号を指定します。ColdFusion サーバーのデフォルトポート番号は 8500 です。
• コンテキストルート：（JRun サーバーを使用する JEE 設定のみに適用）コンテキストルートを入力します。JEE 環境では、1 つのサーバーインスタンス上で、独立した複数の Web アプリケーションを実行できます。したがって、サーバーで動作している JEE Web アプリケーション には  それぞれ、コンテキストルート（コンテキストパス）と呼ばれる固有のベース URL があります。
• アプリケーションサーバー名：（JRun サーバーを使用する EE 設定のみに適用）ColdFusion をデプロイする JRun サーバーの名前。
• RDS ユーザー名：（オプション）RDS を使用している場合は、RDS ユーザー名を指定します。

• RDS パスワード：（オプション）RDS パスワードを指定します。

• ColdFusion Builder で SSL のサポートを有効にするには、「SSL の有効化」を選択します。Server Manager に登録されているサーバーとの通信には SSL を使用できます。
• ColdFusion Builder を起動または終了するたびに ColdFusion サーバーが自動的に起動または停止されるようにするには、「自動起動」および「自動停止」を選択します。

「次へ」をクリックします。

ローカルサーバーの設定

「ローカルサーバーの設定」タブを選択し、必要に応じて次のローカルサーバー設定を指定します。

• サーバーホーム：（Windows で動作するサーバー設定デプロイメントのみに適用）ColdFusion サーバーのホームディレクトリを参照して選択します。例：C:¥ColdFusion11¥cfusion
• ドキュメントルート：Web ルートの場所を参照して選択します。ColdFusion を IIS などの Web サーバーとともに設定する場合は、Web サーバーのドキュメントルート（c:¥inetpub¥wwwroot など）を選択します。この設定は、ColdFusion Builder でプレビュー、デバッグ、CFC 名の解決を行うために必要です。
• バージョン：（Windows で動作するサーバー設定デプロイメントのみに適用）バージョンドロップダウンリストから ColdFusion サーバーのバージョンを選択します。
• Windows サービス：（Windows で動作するサーバー設定デプロイメントのみに適用）「Windows サービス」オプションは、サーバー設定デプロイメントの場合にのみ使用でき、ColdFusion の JEE 設定デプロイメントでは使用できません。Windows Serviceを使用して ColdFusion サーバーの起動と停止を行う場合は、「Windows のサービスを使用してサーバーを起動または停止する」を選択します。

URL 接頭辞

（オプション）

「URL 接頭辞」タブを選択して、次の情報を入力します。

仮想ホストの設定

（オプション）

仮想ホストを設定するには、「仮想ホストの設定」タブを選択して、次のようにします。

仮想ホストの設定を変更するには、仮想ホストテーブルから仮想ホストを選択し、設定を変更して、「更新」をクリックします。

仮想ホストの詳細と、ColdFusion Builder での妥当性については、「仮想ホスト」を参照してください。

拡張機能のインストール

ColdFusion Builder に付属する拡張機能をインストールするには、「拡張機能のインストール」を選択します。

「終了」をクリックすると、ローカルの ColdFusion サーバーインスタンスが作成されます。これらの拡張機能の使用については、拡張機能の使用を参照してください。

バンドルされた ColdFusion サーバーの追加

バンドルされた ColdFusion サーバー

リモートサーバーの追加

ColdFusion Builder にリモートサーバーを追加する前に、ColdFusion Builder の機能を使用して、リモートインスタンスを開始 / 停止する予定の場合は、次の作業を行います。

リモート ColdFusion サーバーでの Admin サーバーインスタンスの実行

リモートサーバーのバージョンと設定に応じて、次の作業を行います。

サーバーのリモートサーバー（バージョン 7.0.2、8.0.1）

1. ファイル AdminServerComponents.zip {CFHome} に解凍します。
   次のファイルが {cfhome}/runtime/bin にコピーされます。

• adminstart.bat
• admin_jvm.config
• adminstart.sh
  Admin Server インスタンスが {cfhome}/runtime/servers にコピーされます。

1. {cfhome}/runtime/bin に移動し、adminstart.bat（Windows の場合）または adminstart.sh（Mac OS の場合）を実行します。

マルチサーバーまたは JEE のリモートサーバー（バージョン 7.0.2、8.0.1）

1. AdminServerComponents.zip ファイルから、次のファイルを JRun_Home/bin に解凍します。

• admin_jvm.config
• adminstart.bat（Windows の場合）または adminstart.sh（Mac OS の場合）

1. JRun_Home/bin に移動し、adminstart.bat（Windows の場合）または adminstart.sh（Mac OS の場合）を実行します。

サーバー、マルチサーバー、JEE のリモートサーバー（バージョン 9 以上）

ColdFusion 9（バージョン 9 以上）では、 Admin サーバーコンポーネントがデフォルトで付属していて、 Admin サーバーコンポーネントがインストール中に選択された場合は、それが実装されます。

• サーバーの場合は、{cfhome}/runtime/bin に移動して、adminstart スクリプトファイルを実行します。
• ColdFusion 9 以前のマルチサーバー設定の場合は、JRun_Home/bin に移動して、 adminstart スクリプトファイルを実行します。

リモート ColdFusion サーバーのセキュリティプロパティの更新

ColdFusion Builder でのリモートサーバー設定の指定

サーバービューで、次のいずれかの操作を行います。

• 右クリックして「サーバーの追加」を選択します。
• をクリックします。

新規 ColdFusion サーバーセットアップウィザードで次の情報を入力します。

一般設定

• サーバー名：ColdFusion サーバーの名前。
• 説明：（オプション）サーバーの説明。

• アプリケーションサーバー：ドロップダウンリストを選択して CF+Tomcat バンドル（CF 11 サーバーの場合）を選択するか、「その他」を選択して別の JEE のサーバーを設定します。

• ホスト名：リモートサーバーホストの名前。

• 「リモート」を選択します。

その他の設定

• Webserver ポート：設定する ColdFusion サーバーインスタンスのポート番号を指定します。ColdFusion サーバーのデフォルトポート番号は 8500 です。
• コンテキストルート：（JRun サーバーを使用する JEE 設定のみに適用）コンテキストルートを入力します。JEE 環境では、1 つのサーバーインスタンス上で、独立した複数の Web アプリケーションを実行できます。したがって、サーバーで動作している JEE Web アプリケーション には  それぞれ、コンテキストルート（コンテキストパス）と呼ばれる固有のベース URL があります。
• アプリケーションサーバー名：（JRun サーバーを使用する EE 設定のみに適用）ColdFusion をデプロイする JRun サーバーの名前。
• RDS ユーザー名：（オプション）RDS を使用している場合は、RDS ユーザー名を指定します。

• RDS パスワード：（オプション）RDS パスワードを指定します。

• ColdFusion Builder で SSL のサポートを有効にするには、「SSL の有効化」を選択します。Server Manager に登録されているサーバーとの通信には SSL を使用できます。

• ColdFusion Builder を起動するたびに ColdFusion サーバーを自動的に起動させるには、「自動起動」を選択します。

「次へ」をクリックします。

リモートサーバーの設定

仮想ホストの設定を変更するには、仮想ホストテーブルから仮想ホストを選択し、設定を変更して、「更新」をクリックします。仮想ホストの詳細と、ColdFusion Builder での妥当性については、 仮想  ホストを参照してください。

「次へ」をクリックします。

拡張機能のインストール

ColdFusion Builder に付属する拡張機能をインストールするには、「拡張機能のインストール」を選択します。

「終了」をクリックすると、リモート ColdFusion サーバーインスタンスが追加されます。これらの拡張機能の使用方法については、「拡張機能の使用」を参照してください。リモートサーバーへの接続に成功すると、ColdFusion Builder に表示されるサーバーステータスが実行中に変わります。リモートサーバーへの接続に成功しなかった場合は、サーバーステータスが不明に変わります。エラーについて詳しくは、「コンソールビュー」を参照してください。

サーバービューの使用

サーバービューは、ColdFusion Builder からサーバーの起動、停止、再起動を行う場合に使用します。また、サーバービューからは、ColdFusion サーバーモニターと ColdFusion Server Administrator も起動できます。

サーバービューがワークベンチに表示されていない場合は、ウィンドウ／ビューの表示／その他を選択して、サーバービューを追加します。ビューの表示ダイアログボックスで、ColdFusion／サーバービューを選択します。

サーバーの起動、停止、再起動、削除

ColdFusion Server Administrator の起動

リモートシステムへの接続

ftp、ssh、sftp などのリモートシステムに接続できます。

リモートシステムに接続する手順は次のとおりです。

RDS サーバー設定のインポート

RDS サーバーが既に設定されている場合は、RDS サーバーの設定を直接インポートして、RDS サーバーをサーバービューに追加できます。

これで、サーバーをプロジェクトに関連付けて、プロジェクトのデバッグ、プレビュー、テストをおこなえるようになります。