Interstage Application Server/Interstage Web 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〜90文字

  

  1〜860文字

  　相対パスの場合、Session Registry Serverを配備したディレクトリからのパスに置き換えられます。相対パスを指定する場合は、絶対パスに置き換えたときに上限の長さ以内となるようにしてください。
  　本項目が初期値“serializedata”(相対パス)で、InterstageのインストールディレクトリやIJServerディレクトリがデフォルト、Session Registry Server名が“SRS001”の場合、以下のようになります。

  

  C:\Interstage\J2EE\var\deployment\ijserver\SRS001\apps\srs.ear\srs.war\serializedata
  同じ条件で本項目を指定する場合、19文字まで指定可能です。

  

  /opt/FJSVj2ee/var/deployment/ijserver/SRS001/apps/srs.ear/srs.war/serializedata
  同じ条件で本項目を指定する場合、798文字まで指定可能です。

  　本定義で指定したディレクトリ配下にサブディレクトリ“sessionrecovery”が生成され利用されます。
  　指定値については、以下に注意してください。

  • 存在しないディレクトリの場合は起動時にエラーとなり、運用できません。
  • クラスタサービス機能を利用する時は、各ノードから利用できる共有ディスクのパスを指定してください。
  • 
    ネットワークドライブやUNCパスは指定できません。
  • 
    Session Registry Serverをroot権限のあるユーザ以外で運用する場合、指定したディレクトリにそのユーザでの全権限がある必要があります。必要に応じてオーナや権限を変更してください。
• 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環境定義ファイルには、定義内容に記載していないタグもありますが、それらは更新・削除しないでください。