カスタマイズ事例 （ウィジェット、セキュリティ・SSO、運用自動化と監視） ウチダスペクトラム株式会社 Product Management Office ©2013 Uchida Spectrum, Inc. All rights reserved. 1 SMART/InSight G2 SMART/InSightで過去に実施したカスタマイズや運用を自動化する際の注意事 項および必要な監視項目について、解説します。 設定変更によるカスタマイズ コード変更によるカスタマイズ 運用自動化と監視 ©2013 Uchida Spectrum, Inc. All rights reserved. 2 設定変更によるカスタマイズ ウィジェットの基本設定は、InSightConfig_Local.xmlに記載されており、コード の変更なしに動作を変更できるものがあります。 以下に代表的な例を記載します。 検索結果ウィジェットのカスタマイズ マスタブラウザのカスタマイズ クロスタブのカスタマイズ 時系列のカスタマイズ ナビゲータのカスタマイズ ヘッダの変更 SMART/InSight 導入設定ガイドの「10.カスタマイズ」に詳細が記載されています。 ©2013 Uchida Spectrum, Inc. All rights reserved. 3 ウィジェットカスタイズ ウィジェットの設定変更は、InSightConfig_Local.xmlを編集する ことで行います。 ウィジェットは、/components/componentに定義されています。 ウィジェット定義ID、JavaScriptクラス ウィジェット拡張属性定義 ウィジェット定義 ©2013 Uchida Spectrum, Inc. All rights reserved. 属性値 内容 minHeight ウィジェットの最小の高さをピクセルで 指定 maxHeight ウィジェットの最大の高さをピクセルで 指定。autoが指定された場合は、 ウィジェット内の描画に合わせて高さを 調整します。 4 設定変更によるカスタマイズ 【検索結果ウィジェットのカスタマイズ】 ナレッジメタデータバーの非表示 InSightConfig_Local.xml mode属性の設定を空にして、 hide_metadata属性をtrueに設定 表示するフィールドの変更 WEB-INF/tld/tags/widget/simplesr/document.tagを変更する。 コンテンツセットに登録されているfieldIDは document.<fieldID>で参照可能。 データチェインが設定しているフィールドの場 合は、検索も可能。 ©2013 Uchida Spectrum, Inc. All rights reserved. 5 設定変更によるカスタマイズ 【マスタブラウザのカスタマイズ】 InSightConfig_Local.xml 非表示のマスターの指定 属性値 内容 excludeMaster マスタブラウザで表示しないマスターのデータモデル名を指定します。 検索モードの設定（startWith,Exact,datachain) 属性値 内容 searchMode マスターブラウザで検索する時の検索タイプを指定します。 検索タイプ 内容 startWith IDを前方一致で検索します。階層構造を持ったID体系の場合に使用します。 exact IDを完全一致で検索します。 datachain フィールドのデータチェイン先として指定しているコンテンツセットに対して検索を行います。 ©2013 Uchida Spectrum, Inc. All rights reserved. 6 設定変更によるカスタマイズ 【クロスタブのカスタマイズ】 行・列の最大表示件数 InSightConfig_Local.xml 最大列数の指定 (maximumColumns) 最大行数の指定 (maximumRows) 表示項目のソート順 sortbyAttribute sortbyOrder ソートタイプ 内容 ソートタイプ 内容 name 文字列順でソート acending 昇順 count 件数順でソート deacending 降順 none ソートしない（検索エンジンからの戻り順） ©2013 Uchida Spectrum, Inc. All rights reserved. 7 設定変更によるカスタマイズ 【時系列のカスタマイズ】 InSightConfig_Local.xml スケール選択時の使用フィールドの変更 (スケール) 年 ファセットの件数を取得 年月 201304 時系列グラフの横軸となる日付型を設定 2013/4/23 コピー ©2013 Uchida Spectrum, Inc. All rights reserved. tsdatetime 2013/4/23 2013 tsyyyymm/tsyyyymmnav 年月日 PurchaseDate(購入日付) tsyyyy/tsyyyynav tsyyyymmdd/tsyyyymmddnav 分割 20130423 8 設定変更によるカスタマイズ 【ナビゲータのカスタマイズ】 InSightConfig_Local.xml 表示順の指定 sortbyAttribute ソートタイプ 内容 name 文字列順でソート count 件数順でソート none ソートしない（検索エンジンからの戻り順） sortbyOrder ソートタイプ 内容 acending 昇順 deacending 降順 ©2013 Uchida Spectrum, Inc. All rights reserved. 9 設定変更によるカスタマイズ 【ヘッダの変更】 共通のヘッダに特定のリンクを付与します。 メイン画面表示用 ©2013 Uchida Spectrum, Inc. All rights reserved. WEB-INF\jsp\core\Mainframe.jsp 10 フェデレートサーチ 検索結果を表示するウィジェットでコンテンツセットを特定することができます。 通常は、ウィジェットはページ作成時に指定したコンテンツセットの検索結果を表示しま すが、コンテンツセットをもったウィジェットをページに配置することで、ひとつの検索で 複数のコンテンツセットの検索を同時に行うことができます。 検索 A コンテンツセット C コンテンツセット B コンテンツセット D コンテンツセット 更新 ©2013 Uchida Spectrum, Inc. All rights reserved. 11 フェデレートサーチ ウィジェットとコンテンツセットを結びつけるには、InSightConfig_Local.xmlにあるウィ ジェットのbamidパラメータにコンテンツセットIDを設定します。 InSightConfig_Local.xml ウィジェットの追加 設定したコンテンツセット用のウィ ジェットとして表示されます。 ©2013 Uchida Spectrum, Inc. All rights reserved. 12 設定変更によるカスタマイズ ウィジェットのパラメータを変更すると、すべてのウィジェットに影響を与えます。 異なるパラメータをもったウィジェットを作成するには、ウィジェットのコピーが必要で す。 コピーする componentDefIdを一意な識別子に変更する ©2013 Uchida Spectrum, Inc. All rights reserved. 13 ウィジェットのカスタマイズ事例 【要件】 ２軸のパラメータを指定させ、データの分布の傾向を表示したい。 【実現手段】 検索結果から、縦軸と横軸のデータを取得して、散布図として描画する。 年式年代 重量 燃費 1990 1503 23 2000 2512 34 2010 1533 22 1990 2700 44 2000 2200 33 2000 1800 21 1990 1954 28 1990 1612 30 ; ; ; データを Indexに投入 ©2013 Uchida Spectrum, Inc. All rights reserved. Index 検索してデータを取得 14 ウィジェットのカスタマイズ事例 【要件】 サーチオプションのようにフィールドを一つずつの指定ではなく、複数のフィールドの組合せで 検索を行いたい。 【実現手段】 専用の入力フォームをもったウィジェットを新規開発した。 複数のフィールドの組み合わせによるAND/ORの条件をサーチオプション で表すのは難しいため、専用のウィジェットを開発することが必要 ©2013 Uchida Spectrum, Inc. All rights reserved. 15 ウィジェットのカスタマイズ事例 【要件】 ページに表示しているグラフをまとめてレポートとして出力したい。 【実現手段】 現在ページに表示しているグラフを、PDFに貼り付けてダウンロード可能にした。 ○○○○(Graph1) ○○○○(Graph1) T1コード(Graph2) T2コード(Graph2) ○○○○(Graph3) ©2013 Uchida Spectrum, Inc. All rights reserved. 16 ウィジェットのカスタマイズ事例 【要件】 表示しているグラフに付加情報を重ねあわせて表示させたい。 たとえば、時系列ウィジェットの日付のグラフにイベント情報を同時に表示。 【実現手段】 ナビゲータや時系列ウィジェットでグラフを生成したあとに、付加情報の検索をおこないグラフ イメージ上に文字の重ね合わせをおこなった。 日付 原因部位 2004/1/22 ブレーキ 2004/1/23 ペダル 2005/2/2 ブレーキ 2010/3/6 アクセル 2004/11/1 ペダル 2002/5/14 アクセル 2001/7/3 ギア 2003/10/5 パネル ; G2.5から使用しているグラフ では、異なるグラフの重ね合 わせも可能 イベント情報の重ねあわせ グラフ表示 ; ©2013 Uchida Spectrum, Inc. All rights reserved. イベントID 日付 1 2004/1/22 2 2004/1/23 3 2005/2/2 17 ウィジェットのカスタマイズ 【要件】 ファイルサーバーの検索で、ユーザーにダウンロード先（サーバー名、共有名）を見せたく ない。 ネットワーク構成上、ユーザーから共有フォルダに直接参照することができない 【実現手段】 ファイルをダウンロードするアクションを追加し、InSight経由でファイルをクライアントに送信す る機能を追加。 ① ダウンロードのリクエストを受付 ② 代理でファイルサーバーにアクセス （※ファイルサーバーへのアクセス権が必要） ③ 取得者がアクセス可能(ACL)かのチェック ④ ストリーミングでクライアントに送信する。 ① 検索 ② ファイルのダウンロード 直接の参照は不可 ©2013 Uchida Spectrum, Inc. All rights reserved. 18 セキュリティ 【要件】 データベースのデータを対象にして、ログインしているユーザーが所属するグループによって、表示 するコンテンツを制御したい。 【実現手段】 InSightでは、データのセキュリティで以下の制御が可能です。 • • • ACL（ファイルサーバーの場合） コンテンツタイプ コンテンツセット userA コンテンツセット１ コンテンツセット２ コンテンツタイプ１ コンテンツタイプ１ コンテンツタイプ３ コンテンツタイプ２ コンテンツタイプ４ userB コンテンツセットやコンテンツタイプで制御ができない場合は、検索時に強制的に条件を 付与することで、フィルタを掛けることも可能です。 フィルタの追加： 所属するグループの取得 フィルタ条件の追加 他システム セキュリティ情報 Search Filter Pipeline 検索 権限レベルの取得 ©2013 Uchida Spectrum, Inc. All rights reserved. 19 userC シングルサインオン 【要件】 既存のアプリケーションから再ログイン無しで連携したい。 InSightでの認証ではなく、ユーザーで構築されている認証基盤を利用した認証を行いたい。 【実装パターン】 ＃ 要件概要 1 お客様の認証機構で認証後、認証機構で付与されるリクエストヘッダの項目をもとにG2へのログインを 行う。 2 お客様の認証機構で認証後、認証機構でCookieに付与される項目をもとにG2へのログインを行う。 3 お客様の認証機構で認証後にリクエストヘッダに付与される項目をもとにG2へのログインを行い、さらに 認証ユーザーの権限情報を格納したDBのデータを参照してG2側でも適切な実行権限を付与。 4 お客様の既存アプリケーションから検索を行い、その際の検索条件を保持してSSOでログインし、その 後検索を実行。 【構成例】 認証サーバー Other System InSight、もしくは他アプリケー ションで認証をおこない、それぞれ の連携で認証情報の引き継ぎ ©2013 Uchida Spectrum, Inc. All rights reserved. 認証 ①代理アクセス ② 認証情報の引き継ぎ 20 運用自動化と監視 【運用自動化】 SMART/InSightを運用を自動化する際の代表的なメンテナンスポイントを以 下に記します。これらをメンテナンス処理を定期的に実行します。 • • • • バックアップ ログの削除 サーチヒストリ削除 ナレッジセンターログの削除 【監視】 SMART/InSightを継続的に動作させるために、システムの監視を運用する必要 があります。これは、通常のOSレベルでの監視（CPU、メモリ、ディスク容量）に 加えて、以下の様な監視をおこなうことで、エラーの早期検出をおこなうことができま す。 • プロセスの死活監視 • エラー監視 ©2013 Uchida Spectrum, Inc. All rights reserved. 21 バックアップ ハードウェア等の障害発生時にリカバリを行うために、定期的なバック アップを検討します。 ここでは、SMART/InSightのバックアップで必要な項目を解説しま す。 • • • • アプリケーションフォルダ データベース ログファイル ナレッジセンター（KC_Log/KC_Content) ©2013 Uchida Spectrum, Inc. All rights reserved. 22 バックアップ ※バックアップの前に、Tomcatの停止をおこなう。 【アプリケーションフォルダ】 [Tomcatインストールフォルダ]\webapps\<InsightG2> をTomcatディレ クトリ以外の場所にコピー 【データベース】 InSightで使用しているデータベースのバックアップをおこなう。 MySQLの場合のサンプル： バックアップ：mysqldump –u root –p g2 > c:\g2.sql 【ログファイル】 [Tomcatインストールフォルダ]\log をTomcatディレクトリ以外の場所にコピー ※ InSightログは、デフォルトでは、\logファイルの直下です。 Log4j.xmlで設定することで、場所を変更することが可能です。 ©2013 Uchida Spectrum, Inc. All rights reserved. 23 バックアップ 【ナレッジセンター】 種別 内容 KC_log ユーザーの操作（検索、ダウンロードなど）の履歴を保存。 検索キーワードやドキュメントのレコメンドに使用。 KC_Contents ナレッジメタデータ（ドキュメントに対するタグやコメントなどの付加情 報）の付与を行ったドキュメントを格納。 KC_Log KCは、InSight専用のSolrインデックスに 格納されている。 InSightConfig_Local.xml KC_Contents 上記フォルダのバックアップを行う。 ※バックアップの前に、Tomcatの停止をおこなう。 ©2013 Uchida Spectrum, Inc. All rights reserved. 24 ログファイルの削除 InSightのログは、規定では、 [Tomcatインストールフォル ダ]\logに格納されます。デフォルトの設定（log4j）では、日単位 でログファイルは切り替われます。 過去のログは、不要の場合は削除することでディスク容量を軽減出来 ます。 ある一定期間経過したログの削除 ©2013 Uchida Spectrum, Inc. All rights reserved. 25 ナレッジセンター ログの削除 ナレッジセンターは、InSightで実行された検索やファイルのダウンロードなどのすべて の操作が記録されます。 これは、InSight内部にあるSolrにインデックスとして格納されます。 検索 ダウンロード タグ付け etc 記録 ナレッジセンター ある特定の期間より古いナレッジログを自動的に削除して、インデックスのディスク容量を軽減す ることができます。また、インデックスの肥大化を防ぐために、定期的なオプティマイズを実行する ことをお薦めします。 InSightConfig_Local.xml ©2013 Uchida Spectrum, Inc. All rights reserved. 26 サーチヒストリ削除 検索を行うと、検索履歴としてフィールドごとに使用したきワードが、個 人スペースに記録されます。 この履歴情報は、InSightのDB上に保存されるため、必要に応 じて削除の検討が必要になる。 t_search_keyword フィールド名 内容 field_value 検索文字列 business_action_id コンテンツセット（BAM)ID action_field_id フィールドID last_run_date 最終検索実行日時 以下の様なSQLを定期的に実行するエージェントを配置 例： delete from t_search_history where last_run_date < (now() - interval 12 month) ※ヒストリに保存しない設定も可能です。詳細は、導入設定ガイドに記載しています。 「15.4.3 サーチヒストリを利用しない場合」を参照ください。 ©2013 Uchida Spectrum, Inc. All rights reserved. 27 監視 【Javaプロセス監視】 OSのリソース（CPU、メモリ、ディスク容量）の監視に加えて、 Javaプロセスの使用メモリ、CPU使用率の確認 【利用メモリ増加の主な要因】 マスターキャッシュ 使用する言語の数に応じて、キャッシュに要するメモリ使用量は増大します。キャッシュの設定 の解除、言語の選択 ナレッジセンターインデックス 不要なログの削除、オプティマイズの実行 【機能監視】 外部からInSightのアクションを呼び出して、検索が正しく行わ れているかを確認する（要カスタマイズ） LWSのSolr Adminを使用してLWSの検索機能を確認することも可能 ©2013 Uchida Spectrum, Inc. All rights reserved. 28 エラー監視 InSightでは、エラーが発生した場合は、ログにエラーが出力されます。 運用時にエラー監視をおこなうには、以下のファイルの更新日を確認 します。 [Tomcatインストールフォルダ]\log 種別 内容 Insight_fatal.log システムの継続ができないなどの致命的なエラーが発生した場合 に出力されます。 Insight_error.log システムは継続して利用することができるが、一部の機能が正常 に動作していない場合に出力します。（バッチのエラーやウィジェッ トのエラー、一部のコンテンツセットでの検索エラーなど） デフォルトの設定では、導入時のエラーの確認をおこなうために、エラーレベルは、 「INFO」になっています。 運用を開始後は、「WARNING」もしくは、「ERROR」レベルに変更することを推奨 します。 ©2013 Uchida Spectrum, Inc. All rights reserved. 29 ご清聴いただき、ありがとうございました。 ©2013 Uchida Spectrum, Inc. All rights reserved. 30
© Copyright 2024 ExpyDoc
