WEA5.0 用 KDDI BBP サポート・パッケージ
バージョン 1.0
インストールと構成に関する README

目次

  • はじめに
  • 用語について
  • パッケージの内容
    •
  • インストールと構成
  • BBP 用 JSP テンプレートのインストール手順
  • オフライン・ブラウジング用サーブレットのインストール手順
  • オフライン・フォーム用データベースのインストール手順
    •
  • 運用時に必要な設定等
  • BBP 端末に必要な設定
  • オフライン・フォーム用データベースのメンテナンスについて
  • オフライン・ブラウジング用サーブレットの設定
  • WEA の設定に関するヒント
  • BBP 端末に表示されるポートレット名を変更するには？
    •
  • 商標
    •

    はじめに

    この README は、IBM WebSphere Everyplace Access (WEA) version 5.0 のオフライン・ブラウジング機能および オフライン・フォーム機能を KDDI BREW Business Profile (BBP) 端末から利用できるようにするための追加パッケージの インストールと構成方法について説明しています。 WebSphere Application Server (WAS) および WebSphere Portal (WP) の基本的な使い方については理解されていることを前提とします。

    用語について

    本 README 中では以下の用語を使用します。

    WAS
    WebSphere Application Server
    WP
    WebSphere Portal
    WEA
    WebSphere Everyplace Access
    BBP
    BREW Business Profile

    パッケージの内容

    本パッケージの内容物は以下のとおりです。

    doc/readme_ja.htmlREADME
    agg_bbp50_PortalServer.zipBBP 用 JSP テンプレート その１
    agg_bbp50_wps.war.zipBBP 用 JSP テンプレート その２
    webcache_bbp.earオフライン・ブラウジング用サーブレット
    db/dbBBP.batWindows用オフライン・フォーム用データベースの管理のための簡易ユーティリティー
    db/setupOfflineBBP.cmd
    db/listOfflineBBP.cmd
    db/deleteOfflineBBP.cmd
    db/createTablesBBP.ddl
    db/dropTablesBBP.ddl
    db/dbBBPTool.tarAIX用オフライン・フォーム用データベースの管理のための簡易ユーティリティー

    インストールと構成

    導入および構成手順：

    1. オフライン・ブラウジングの機能をインストールする。

      WEA のコンソールに管理者でログインして、「オフライン・ブラウズの管理ポートレット」が表示されているか確認してください。 表示されていない場合は、オフライン・ブラウジングの機能はインストールされていません。 基本インストールでWEAをインストールした場合には、オフライン・ブラウジングの機能はインストールされていません。 以下の手順でオフライン・ブラウジングの機能をインストールください。

      1. 以下のディレクトリにある、「EASInstallConfig.properties」が導入する環境に合っていることを確認する。

        • Windows
          C:\Program Files\WebSphere\EAS\config

        • AIX
          /usr/WebSphere/EAS/config

      2. WAS/WPSが起動されていることを確認する。

      3. コマンドラインより、

        • Windows
          EASWASconfig.bat eas-basic-config

        • AIX
          ./EASWASconfig.sh eas-basic-config

        を実行し、オフライン・ブラウジングの機能をインストールする。

      4. WAS/WPS/WEAを再起動する。

    2. BBP 用 JSP テンプレートをインストールする。
      (後述の「BBP 用 JSP テンプレートのインストール手順」をご参照ください。)

    3. オフライン・ブラウジング用サーブレットをインストールする。
      (後述の「オフライン・ブラウジング用サーブレットのインストール手順」をご参照ください。)

    4. オフライン・フォーム用データベースをインストールする。
      (後述の「オフライン・フォーム用データベースのインストール手順」をご参照ください。)

    5. WEA が起動されていることを確認し、もし起動されていなければ起動する。

    6. WEA のコンソールに管理者としてログインする。

    7. BBP 用マークアップ設定を追加する。

      1. 「マイ・ポータル」から「管理」を選択する。

      2. 「ポータルの設定」の「サポートされるマークアップ」を選択する。

      3. 「新規マークアップの追加」を選択し、以下のように設定する。

        マークアップ名：
        brew
        MIMEタイプ：
        text/html
        デフォルト文字セット：
        UTF-8

      4. 「OK」をクリックする。

      5. 「選択されたマークアップの編集」をクリックする。

      6. 「ロケール固有設定値の設定」をクリックする。

      7. 「日本語」を選択し、「選択された言語に関する設定値の編集」クリックし、以下のように設定する。

        文字セット：
        Shift_JIS

      8. 「OK」をクリックする。

      9. 「OK」をクリックする。

      10. アクティブにする。

    8. BBP 用クライアント設定を追加する。

      1. 「マイ・ポータル」から「管理」を選択する。

      2. 「ポータルの設定」の「サポートされるクライアント」を選択する。

      3. 「新規クライアントの追加」を選択し、以下のように設定する。

        ユーザー・エージェント：
        .*brew.*
        マークアップ：
        brew
        マークアップ・バージョン：
        <空白>
        位置：
        次の後 .*offline.*

      4. 「OK」ボタンをクリックする。

      5. 再度、「新規クライアントの追加」を選択し、以下のように設定する。

        ユーザー・エージェント：
        .*brew.*offline.*
        マークアップ：
        brew
        マークアップ・バージョン：
        offline
        位置：
        先頭

      6. 「OK」ボタンをクリックする。

    9. 「オフライン・ブラウジング」ポートレットの設定する。

      1. 「マイ・ポータル」から「管理」を選択する。

      2. 「WebSphere EveryPlace」を選択し、「オフライン・ブラウズ」を選択する。

      3. 「オフライン・ブラウズ」ポートレットにおいて以下のように設定する。

      4. オフラインで使用するポートレットの「オフライン表示の使用可能化 」をチェックする。

      5. ページ右上の「構成」アイコン(スパナのアイコン)をクリックし、以下のように設定する。

        URL：
        http://<HostName>/wps/myportal
        リンクをたどるデフォルトの深さ：
        5

      6. 「保管」をクリックする。

      7. 「OK」をクリックする。

    10. WEA コンソールからログオフする。

    11. PNG イメージを使用可能にするための設定をする。

      1. WAS の管理コンソールを起動する。

      2. ナビゲーション・ツリーで「環境」を選択する。

      3. ナビゲーション・ツリーで「仮想ホスト」を選択する。

      4. 「default_host」を選択する。

      5. 「MIME_TYPE」を選択する。

      6. 「新規」ボタンを押す。

      7. 以下のように設定する。

        8. MIMEタイプ:
        image/png
        拡張子:
        PNG png

      8. 「適用」ボタンをを押す。

      9. 「OK」ボタンをを押す。

      10. 「保管」をクリックする。

      11. 「保管」ボタンを押す。

    12. WAS を再起動する。

    13. マイポータルからポートレットを配置するページまで、すべてbrewのマークアップをEnableする

      1. 「マイ・ポータル」から「管理」を選択する。

      2. 「ポータル・ユーザーインターフェース」を選択する。

      3. 「ページの管理」を選択する。

      4. 「マイ・ポータル」を選択する。

      5. 「ページ・プロパティの編集」アイコンをクリックして拡張オプションを展開する。

      6. brewのチェックボックスをチェックする

      7. ポートレットを配置するページまで、5,6の手順を繰り返す。

    この後、必要に応じて以下の作業を行なう。

    BBP 用 JSP テンプレートのインストール手順

    使用するモジュール：

    agg_bbp50_PortalServer.zip
    agg_bbp50_wps.war.zip

    インストール：

    1. agg_bbp50_PortalServer.zip を 以下のディレクトリから展開する。

      • Windows

        • C:\Program Files\WebSphere

      • AIX

        • /usr/WebSphere

    2. agg_bbp50_wps.zip を以下のディレクトリから展開する。

      • Windows

        • C:\Program files\WebSphere\AppServer\installedApps\[host name]\wps.ear

      • AIX

        • /usr/WebSphere/AppServer/installedApps/[host name]/wps.ear

    3. WAS を再起動する。

    アンインストール：

    1. 以下のファイルを削除する。

      • Windows

        • C:\Program Files\WebSphere\PortalServer\shared\app\nls\brew.properties
        C:\Program Files\WebSphere\PortalServer\shared\app\nls\brew_ja.properties

      • AIX

        • /usr/WebSphere/PortalServer/shared/app/nls/brew.properties
        /usr/WebSphere/PortalServer/shared/app/nls/brew_ja.properties

    2. 以下のディレクトリを削除する。

      • Windows

        • C:\Program Files\WebSphere\AppServer\installedApps\[host name]\wps.ear\wps.war\screens\brew
        C:\Program Files\WebSphere\AppServer\installedApps\[host name]\wps.ear\wps.war\themes\brew
        C:\Program Files\WebSphere\AppServer\installedApps\[host name]\wps.ear\wps.war\skins\brew

      • AIX

        • /usr/WebSphere/AppServer/installedApps/[host name]/wps.ear/wps.war/screens/brew
        /usr/WebSphere/AppServer/installedApps/[host name]/wps.ear/wps.war/themes/brew
        /usr/WebSphere/AppServer/installedApps/[host name]/wps.ear/wps.war/skins/brew

    3. WAS を再起動する。

    オフライン・ブラウジング用サーブレットのインストール手順

    使用するモジュール：

    webcache_bbp.ear

    インストール：

    1. WEA Server を停止する。

    2. WAS の管理コンソールを起動する。

    3. ナビゲーション・ツリーからアプリケーションを展開する。

    4. 新規アプリケーションのインストールを選択する。

    5. ローカルパスからwebcache_bbp.earを指定

    6. 「ステップ4 モジュールをアプリケーション・サーバーにマップ 」パネルが表示されるまで「次へ」ボタンをクリックしながら先へ進む。

    7. 「ステップ4 モジュールをアプリケーション・サーバーにマップ 」パネルにおいて、WebCacheBBPをチェックし、リストからWEA_Server を選択し 「適用」ボタンを押す。

    8. 「ステップ6 要約」パネルが表示されるまで「次へ」ボタンをクリックしながら先へ進む。

    9. 「ステップ6 要約」パネルにおいて、「終了」ボタンを押す。

    10. 「インストール中..」パネルにおいて、「マスター構成に保管」をクリックする。

    11. 「保管」パネルにおいて、「保管」ボタンをクリックする。

    12. WEA Server を起動する。

    13. ナビゲーション・ツリーで 環境 を展開し「Web サーバー・プラグインの更新」を選択、「OK」ボタンをクリックする。

    14. WAS を再起動する。

    アンインストール：

    1. WEA Server を停止する。

    2. ナビゲーション・ツリーからアプリケーションを展開する。

    3. 「エンタープライズ・アプリケーション」を選択する。

    4. webcache_bbp.war をチェックし、「アンインストール」ボタンを押す。

    5. 保管 をクリックする。

    6. 「保管」パネルにおいて、「保管」ボタンをクリックする。

    7. WEA Server を起動する。

    オフライン・フォーム用データベースのインストール手順

    使用するモジュール：

    Windows:
    db/dbBBP.bat
    db/setupOfflineBBP.cmd
    db/listOfflineBBP.cmd
    db/deleteOfflineBBP.cmd
    db/createTablesBBP.ddl
    db/dropTablesBBP.ddl


    AIX:
    db/dbBBPTool.tar

    インストール：

    • Windows

      コマンド・プロンプトで以下のコマンドを入力する。(AdminUserID と AdminPassword はそれぞれデータベースの管理者のユーザー ID とパスワード)

      dbBBP <AdminUserID> <AdminPassword> create


    • AIX

      • 以下の手順で、db2instance 環境をユーザーのプロファイルにエクスポートする。
        .profile ファイルで、以下を追加する。
        if [ -f /home/db2admin/sqllib/db2profile ]; then . /home/db2admin/sqllib/db2profile; fi
        ここで、db2admin は、ユーザーのデータベース・インスタンスを表す。

      • dbBBPTool.tarを展開する。
        tar xvf dbBBPTool.tar

      • 以下のコマンドを入力する。(AdminUserID と AdminPassword はそれぞれデータベースの管理者のユーザー ID とパスワード)
        cd dbBBPTool
        ./dbBBP.sh <AdminUserID> <AdminPassword> create

    アンインストール：

    • Windows
      コマンド・プロンプトで以下のコマンドを入力する。

      dbBBP <AdminUserID> <AdminPassword> drop


    • AIX
      db2instance 環境が設定されたターミナルで、以下のコマンドを入力する。(AdminUserID と AdminPassword はそれぞれデータベースの管理者のユーザー ID とパスワード)

      cd dbBBPTool
      ./dbBBP.sh <AdminUserID> <AdminPassword> drop

    運用時に必要な設定等

    BBP 端末に必要な設定

    オフライン・ブラウジング機能あるいはオフライン・フォーム機能を利用するには、BBP 端末から以下のサーバー URL にアクセスする必要があります。 BBP 端末に接続先として別の URL が設定・保存されている場合は、BBP 端末側で設定変更が必要です。

    http://<HostName>/WebCacheBBP/WebCacheBBP

    オフライン・フォーム用データベースのメンテナンスについて

    オフライン・フォーム用データベースには、BBP 端末から送信されたフォーム提出内容やサーバーによるフォーム処理結果等が格納されています。 このデータベースの内容は自動的には削除されませんので適当なタイミングごとにメンテナンスが必要になります。 このパッケージには、データベースの内容を参照・削除するための簡易コマンドライン・スクリプト (dbBBP) が用意されています。 使い方の詳細は、(Windows)dbBBP.bat/(AIX)dbBBP.sh をコマンド・プロンプトからパラメーターなしで起動した際に表示されるヘルプをご覧ください。

    オフライン・ブラウジング用サーブレットの設定

    オフライン・ブラウジング用サーブレットには、動作時の振る舞いを設定するためのいくつかの構成パラメーターが用意されています。 すべてのパラメーターは以下のファイルに記述されており、パラメーター変更後 WEA Server を再起動することにより変更が有効となります。 それぞれのパラメーターの詳細はファイル内の記述をご覧ください。

    • Windows
      C:\Program Files\WebSphere\AppServer\installedApps\<host name>\webcache_bbp.war.ear\webcache_bbp.war\WEB-INF\classes\com\ibm\pvc\webcachebbpOfflineFormsBBP.properties

    • AIX
      /usr/WebSphere/AppServer/installedApps/<host name>/webcache_bbp.war.ear/webcache_bbp.war/WEB-INF/classes/com/ibm/pvc/webcachebbpOfflineFormsBBP.properties

    AIXでの運用時の注意点

    AIX コンピューター上の WebSphere Application Server と DB2 の間には、共用メモリーの問題があります。 この問題によって、オフライン機能にアクセスが集中した場合、

    "データベースに接続できませんでした: [IBM][CLI Driver] SQL1224N。データベース・エージェントが、要求に対してサービスを提供するよう開始されない、または、データベース・システムのシャットダウンあるいは強制コマンドの結果、終了されました。"

    というExceptionが発生する場合があります。以下はWEA 5.0のInfoCenterからの引用です。

    AIX で WEA 用に DB2 を構成するには、以下の手順に従い、EXTSHMを使用して共用メモリー・セグメントの数を増やす必要があります。 コマンドを入力する前に、WebSphere Portal データベースを含むユーザー・インスタンスに切り替える必要があります。

    1. WebSphere Portal データベースを含むユーザー・インスタンスに切り替えます。 user_name変数は、WEA データベースをインストールするために使用するユーザー名 (db2inst1 など) を表します。 
      su - user_name
    2. /home/user_name ディレクトリーに移動し、.profile ファイルを開きます。
    3. 次の記述を .profile に追加します。 
      export EXTSHM=ON
    4. 変更を保存します。
    5. 次のコマンドを実行します。 
      db2set DB2ENVLIST=EXTSHM
    6. DB2 を停止します。

      db2stop

    7. DB2 を始動します。

      db2start

    注: WebSphere Application Serverを始動する前に DB2 プロファイルを実行する必要があります。

    また、技術情報SQL1224N - Shared Memory Segmentsも参照してください。

    WEA の設定に関するヒント

    BBP 端末に表示されるポートレット名を変更するには？

    1. WEA のコンソールに管理者としてログインする。
    2. 「マイ・ポータル」から「管理」を選択する。
    3. 「ポートレット」を選択し、「ポートレットの管理」を選択する。
    4. タイトルを変更したいポートレットをリストから選択する。
    5. 「パラメーターの変更」をクリックする。
    6. ロケールとタイトルを選択し、「選択されたロケールのタイトルの設定」をクリックする。
    7. タイトルを変更し、「OK」をクリックする。
    8. 「保管」をクリックする。

    商標

    以下は IBM Corporation の米国およびその他の国における商標です。

    IBM
    WebSphere
    Everyplace

    Java およびすべての Java 関連の商品およびロゴは、Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。

    Microsoft および Windowsは、Microsoft Corporationの米国およびその他の国における商標です。

    他の会社名、製品名およびサービス名等はそれぞれ各社の商標または登録商標です。

    © International Business Machines Corporation 2004. All rights reserved.