コマンドラインインターフェイスの使用

Web サーバー設定ツールはコマンドラインインターフェイスを使用して実行することもできます。

コマンドラインインターフェイスの実行

  1. コンソールウィンドウを開きます。

  2. cf_root/runtime/bin（サーバー設定）ディレクトリに移動します。

  3. 次のようにして、wsconfig.exe (Windows) コマンドまたは wsconfig (UNIX) コマンドを実行します。

          wsconfig.exe [-options] 
      ./wsconfig [-options]

次の表にオプションを示します。

オプション

説明

-ws

次のように、Web サーバーを指定します。

  • IIS

  • Apache

  • SunOne

Web サーバー名の指定では、大文字と小文字は区別されません。

-dir

構成ディレクトリ（SunONE config）へのパスを指定します。

-site

IIS の Web サイト名を指定します (大文字と小文字は区別されます)。All または 0 を指定して、グローバルレベルのコネクタを設定します。この設定はすべての IIS Web サイトに適用されます。

-host

ColdFusion サーバーアドレスを指定します。デフォルト値は localhost です。

-norestart

Web サーバーを再起動しないよう指定します。

-cluster

Tomcat クラスタ名を指定します。 このオプションを使用して、単一サーバーではなく Tomcat クラスタへの接続を定義できます。

-l

コネクタの verbose ロギングを有効化します。

-upgrade

既存の設定済みコネクタを、新しい "wsconfig.jar" ファイルの新しいモジュールでアップグレードします。

-service

Apache Windows サービス名を指定します。デフォルト値は Apache です。

-bin

Apache サーバーのバイナリファイル (Windows では apache.exe、UNIX では httpd) のパスを指定します。

-script

Apache UNIX コントロールスクリプトファイル (apachectl) のパスを指定します (Apache 派生製品の Stronghold などではファイルが若干異なる場合があります)。

-v

Web サーバー設定ツールからの verbose 出力を有効にします。

-list

設定されたすべての Web サーバーをリストします。

-list -host server-host

指定されたホストのすべての Tomcat サーバーをリストします。

-remove

設定を削除します。–ws オプションと、–dir または –site オプションが必要です。

-uninstall

設定済みコネクタをすべて削除します。

-h

すべてのパラメータをリストします。

バッチファイルとシェルスクリプトの使用

ColdFusion サーバー設定には、コマンドラインでの一般的なコネクタ設定を実装するバッチファイルとシェルスクリプトが含まれています。それらのファイルは、"<ColdFusion のルートディレクトリ>/bin/connectors" ディレクトリにあります。たとえば、"IIS_connector.bat" ファイルでは、IIS のすべてのサイトを 0 に設定することでグローバルに定義されたコネクタを確立し、そのフィルタとマッピングがすべてのサイトに継承されるようにします。

Apache または Sun ONE Web Server を使用する場合は、これらのファイルをプロトタイプとして使用し、サイトに応じて編集して保存します。

コマンドラインインターフェイスの例

複数の Web サーバーを使用する場合の例

  1. 特定の IIS サイトを設定します。

    cf_root/runtime/bin/wsconfig.exe -ws iis -site "web31" -v

    すべてのサイトで ColdFusion を実行するシステムでは、通常は個々のサイトを設定する必要はありません。

  2. すべての既存 IIS サイト (ISP) を設定します。

    cf_root/runtime/bin/wsconfig.exe -ws iis -site 0 -v

  3. 1 台目の UNIX 上の Apache を設定します。

    cf_root/runtime/bin/wsconfig -ws Apache -bin /opt/apache2/bin/httpd -script /opt/apache2/bin/apachectl -dir /opt/apache2/conf -v

  4. 2 台目の UNIX 上の Apache を設定します。

    cf_root/runtime/bin/wsconfig -ws Apache-bin /usr/bin/httpd -script /usr/bin/httpd -dir /etc/httpd/conf -coldfusion -v

  5. Windows 上の Apache を設定します。

    cf_root/runtime/bin/wsconfig.exe -ws apache -dir "c:\program files\apache group\apache2\conf" -coldfusion -v

  6. UNIX 上の Sun ONE Web Server を設定します。

    cf_root/runtime/bin/wsconfig -ws sunone -dir [path to config] -coldfusion -v