サーバーの登録

Server Manager から ColdFusion サーバーインスタンスを管理するには、各サーバーインスタンスを登録します。

注意: Server Manager AIR アプリケーションでサポートされるのは、ColdFusion インスタンスのみです。

ColdFusion サーバーを登録するには :

  1. Server Manager の右ペインにあるプラス記号 (+) をクリックします。

  2. サーバー名、ホストの名前または IP アドレス、ポート番号、(J2EE サーバーの) コンテキストルート、ユーザー名とパスワードなど、サーバーに関する詳細を入力します。

    ホストを設定するには、ホスト名または IP アドレスのいずれかを指定します。特定のサーバーを登録するときは、ホスト名または IP アドレスを使用して Server Manager AIR アプリケーションから 1 回だけ登録することをお勧めします。同じサーバーを複数回登録すると、次のような例外が発生する場合があります。

    [BlazeDS]Unhandled error when processing a message: flex.messaging.LocalizedException: 
    The FlexSession is invalid. 
    message =  There was an unhandled failure on the server. The FlexSession is invalid. 
    Exception: flex.messaging.LocalizedException: The FlexSession is invalid.
  3. 「適用」をクリックします。登録されたサーバーは、Server Manager の [すべてのサーバー] リストに表示されます。サーバーおよび認証に関する詳細が正しい場合は、サーバーのステータスが [ログイン済み] と表示され、正しくない場合は [ログイン失敗] または [到達不能] と表示されます。

  4. 登録済みの ColdFusion サーバーインスタンスの詳細を取得するには、左ペインの [サーバー] ドロップダウンリストの横にあるアイコンを選択します。

    サーバーインスタンスに関する最新情報を取得するには、メインの ColdFusion サーバーからこれらの情報を取得します。

注意: サーバークラスタの場合は、クラスタ内の各インスタンスを Server Manager で登録します。

デフォルトでは、登録済みサーバーは [すべてのサーバー] タブの右ペインにある [クイックビュー] に表示されます。サーバーインスタンスまたはクラスタをグループに関連付けている場合は、グループタブの下にも表示されます。

サーバーインスタンスを登録した後は、ホットフィックスを適用したり、サーバーテンプレートキャッシュをクリアすることができます。これらのタスクは、サーバーインスタンスごとに実行することも、複数のサーバーに対して実行することもできます。これらのタスクを実行する方法については、ホットフィックスの適用および テンプレートキャッシュのクリアを参照してください。

ColdFusion サーバーインスタンスの起動と停止

ColdFusion で一部の設定を再定義する際には、サーバーの再起動が必要になる場合があります。Server Manager を使用すると、ホストにログインせずにサーバーを再起動できます。

ColdFusion インスタンスがデプロイされている次のタイプのサーバーであれば、起動または停止の機能を設定できます。

  • Tomcat(スタンドアローン)

  • WebLogic

  • WebSphere

  • JBoss

アプリケーションサーバーに ColdFusion をデプロイする方法について詳しくは、『ColdFusion インストール』のColdFusion J2EE deployment and configurationを参照してください。

サーバーの起動操作と停止操作を実装する一般的な方法は、次のとおりです。

  1. サーバーを起動または停止するには、使用しているアプリケーションサーバーに固有の WAR ファイルをアプリケーションサーバーにデプロイして、起動操作と停止操作を実行します。

  2. Server Manager から ColdFusion サーバーインスタンスを起動または停止するには、デプロイ済みの WAR インスタンスがアプリケーションサーバー上で実行されている必要があります。

各アプリケーションサーバーに対応する WAR ファイルと、起動操作および停止操作を実行するために必要なパラメーターについて詳しくは、次のセクションを参照してください。

注意: 起動、停止、再起動などのオプションは、[開始 / 停止の詳細] タブで必要な詳細を指定した後に有効になります。

スタンドアローンサーバー(Tomcat)パラメーター

サーバーマネージャーの HTTPS を使用して、リモートインスタンス機能の起動と停止を設定できます。 この機能を有効にするには、ColdFusion のインストール時に、リモートインスタンス管理者をインストールします。

  1. リモートホストで、次のようにします。

    1. リモートホストで、キーストアファイルに秘密鍵を生成します。 プロンプトが表示されたら、詳細を指定します。

      <CF_installation>\jre\bin\keytool -genkeypair -alias certificatekey -keyalg RSA -validity 7 -keystore keystore.jks
    2. 証明書をエクスポートします。 自己署名証明書または認証機関からの証明書が必要です。

      <CF_installation>\jre\bin\keytool -export -alias certificatekey -keystore keystore.jks -rfc -file selfsignedcert.cer
    3. リモートホストで作成された .jks ファイルを jetty¥etc ディレクトリにコピーします。

    4. jetty¥etc¥jetty.xml ファイルを開きます。

    5. To add a HTTPS SSL Listener という文字列を検索して、次のエントリを追加します。

       <Call name="addConnector"> 
          <Arg> 
          <New class="org.mortbay.jetty.security.SslSocketConnector"> 
              <Set name="Port">8443</Set> 
              <Set name="maxIdleTime">30000</Set> 
              <Set name="keystore"><SystemProperty name="jetty.home" default="." />/etc/server.jks</Set> 
              <Set name="password">changeit</Set> 
              <Set name="keyPassword">changeit</Set> 
              <Set name="truststore"><SystemProperty name="jetty.home" default="." />/etc/server.jks</Set> 
              <Set name="trustPassword">changeit</Set> 
          </New> 
          </Arg> 
      </Call>
    6. エントリのキーストア名、パスワード、キーパスワードおよび jks ファイルを更新します。

    7. org.mortbay.jetty.bio.SocketConnector という文字列を検索します。

    8. リモートホストのポート番号でホストを更新します。

    9. jetty サーバーを再起動します。

      注意: Windows Vista、Windows 7 または Windows Server 2008 でリモートサーバーを実行している場合は、管理者権限で jetty サーバーを起動します。
  2. リモートインスタンスを追加するローカルホストで、次のようにします。

    1. リモートホストで作成した .cer ファイルを任意の場所にコピーします。

    2. 証明書をインポートします。

      <CF_installation>\jre\bin\keytool.exe -importcert -keystore "<CF_installation>\jre\lib\security\cacerts" -file selfsignedcert.cer -storepass password
  3. ローカルホストの wwwroot¥CFIDE¥ServerManager¥ServerManager.air を開きます。

  4. 接続の詳細を指定します。

  5. 「開始 / 停止の詳細」をクリックします。

  6. 「HTTPS」を選択します。

  7. 次の情報を指定します。

    • アプリケーションサーバーユーザー名:ColdFusion のインストール中に指定した admin コンポーネントのユーザー名です。 デフォルト値は admin です。

    • アプリケーションサーバーパスワード:admin コンポーネントのパスワードです。

    • ポート:ColdFusion のリモートインスタンスの HTTPS ポートです。

    • サーバー:ColdFusion のリモートインスタンス名です。

    • ColdFusion のバージョン:ColdFusion の場合は 10 です。

    • 管理サーバーポート:デフォルト https ポートは 8443 です。 Jetty サーバーのポートです。

    • コンテキストルート:値は AdminServlet です。

  8. 「適用」をクリックします。

サーバーマネージャーの HTTP を使用したリモート起動および停止機能の設定

サーバーマネージャーのリモートインスタンス機能の起動と停止を設定できます。 この機能を有効にするには、ColdFusion のインストール時に、リモートインスタンス管理者をインストールします。

  1. リモートホストで、次のようにします。

    1. リモートホストで、ColdFusion_installtion¥cfusion¥jetty¥etc¥jetty.xml を開きます。

    2. org.mortbay.jetty.bio.SocketConnector という文字列を検索します。

    3. リモートホストの IP アドレスでホストを更新します。

    4. jetty サーバーを起動します。 ColdFusion_installation¥cfusion¥jetty ディレクトリに移動して、jetty.exe を使用します。 Windows サービスの jetty サービスを使用することもできます。

  2. ローカルホストの wwwroot¥CFIDE¥ServerManager¥ServerManager.air を開きます。

  3. 接続の詳細を指定します。

  4. 「開始 / 停止の詳細」をクリックします。

  5. 「HTTP」を選択します。

  6. 次の情報を指定します。

    • アプリケーションサーバーユーザー名:ColdFusion のインストール中に指定した admin コンポーネントのユーザー名です。 デフォルト値は、admin です。

    • アプリケーションサーバーパスワード:admin コンポーネントのパスワードです。

    • ポート:ColdFusion のリモートインスタンスの HTTP ポートです。

    • サーバー:ColdFusion のリモートインスタンス名です。

    • ColdFusion のバージョン:ColdFusion の場合は 10 です。

    • 管理サーバーポート:デフォルト https ポートは 8985 です。 Jetty サーバーのポートです。

    • コンテキストルート:値は AdminServlet です。

  7. 「適用」をクリックします。

WebLogic サーバー固有のパラメータ

WebLogic サーバー (admin サーバー、または ColdFusion のデプロイ先と同じドメインに属す admin 以外のサーバー) に wlogicappstartup.war ファイルをデプロイします。

Server Manager の [開始 / 停止の詳細] タブには、次の WebLogic 関連パラメータがあります。

  • ユーザー名 (WebLogic Server で ColdFusion アプリケーションがデプロイされているドメインのユーザー名)

  • パスワード (ユーザー名に対応するパスワード)

  • ポート (admin コンソールにアクセスするためのポート番号)

  • コンテキストルート (コンテキストルートが指定されてないときの WAR ファイルの名前)

  • ColdFusion アプリケーション名 (WebLogic Server にデプロイされている ColdFusion アプリケーションの名前)

  • Admin ポート (デプロイ済みの WAR ファイルにアクセスするためのポート番号。通常は管理サーバーポート)

Websphere 固有のパラメータ

ColdFusion インスタンスのデプロイ先と同じプロファイルで WebSphere に wsappstartup.war ファイルをデプロイします。

Server Manager の [開始 / 停止の詳細] タブには、次の WebSphere 関連パラメータがあります。

  • ユーザー名 (WebSphere の Admin ユーザー名)

  • パスワード (WebSphere の Admin パスワード)

  • コンテキストルート (デプロイ済みの WAR ファイルのコンテキストルート)

  • ColdFusion アプリケーション名 (WebSphere にデプロイされている ColdFusion アプリケーションの名前)

  • Admin ポート (デプロイ済みの WAR ファイルにアクセスするためのポート番号。通常は管理サーバーポート)

JBoss 固有のパラメータ

JBoss を使用する場合は、JBoss サーバーに jbossappstartup.war ファイルをデプロイします。

起動操作と停止操作は、HTTP による JNDI のセキュアアクセスが有効になっている場合にのみ機能します。

HTTP による JNDI のセキュアアクセスを設定するには :

  1. "<JBoss のホームディレクトリ>/server/default/deploy/http-invoker.sar/invoker.war/WEB-INF/web.xml" で、サーブレットマッピングのコメントを解除します。

    <servlet-mapping> 
            <servlet-name>JNDIFactory</servlet-name> 
            <url-pattern>/restricted/JNDIFactory/*</url-pattern> 
        </servlet-mapping>
  2. "<JBoss のホームディレクトリ>/server/default/deploy/http-invoker.sar/invoker.war/WEB-INF/jboss-web.xml" で、次の行のコメントを解除します。

    <security-domain>java:/jaas/jmx-console</security-domain>
  3. "<JBoss のホームディレクトリ>/server/default/conf/login-config.xml" に、次のポリシーを追加します (存在しない場合)。

    <application-policy name = "jmx-console"> 
           <authentication> 
              <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule" 
                 flag = "required"> 
                 <module-option name="usersProperties">props/jmx-console-users.properties</module-option> 
                 <module-option name="rolesProperties">props/jmx-console-roles.properties</module-option> 
              </login-module> 
           </authentication> 
        </application-policy>

"props/jmx-console-users.properties" ファイルおよび "props/jmx-console-roles.properties" ファイルには、次の形式のエントリが登録されている必要があります。

/jmx-console-users.properties:

形式 : {ユーザー名} = {パスワード}

/jmx-console-roles.properties

形式 : {ユーザー名} = {ロールのカンマ区切りリスト}

HTTP による JNDI のセキュアアクセスを有効にする方法の詳細については、Securing Access to JNDI over HTTP を参照してください。

Server Manager の [開始 / 停止の詳細] タブには、次の JBoss 関連パラメータがあります。

  • ユーザー名 (jmx-console-users.properties で指定されているユーザー名)

  • パスワード (対応するユーザー名のパスワード)

  • ポート (admin コンソールにアクセスするためのポート番号)

  • コンテキストルート (デプロイ済みの WAR ファイルの名前)

  • Admin ポート (デプロイ済みの WAR ファイルにアクセスするためのポート番号。通常は admin サーバーポート)

2 つのサーバー設定の相違の表示

Server Manager で利用可能な [相違] オプションを使用すると、2 つのサーバーインスタンスまたはクラスタの設定の相違を確認できます。このオプションを使用すると、2 つのサーバーインスタンスの設定の相違を確認できます。[相違] は、[ログイン済み] 状態にある 2 つのサーバーに対して実行できます。

[相違] を実行するには :

  1. [相違] を実行するサーバーの 1 つを右クリックします。

  2. [相違] をクリックし、選択したサーバーインスタンスと比較するもう 1 つのサーバーを選択します。

  3. [<サーバー A> と <サーバー B> の設定の相違] ダイアログボックスで、比較する設定を選択します。

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

  5. プラス記号 (+) をクリックして、設定を展開します。2 つのサーバーインスタンス間で相違がある設定が強調表示されます。