UNIX®/Linux/macOS 向けの Apache
UNIX®/Linux/macOS 向けの Apache
Apache HTTP Web サーバは Apache グループによって提供されており、http://www.apache.orgOpens in a new tab から無料でダウンロードできます。多くのシステムは、Apache を事前にインストールおよび構成して、すぐに使用できる状態で出荷されます。サポート対象 UNIX® または Linux システムに Apache をインストールする方法については、次の Developer Community の記事を参照してください : https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=GCGI_webserver#GCGI_ux_apacheOpens in a new tab。
macOS では、InterSystems IRIS インストーラは事前インストールされているバージョンの Apache を自動的に構成することはできません。ただし、Homebrew (https://brew.sh/Opens in a new tab) を使用してインストールされた Apache のバージョンを自動的に構成することはできます。
このページでは、インターシステムズが Apache のネイティブ API を使用して実装する動的モジュール csp_module_sa を使用して、Apache で Web ゲートウェイを導入する方法を説明します。
csp_module_sa モジュールは、2 つの動的共有オブジェクト (.so) ファイルを使用して Web ゲートウェイを実装します。
-
CSPa24.so — ランタイム・バイナリ。
-
CSPa24Sys.so — Web ゲートウェイ管理バイナリ。
これが Apache の推奨導入オプションで、ほとんどのユース・ケースで有効です。
セキュリティが制限されたバージョン の Apache (SELinux を搭載した RHEL など) を使用するシステムで Web ゲートウェイを構成する場合は、"ロック・ダウン Apache インストールへの Web ゲートウェイの追加" で補足手順を参照してください。"Apache の代替オプション" では、Network Service Daemon (NSD) を使用するオプションを含め、Apache で Web ゲートウェイを導入するその他のオプションについて説明しています。
"Apache に関する考慮事項" では、Web ゲートウェイに接続されている Apache Web サーバの管理に関するガイダンスを提供しています。詳細なガイダンスは、Apache のドキュメント (https://httpd.apache.org/docs/Opens in a new tab) を参照してください。
Apache が共有オブジェクト・モジュールを管理できることの確認
Apache 独自の API を使用して Apache 構成に Web ゲートウェイを追加する前に、Apache のビルドに共有オブジェクトを管理するための組み込みのモジュール (mod_so) が含まれていることを確認します。
Red Hat Linux でこのチェックを実行するには、コマンド行から以下のコマンドを発行します (オペレーティング・システムに対応するコマンドを選択します)。
httpd -l
apache2 -l
このコマンドは、現在の Apache インストールに含まれているモジュールのリストを示します。mod_so がこのリストに含まれていない場合は、Apache のドキュメント (https://httpd.apache.org/docs/2.4/Opens in a new tab) で提供されている手順に従って、このモジュールを含む Apache の新しいビルドをコンパイルします。
Web サーバ構成への Web ゲートウェイ・モジュールの追加
-
Web ゲートウェイ・モジュール・ファイルのファイル・システムの場所を記録しておきます。これらの手順では、最も一般的な場所である /opt/webgateway/bin を使用します。
-
Apache Web サーバ構成ファイル (httpd.conf) をテキスト・エディタで開きます。このファイルは、Apache のインストール・ディレクトリの /conf サブディレクトリ内にあります。最も一般的なインストール場所は次のとおりです。
/etc/httpd/conf
/usr/apache2/conf
-
Web ゲートウェイ・モジュールを追加するファイルの最後に指示文を追加します。これらの指示文では、以下を行います。
-
LoadModule 指示文を使用して、モジュールの名前と Web ゲートウェイのランタイム機能用の .so ファイルの場所を指定し、モジュールをロードします。
-
CSPModulePath 指示文を発行し、Web ゲートウェイのランタイム機能用の .so ファイルを含むディレクトリのフル・パスを指定します。
-
CSPConfigPath 指示文を発行し、Web ゲートウェイの管理機能用の .so ファイルを含むディレクトリのフル・パスを指定します。
-
Web ゲートウェイ・バイナリを含むディレクトリのアクセス設定を構成します。そのためには、以下のようにそのディレクトリに <Directory> 指示文ブロックを追加します (この例では、最も一般的なインストール場所を想定しています)。
<Directory "/opt/webgateway/bin"> 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 アプリケーションへの要求を処理する指示文を発行します。このために、以下の指示文が用意されています。
-
CSPFileTypes。指定した一連のファイル・タイプの要求に対して Web ゲートウェイを呼び出します。(REST API エンドポイントは通常、ファイルではなくパスであるため、REST アプリケーションの要求を呼び出すには、この指示文では不十分です。)
-
CSP On と CSP Off。Web ゲートウェイをすべての要求のハンドラとして有効または無効にします。
<Location> ブロック内でこれらの指示文を発行することで、Web サーバを細かく構成し、InterSystems IRIS Web アプリケーションに対応する相対 URL パスに対してのみ Web ゲートウェイを呼び出すことができます。
以下の場所ブロックは、iris3 という InterSystems IRIS インスタンスの管理ポータル宛ての要求に対してのみ Web ゲートウェイを呼び出します。
<Location "/iris3/csp/sys/"> CSP On </Location>
Note:InterSystems IRIS インスタンスにアクセスせずに、Web ゲートウェイの管理ページにアクセスするには、/csp パスに対して Web ゲートウェイを有効にします。
-
-
httpd.conf ファイルを保存します。
-
Apache を再起動して、構成の変更を有効にします。
インストーラは、Apache Web サーバを自動構成する際にこの手順を使用します。例については、"自動構成例" を参照してください。