UNIX®、Linux、および Mac OS X の代替構成

代替 TCP ポートでの NSD の開始

既定では、NSD は TCP ポート 7038 で着信する要求を待ち受けます。以下のようにサービスを開始することでこれをオーバーライドできます。port_no は、指定する TCP ポート番号です。

./CSPnsd [port_no]

または以下のようにします。

./CSPnsd -p=[port_no]

開始時に、NSD は以下のファイルを作成します。

/opt/cspgateway/csp/CSPnsd.ini

このファイルには、通常、以下の行が記述されます。

[SYSTEM]
Ip_Address=127.0.0.1
TCP_Port=7038

ここでは、クライアントは、Web サーバに格納された CSP モジュールまたは Web サーバに動的にリンクされる CSP モジュール、およびサーバから呼び出された CSP CGI モジュール (またはそのどちらかのモジュール) です。したがって、このファイルを削除、または移動することはできません。また、Web サーバ・プロセスがこのファイルを読み取り可能であることも重要です。Web サーバを操作する UNIX® ユーザ名を考慮して、適切な特権を設定してください。NSD クライアントは、以下の場所でこのファイルを検索しようとします。

/cache-install-dir/csp

/opt/cspgateway/csp

/etc

NSD が別のディレクトリで動作している場合、CSPnsd.ini ファイルを上記のいずれかの場所に移動する必要があります。

NSD の複数のインスタンスが実行している状況で、CSPnsd.ini ファイルに NSD ポート番号を格納することは不適切です。Apache サーバの場合、NSD の TCP ポート番号をクライアントに伝えるためのより適切なメカニズムがあります。Apache 構成で以下の環境変数を設定して、ターゲットの NSD インストールのアドレスとポートを指定します。

CSP_NSD_NAME — NSD の IP アドレスです。NSD がリモート・コンピュータで動作している場合のみ、このパラメータを使用します。

CSP_NSD_PORT — NSD の TCP ポート番号です。

これらの環境変数に指定した値は、CSPnsd.ini ファイルの値よりも優先されます。

2 つの Apache 仮想ホスト (123.123.1.1 および 123.123.1.2) の負荷を、2 つの独立した NSD インストール (TCP ポート 7038 および 7039 で待ち受ける) 間で分散するには、Apache 構成 (httpd.conf) に以下の指示文を追加します。

<VirtualHost 123.123.1.1>
ServerName 123.123.1.1
SetEnv CSP_NSD_PORT 7038
</VirtualHost>
<VirtualHost 123.123.1.2>
ServerName 123.123.1.2
SetEnv CSP_NSD_PORT 7039
</VirtualHost>

2 つの CSP アプリケーション (/csp1 および /csp2) の負荷を、2 つの独立した NSD インストール (TCP ポート 7038 および 7039 で待ち受ける) 間で分散するには、Apache 構成 (httpd.conf) に以下の指示文を追加します。

<Location /csp1>
SetEnv CSP_NSD_PORT 7038
</Location>
<Location /csp2>
SetEnv CSP_NSD_PORT 7039
</Location>

Apache 構成の変更後は、Apache を再起動します。

NSD の複数のインスタンスを実行している場合は、各インスタンスを別々のディレクトリにインストールし、それぞれのインスタンスに専用の構成ファイル (CSP.ini) およびログ・ファイル (CSP.log) を管理することをお勧めします。NSD の内部 HTTP サーバを使用すると、各インスタンスの CSP ウェブゲートウェイ管理ページに簡単にアクセスできます。以下はその例です。

http://localhost:7038/csp/bin/Systems/Module.cxw

http://localhost:7039/csp/bin/Systems/Module.cxw

複数の NSD プロセスへの負荷分散

既定では、NSD は 2 プロセス処理モード (親ワーカ 1 つと子ワーカ 1 つ) で動作します。

ただし、1 つの UNIX® プロセスが起動できるスレッドの数には上限があります。同時に発生している CSP アプリケーションの負荷により、要求が使用可能なスレッドの待ち行列を作ってしまった場合は、NSD で使用されるプロセスの数を増やすことを検討してください。

./CSPnsd –c=[no_processes]

ここで、no_processes は開始される子 (またはワーカ) プロセスの数です。

子プロセスの数を 1 に設定することには長所があるということにも注目してください。

./CSPnsd –c=1

このような状況では、NSD により、親プロセス 1 つと子ワーカ・プロセス 1 つの合計 2 プロセスが開始されます。‘–c’ 指示文を使用しているときに、親プロセスが存在すると、ワーカ・プロセスの 1 つで障害が発生している場合に親プロセスがその処理を引き継ぐことができるため、NSD の復元力が向上します。単一のマルチスレッド・アーキテクチャでは、NSD は必ずしも重大な内部エラー状態から回復できるわけではありません。

ワーカ・プロセスの数が 2 つ以上の場合は、ステート認識接続 (保持モード 1) を使用しないでください。

NSD に対する管理者権限の付与

NSD (CSPnsd) コンポーネントの管理者は、このサービスの開始/停止が許可されたユーザ (またはグループ) を一部制御することができます。

既定のシナリオでは、CSPnsd マスタ・プロセス ID (PID) ファイル (CSPnsd) は、サービスを開始したユーザのみがその後サービスを終了できるように作成されます。

例えば、管理者は、現在の UNIX グループに属するすべてのユーザがサービスを管理できるように選択することができます。 これは管理ユーザが属するグループです。

NSD start-up option: [-m=s]
     Define the user(s) permitted to manage this service
          where 's' is:
               'u' for the current user (the default),
               'g' for the current group,
               'o' for others,
               'a' for everyone (m=ugo),

例：

./CSPnsd -m=ug

これにより、現在のユーザ・グループ内の現在のユーザおよびその他すべてのユーザが NSD を管理できます。

NSD を停止するコマンドが発行されると、まず CSPnsd 親プロセスに以前と同様にシャットダウンするようシグナルを送信しようとします。 サービスが別のユーザによって開始されたためにこれが不可能な場合は、CSPnsd.ini ファイルにフラグが書き込まれ、サービスはこのフラグを認識したときに自体を正常に終了します。 このプロセスの完了には、最大 20 秒かかります。

方法 1 ： apxs (APache eXtenSion) ツールを使用した、共有オブジェクトとしての CSP モジュールのビルド

以下のコマンドを実行すると、Apache 拡張ツール apxs を使用して、Apache の /modules ディレクトリに共有ライブラリ mod_csp24.so がビルドおよびインストールされます。モジュールをロードする指示文が、Apache 構成ファイル /conf/httpd.conf に追加されます。

apxs -I -a –c mod_csp.c

Apache バージョン 2.02.x では mod_csp22.so モジュールを使用し、Apache バージョン 2.0.x では mod_csp2.so モジュールを使用します。

また、以下のように mod_csp24.so を直接ビルドすることもできます。

apxs –c –o mod_csp2.so mod_csp.c

共有オブジェクトによって生成されたバイナリをディレクトリ /opt/cspgateway/bin にインストールします。

方法 2 ： 共有オブジェクトとしての CSP モジュールの手動ビルド

CSP モジュールを共有オブジェクトとして手動でビルドするには、以下の手順を実行します。

1. モジュール・ソース・ファイル mod_csp.c を以下のディレクトリにインストールします。/usr/apache/src/modules/extra。

2. /usr/apache/src ディレクトリに戻り、構成ファイルを編集します。このファイルの末尾に近いところから、以下の行を見つけてください。

   # AddModule modules/example/mod_example.o
   

   この行の後に、以下の行を追加してください。

   ShareModule modules/extra/mod_csp24.so
   

3. 以下のコマンドを実行して、構築プロセスを構成します。

   ./Configure
   

   

4. 以下のコマンドを実行して、共有オブジェクトを構築します。

   make
   

   

5. 共有オブジェクト mod_csp.so を /usr/apache/src/modules/extra に作成します。

方法 2 の例 ：

このセクションでは、一般的な UNIX® システムで Apache モジュールのビルドに使用できるコンパイラ・コマンドおよびリンカ・コマンドをまとめています。

• DEC UNIX® 5 (DEC コンパイラ)

  cc -c -DOSF1 -std1 -pthread -DIS_64 -ieee_with_inexact \
   –I/usr/apache/include mod_csp.c -o mod_csp.o
  ld -all -shared -expect_unresolved "*" -taso mod_csp.o \
  -o mod_csp24.so
  

  

• FreeBSD (GNU コンパイラ)

  cc -c -DFREEBSD –I/usr/apache/include -o mod_csp.o mod_csp.c
  ld -G -o mod_csp.so mod_csp24.o
  

  

• HP-UX (HP コンパイラ)

  cc -c -DHPUX11 -DNET_SSL -D_HPUX_SOURCE -Ae +DAportable +z  -DMCC_HTTPD -DSPAPI20 –I/usr/apache/include \
   mod_csp.c -o mod_csp.o
  ld -b mod_csp.o -o mod_csp24.so
  

  

• HP-UX ： 64-bit (HP コンパイラ)

  cc -c -DHPUX11 -DNET_SSL -D_HPUX_SOURCE -Ae +DAportable +z  -DMCC_HTTPD -DSPAPI20 -I/usr/apache/include \
  mod_csp.c -o mod_csp.o
  ld -b mod_csp.o -o mod_csp24.so
  

  

• HP-UX ： Itanium (HP コンパイラ)

  cc -c -c -DHPUX11 -DNET_SSL -D_HPUX_SOURCE -Ae +z -DMCC_HTTPD  -DSPAPI20 –I/usr/apache/include mod_csp.c -o mod_csp.o
  ld -b mod_csp.o -o mod_csp24.so
  

  

• Linux ： (GNU コンパイラ)

• Apache v2.0.x

  cc -c -fpic -DLINUX –I/usr/apache/include -o mod_csp.o mod_csp.c 
  ld -G -lrt -ldl -o mod_csp.so mod_csp.o
  

  

• Apache v24.x

  cc -c -fpic -DLINUX=2 -D_REENTRANT -D_GNU_SOURCE -D_LARGEFILE64_SOURCE –I/usr/apache/include mod_csp.c -o mod_csp24.o
  ld -G mod_csp24.o -lrt -ldl -o mod_csp24.so
  

  

• Mac OS X ： (Mac OS X コンパイラ)

  –I/usr/apache/include mod_csp.c -o mod_csp.o
  gcc -c -fPIC -fno-common -DMACOSX -DDARWIN gcc -bundle -flat_namespace -undefined suppress mod_csp.o -o mod_csp24.so
  

  

• IBM AIX® (IBM コンパイラ)

  xlc_r -c -DAIX -DAIX5 -I/usr/apache/include mod_csp.c -o mod_csp.o
  xlc_r -G -H512 -T512 -bM:SRE mod_csp.o -berok -bexpall -bnoentry -lm -lc -o mod_csp24.so
  

  

• IBM AIX® ： 64-bit (IBM コンパイラ)

  OBJECT_MODE=64
  export OBJECT_MODE
  xlc_r -c -DAIX -DAIX5 -I/usr/apache/include mod_csp.c -o mod_csp.o
  xlc_r -G -H512 -T512 -bM:SRE mod_csp.o -berok -bexpall -bnoentry -lm -lc -o mod_csp24.so
  

  

• Sun OS/Solaris ： Opteron (Sun コンパイラ)

  cc -c -Xa -w -DSOLARIS -KPIC -I/usr/apache/include -o mod_csp.o mod_csp.c 
  ld -G -o mod_csp.24so mod_csp.o
  

  

• Sun OS/Solaris ： Opteron ： 64-bit (Sun コンパイラ)

  cc -c -Xa -w -DSOLARIS -KPIC -xarch=amd64 -DBIT64PLAT -I/usr/apache/include -o mod_csp.o mod_csp.c 
  ld -G -o mod_csp24.so mod_csp.o
  

  

• Sun OS/Solaris ： Intel (Sun コンパイラ)

  cc -c -Xa -w -DSOLARIS -KPIC -I/usr/apache/include -o mod_csp.o mod_csp.c 
  ld -G -o mod_csp24.so mod_csp.o
  

  

• Sun OS/Solaris ： SPARC (Sun コンパイラ)

  cc -c -Xa -w -DSOLARIS -I/usr/apache/include
  -o mod_csp.o mod_csp.c
  old -G -o mod_csp24.so mod_csp.
  

  

• Sun OS/Solaris ： SPARC ： 64-bit (Sun コンパイラ)

  cc -c -Xa -w -DSOLARIS -KPIC -xarch=v9 -DBIT64PLAT -I/usr/apache/include -o mod_csp.o mod_csp.c
  ld -G -o mod_csp.24so mod_csp.o
  

  

mod_csp24.so を /opt/cspgateway/bin にコピーします。

実行時の構成

Apache 構成ファイル httpd.conf を編集します。標準の Apache ディストリビューションでは、このファイルは以下の場所に配置されています。

/usr/apache/conf

Red Hat Linux の場合、httpd.conf の実行時バージョンは以下の場所に配置されています。

/etc/httpd/conf

拡張子 .csp、.cls、または .zen を含む要求されたファイルに対して CSP エンジンを呼び出す場合は、以下のセクションを httpd.conf の最後に追加します。もちろん、Apache バージョン 2.0.x を使用する場合は、以下の構成ブロックで mod_csp2.so を指定してください。Apache バージョン 2.2.x を使用している場合は、mod_csp22.so を指定してください。

以下の構成ブロックは、Apache 環境で利用できる正規表現 (regex) プロセッサに依存しています。このケースに相当しない場合、結果として CSP ファイルは提供されません ("ファイルが見つかりません" というエラーが返されます)。この状況を解決するには、以下の手順に従います。

<LocationMatch "/*\.([Cc][Ss][Pp]|[Cc][Ll][Ss]|[Zz][En][Nn])$">
                SetHandler csp-handler
</LocationMatch>

以下のブロックと置換します。

CSPFiletypes csp-handler csp cls

LoadModule csp_module /opt/cspgateway/bin/mod_csp.so
<LocationMatch "/*\.([Cc][Ss][Pp]|[Cc][Ll][Ss]|[Zz][En][Nn])$">
                SetHandler csp-handler
</LocationMatch>
Alias /csp/ /opt/cspgateway/csp/
<Directory "/opt/cspgateway/csp">
        AllowOverride None
        Options MultiViews FollowSymLinks ExecCGI
        Require all granted
        <FilesMatch "\.(log|ini|pid|exe)$">
                Require all denied
        </FilesMatch>
        <Files CSPnsd>
                Require all denied
        </Files>
</Directory>
ScriptAlias /csp-bin/ "/opt/cspgateway/bin/"
ScriptAliasMatch /csp/bin/Systems/Module.cxw "/opt/cspgateway/bin/nph-CSPcgiSys" 
ScriptAliasMatch /csp/bin/RunTime/Module.cxw "/opt/cspgateway/bin/nph-CSPcgi"
<Directory "/opt/cspgateway/bin/">
        AllowOverride None
        Options None
        Require all granted
</Directory>

httpd.conf の変更後に、Apache を再起動します。

接続プーリングの制御

接続プールのサイズは、http.conf で指定されている以下の Apache 構成パラメータで制御できます。

CSPMaxPooledNSDConnections <no> 

このパラメータが存在しない場合は、既定値の 32 が内部的に使用されます。これは事実上、以下と同じです。

CSPMaxPooledNSDConnections 32 

接続プーリングをオフにするには、以下のようにしてこのパラメータをゼロに設定します。

CSPMaxPooledNSDConnections 0 

何らかの理由により、従来の操作モード (非対称モード) の使用 (これにより、ゲートウェイ側の接続が閉じられ、応答の送信終了が通知される) が必要になった場合は、このパラメータをマイナス 1 に設定します。

CSPMaxPooledNSDConnections -1

Apache API および NSD を使用したゲートウェイの運用および管理

この接続オプションは、CSP ゲートウェイの Network Service Daemon (NSD) に依存します。

1. “Network Service Daemon (NSD) の操作” のセクションの説明に従って、CSP NSD を起動します。

2. Apache の構成 (httpd.conf) を変更した後、その Apache を再起動する必要があります。

   Apache と NSD を起動する順序は重要ではありません。

3. CSP ウェブゲートウェイ管理ページにアクセスするには、ブラウザに以下の URL を入力します。CSP ページは高性能なモジュール (mod_csp24.so) を介して提供されますが、CSP ウェブゲートウェイ管理ページへアクセスするには専用の CGI モジュール (nph-CSPcgiSys) を使用します。

   http://localhost:<port_no>/csp-bin/nph-CSPcgiSys
   

   

承認されないユーザであることを通知するエラー・メッセージが表示された場合は、"セキュリティの考慮事項" を参照してください。

.csp、.cls、および .zen 拡張子を含むファイルが要求されると、CSP エンジンが自動的に呼び出されます。以下はその例です。

http://localhost:<port_no>/csp/samples/menu.csp

CSP へのファイルの種類の追加登録

Apache API モジュールは、以下の予約されたファイル拡張子を常に認識します。

.csp .cls .zen .cxw 

この他のファイルを CSP に送信して処理できます。例えば、CSP ゲートウェイを経由して他の静的ファイルを処理する必要がある場合、またはこの Web サーバを経由して管理ポータルにアクセスする必要がある場合は、ファイルの .jpg、.gif、.png、.css、.js の各種類に対してマッピングを追加します。

以下の方法で、CSP に渡すファイルを Apache が認識するように構成できます。

• CSP の Location 指示文の使用

• ファイル拡張子の使用 — CSPFileTypes 指示文

• MIME タイプの使用

CSP 指示文を使用して、特定の位置にあるすべてのファイルが CSP によって処理されるように要求します。 パス /csp の下にあるすべてのファイルとディレクトリが CSP によって処理されるように要求するには、以下のように指定します。

<Location /csp>
   CSP On 
   SetHandler csp-handler-sa
</Location> 

例えば、以下のファイルはすべて CSP に送信されて処理されます。

/csp/ 
csp/samples/menu.csp 
csp/sys/ 

CSPFileTypes 指示文は、拡張子を持つファイル (/csp/menu.csp など) に対する要求に適用されます。 ファイル拡張子を持たないファイル (/csp/menu など) への要求には適用されません。

このパラメータは、ゲートウェイの Apache モジュールにより処理され、(httpd.conf の) サーバ定義レベルでグローバルに定義されるか、または位置もしくはディレクトリ・ブロックに対する定義内に制限されます。

ファイルの種類で指定： .xxx と . yyy の両方の種類のファイルが CSP によって処理されるように要求するには、以下の指示文のように指定します。

CSPFileTypes xxx yyy 

位置で指定 ： 以下の要求では、.xxx と .yyy の両方の種類のファイルが CSP によって処理されますが、/csp よりも下の位置 (例えば、/csp/samples などのサブ・ディレクトリ) にあるファイルに限られます。

<Location /csp/> 
   CSPFileTypes xxx yyy
</Location>

ワイルドカード文字を使用して、パス /csp の下 (および /csp/samples など) にあるすべてのファイルが CSP によって処理されるように要求するには、以下のように指定します。

<Location /csp/> 
   CSPFileTypes * 
</Location> 

CSP は、前述のファイル拡張子に加えて、以下の MIME タイプのファイルを認識することもできます。

application/x-csp

および

text/csp

例えば、CSP によって処理されるファイルのリストにファイル拡張子 xxx を追加するには以下のように指定します。

LoadModule csp_module_sa /opt/cspgateway/csp/bin/CSPa22.so
AddType application/x-csp csp cls zen xxx

MIME タイプを使用してファイルの種類を CSP と関連付けた場合の問題の 1 つに、リソースへのパス (ホスト・ディレクトリ) が物理的に存在することを Apache が確認し、存在しない場合には「ファイルが見つかりません」というエラーを返すことがあります。 しかし、要求されたファイルが物理的に存在することを保証するためのチェックは行われませんが、これは CSP によりサービスを受けるリソースには適切です。なぜならば、このようなリソースは Caché からサービスを受け、Web サーバからは仮想的なものだからです。 したがって、“MIME タイプによる指定” というアプローチは、アプリケーションのパス構造を Web サーバ上に複製できる場合のみ適しています。

CSP へのファイルの種類の追加登録

Apache API モジュールは、以下の予約されたファイル拡張子を常に認識します。

.csp .cls .zen .cxw 

この他のファイルを CSP に送信して処理できます。例えば、CSP ゲートウェイを経由して他の静的ファイルを処理する必要がある場合、またはこの Web サーバを経由して管理ポータルにアクセスする必要がある場合は、ファイルの .jpg、.gif、.png、.css、.js の各種類に対してマッピングを追加します。

以下の方法で、CSP に渡すファイルを Apache が認識するように構成できます。

• CSP の Location 指示文の使用

• ファイル拡張子の使用 — CSPFileTypes 指示文

• MIME タイプの使用

CSP 指示文を使用して、特定の位置にあるすべてのファイルが CSP によって処理されるように要求します。 パス /csp の下にあるすべてのファイルとディレクトリが CSP によって処理されるように要求するには、以下のように指定します。

<Location /csp>
   CSP On 
   SetHandler csp-handler-sa
</Location> 

例えば、以下のファイルはすべて CSP に送信されて処理されます。

/csp/ 
csp/samples/menu.csp 
csp/sys/ 

CSPFileTypes 指示文は、拡張子を持つファイル (/csp/menu.csp など) に対する要求に適用されます。 ファイル拡張子を持たないファイル (/csp/menu など) への要求には適用されません。

このパラメータは、ゲートウェイの Apache モジュールにより処理され、(httpd.conf の) サーバ定義レベルでグローバルに定義されるか、または位置もしくはディレクトリ・ブロックに対する定義内に制限されます。

ファイルの種類で指定 ： .xxx と .yyy の両方の種類のファイルが CSP によって処理されるように要求するには、以下の指示文のように指定します。

CSPFileTypes xxx yyy 

位置で指定 ： 以下の要求では、.xxx と .yyy の両方の種類のファイルが CSP によって処理されますが、/csp よりも下の位置 (例えば、/csp/samples などのサブ・ディレクトリ) にあるファイルに限られます。

<Location /csp/> 
   CSPFileTypes xxx yyy
</Location>

ワイルドカード文字を使用して、パス /csp の下 (および /csp/samples など) にあるすべてのファイルが CSP によって処理されるように要求するには、以下のように指定します。

<Location /csp/> 
   CSPFileTypes * 
</Location> 

CSP は、前述のファイル拡張子に加えて、以下の MIME タイプのファイルを認識することもできます。

application/x-csp

および

text/csp

例えば、CSP によって処理されるファイルのリストにファイル拡張子 xxx を追加するには以下のように指定します。

LoadModule csp_module_sa /opt/cspgateway/csp/bin/CSPa22.so
AddType application/x-csp csp cls zen xxx

MIME タイプを使用してファイルの種類を CSP と関連付けた場合の問題の 1 つに、リソースへのパス (ホスト・ディレクトリ) が物理的に存在することを Apache が確認し、存在しない場合には「ファイルが見つかりません」というエラーを返すことがあります。 しかし、要求されたファイルが物理的に存在することを保証するためのチェックは行われませんが、これは CSP によりサービスを受けるリソースには適切です。なぜならば、このようなリソースは Caché からサービスを受け、Web サーバからは仮想的なものだからです。 したがって、“MIME タイプによる指定” というアプローチは、アプリケーションのパス構造を Web サーバ上に複製できる場合のみ適しています。

CGI および NSD を使用したゲートウェイの運用および管理

この接続オプションは、CSP ゲートウェイの Network Service Daemon (NSD) に依存します。

1. “Network Service Daemon (NSD) の操作” のセクションの説明に従って、CSP NSD を起動します。

2. Apache の構成 (httpd.conf) を変更した後、その Apache を再起動する必要があります。

   Apache と NSD を起動する順序は重要ではありません。

3. CSP ウェブゲートウェイ管理ページにアクセスするには、ブラウザに以下のいずれかの URL を入力します。

   http://localhost:<port_no>/csp/bin/Systems/Module.cxw 
   http://localhost:<port_no>/csp-bin/nph-CSPcgiSys
   

   

承認されないユーザであることを通知するエラー・メッセージが表示された場合は、“セキュリティの考慮事項” を参照してください。

.csp、.cls、および .zen 拡張子を含むファイルが要求されると、CSP エンジンが自動的に呼び出されます。以下はその例です。

http://localhost:<port_no>/csp/samples/menu.csp

CSP モジュール・ソース・コードを含めた Apache のビルド

この手順の詳細は、以下の Apache ドキュメントを参照してください。

http://httpd.apache.org/Opens in a new tab

生成した Apache バイナリの確認

以下のコマンドを実行して、CSP モジュールが Apache コアに正常に追加されたことを確認します (このコマンドを実行すると、現在 Apache に組み込まれているすべてのモジュールが表示されます)。

./httpd -l

以下に例を示します。

Compiled in modules:
        core.c
        mod_access.c
        mod_auth.c
        mod_include.c
        mod_log_config.c
        mod_env.c
        mod_setenvif.c
        prefork.c
        http_core.c
        mod_mime.c
        mod_status.c
        mod_autoindex.c
        mod_asis.c
        mod_cgi.c
        mod_negotiation.c
        mod_dir.c
        mod_imap.c
        mod_actions.c
        mod_userdir.c
        mod_alias.c
        mod_csp.c

実行時の構成

Apache 構成ファイル httpd.conf を編集します。標準の Apache では、このファイルは以下の場所に配置されています。

/usr/apache/conf

Red Hat Linux の場合、httpd.conf の実行時バージョンは以下の場所に配置されています。

/etc/httpd/conf

拡張子 .csp、.cls、または .zen を含む要求されたファイルに対して CSP エンジンを呼び出す場合は、以下のセクションを httpd.conf の最後に追加します。

<LocationMatch "/*\.([Cc][Ss][Pp]|[Cc][Ll][Ss]|[Zz][En][Nn])$">
                SetHandler csp-handler
</LocationMatch>
ScriptAliasMatch /csp/bin/Systems/Module.cxw "/opt/cspgateway/bin/nph-CSPcgiSys" 
ScriptAliasMatch /csp/bin/RunTime/Module.cxw "/opt/cspgateway/bin/nph-CSPcgi"
Alias /csp/ /opt/cspgateway/csp/
<Directory "/opt/cspgateway/csp">
        AllowOverride None
        Options MultiViews FollowSymLinks ExecCGI
        Require all granted
        <FilesMatch "\.(log|ini|pid|exe)$">
                Require all denied
        </FilesMatch>
        <Files CSPnsd>
                Require all denied
        </Files>
</Directory>
ScriptAlias /csp-bin/ "/opt/cspgateway/bin/"
<Directory "/opt/cspgateway/bin/">
        AllowOverride None
        Options None
        Require all granted
</Directory>

上記の構成ブロックは、Apache 環境で利用できる正規表現 (regex) プロセッサに依存しています。このケースに相当しない場合、結果として CSP ファイルは提供されません ("ファイルが見つかりません" というエラーが返されます)。この状況を修復するには、以下の構成ブロックを

<LocationMatch "/*\.([Cc][Ss][Pp]|[Cc][Ll][Ss]|[Zz][En][Nn])$">
                SetHandler csp-handler
</LocationMatch>

以下のブロックと置換します。

CSPFiletypes

Apache に対するすべての要求は、事前に定義されたシーケンス内で実行されるモジュールのセットにより提供されます。CSP モジュールは最初に実行されるモジュールの 1 つです。ただし、その定義が構成ファイルの最後の部分に追加されていることが条件となります。

httpd.conf の変更後に、Apache を再起動します。

CSP へのファイルの種類の追加登録

Apache API モジュールは、以下の予約されたファイル拡張子を常に認識します。

.csp .cls .zen .cxw 

この他のファイルを CSP に送信して処理できます。例えば、CSP ゲートウェイを経由して他の静的ファイルを処理する必要がある場合、またはこの Web サーバを経由して管理ポータルにアクセスする必要がある場合は、ファイルの .jpg、.gif、.png、.css、.js の各種類に対してマッピングを追加します。

以下の方法で、CSP に渡すファイルを Apache が認識するように構成できます。

• CSP の Location 指示文の使用

• ファイル拡張子の使用

• CSPFileTypes 指示文の使用

• MIME タイプの使用

CSP 指示文を使用して、特定の位置にあるすべてのファイルが CSP によって処理されるように要求します。 パス /csp の下にあるすべてのファイルとディレクトリが CSP によって処理されるように要求するには、以下のように指定します。

<Location /csp>
   CSP On 
   SetHandler csp-handler-sa
</Location> 

例えば、以下のファイルはすべて CSP に送信されて処理されます。

/csp/ 
csp/samples/menu.csp 
csp/sys/ 

従来、Apache は要求されたファイルの拡張子を基に CSP を呼び出すように構成されてきました。 例えば、以下の (httpd.conf の) 構成ブロックは、ファイルの種類が *.csp、*.cls、*.zen、および *.cxw である場合に CSP で要求を処理可能にするよう Apache に指示しています。

LoadModule csp_module_sa /opt/cspgateway/csp/bin/CSPa22.so
AddHandler csp-handler-sa csp cls zen cxw

このメソッドは Apache v1.3.x で問題なく動作しますが、Apache v2.0.x (およびそれ以降) では動作しない場合があります。

CSPFileTypes 指示文は、拡張子を持つファイル (/csp/menu.csp など) に対する要求に適用されます。 ファイル拡張子を持たないファイル (/csp/menu など) への要求には適用されません。

このパラメータは、ゲートウェイの Apache モジュールにより処理され、(httpd.conf の) サーバ定義レベルでグローバルに定義されるか、または位置もしくはディレクトリ・ブロックに対する定義内に制限されます。

ファイルの種類で指定： .xxx と . yyy の両方の種類のファイルが CSP によって処理されるように要求するには、以下の指示文のように指定します。

CSPFileTypes xxx yyy 

位置で指定 ： 以下の要求では、.xxx と .yyy の両方の種類のファイルが CSP によって処理されますが、/csp よりも下の位置 (例えば、/csp/samples などのサブ・ディレクトリ) にあるファイルに限られます。

<Location /csp/> 
   CSPFileTypes xxx yyy
</Location>

ワイルドカード文字を使用して、パス /csp の下 (および /csp/samples など) にあるすべてのファイルが CSP によって処理されるように要求するには、以下のように指定します。

<Location /csp/> 
   CSPFileTypes * 
</Location> 

CSP は、前述のファイル拡張子に加えて、以下の MIME タイプのファイルを認識することもできます。

application/x-csp

および

text/csp

例えば、CSP によって処理されるファイルのリストにファイル拡張子 xxx を追加するには以下のように指定します。

LoadModule csp_module_sa /opt/cspgateway/csp/bin/CSPa22.so
AddType application/x-csp csp cls zen xxx

MIME タイプを使用してファイルの種類を CSP と関連付けた場合の問題の 1 つに、リソースへのパス (ホスト・ディレクトリ) が物理的に存在することを Apache が確認し、存在しない場合には「ファイルが見つかりません」というエラーを返すことがあります。 しかし、要求されたファイルが物理的に存在することを保証するためのチェックは行われませんが、これは CSP によりサービスを受けるリソースには適切です。なぜならば、このようなリソースは Caché からサービスを受け、Web サーバからは仮想的なものだからです。 したがって、“MIME タイプによる指定” というアプローチは、アプリケーションのパス構造を Web サーバ上に複製できる場合のみ適しています。

Apache API および NSD を使用したゲートウェイの運用および管理

この接続オプションは、CSP ゲートウェイの Network Service Daemon (NSD) に依存します。

1. “Network Service Daemon (NSD) の操作” のセクションの説明に従って、CSP NSD を起動します。

2. Apache の構成 (httpd.conf) を変更した後、その Apache を再起動する必要があります。

   Apache と NSD を起動する順序は重要ではありません。

3. CSP ウェブゲートウェイ管理ページにアクセスするには、ブラウザで以下のいずれかの場所を指定します。CSP ページは高性能な組み込みモジュール (mod_csp.c) によって管理されますが、CSP ウェブゲートウェイ管理ページへアクセスするには専用の CGI モジュール (nph-CSPcgiSys) を使用します。

   http://localhost:<port_no>/csp/bin/Systems/Module.cxw
   http://localhost:<port_no>/csp-bin/nph-CSPcgiSys
   

   

承認されないユーザであることを通知するエラー・メッセージが表示された場合は、"セキュリティの考慮事項" を参照してください。

.csp、.cls、および .zen 拡張子を含むファイルが要求されると、CSP エンジンが自動的に呼び出されます。以下はその例です。

http://localhost:<port_no>/csp/samples/menu.csp

指示文

静的コンポーネントと CGI モジュールを見つけるための指示文

obj.conf の default 指示文セクションを探します。

<Object name="default">

default セクションで、上記の行の後に以下の行を追加します。

NameTrans fn="pfx2dir" from="/csp/samples" dir="/cache-install-dir/csp/samples"
NameTrans fn="pfx2dir" from="/csp/broker" dir="/cache-install-dir/csp/broker"

NameTrans fn="pfx2dir" from="/csp-bin" dir="/cache-install-dir/csp/bin" name="cgi"

CSP 要求を認識および処理するための指示文

obj.conf の最後に以下のセクションを追加します。

<Object ppath="*/*.csp">
Service method=(GET|HEAD|POST) fn=csp_req
</Object>
<Object ppath="*/*.cls">
Service method=(GET|HEAD|POST) fn=csp_req
</Object>
<Object ppath="*/*.zen">
Service method=(GET|HEAD|POST) fn=csp_req
</Object>

NSAPI および NSD を使用したゲートウェイの運用および管理

この接続オプションは、CSP ゲートウェイの Network Service Daemon (NSD) に依存します。

1. “Network Service Daemon (NSD) の操作” の説明に従って、CSP NSD を起動します。

2. Web サーバの構成ファイル (magnus.conf および obj.conf) を変更した後は、その Web サーバを再起動する必要があります。

   Web サーバと NSD を起動する順序は重要ではありません。

3. CSP ウェブゲートウェイ管理ページにアクセスするには、ブラウザで以下の場所のいずれかを指定します。CSP ページは高性能なモジュール (CSPcn2.so) を介して提供されますが、CSP ウェブゲートウェイ管理ページへアクセスするには専用の CGI モジュール (nph-CSPcgiSys) を使用します。

   http://localhost:<port_no>/csp/bin/Systems/Module.cxw 
   http://localhost:<port_no>/csp-bin/nph-CSPcgiSys
   

   

承認されないユーザであることを通知するエラー・メッセージが表示された場合は、"セキュリティの考慮事項" を参照してください。

.csp、.cls、および .zen 拡張子を含むファイルが要求されると、CSP エンジンが自動的に呼び出されます。以下はその例です。

http://localhost:<port_no>/csp/samples/menu.csp