Windows 用 Apache
Windows 用 Apache
Apache HTTP Web サーバ (httpd) は、Apache Software Foundation によって開発および保守されています。Apache Software Foundation は Windows 互換の Apache httpd バイナリを配布していません。自身で httpd をコンパイルするか (https://httpd.apache.org/docs/current/platform/win_compiling.htmlOpens in a new tab を参照)、信頼できるサードパーティ・ソースから httpd バイナリ・パッケージを取得できます (https://httpd.apache.org/docs/current/platform/windows.htmlOpens in a new tab を参照)。詳細なガイダンスは、Apache のドキュメント (https://httpd.apache.org/docs/Opens in a new tab) を参照してください。
このセクションでは、インターシステムズが Apache のネイティブ API を使用して実装する動的モジュール csp_module_sa を使用して、Windows システム上の Apache httpd 内に Web ゲートウェイを導入する方法を説明します。これが Apache の推奨導入オプションで、ほとんどのユース・ケースで有効です。
"Apache の代替オプション" では、Network Service Daemon (NSD) を使用するオプションを含め、Apache で Web ゲートウェイを導入するその他のオプションについて説明しています。
csp_module_sa モジュールの .dll ファイルの取得
Windows では、csp_module_sa モジュールは、2 つのダイナミック・リンク・ライブラリ (.dll) ファイルを使用して Web ゲートウェイを実装します。
-
CSPa24.dll — ランタイム・バイナリ。
-
CSPa24Sys.dll — Web ゲートウェイ管理バイナリ。
Windows システムでは、InterSystems IRIS のインストールにこれらのファイルは含まれません。これらのファイルを取得するには、Web Gateway modules for Apache HTTPD servers インストール・コンポーネントを含むスタンドアロン Web ゲートウェイをダウンロードしてインストールします。
Apache が共有オブジェクト・モジュールを管理できることの確認
Apache 独自の API を使用して Apache 構成に Web ゲートウェイを追加する前に、Apache のビルドに共有オブジェクトを管理するための組み込みのモジュール (mod_so) が含まれていることを確認します。
Windows でこれを確認するには、コマンド行から Apache インストールの \bin\ サブディレクトリに移動し、以下のコマンドを実行します。
httpd.exe -l
このコマンドは、現在の Apache インストールに含まれているモジュールのリストを示します。mod_so がこのリストに含まれていない場合は、Apache のドキュメント (https://httpd.apache.org/docs/2.4/Opens in a new tab) で提供されている手順に従って、このモジュールを含む Apache の新しいビルドをコンパイルします。
Web サーバ構成への Web ゲートウェイ・モジュールの追加
-
Web ゲートウェイ・モジュール・ファイルのファイル・システムの場所を記録しておきます。これらの手順では、例の場所 C:\InterSystems\WebGateway\ を使用しています。この場所を、必ずファイル・システム内の Web ゲートウェイ・モジュール・ファイルの場所に置き換えてください。
-
Apache httpd Web サーバ構成ファイル (httpd.conf) をテキスト・エディタで開きます。このファイルは、Apache のインストール・ディレクトリの /conf サブディレクトリ内にあります。Windows では、httpd の既定のインストール・ディレクトリは通常 C:\Apache24\ です。
-
Web ゲートウェイ・モジュールを追加するファイルの最後に指示文を追加します。これらの指示文では、以下を行います。
-
LoadModule 指示文を使用して、モジュールの名前 (csp_module_sa) と Web ゲートウェイのランタイム機能用の .dll ファイルの場所を指定し、モジュールをロードします。以下に例を示します。
LoadModule csp_module_sa "C:/InterSystems/WebGateway/CSPa24.dll"
-
CSPModulePath 指示文を発行し、Web ゲートウェイのランタイム機能用の .dll ファイルを含むディレクトリのフル・パスを指定します。以下に例を示します。
CSPModulePath "C:/InterSystems/WebGateway/"
-
CSPConfigPath 指示文を発行し、Web ゲートウェイの管理機能用の .dll ファイルを含むディレクトリのフル・パスを指定します。以下に例を示します。
CSPConfigPath "C:/InterSystems/WebGateway/"
-
Web ゲートウェイ・バイナリを含むディレクトリのアクセス設定を構成します。そのためには、以下のようにそのディレクトリに <Directory> 指示文ブロックを追加します (この例では、最も一般的なインストール場所を想定しています)。
<Directory "C:/InterSystems/WebGateway"> AllowOverride None Options MultiViews FollowSymLinks ExecCGI Require all granted <FilesMatch "\.(log|ini|pid|exe)$"> Require all denied </FilesMatch> </Directory>
-
-
オプション : Web サーバで Web アプリケーションの静的ファイルを処理する場合は、該当する /csp パスを Web サーバからアクセスできるファイル・システムの場所にマップする指示文を追加します。Apache Alias 指示文は、そのための方法の 1 つを提供します。
例えば、アプリケーション /dashboard はリモートの InterSystems IRIS インスタンスによって提供されるが、アプリケーションの静的ファイルは Web サーバ・マシンのディレクトリ C:\iris\csp\dashboard から提供したい場合は、以下の指示文を追加できます。
Alias /dashboard/ "C:/iris/csp/dashboard"
-
Web ゲートウェイを呼び出して、InterSystems IRIS アプリケーションへの要求を処理する指示文を発行します。このために、以下の Apache 構成指示文が用意されています。
-
CSPFileTypes。指定した一連のファイル・タイプの要求に対して Web ゲートウェイを呼び出します。
Note:REST API エンドポイントは通常、ファイルではなくパスであるため、REST アプリケーションの要求をルーティングするには、CSPFileTypes 指示文では不十分です。
-
CSP On と CSP Off。Web ゲートウェイをすべての要求のハンドラとして有効または無効にします。
<Location> ブロック内でこれらの指示文を発行することで、Web サーバを細かく構成し、InterSystems IRIS Web アプリケーションに対応する相対 URL パスに対してのみ Web ゲートウェイを呼び出すことができます。(組み込みの InterSystems IRIS Web アプリケーションに関連付けられているパスに関する詳細情報は、"必要なアプリケーション・パスの指定" を参照してください。)
以下の場所ブロックは、iris3 という InterSystems IRIS インスタンスの管理ポータル宛ての要求に対してのみ Web ゲートウェイを呼び出します。
<Location "/iris3/csp/sys/"> CSP On </Location>
Note:InterSystems IRIS インスタンスにアクセスせずに、Web ゲートウェイの管理ページにアクセスするには、/csp パスに対して Web ゲートウェイを有効にします。インスタンスの /<instancePrefix> または /<instancePrefix>/csp パスへ要求をルーティングします。
-
-
httpd.conf ファイルを保存します。
-
Apache が実行されている場合、Apache を再起動して、構成の変更を有効にします。
Apache の起動
Apache がまだ実行されていない場合、コマンド行から Apache インストールの \bin\ サブディレクトリに移動し、以下のコマンドを実行して起動します。
httpd.exe
次のステップ : Web ゲートウェイのサーバ・アクセス・プロファイルとアプリケーション・アクセス・プロファイルの定義
Apache httpd と InterSystems IRIS サーバ・インスタンス間の Web ゲートウェイ接続の構成を完了するには、以下の手順を完了する必要があります。
-
httpd の Web ゲートウェイの構成内で、インスタンスのサーバ・アクセス・プロファイルを定義します。
-
httpd の Web ゲートウェイの構成内で、目的のアプリケーション・パスの 1 つ以上のアプリケーション・アクセス・プロファイルを定義します。