Interstage Application Server J2EE ユーザーズガイド

9.3.5 Session Registry Server環境定義ファイルの設定内容

　Session Registry Server環境定義ファイルの設定内容を説明します。

◆記述形式

　Session Registry Server環境定義ファイルは、以下の形式で記載されています。

-------------------------------------------------------------------------------
        ・
        ・
        ・
  <web-app>
    <context-param>
      <param-name>backup.limit</param-name>
      <param-value>0</param-value>
    </context-param>
    <context-param>
      <param-name>clean.interval</param-name>
      <param-value>60</param-value>
    </context-param>
    <context-param>
      <param-name>session.store</param-name>
      <param-value>off</param-value>
    </context-param>
    <context-param>
      <param-name>serialize.file.path</param-name>
      <param-value>serializedata</param-value>
    </context-param>
    <context-param>
      <param-name>serialize.interval</param-name>
      <param-value>60</param-value>
    </context-param>
    <context-param>
      <param-name>pop.timeout</param-name>
      <param-value>360</param-value>
    </context-param>
    <context-param>
      <param-name>access_log</param-name>
      <param-value>off</param-value>
    </context-param>
  </web-app>
        ・
        ・
        ・
-------------------------------------------------------------------------------

◆定義内容

• backup.limit : 保持するセション数の制限
  　Session Registry Serverでセションを保持する上限数を、0〜2147483647の整数値で指定します。デフォルト値は、0です。0を指定した場合、上限はなくなります。
  　
• clean.interval : 期限切れセションの監視間隔
  　タイムアウトしたセションの監視の間隔(秒)を、30〜2147483647の整数値で指定します。デフォルト値は、60です。
  　
• session.store : セションの永続化
  　Session Registry Serverがセションの永続化(ファイルに保管)を行うかどうかを、以下から選択します。大文字・小文字は区別しません。
  　クラスタサービス機能を利用する場合は、必ず“on”を選択してください。
  • on : 有効
  • off: 無効・・・デフォルト値
    　
• serialize.file.path : セションの永続化ファイルの保存先
  　セション情報の永続化ファイルの保存先ディレクトリを指定します。
  　session.storeでonを指定した場合は必須です。指定値については、以下に注意してください。
  　
  • パス長は、1〜860バイトである必要があります。相対パスを指定した場合、絶対パスに変換した長さが上限以内となるようにしてください。
    例:Interstageのインストールディレクトリ、J2EE共通ディレクトリがデフォルト“/opt/FJSVj2ee/var/deployment”、Session Registry Server名が“SRSV01”の場合、相対パスでは798文字まで指定可能です。
    　
  • クラスタサービス機能を利用する時は、各ノードから利用できる共有ディスクのパスを指定してください。
    　
  • 存在しないディレクトリの場合は起動時にエラーとなり、運用できません。
    　
  • Session Registry Serverをroot権限のあるユーザ以外で運用する場合、指定したディレクトリにそのユーザでの全権限がある必要があります。必要に応じてオーナや権限を変更してください。
    　
  • 本定義で指定したディレクトリ配下にサブディレクトリ“sessionrecovery”が生成され利用されます。
    相対パスを指定した場合、Session Registry Serverを配備したディレクトリからのパスとなります。初期値“serializedata”は相対パスですので、この場合、以下となります。

    [J2EE共通ディレクトリ]/ijserver/[Session Registry Server名]/apps/srs.ear/srs.war/serializedata

    例:J2EE共通ディレクトリがデフォルト、Session Registry Server名が“SRSV01”の場合

    /opt/FJSVj2ee/var/deployment/ijserver/SRSV01/apps/srs.ear/srs.war/serializedata

• serialize.interval : セションを永続化する間隔
  　セションを永続化する間隔(秒)を、1〜2147483647の整数値で指定します。デフォルト値は、60です。
  　
• pop.timeout : 最新セション取得待ち時間
  　最新セション取得待ち時間(秒)を、1〜86400の整数値で指定します。デフォルト値は、360です。
  　セションのリカバリ時、もともとセションを保持していたコンテナから最新のセションの取得を行いますが、このときの最大待ち時間です。
  　セションがリクエスト処理中で使用されている場合の待ち時間です。待ち時間をオーバーしてもセション使用中の場合、該当のセションはリカバリされません。
  　タイムアウト値については、“各タイムアウト値の設定について”を参照してください。
  　
• access_log : アクセスログを出力する
  　アクセスログの出力の有効無効を、以下から選択します。大文字・小文字は区別しません。
  　アクセスログには、バックアップやリカバリ、生存監視の通信の詳細ログを出力します。
  • on : 出力する
  • off: 出力しない・・・デフォルト値
    　

◆注意事項

• Session Registry Server環境定義ファイルに2バイトコードを記載する場合(コメントやserialize.file.pathなど)、UTF-8で記載してください。
• Session Registry Server環境定義ファイルには、定義内容に記載していないタグもありますが、それらは更新・削除しないでください。