Web ゲートウェイと連携させるための Apache の構成 (Windows)
ここでは、Windows 上の InterSystems Web ゲートウェイで使用するための、Apache Web サーバの構成方法について説明します。(Windows では、その他の選択肢として、IIS と Nginx がありますが、この場合のオプションはその他のオペレーティング・システムとは異なります。)
InterSystems IRIS® インストーラを使用して Web ゲートウェイをインストールした場合、または CSP で動作するように Apache サーバを構成する場合は、このページの手順に従ってください。
Apache Web サーバを使用している場合は、以下の指示に従って、ネイティブ・モジュールを使用して Apache を構成します。ネイティブ・モジュールは、ダイナミック・リンク・モジュール (DLL) として実装された拡張機能です。これにより、ISAPI (Internet Server Application Programming Interface) の拡張機能を利用できます。ISAPI は、Microsoft Web サーバ用に開発された高パフォーマンスの API です。
Apache は Apache グループによって提供されており、http://www.apache.orgOpens in a new tab から無料でダウンロードできます。
Apache の完全なソース・コードが、サーバの構築に関する明確な解説と共に Apache からダウンロード可能です。Apache を Windows で構築するには、Microsoft C コンパイラ (Visual C++) のバージョン 5.0 以降が必要です。サーバを自身で構築する代わりに、Windows 用のビルド済みキットをダウンロードできます。このビルド済みキットは通常、最新の Apache ソース・コードよりも数回前のビルドとなります。
最初に、"Apache サーバでのインストール場所 (すべての構成)" の指示に従い、次に "推奨オプション : Apache API モジュール (CSPa24.dll)" の指示に従います (一般的ではない構成をインストールしている場合は、"Windows Apache の代替オプション" を参照してください)。
想定
ここでは、以下のように想定しています。
システムのレイアウトが異なる場合は、必要に応じて、構成指示文を修正してください。
Apache サーバでのインストール場所 (すべての構成)
Apache サーバのユーザはすべて、このセクションの指示に従う必要があります。以下の Web ゲートウェイのコンポーネントおよび CSP 静的ファイルをインストールします。
-
CGI およびその他のダイナミック・リンク・モジュール :
すべての Apache バージョンの共通ファイルには、以下のものがあります。
-
CSPcgi.exe (実行時モジュール)
-
nph-CSPcgi.exe (CSPcgi.exe のコピー)
-
CSPcgiSys.exe (システム管理モジュール)
-
nph-CSPcgiSys.exe (CSPcgiSys.exe のコピー)
Apache バージョン 2.4.x の個別のバイナリは、以下のとおりです。
-
mod_csp24.dll (DLL として機能する Apache 組み込み module が用意されている場合はそれを使用)
-
CSPa24.dll (実行時モジュールが用意されている場合はそれを使用)
-
CSPa24Sys.dll (ゲートウェイのシステム管理モジュールが用意されている場合はそれを使用)
これらのバイナリの既定の場所は C:\Program Files\Apache Group\Apache\WebGateway\bin です。
元の場所 (install-dir\csp\bin) は、特定の InterSystems IRIS インスタンスの管理ポータルの提供に必要な Web ゲートウェイ・コンポーネントの保持に使用されます。
NSD ベース以外の接続オプションの場合、構成ファイルとログ・ファイルはこのディレクトリに書き込まれます。
Sys が追加されたモジュールは、Web ゲートウェイ管理ページにアクセスするための特別なモジュールです。実行時モジュール (Sys が追加されていないモジュール) はシステム管理のフォームにアクセスできません。
-
ハイパーイベントのコンポーネント
-
CSPBroker.js
-
CSPxmlhttp.js
これらのファイルの既定の場所は install-dir\csp\broker です。
-
CSP サンプルで使用するその他の静的リソース
CSP サンプルでは、(イメージ・ファイルなど) いくつかの静的な Web リソースが必要になります。これらのファイルの既定の場所は install-dir\csp\samples です。
-
管理ポータルで使用するその他の静的リソース
管理ポータルでは、(イメージ・ファイルなど) いくつかの静的な Web リソースが必要になります。これらのファイルの既定の場所は install-dir\csp\sys です。
推奨オプション : Apache API モジュール (CSPa24.dll)
これは管理ポータルを提供するプライベート Web サーバで使用するオプションです。
この比較的新しい接続オプションは、最適なパフォーマンスをもたらすだけでなく、構成が最も簡単です。Windows で実行する Apache は完全にマルチスレッド化されており、そのモジュールは Apache の起動後メモリに永続します。これら 2 つの重要な特性により、Web ゲートウェイの機能を一連のスタンドアロン・モジュールとして実装することができます。
一般的ではない構成をインストールしている場合は、"Apache の代替オプション (Windows)" を参照してください。
CSPap*.dll (実行時) モジュールと CSPapSys*.dll (Web ゲートウェイのシステム管理) モジュールは、対応する Microsoft ISAPI DLL 同様に機能するように設計されたダイナミック・リンク・モジュールです。Apache 2.4.x では、これらのモジュールの名前は CSPa24.dll および CSPa24Sys.dll のようになります。
インターシステムズのファイル・タイプを認識し、それらを Web ゲートウェイ・モジュールに渡して処理するように Web サーバを構成します。
Web サーバ構成ファイル (httpd.conf) は C:\Program Files\Apache Group\Apache\conf にあります。
-
Apache 2.4.x : 以下のセクションを httpd.conf の最後に追加します。
LoadModule csp_module_sa c:/iris/csp/bin/CSPa24.dll
CSPFileTypes csp cls zen cxw
Alias /csp/ c:/iris/csp/
<Directory "c:/iris/csp">
AllowOverride None
Options MultiViews FollowSymLinks ExecCGI
Require all granted
<FilesMatch "\.(log|ini|pid|exe)$">
Require all denied
</FilesMatch>
</Directory>
-
httpd.conf の変更後に、Apache を再起動します。
-
必要に応じて、"追加ファイル・タイプを渡すための Apache の構成" を参照してください。
これで、Web ゲートウェイ管理ページを使用して、さらに Web ゲートウェイを構成できます。