セッション情報の引き継ぎを行うWebアプリケーションへのフィルタの組み込みには，サーバ管理コマンドを使用した属性ファイルの編集による方法と，Server Plug-inを使用する方法と，WebアプリケーションのDD（web.xml）の直接編集による方法の3種類があります。ここでは，サーバ管理コマンドで属性ファイルを編集してフィルタを組み込む方法について説明します。Server Plug-inを使用したフィルタの組み込みについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。また，WebアプリケーションのDD（web.xml）の直接編集によるフィルタの組み込みについては，マニュアル「Cosminexus　機能解説」のセッションフェイルオーバ機能を使用するアプリケーションの実装に関する説明を参照してください。

Webアプリケーションにセッションフェイルオーバ用フィルタを組み込むために，フィルタ属性ファイルおよびWAR属性ファイルに設定する内容を次の表に示します。なお，属性ファイルの取得，編集した属性ファイルの設定の手順については，「9.7.1(2)　built-inフィルタの組み込み手順」を参照してください。

表9-14　属性ファイルでの設定内容（セッションフェイルオーバ用フィルタ）

注※　フィルタマッピングを定義する場合，次の点に注意してください。

• フィルタマッピング定義を複数定義する場合，セッションフェイルオーバ機能用のフィルタマッピング定義を最初に記述してください。最初に記述しない場合はアプリケーションを開始できません。
• セッションフェイルオーバ機能用のフィルタマッピング定義は複数定義しないでください。複数定義した場合はアプリケーションを開始できません。
• WebアプリケーションのバージョンがServlet2.4の場合，<filter-mapping>タグの要素，および<dispatcher>タグは指定しないでください。また，<dispatcher>タグで「FORWARD」，「INCLUDE」，「ERROR」を指定した場合，Webアプリケーションの開始時にセッションフェイルオーバ用フィルタの初期化でエラーが発生し，アプリケーションが開始できなくなるので，注意してください。

セッション情報の引き継ぎに設定する項目と<param-name>タグに指定する初期化パラメタの対応について次の表に指定します。

表9-15　セッション情報の引き継ぎに設定する項目と<param-name>タグに指定する初期化パラメタの対応

これらのパラメタは，使用する機能によって設定するかどうかが異なります。使用する機能ごとの<param-name>タグに指定する初期化パラメタの設定要否を次の表に示します。

表9-16　使用する機能ごとの<param-name>タグに指定する初期化パラメタの設定要否

（凡例）

任意：省略できることを示す。省略した場合はデフォルトの値が設定される。

無効：指定しても無効になることを示す。設定した値は使用されない。

注※1　GSInfoKey-RWとGSInfoKey-Rの両方を省略することはできません。

注※2　パラメタに不正な値を指定した場合はエラーとなり，Webアプリケーションは開始できません。

注※3　指定したSFOサーバ名が，簡易構築定義ファイルで指定されているSFOフィルタのサーバ定義名にない場合もエラーになりません。SFOフィルタのサーバ定義名は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，webserver.sfo.sfo_serversパラメタで指定します。

注意

セッション情報の引き継ぎに関する設定を変更するときは，フィルタ属性ファイルの<init-param>タグ内にある<param-name>タグおよび<param-value>タグを編集します。なお，タグの指定を省略する場合，タグの記述も含めて省略する必要があります（<init-param>タグ〜</init-param>タグの記述を省略します）。次のようにタグを記述して値だけ省略した場合，空白文字列が指定されたと判断してエラーとなります。

間違った省略方法の例

（省略） 　　　　： <init-param> <param-name>LockTimeout</param-name> <param-value></param-value> </init-param> 　　　　： 　　 （省略）

　

HTTPセッションに登録されるセッション情報の中から，グローバルセッション情報として，SFOサーバに引き継ぐセッション情報を選択します。また，グローバルセッション情報には，書き換え可能な情報と読み取り専用の情報の2種類があるため，グローバルセッション情報の種別を指定します。

グローバルセッション情報の設定に使用する初期化パラメタは，GSInfoKey-RWパラメタ（書き換え可能な場合）またはGSInfoKey-Rパラメタ（読み取り専用の場合）です。GSInfoKey-RWパラメタおよびGSInfoKey-Rパラメタには同じ値を指定しないでください。同じ値を指定した場合，Webアプリケーションの開始時にエラーとなり，Webアプリケーションは開始できません。また，GSInfoKey-RWパラメタおよびGSInfoKey-Rパラメタの両方を省略することはできません。

グローバルセッション情報として指定できるセッション情報と，セッション情報のデータ型，グローバルセッション情報の種別について説明します。なお，統合ユーザ管理機能を使用する場合には，セッション情報の種別，およびパラメタの設定値が決まっています。詳細については，「(d)　統合ユーザ管理機能を使用する場合のグローバルセッション情報」を参照してください。

(a)　グローバルセッション情報として指定できるセッション情報

HTTPセッションに登録されるセッション情報の中から，グローバルセッション情報として，SFOサーバに引き継ぐセッション情報を選択します。

グローバルセッション情報として指定できるセッション情報は，HTTPセッションに登録された一部，またはすべてです。HTTPセッションに登録される一部のセッション情報をグローバルセッション情報として指定する場合は，GSInfoKey-RWパラメタまたはGSInfoKey-Rパラメタで，SFOサーバに引き継ぐセッション情報のキー名称を指定します。HTTPセッションに登録されるすべてのセッション情報をグローバルセッション情報として指定する場合は，GSInfoKey-RWパラメタまたはGSInfoKey-Rパラメタで，*（半角アスタリスク）を指定します。

グローバルセッション情報を選択するときの留意事項を次に示します。

• グローバルセッション情報として，HTTPセッションに登録されたすべてのセッション情報を指定すると，引き継ぐ必要のない情報がHTTPセッションに登録されている場合にリクエスト処理のパフォーマンスが低下することがあります。このため，必要最小限のセッション情報を，グローバルセッション情報としてSFOサーバに引き継ぐように設定することをお勧めします。必要最小限のグローバルセッション情報を引き継ぐことで，SFOサーバのパフォーマンスの向上を図れます。

(b)　グローバルセッション情報として指定できるセッション情報のデータ型

グローバルセッション情報として指定できるセッション情報には，次のデータ型が指定できます。

• java.lang.Stringクラスのオブジェクト
• byte型配列
• 直列化可能クラスのオブジェクト

データ型にjava.lang.Stringクラスのオブジェクト以外を指定する場合は，どのデータ型のセッション情報に対して引き継ぎを許可するかを，GSInfoTypeByteArrayEnableパラメタまたはGSInfoTypeSerializableEnableパラメタで設定します。

グローバルセッション情報として，指定したデータ型以外のオブジェクトがHTTPセッションに登録されると，SFOサーバへのセッション情報の引き継ぎでエラーが発生し，セッション情報は保持されません。引き継ぎ対象外のオブジェクトがHTTPセッションに登録された場合の，引き継ぎ対象外のオブジェクトの扱いについては，マニュアル「Cosminexus　機能解説」を参照してください。

グローバルセッション情報のデータ型を指定するときの留意事項を次に示します。

• 引き継ぎ対象のセッション情報のデータ型が，直列化可能クラスのオブジェクトの場合，グローバルセッション情報の更新処理や，引き継ぎ処理で，オブジェクトのシリアライズ処理またはデシリアライズ処理が必要になります。このため，引き継ぐ必要のない情報を含むクラスの場合，性能が低下する原因となることがあります。また，シリアライズ処理およびデシリアライズ処理では，引き継ぎ対象のHTTPセッションに登録されたオブジェクトだけでなく，そのオブジェクトから参照されるオブジェクトも処理の対象となるため，SFOサーバのパフォーマンスが低下することがあります。
  グローバルセッション情報として引き継ぐセッション情報のデータ型には，java.lang.Stringクラスのオブジェクトまたはbyte型配列を指定することをお勧めします。
  

(c)　グローバルセッション情報の種別

グローバルセッション情報として選択したセッション情報を書き換え可能な情報とするか，または読み取り専用の情報とするか，どちらかを選択します。

なお，複数のグローバルセッション情報を選択した場合，それぞれのグローバルセッション情報に対して種別を指定してください。

グローバルセッション情報の種別の選択基準を次に示します。

• 書き換え可能なグローバルセッション情報とする場合
  HTTPセッションに登録されたあと，更新が必要となるセッション情報です。
  次に示す性質を持つセッション情報の場合，書き換え可能なグローバルセッション情報としてください。
  
  • HTTPセッションに登録されたあと，更新または削除が必要なセッション情報である。
  • リクエスト処理の推移とともに更新される可能性のあるセッション情報である。
  なお，書き換え可能なグローバルセッション情報は，SFOサーバに障害が発生した場合，破棄されます。
  
• 読み取り専用のグローバルセッション情報とする場合
  HTTPセッションに登録されたあと，更新されないセッション情報です。
  ログイン情報などのように，HTTPセッションに一度登録したあと，更新されないセッション情報の場合，読み取り専用のグローバルセッション情報としてください。
  なお，読み取り専用のグローバルセッション情報は，SFOサーバに障害が発生しても，そのまま使用できます。例えば，J2EEアプリケーションのログイン情報などを，読み取り専用グローバルセッション情報に設定すると，SFOサーバで障害が発生した場合でも，ユーザに対して再ログインを要求する必要がありません。このため，障害発生時のユーザへの影響を軽減できます。
  

(d)　統合ユーザ管理機能を使用する場合のグローバルセッション情報

統合ユーザ管理機能を使用する場合のセッション情報は，HTTPセッションに登録したあと変更が必要になるため，書き換え可能なグローバルセッション情報（GSInfoKey-RWパラメタ）を選択してください。また，GSInfoKey-RWパラメタには，「com.cosminexus.admin.auth.user_data」を設定してください。

SFOサーバに格納するグローバルセッション情報の一つ当たりの最大サイズを指定します。SFOサーバで冗長化できるグローバルセッション情報のサイズは，デフォルトでは1,024バイトまでです。冗長化するグローバルセッション情報の文字数がこの値を超える場合は，設定を変更する必要があります。グローバルセッション情報の最大サイズの設定に使用する初期化パラメタは，GSInfosLengthMaxパラメタです。

なお，グローバルセッション情報の最大サイズを小さくすることにより，SFOサーバのメモリの消費量を削減できます。ご使用の環境に応じて，グローバルセッション情報の最大サイズに適切な値を設定してください。

グローバルセッション情報の最大サイズの見積もり式は，統合ユーザ管理機能を使用する場合と使用しない場合とで異なります。それぞれの場合の見積もり式について説明します。

(a)　統合ユーザ管理機能を使用しない場合

統合ユーザ管理機能を使用しない場合のグローバルセッション情報の最大サイズの見積もり式を次に示します。直列化可能クラスのオブジェクトであるセッション情報の引き継ぎを許可しているかどうか（GSInfoTypeSerializableEnableパラメタの指定）によって，見積もり式が異なります。

• 直列化可能クラスのオブジェクトであるセッション情報の引き継ぎを許可していない場合
  

  グローバルセッション情報の最大サイズ 　　　　　＝各グローバルセッション情報のキー※1の文字列長の合計 　　　　　＋HTTPセッションに登録されたオブジェクトのサイズの最大長※2の合計 　　　　　＋区切り文字数※3 　　　　　＋HTTPセッションの有効期間情報※4

  注※1

  グローバルセッション情報の設定に使用する初期化パラメタ，GSInfoKey-RWパラメタまたはGSInfoKey-Rパラメタに指定したキーです。

  注※2

  グローバルセッション情報がjava.lang.Stringクラスの場合，最大長は「最大文字列長」になります。また，グローバルセッション情報がbyte型配列の場合，最大長は「byte型配列の最大長+5」になります。

  注※3

  区切り文字数は，2×（設定したグローバルセッション情報の数）-1で算出できます。これは，区切り文字には，グローバルセッション情報間の区切り文字と，各グローバルセッション情報のキーと値の区切り文字が含まれるためです。

  注※4

  HTTPセッションの有効期間情報は4バイトです。

  
  ただし，グローバルセッション情報がjava.lang.Stringクラスの場合，文字列をUTF-8の文字エンコーディングでURLエンコードして冗長化します（URLエンコードにはjava.net.URLEncoderクラスを使用します）。そのため，グローバルセッション情報の文字列長は，セッション情報の文字列長と異なることがあります。文字種ごとのURLエンコード後の文字列長を次の表に示します。
  

  表9-17　文字種ごとのURLエンコード後の文字列長

  項番	文字種		文字列長（バイト）
  1	ASCII文字	英数字（0〜9およびa〜Z）および次に示す特殊文字 ピリオド（.） ハイフン（-） アスタリスク（*） アンダースコア（_）	1
  		上記以外のASCII文字	3
  2	JIS X 0201のすべての非ASCII文字		6または9
  3	JIS X 0208のすべての非ASCII文字		6または9
  4	JIS X 0212のすべての非ASCII文字		6または9
  5	Windows-31Jの拡張文字		9
  6	Unicodeの補助文字（基本多言語面以外の文字）		12
  7	JIS X 0213の第3，第4水準漢字		9または12

  このため，グローバルセッション情報のサイズは，セッション情報の文字列を文字種ごとにURLエンコード後の文字列長に変換してから，それらを合計して見積もる必要があります。
  n種類のグローバルセッション情報を設定した場合の見積もり式の例を次に示します。
  

  グローバルセッション情報の最大サイズ 　　　　　＝グローバルセッション情報1のキーの文字数 　　　　　＋グローバルセッション情報2のキーの文字数 　　　　　： 　　　　　＋グローバルセッション情報nのキーの文字数 　　　　　＋HTTPセッションに登録されたオブジェクト1の最大サイズ長 　　　　　＋HTTPセッションに登録されたオブジェクト2の最大サイズ長 　　　　　： 　　　　　＋HTTPセッションに登録されたオブジェクトnの最大サイズ長 　　　　　＋（2n-1） 　　　　　＋4

  参考

  グローバルセッション情報のサイズ見積もり機能を使用すると，HTTPセッションに含まれるセッション情報ごとのバイト数が出力できます。出力されたサイズ情報を参考にして，グローバルセッション情報の最大サイズに適切な値を設定してください。グローバルセッション情報のサイズ見積もり機能については，マニュアル「Cosminexus　機能解説」のグローバルセッション情報のサイズの見積もりに関する説明を参照してください。

• 直列化可能クラスのオブジェクトであるセッション情報の引き継ぎを許可している場合
  

  グローバルセッション情報の最大サイズ 　＝各グローバルセッション情報のキー※1のシリアライズ後のバイト数合計 　＋各HTTPセッションに登録されたオブジェクトのシリアライズ後のバイト数合計 　＋HTTPセッションの有効期間情報※2

  注

  シリアライズは，一つのHTTPセッションに対して，一つのjava.io.ObjectOutputStreamのオブジェクトを使用して実施します。

  注※1

  グローバルセッション情報の設定に使用する初期化パラメタ，GSInfoKey-RWパラメタまたはGSInfoKey-Rパラメタに指定したキーです。

  注※2

  HTTPセッションの有効期間情報は4バイトです。

  
  n種類のグローバルセッション情報を設定した場合の見積もり式の例を次に示します。
  

  グローバルセッション情報の最大サイズ 　　　＝グローバルセッション情報1のキーのシリアライズ後のバイト数 　　　＋グローバルセッション情報2のキーのシリアライズ後のバイト数 　　　： 　　　＋グローバルセッション情報nのキーのシリアライズ後のバイト数 　　　＋HTTPセッションに登録されたオブジェクト1のシリアライズ後のバイト数 　　　＋HTTPセッションに登録されたオブジェクト2のシリアライズ後のバイト数 　　　： 　　　＋HTTPセッションに登録されたオブジェクトnのシリアライズ後のバイト数 　　　＋4

  注

  シリアライズは，一つのHTTPセッションに対して，一つのjava.io.ObjectOutputStreamのオブジェクトを使用して実施します。

  
  

  参考

  グローバルセッション情報のサイズ見積もり機能を使用すると，各情報のシリアライズ後のバイト数が出力できます。出力されたサイズ情報を参考にして，グローバルセッション情報の最大サイズに適切な値を設定してください。グローバルセッション情報のサイズ見積もり機能については，マニュアル「Cosminexus　機能解説」のグローバルセッション情報のサイズの見積もりに関する説明を参照してください。

(b)　統合ユーザ管理機能を使用する場合

統合ユーザ管理機能を使用する場合のグローバルセッション情報の最大サイズの見積もり式を次に示します。

　
グローバルセッション情報の最大サイズ
　　　　　＝統合ユーザ管理で使用する値
　　　　　＋ユーザアプリケーションで使用する値

統合ユーザ管理で使用する値は，統合ユーザ管理フレームワークのAPIを使用する場合とタグライブラリを使用する場合で異なります。また，パスワード保存機能を使用するかどうかによっても異なります。それぞれの場合の統合ユーザ管理で使用する値の計算式を次に示します。

• APIを使用し，パスワード保存機能を使用する場合
  

  統合ユーザ管理で使用する値 　　　　＝｛1,500＋（レルム名の長さ＋ユーザ名の最大長＋パスワードの最大長 　　　　＋1,200）×レルム数｝×2

• APIを使用し，パスワード保存機能を使用しない場合
  

  統合ユーザ管理で使用する値 　　　　＝｛1,500＋（レルム名の長さ＋ユーザ名の最大長＋1,200）×レルム数｝×2

• タグライブラリを使用し，パスワード保存機能を使用する場合
  

  統合ユーザ管理で使用する値 　　　　＝｛1,500＋（レルム名の長さ＋ユーザ名の最大長 　　　　＋loginタグのid属性値の長さ＋loginタグのentry属性値の長さ 　　　　＋パスワードの最大長＋1,200）×レルム数｝×2

• タグライブラリを使用し，パスワード保存機能を使用しない場合
  

  統合ユーザ管理で使用する値 　　　　＝｛1,500＋（レルム名の長さ＋ユーザ名の最大長 　　　　＋loginタグのid属性値の長さ＋loginタグのentry属性値の長さ 　　　　＋1,200）×レルム数｝×2

ポイント

計算式中の1,500と1,200は固定値です。統合ユーザ管理の管理情報を保存するために必要な値です。なお，この値はオブジェクトをシリアライズしたときのバイト数の最大値を基に算出しています。

注意

セッションフェイルオーバ用フィルタの設定に誤りがある場合，セッションフェイルオーバが正しく行われませんので注意してください。

統合ユーザ管理では，GIDCookieNameパラメタが示す値が取得できたときに統合ユーザ管理でのセッションフェイルオーバ機能を有効にしますが，統合ユーザ管理からはセッションフェイルオーバ用フィルタの内容が正しいかチェックできません。このため，フィルタの設定に誤りがあった場合，実際にフェイルオーバが発生するまで誤りに気づかないおそれがあります。

グローバルセッション情報を格納するSFOサーバの名称を指定します。SFOサーバの名称の設定に使用する初期化パラメタは，SFOServerNameパラメタです。

グローバルセッション情報を格納するSFOサーバは，Webアプリケーションが配置されているJ2EEサーバのグローバルセッション情報を格納するSFOサーバから選択します。

J2EEサーバのグローバルセッション情報を格納するSFOサーバは，Smart Composer機能の簡易構築定義ファイルのsfo-tierで定義します。グローバルセッション情報を格納するSFOサーバの設定については，「6.2.3　セッション情報の引き継ぎを行うJ2EEサーバの設定」を参照してください。

ポイント

システム内に複数のSFOサーバを配置する場合，セッションフェイルオーバ機能を使用するWebアプリケーション単位に，SFOサーバを割り当てることをお勧めします。Webアプリケーション単位にSFOサーバを割り当てることにより，SFOサーバでの障害発生時の影響範囲を特定のJ2EEアプリケーションに限定させることができます。システム内に複数のSFOサーバを配置する場合の設定例を次の図に示します。

図9-15　システム内に複数のSFOサーバを配置する場合の設定例

　

グローバルセッションの制御方法を指定します。グローバルセッションの制御方法の設定に使用する初期化パラメタは，GSessionControlパラメタです。

GSessionControlパラメタに指定した値に応じて，Webクライアントに対するグローバルセッションIDの送信方法，およびWebクライアントからのグローバルセッションIDの受信方法が決まります。

GSessionControlパラメタに指定できる値と意味を次の表に示します。

表9-18　GsessionControlパラメタの指定値と意味

注意

Smart Composer機能で構築する，セッションフェイルオーバ機能を使用したシステムでは，HTTP Cookieによるグローバルセッション情報の制御に対応していますが，URL書き換えによるグローバルセッション情報の制御には対応していません。グローバルセッション情報の制御にURL書き換えを使用するシステムは，運用管理ポータル，またはファイル編集とコマンド実行で構築してください。運用管理ポータルの場合は，マニュアル「Cosminexus　運用管理操作ガイド」を，ファイル編集とコマンド実行の場合は，マニュアル「Cosminexus　リファレンス　定義編」およびマニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

HTTP Cookieを使用してグローバルセッションを制御している場合，グローバルセッションIDは，HTTPレスポンスヘッダのSet-Cookieヘッダに設定されて，Webクライアント（ブラウザなど）に送信されます。

グローバルセッションIDを設定するCookieに任意の名称を指定します。Cookieの名称の設定に使用する初期化パラメタは，GIDCookieNameパラメタです。

Cookieの名称は，Webアプリケーション単位に指定できます。ただし，次に示すCookieの名称と同じ値を指定することはできません。

• HTTPセッションのセッションIDの送信に使用するCookieの名称「JSESSIONID」
• HTTPセッションを生成したリクエストのレスポンスに付加されるサーバIDのCookieの名称
  HTTPセッションを生成したリクエストのレスポンスにサーバIDのCookieを付加する機能を有効にしている場合に確認が必要です。
  この機能を有効にしているかどうか，および付加されるサーバIDのCookieの名称については，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内で，次のパラメタの値を参照してください。
  
  • webserver.container.server_id.enabled
  • webserver.container.server_id.name

なお，グローバルセッションIDの送信に使用するCookieの名称が，上記のCookieの名称と重複した場合，Webアプリケーションに定義したセッションフェイルオーバ用フィルタ（J2EE仕様で規定されたjavax.servlet.Filterインタフェースを実装したクラス）の開始処理でエラーとなり，Webアプリケーションを実行できません。

グローバルセッションIDの送信に使用するURLのパスパラメタ名を指定します。URLのパスパラメタ名の設定に使用する初期化パラメタは，GIDURLParamNameパラメタです。

GSessionControlパラメタに「cookie」を指定した場合，GIDURLParamNameパラメタに設定した値は無効になります。なお，GSessionControlパラメタに「cookie」を指定した場合，GIDURLParamNameパラメタに設定した値はチェックされません。このため，GIDURLParamNameパラメタに不正な値を設定した場合も，検出はされません。

注意

Webアプリケーション内で使用するURLのパスパラメタと同じ名称を，GIDURLParamNameパラメタで指定しないでください。指定した場合，セッションフェイルオーバ機能が正しく動作しません。

すでにロックされた状態のセッションに対して，別のJ2EEサーバからロック要求があった場合に，ロック解除待ちがタイムアウトになるまでの時間を設定します。グローバルセッション情報のロック待ちタイムアウトの設定に使用する初期化パラメタは，LockTimeoutパラメタです。

J2EEサーバからSFOサーバに対してグローバルセッション情報のロック取得要求をしたあとでJ2EEサーバに障害が発生して停止した場合，SFOサーバ上のグローバルセッション情報がロックされたままの状態になってしまうおそれがあります。グローバルセッション情報のロック待ちタイムアウト時間は，このような場合に，J2EEサーバに障害が発生したと判断するために使用される時間です。このタイムアウト時間を超えると，SFOサーバ上のロックは解除されます。

また，次のような場合にロックされたままの状態になったときにも，このタイムアウト時間が有効になります。これらの状態は，負荷分散機を利用している環境で発生することがあります。

• ページにフレームを使用している場合など，同じセッションを使用するリクエストが同時に送信され，それぞれのリクエストが負荷分散機のスケジュール機能によって異なるJ2EEサーバに分散されて転送された場合
• ユーザの操作によってリクエストが二重に送信された場合など，リクエストを送信して応答が返されるよりも前に次のリクエストを送信したときに，それぞれのリクエストが負荷分散機のスケジュール機能によって異なるJ2EEサーバに分散されて転送された場合

なお，クライアントから同時に実行されることが想定されるWebアプリケーションがある場合，その処理に要する時間を考慮して，グローバルセッション情報のロック待ちタイムアウト時間を指定してください。

byte型配列であるセッション情報を引き継ぎ対象とするかどうかを指定します。

GSInfoTypeByteArrayEnableパラメタにtrueを指定した場合には，byte型配列のセッション情報は引き継ぎ対象となります。

GSInfoTypeByteArrayEnableパラメタにfalseを指定した場合には，byte型配列のセッション情報は引き継ぎ対象となりません。このため，byte型配列のセッション情報の場合は，グローバルセッション情報の更新時にエラーとなります。

直列化可能クラスのオブジェクトであるセッション情報を引き継ぎ対象とするかどうかを指定します。

GSInfoTypeSerializableEnableパラメタにtrueを指定した場合には，直列化可能クラスのオブジェクトであるセッション情報は引き継ぎ対象となります。

GSInfoTypeSerializableEnableパラメタにfalseを指定した場合には，直列化可能クラスのオブジェクトであるセッション情報は引き継ぎ対象となりません。

属性ファイルの記述例を示します。

(a)　統合ユーザ管理機能を使用しない場合

統合ユーザ管理機能を使用しない場合の属性ファイルの記述例を次に示します。この例は，HTTP Cookieを使用してグローバルセッションを制御し，byte型配列のセッション情報を引き継ぐ場合の例です。

• フィルタ属性ファイルの記述例
  

  （省略） 　　　　： <filter> <filter-name>com.hitachi.software.was.sfo.web.SFOFilter</filter-name> <filter-class>com.hitachi.software.was.sfo.web.SFOFilter</filter-class> <init-param> <param-name>GSInfoKey-RW</param-name> <param-value>page</param-value> </init-param> <init-param> <param-name>GSInfoKey-R</param-name> <param-value>userId;roll</param-value> </init-param> <init-param> <param-name>GSInfosLengthMax</param-name> <param-value>44</param-value> </init-param> <init-param> <param-name>SFOServerName</param-name> <param-value>sfo_server1</param-value> </init-param> <init-param> <param-name>GSessionControl</param-name> <param-value>cookie</param-value> </init-param> <init-param> <param-name>GIDCookieName</param-name> <param-value>SFOSESSIONID</param-value> </init-param> <init-param> <param-name>LockTimeout</param-name> <param-value>180</param-value> </init-param> <init-param> <param-name>GSInfoTypeByteArrayEnable</param-name> <param-value>true</param-value> </init-param> 　　　　： 　　 （省略）

• WAR属性ファイルの記述例
  

  （省略） 　　　　： <filter-mapping> <filter-name>com.hitachi.software.was.sfo.web.SFOFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> 　　　　： 　　 （省略）

この記述例で設定される内容は，次のとおりです。

• 書き換え可能なグローバルセッション情報として，「page」の値を格納します。
• 読み取り専用のグローバルセッション情報として，「UserID」および「Roll」の2種類の値を格納します。
• グローバルセッション情報の最大サイズとして，49を設定します。
  最大サイズは，次の式で算出します。なお，ここでは，page（4文字）の値は1〜2文字のASCII文字列，UserID（6文字）の値は1〜12バイトのbyte型配列，roll（4文字）の値は1〜7文字のASCII文字列とします。
  （4＋4＋6）+（2＋7＋（12＋5））＋（2×3-1）＋4＝49
  
• グローバルセッション情報を格納するSFOサーバの名称は，「sfo_server1」とします。
• グローバルセッションの制御には，HTTP Cookieを使用します。
• グローバルセッションIDの送信に使用するCookieの名称は，「SFOSESSIONID」とします。
• グローバルセッション情報のロック待ちタイムアウトは，「180秒」とします。
• byte型配列のセッション情報を引き継ぐため，GSInfoTypeByteArrayEnableパラメタにtrueを指定します。

(b)　統合ユーザ管理機能を使用する場合

統合ユーザ管理機能を使用する場合の属性ファイルの記述例を次に示します。この例は，HTTP Cookieを使用してグローバルセッションを制御している場合の例です。

• フィルタ属性ファイルの記述例
  

  （省略） 　　　　： <filter> <filter-name>com.hitachi.software.was.sfo.web.SFOFilter</filter-name> <filter-class>com.hitachi.software.was.sfo.web.SFOFilter</filter-class> <init-param> <param-name>GSInfoKey-RW</param-name> <param-value>com.cosminexus.admin.auth.user_data</param-value> </init-param> <init-param> <param-name>GSInfoKey-R</param-name> <param-value></param-value> </init-param> <init-param> <param-name>GSInfosLengthMax</param-name> <param-value>10380</param-value> </init-param> <init-param> <param-name>SFOServerName</param-name> <param-value>sfo_server1</param-value> </init-param> <init-param> <param-name>GSessionControl</param-name> <param-value>cookie</param-value> </init-param> <init-param> <param-name>GIDCookieName</param-name> <param-value>GSESSIONID</param-value> </init-param> <init-param> <param-name>LockTimeout</param-name> <param-value>30</param-value> </init-param> <init-param> <param-name>GSInfoTypeByteArrayEnable</param-name> <param-value>false</param-value> </init-param> </filter> 　　　　： 　　 （省略）

• WAR属性ファイルの記述例
  

  （省略） 　　　　： <filter-mapping> <filter-name>com.hitachi.software.was.sfo.web.SFOFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> 　　　　： 　　 （省略）

この記述例で設定される内容は，次のとおりです。

• 書き換え可能なグローバルセッション情報として，「com.cosminexus.admin.auth.user_data」の値を格納します。
• グローバルセッション情報の最大サイズとして，10,380文字を設定します。
  最大サイズは，次の式で算出します。
  ｛1,500＋(10＋20＋1,200）×3｝×2＝10,380
  なお，ここでは，次の条件で最大サイズを算出しています。
  
  • APIを使用する。
  • パスワード保存機能は使用しない。
  • レルム名の長さ：10
  • ユーザ名の最大長：20
  • レルム数（シングルサインオンを使用するシステムの数）：3
• グローバルセッション情報を格納するSFOサーバの名称は，「sfo_server1」とします。
• グローバルセッションの制御には，HTTP Cookieを使用します。
• グローバルセッションIDの送信に使用するCookieの名称は，「GSESSIONID」とします。
• グローバルセッション情報のロック待ちタイムアウトは，「30」秒とします。
• グローバルセッション情報として，byte型配列を使用しないため，GSInfoTypeByteArrayEnableパラメタにfalseを指定します。