Interstage Shunsaku Data Manager コマンドリファレンス Windows/Solaris/Linux J2X1-1912-03Z0(01) 2008年6月 まえがき 本書の目的 本書は、Interstage Shunsaku Data Manager(以降、Shunsakuと略します)が提供するコマンドの機能、オプションおよび使 用例について説明しています。 本書の読者 本書は、以下の読者を対象としています。 ・ Shunsakuを利用して、システムを構築する人 ・ Shunsakuで構築した業務システムを運用管理する人 前提知識 本書を読む場合、以下の知識が必要です。 Solarisの場合 ・ Solaris(TM) オペレーティングシステムに関する知識 Linuxの場合 ・ Linuxに関する知識 Windowsの場合 ・ Windowsに関する知識 本書の構成 本書は以下の構成になっています。 第1章 コマンド一覧 Shunsakuのコマンドを機能別に説明しています。 第2章 サーバ共通のコマンド Shunsakuのすべてのサーバで実行可能なコマンドの詳細を説明しています。 第3章 conductor用コマンド Shunsakuのconductor用コマンドの詳細を説明しています。 第4章 director用コマンド Shunsakuのdirector用コマンドの詳細を説明しています。 第5章 sorter用コマンド Shunsakuのsorter用コマンドの詳細を説明しています。 第6章 searcher用コマンド Shunsakuのsearcher用コマンドの詳細を説明しています。 -i- 第7章 データベース連携用コマンド Shunsakuのデータベース連携用のコマンドの詳細を説明しています。 第8章 V6.0系のコマンド ShunsakuのV6.0系で提供していたコマンドの詳細を説明しています。 コマンドの記述形式 項目 説明 [] 省略できるオプションであることを示します。 例) [-n Shunsakuシステム名] [|] 選択肢が複数あり、省略できるオプションであることを示 します。 選択肢は、| で区切って表記しています。 例) [ -b | -e | -c ] {|} 選択肢が複数あり、選択肢のどれか1つを指定する必 要があることを示します。 選択肢は、| で区切って表記しています。 例) { -b | -e | -c } 出版年月および版数 平成19年 6月 初版 平成19年 8月 第2版 平成20年 6月 第3版 変更履歴 追加・変更内容 ポート番号の表示例を変更しました。 (例:33101→23101) 変更箇所 2.4 マニュアルコード J2X1-1912-03Z0(01) 著作権表示 Copyright 2007-2008 FUJITSU LIMITED - ii - 目 次 第1章 コマンド一覧....................................................................................................................................................................1 1.1 コマンド一覧(機能別)........................................................................................................................................................................1 1.2 コマンド一覧(サーバ別).....................................................................................................................................................................3 1.3 コマンド使用時の注意........................................................................................................................................................................5 第2章 サーバ共通のコマンド......................................................................................................................................................7 2.1 shunprtmsg...........................................................................................................................................................................................7 2.2 shunsyscfgedit......................................................................................................................................................................................8 2.3 shunsysstart..........................................................................................................................................................................................9 2.4 shunsysstate.......................................................................................................................................................................................10 2.5 shunsysstop........................................................................................................................................................................................14 第3章 conductor用コマンド......................................................................................................................................................16 3.1 shuncservice.......................................................................................................................................................................................16 3.2 shuncstate...........................................................................................................................................................................................17 3.3 shuncterm...........................................................................................................................................................................................25 第4章 director用コマンド..........................................................................................................................................................27 4.1 shundbackup......................................................................................................................................................................................27 4.2 shundcds.............................................................................................................................................................................................28 4.3 shundclear..........................................................................................................................................................................................29 4.4 shundexport........................................................................................................................................................................................30 4.5 shundimport.......................................................................................................................................................................................33 4.6 shundrecover......................................................................................................................................................................................35 4.7 shundresend.......................................................................................................................................................................................37 4.8 shundrestrict.......................................................................................................................................................................................39 4.9 shundservice.......................................................................................................................................................................................40 4.10 shundstate.........................................................................................................................................................................................41 第5章 sorter用コマンド.............................................................................................................................................................53 5.1 shunoservice.......................................................................................................................................................................................53 5.2 shunostate...........................................................................................................................................................................................54 第6章 searcher用コマンド........................................................................................................................................................59 6.1 shunsservice.......................................................................................................................................................................................59 6.2 shunsstate...........................................................................................................................................................................................60 第7章 データベース連携用コマンド...........................................................................................................................................65 7.1 shunrdb...............................................................................................................................................................................................65 第8章 V6.0系のコマンド...........................................................................................................................................................67 8.1 shunccfgedit.......................................................................................................................................................................................67 8.2 shuncstart...........................................................................................................................................................................................68 8.3 shuncstop...........................................................................................................................................................................................69 8.4 shundcfgedit.......................................................................................................................................................................................70 8.5 shundstart...........................................................................................................................................................................................71 8.6 shundstop...........................................................................................................................................................................................72 8.7 shunostart...........................................................................................................................................................................................73 8.8 shunostop...........................................................................................................................................................................................74 8.9 shunsstart...........................................................................................................................................................................................75 8.10 shunsstop..........................................................................................................................................................................................76 索引........................................................................................................................................................................................78 - iii - 第1章 コマンド一覧 Shunsakuの運用で使用するコマンドの一覧を、以下の分類で説明します。 ・ コマンド一覧(機能別) ・ コマンド一覧(サーバ別) 1.1 コマンド一覧(機能別) Shunsakuのコマンドを機能別に説明します。 Shunsakuのコマンドは、以下のように分類されます。 ・ セットアップ ・ 起動・停止 ・ 環境変更 ・ 運用 ・ バックアップ・リカバリ ・ モニタリング ・ コネクション ・ データベース連携 ・ メッセージ ・ V6.0系のコマンド セットアップ セットアップで利用するコマンドの一覧を以下に示します。 コマンド名 機能概要 shuncservice conductorをサービスに登録、またはサービスから削除します。 shundservice directorをサービスに登録、またはサービスから削除します。 shunoservice sorterをサービスに登録、またはサービスから削除します。 shunsservice searcherをサービスに登録、またはサービスから削除します。 起動・停止 起動・停止で利用するコマンドの一覧を以下に示します。 コマンド名 機能概要 shunsysstart Shunsakuを起動します。 shunsysstop Shunsakuを停止します。 -1- 環境変更 環境変更で利用するコマンドの一覧を以下に示します。 コマンド名 shunsyscfgedit 機能概要 Shunsakuの環境を動的に変更します。 運用 運用で利用するコマンドの一覧を以下に示します。 コマンド名 機能概要 shundcds ディレクタデータファイルを最適化します。 shundclear ディレクタデータおよびサーチデータを破棄します。 shundexport directorから検索用データを抽出し、テキストファイルに格納します。 shundimport テキストファイルまたは抽出データファイルからdirectorにXML文書 を取り込み、検索用データを作成します。 shundresend サーチデータを再配置します。 shundrestrict アプリケーションからdirectorに格納されているXML文書への操作の 抑止を設定します。 バックアップ・リカバリ バックアップ・リカバリで利用するコマンドの一覧を以下に示します。 コマンド名 機能概要 shundbackup ディレクタデータのバックアップ開始宣言または終了宣言をします。 shundrecover ディレクタデータのリカバリ開始宣言または終了宣言、およびオペ レーションログファイルのリカバリをします。 モニタリング モニタリングで利用するコマンドの一覧を以下に示します。 コマンド名 機能概要 shuncstate conductorおよびコネクションの状態を表示します。 shundstate directorの状態を表示します。 shunostate sorterの状態を表示します。 searcherの状態を表示します。 shunsstate shunsysstate Shunsakuのプロセス構成情報を表示します。 コネクション コネクションの操作で利用するコマンドの一覧を以下に示します。 コマンド名 shuncterm 機能概要 コネクションを強制的に切断し、コネクション資源を回収します。 -2- データベース連携 データベースとの連携で利用するコマンドの一覧を以下に示します。 コマンド名 shunrdb 機能概要 Symfowareデータベースから抽出データファイルを作成します。 メッセージ メッセージの操作で利用するコマンドを以下に示します。 コマンド名 shunprtmsg 機能概要 メッセージ番号の説明を表示します。 V6.0系のコマンド V6.0系で提供していたコマンドの一覧を以下に示します。 最新のバージョンでは不要なコマンドですが、V6.0系と同様に利用することができます。 コマンド名 機能概要 shunccfgedit conductor環境を動的に変更します。 shuncstart conductorを起動します。 shuncstop conductorを停止します。 shundcfgedit director環境を動的に変更します。 shundstart directorを起動します。 shundstop directorを停止します。 shunostart sorterを起動します。 shunostop sorterを停止します。 searcherを起動します。 shunsstart searcherを停止します。 shunsstop 1.2 コマンド一覧(サーバ別) Shunsakuが提供するコマンドを、実行可能なサーバごとに説明します。 Shunsakuのコマンドは、以下のように分類されます。 ・ サーバ共通のコマンド ・ conductor用コマンド ・ director用コマンド ・ sorter用コマンド ・ searcher用コマンド ・ データベース連携用コマンド -3- サーバ共通のコマンド サーバ共通のコマンドの一覧を以下に示します。 conductor、director、sorter、またはsearcherが存在するサーバで実行することができます。 コマンド名 機能概要 shunprtmsg メッセージ番号の説明を表示します。 shunsyscfgedit Shunsakuの環境を動的に変更します。 shunsysstart Shunsakuを起動します。 shunsysstate Shunsakuのプロセス構成情報を表示します。 shunsysstop Shunsakuを停止します。 conductor用コマンド conductor用コマンドの一覧を以下に示します。 conductorが存在するサーバで実行することができます。 コマンド名 機能概要 conductorをサービスに登録、またはサービスから削除します。 shuncservice shuncstate conductorおよびコネクションの状態を表示します。 shuncterm コネクションを強制的に切断し、コネクション資源を回収します。 director用コマンド director用コマンドの一覧を以下に示します。 directorが存在するサーバで実行することができます。 コマンド名 機能概要 shundbackup ディレクタデータのバックアップ開始宣言または終了宣言をします。 shundcds ディレクタデータファイルを最適化します。 shundclear ディレクタデータおよびサーチデータを破棄します。 shundexport directorから検索用データを抽出し、テキストファイルに格納します。 shundimport テキストファイルまたは抽出データファイルからdirectorにXML文書 を取り込み、検索用データを作成します。 shundrecover ディレクタデータのリカバリ開始宣言または終了宣言、およびオペ レーションログファイルのリカバリをします。 shundresend サーチデータを再配置します。 shundrestrict アプリケーションからdirectorに格納されているXML文書への操作の 抑止を設定します。 directorをサービスに登録、またはサービスから削除します。 shundservice shundstate directorの状態を表示します。 -4- sorter用コマンド sorter用コマンドの一覧を以下に示します。 sorterが存在するサーバで実行することができます。 コマンド名 機能概要 sorterをサービスに登録、またはサービスから削除します。 shunoservice shunostate sorterの状態を表示します。 searcher用コマンド searcher用コマンドの一覧を以下に示します。 searcherが存在するサーバで実行することができます。 コマンド名 機能概要 searcherをサービスに登録、またはサービスから削除します。 shunsservice searcherの状態を表示します。 shunsstate データベース連携用コマンド データベース連携用コマンドの一覧を以下に示します。 データベース連携用コマンドが存在するサーバで実行することができます。 コマンド名 shunrdb 機能概要 Symfowareデータベースから抽出データファイルを作成します。 1.3 コマンド使用時の注意 Shunsakuが提供するコマンドの使用時の注意について示します。 競合関係 コマンドとアプリケーションおよびコマンドとの競合関係については“導入・運用ガイド”の“競合関係”を参照してくださ い。 実行時の注意 Shunsakuのコマンドは、スーパーユーザーのみ実行可能です。 Shunsakuのコマンドは、“Administrators”グループに属するユーザのみ実行可能です。 Windows Server 2008の場合は以下の注意が必要です。 -5- 使用するユーザがビルトインアカウントの“Administrator”以外の場合、本書で記載している“Administrators”グループに 属するユーザのみ実行可能なコマンドは、管理者のコマンドプロンプトから実行してください。 以下に管理者のコマンドプロンプトの起動方法を示します。 1. [スタート]ボタンをクリックし、[すべてのプログラム](注)の[アクセサリ]の[コマンドプロンプト]を選択し右クリックしま す。 注)クラシック[スタート]メニューの場合は、[プログラム]になります。 2. コンテキストメニューから[管理者として実行]をクリックします。 3. ユーザーアカウント制御のダイアログボックスで[続行]をクリックします。 CSVの形式 shuncstateコマンドなど、状態表示系のコマンドの結果をCSV形式で出力する場合、出力されるCSVの形式は、以下にな ります。 ・ 表示項目は、“,”(カンマ)で区切られます。 ・ 値が文字列の場合、二重引用符(")で括られます。 数値項目は、二重引用符(")で括られません。 文字列中に二重引用符(")がある場合は、二重引用符(")を2回繰り返して出力します。 ・ 表示する情報がない項目は、値なしとして表示されます。 例:A,,,B, オプションの拡張 モニタリングで利用する以下のコマンドのeオプションで表示される情報は、今後、バージョンレベルが上がることに情報 が追加される場合があります。 ・ shuncstate ・ shundstate ・ shunostate ・ shunsstate ・ shunsysstate -6- 第2章 サーバ共通のコマンド サーバ共通のコマンドの詳細を説明します。 2.1 shunprtmsg 名前 shunprtmsg -- メッセージの説明の表示 形式 shunprtmsg -shn [ メッセージ番号 ] 機能説明 指定されたメッセージの説明を表示します。 オプション -shn Shunsakuが出力したメッセージに対する説明を表示する場合に指定します。 メッセージ番号 メッセージの番号を指定します。 番号は出力されたメッセージの数字部分が対象となります。 たとえば、shn22000iの場合には“22000”がメッセージ番号となります。 メッセージ番号が省略された場合には、すべてのメッセージが対象となります。 使用例 例 “shn22000i”のメッセージに対する説明を表示します。 shunprtmsg -shn 22000 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 -7- 2.2 shunsyscfgedit 名前 shunsyscfgedit -- Shunsakuの動作環境の動的な変更 形式 shunsyscfgedit [ -n Shunsakuシステム名 ] 機能説明 Shunsakuの環境を動的に変更します。 変更可能な操作を以下に示します。 ・ searcherの追加 ・ 代替searcherの追加 ・ directorの追加 ・ sorterの追加 ・ Shunsaku Fileの作成、削除および変更 ・ データ挿入先directorの変更 ・ Shunsaku Fileが指定されていないアプリケーションがアクセスするShunsaku Fileの変更 本コマンドは、システム用動作環境ファイル、conductor用動作環境ファイルに記述された内容に従って、Shunsakuの環 境を動的に変更します。 本コマンドを実行する前に、システム用動作環境ファイル、conductor用動作環境ファイルを編集してください。 変更の操作と、動作環境ファイルおよび実行パラメタ名の関係を以下に示します。 表2.1 変更の操作種別と、動作環境ファイルおよび実行パラメタ名の関係 操作種別 実行パラメタの名前 動作環境ファイルの種 別 searcherの追加 Searcher 代替searcherの追加 AlternativeSearcher システム用動作環境 ファイル directorの追加 Director sorterの追加 Sorter Shunsaku Fileの作成、削除お よび変更 FileおよびDomain データ挿入先directorの変更 InsertPoint Shunsaku Fileが指定されてい ないアプリケーションがアクセ スするShunsaku Fileの変更 DefaultFile conductor用動作環境 ファイル オプション -8- -n Shunsakuシステム名 コマンド実行対象のShunsakuシステム名を指定します。 本オプションを省略した場合、Shunsakuシステム名に“shunsaku”が指定されたものとみなします。 使用例 例 Shunsakuシステム名“shunsaku”の環境を動的に変更します。 shunsyscfgedit -n shunsaku 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドは、変更操作によって実行するサーバが異なります。詳細は、“導入・運用ガイド”を参照してください。 ・ 機能説明に記述した変更可能な操作以外の操作を行う場合には、Shunsakuシステムの停止が必要です。Shunsaku システムを停止した後、各種の動作環境ファイルを修正してShunsakuシステムの起動を行ってください。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 2.3 shunsysstart 名前 shunsysstart -- Shunsakuの起動 形式 shunsysstart [ -n Shunsakuシステム名 ] 機能説明 Shunsakuを構成するconductor、director、sorterおよびsearcherのうち、本コマンドを実行したサーバに配置されているも のを起動します。 マルチサーバ構成のShunsakuの起動は、ソートサーバ、サーチサーバ、増設したディレクタサーバ、conductorを配置し ているディレクタサーバの順に各サーバ上で本コマンドを実行してください。 オプション -n Shunsakuシステム名 Shunsakuシステム名を指定します。 本オプションを省略した場合、Shunsakuシステム名に“shunsaku”が指定されたものとみなします。 -9- 使用例 例 Shunsakuシステム名“shunsaku”のShunsakuを起動します。 shunsysstart -n shunsaku 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンド実行後、各サーバ上において shunsysstateコマンドを実行し、サーバ内のプロセスの稼働状況がACTIVE になっていることを確認してださい。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 2.4 shunsysstate 名前 shunsysstate -- Shunsakuのプロセス構成情報の表示 形式 shunsysstate [ -n Shunsakuシステム名 ] [ -p | -i ] [ -C ] 機能説明 Shunsakuを構成するconductor、sorter、directorおよびsearcherのうち、本コマンドを実行したサーバに配置されているプ ロセスの構成情報を表示します。 本コマンドは、以下のような場合に使用できます。 ・ サーバ内のプロセスの構成を確認する ・ サーバ内のプロセスの現在の稼働状況を確認する ・ システム用動作環境ファイルの設定を確認する 本コマンドは、Shunsakuシステムが停止状態でも実行可能です。 オプション - 10 - -n Shunsakuシステム名 Shunsakuシステム名を指定します。 本オプションを省略した場合、Shunsakuシステム名に“shunsaku”が指定されたものとみなします。 -p サーバ内のプロセスの状態を表示します。 -i システム用動作環境ファイルに指定されている実行パラメタを表示します。 -C CSV形式で出力します。 使用例 例1 サーバ内のプロセスの状態を表示します。 shunsysstate -n shunsaku -p 表示例 shunsysstate -n shunsaku -p Shunsaku shunsysstate 2007/01/01 19:01:00 Type Conductor Sorter Director Searcher Searcher ID shunc shuno1 shund1 shuns01 shuns02 Hostname DirSvr1 DirSvr1 DirSvr1 DirSvr1 DirSvr1 State ACTIVE ACTIVE ACTIVE ACTIVE ACTIVE StateChanged 2007/01/01 10:50:11 2007/01/01 10:50:11 2007/01/01 10:50:11 2007/01/01 10:50:11 2007/01/01 10:50:11 上記の情報をCSV形式で出力します。 Solaris/Linuxの場合 shunsysstate -n shunsaku -p -C > /home/shunsaku/ monitor/sysstate.csv Windowsの場合 shunsysstate -n shunsaku -p -C > C:\shunwork\monitor \sysstate.csv sysstate.csvの内容 "Type","ID","Hostname","State","StateChanged","Director" "Conductor","shunc","DirSvr1","ACTIVE","2007/01/01 10:50:11", "Sorter","shuno1","DirSvr1","ACTIVE","2007/01/01 10:50:11", "Director","shund1","DirSvr1","ACTIVE","2007/01/01 10:50:11", "Searcher","shuns01","DirSvr1","ACTIVE","2007/01/01 10:50:11","shund1" "Searcher","shuns02","DirSvr1","ACTIVE","2007/01/01 10:50:11","shund1" - 11 - Director shund1 shund1 例2 システム用動作環境ファイルに指定されている実行パラメタを表示します。 shunsysstate -n shunsaku -i 表示例 shunsysstate -n shunsaku -i Shunsaku shunsysstate 2007/12/01 19:01:00 Parameter Value Conductor shunc DirSvr1 23101 Sorter shuno1 DirSvr1 23201 Director shund1 DirSvr1 23301 23302 23102 SearcherType=Memory SearcherMaxMemorySize=1024 Searcher shuns01 DirSvr1 23501 shund1 Searcher shuns02 DirSvr1 23502 shund1 CharacterCode UTF-8 ANKmix 0 KNJmix 0 SkipChar "\s,\S,\n,\t" ExtendedQuery 0 SeparateChar Default SearcherFailureEscalation 0 MonitoringStyle 0 SearchAttribute 0 DegradableSearcherCnt 1 上記の情報をCSV形式で出力します。 Solaris/Linuxの場合 shunsysstate -n shunsaku -i -C > /home/shunsaku/ monitor/syssetting.csv Windowsの場合 shunsysstate -n shunsaku -i -C > C:\shunwork\monitor \syssetting.csv syssetting.csvの内容 "Parameter","Value" "Conductor","shunc DirSvr1 23101" "Sorter","shuno1 DirSvr1 23201" "Director","shund1 DirSvr1 23301 23302 23102 SearcherType=Memory SearcherMaxMemorySize=1024" "Searcher","shuns01 DirSvr1 23501 shund1" "Searcher","shuns02 DirSvr1 23502 shund1" "CharacterCode","UTF-8" "ANKmix",0 "KNJmix",0 "SkipChar","\s,\S,\n,\t" "ExtendedQuery",0 "SeparateChar","Default" "SearcherFailureEscalation",0 "MonitoringStyle",0 - 12 - "SearchAttribute",0 "DegradableSearcherCnt",1 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドは、システム用動作環境ファイルに記載された内容に従って動作します。システム用動作環境ファイルを Shunsakuシステム運用中に変更した場合、Shunsakuシステムが実際に使用している値とは、異なった値が出力され ます。 ・ 本コマンドにpオプションを指定して実行した場合、実行したサーバに配置されたプロセスについてのみ情報を出力 します。異なるサーバに配置されたプロセスについては、各サーバ上で本コマンドを実行してください。 ・ pオプションおよびiオプションを省略した場合、pオプションが指定されたものとみなします。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 表示項目の見出しと意味 pオプション指定時に出力される情報 Type プロセス種別 - Conductor - Sorter - Director - Searcher - Searcher(Disk) - AlternativeSearcher - AlternativeSearcher(Disk) ID プロセスの識別子 Hostname ホスト名またはIPアドレス State プロセス状態 【ConductorまたはSorterの場合】 - ACTIVE:起動状態 - INACTIVE:停止状態 【Directorの場合】 - ACTIVE:起動状態 - ACTIVATING:起動処理中 - DEGRADED:縮退状態 - DEGRADING:縮退処理中 - RESENDING:再配置中 - 13 - - SWITCHING:代替searcherへの切替え中 - CONDENSING:最適化中 - BACKUP:バックアップ中 - RECOVER:リカバリ中 - INACTIVE:停止状態 - WAITING:searcher接続待ち 【Searcher、AlternativeSearcherの場合】 - ACTIVE:起動状態 - ACTIVATING:起動処理中 - INACTIVE:停止状態 - IDLE:代替待機状態 StateChanged 現在のプロセス状態になった日時(YYYY/MM/DD hh:mm:ss) Director 接続先のdirector識別子 以下のいずれかの場合に表示されます。 - プロセス種別が、Searcherの場合 - プロセス種別が、Searcher(Disk)の場合 - プロセス種別が、AlternativeSearcherで、稼働状況がACTIVATING/ACTIVEの場合 - プロセス種別が、AlternativeSearcher(Disk)で、稼働状況がACTIVATING/ACTIVEの場合 iオプション指定時に出力される情報 Parameter システム用動作環境ファイルの実行パラメタ名 Value 実行パラメタに指定している値 2.5 shunsysstop 名前 shunsysstop -- Shunsakuの停止 形式 shunsysstop [ -n Shunsakuシステム名 ] [ -e ] 機能説明 Shunsakuを構成するconductor、sorter、directorおよびsearcherのうち、本コマンドを実行したサーバに配置されているも のを停止します。 マルチサーバ構成の場合の停止は、conductorを配置しているディレクタサーバ、増設したディレクタサーバ、サーチサー バ、ソートサーバ、の順に各サーバ上で本コマンドを実行してください。 トランザクション動作中に本コマンドを実行した場合は、トランザクションの完了を待ってからShunsakuの停止が行われま す。 トランザクション動作中にeオプションを指定し本コマンドを実行した場合、トランザクションを即時にロールバックし、接続 中のコネクションを切断してからShunsakuの停止が行われます。 - 14 - オプション -n Shunsakuシステム名 Shunsakuシステム名を指定します。 本オプションを省略した場合、Shunsakuシステム名に“shunsaku”が指定されたものとみなします。 -e Shunsakuを強制停止します。 使用例 例 Shunsakuシステム名“shunsaku”のShunsakuを停止します。 shunsysstop -n shunsaku 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドは、システム用動作環境ファイルに記載された内容に従って動作します。Shunsakuシステム運用中にシス テム用動作環境ファイルのDirectorパラメタ、Sorterパラメタ、Searcherパラメタ、およびAlternativeSearcherパラメタの 変更・削除を行った場合、該当のプロセスを停止することはできません。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 - 15 - 第3章 conductor用コマンド conductor用コマンドの詳細を説明します。 3.1 shuncservice 名前 shuncservice -- conductorのサービスへの登録・削除 形式 shuncservice -s conductor識別子 [ -n Shunsakuシステム名 ] [ -a | -d ] 機能説明 conductorをサービスに登録します。 または、conductorをサービスから削除します。 オプション -s conductor識別子 conductor識別子を指定します。 -n Shunsakuシステム名 Shunsakuシステム名を指定します。 本オプションを省略した場合、conductor用動作環境ファイルのSystemNameパラメタに指定したShunsakuシステム名 が指定されたものとみなします。 ただし、SystemNameパラメタが指定されていない場合は、Shunsakuシステム名に“shunsaku”が指定されたものとみな します。 -a 指定されたconductorをサービスに登録します。 -d 指定されたconductorをサービスから削除します。 使用例 例 Shunsakuシステム名が“shunsaku”、conductor識別子が“shunc”のconductorをサービスに登録します。 shuncservice -s shunc -n shunsaku - 16 - 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドでconductorをサービスに登録するまでは、conductorを起動することはできません。 ・ aオプションおよびdオプションを省略した場合は、aオプションが指定されたものとみなします。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 3.2 shuncstate 名前 shuncstate -- conductorおよびコネクションの状態表示 形式1(運用状態の表示) shuncstate -s conductor識別子 [ -w ] [ -C ] [ 時間間隔 [ 繰返し回数 ] ] 形式2(プロセス情報/動作環境情報/コネクション情報の表示) shuncstate -s conductor識別子 { -p | -i | -c } [ -C ] 形式3(統計情報のリセット) shuncstate -s conductor識別子 -r 形式4(コネクション情報のロギング) shuncstate -s conductor識別子 -t { start [ [-f Shunsaku File名] ... ] [ -q 時間 ] [ -C ] [ -o 出力ファイル名 ] | end } 機能説明 conductorの状態およびコネクションの状態を表示します。 本コマンドは、以下のような場合に使用できます。 ・ conductorの稼働状況を確認する - 17 - ・ アプリケーションからの要求の統計情報を確認する ・ アプリケーション実行時にdirectorまたはsorterとの通信で問題が発生したとき、どのdirectorまたはsorterに問題が起 こったかを確認する ・ conductorに設定されている動作環境を確認する ・ アプリケーションとShunsakuとの接続状態を確認する ・ アプリケーションへの応答時間が一定時間を超えるコネクションの情報を収集する ・ どのアプリケーションからの要求に時間がかかっているかを分析する 形式1のオプション -s conductor識別子 conductor識別子を指定します。 -w conductorの運用状態を表示します。 -C CSV形式で出力します。 [ 時間間隔 [ 繰返し回数 ] ] conductorの運用状態を表示する場合に、時間間隔(秒)で指定された間隔をあけて、繰返し回数で指定された回数 分の運用情報を表示します。 時間間隔が省略された場合、起動時からの累積の運用情報を表示します。繰返し回数が省略された場合は、1が指 定されたものとみなします。 形式2のオプション -s conductor識別子 conductor識別子を指定します。 -p conductorと接続しているsorterおよびdirectorの情報を表示します。 -i conductorに設定されている動作環境を表示します。 -c コネクションに関連する情報を表示します。 -C CSV形式で出力します。 形式3のオプション -s conductor識別子 conductor識別子を指定します。 -r conductorの運用状態の統計情報(wオプション指定時に出力される情報)をリセットします。 - 18 - 形式4のオプション -s conductor識別子 conductor識別子を指定します。 -t {start | end} コネクション情報の出力の開始と終了を指示します。 本オプションにstartを指定すると情報の出力を開始します。 情報は、oオプションで指定したファイルに出力されます。 情報の出力を終了するには、本オプションにendを指定して実行します。 本オプションにstartを指定した場合、endを指定するまでコネクションおよびアプリケーションに関連する情報をoオプ ションで指定したファイルに出力し続けます。 -f Shunsaku File名 指定したShunsaku Fileをアクセス対象とするコネクションの情報のみを出力することを指示します。 本オプションを複数指定することで、異なるShunsaku Fileをアクセス対象とするコネクションの情報を同時に出力する ことができます。 -q 時間 アプリケーションへの応答時間が指定した時間(秒)を超えたコネクションの情報を出力します。本オプションを省略し た場合には、時間に関係なくすべての情報が出力されます。 -C CSV形式で出力します。 -o 出力ファイル名 結果を出力するファイル名を絶対パスで指定します。 出力ファイル名に指定できる長さは、255バイトまでです。 本オプションを省略した場合には、conductor用動作環境ファイルのLogFileFolderパラメタで定義されているディレク トリ配下の“monitor.connection.log”が指定されたものとみなします。 使用例 例1 conductorの運用状態を表示します。 shuncstate -s shunc -w 表示例 shuncstate -s shunc -w Shunsaku shuncstate 2007/01/01 19:01:00 Time State Errors 19:01:00 ACTIVE Connections Searches Sorts Updates 310 20 150 100 例2 conductorの運用状態を60秒間隔で3回収集し、CSV形式で出力します。 Solaris/Linuxの場合 - 19 - 0 shuncstate -s shunc -w -C 60 3 > /home/shunsaku/monitor/ constate.csv Windowsの場合 shuncstate -s shunc -w -C 60 3 > C:\shunwork\monitor \constate.csv constate.csvの内容 "Time","State","Connections","Searches","Sorts","Updates","Er rors" "2007/01/01 19:02:00","ACTIVE",310,10,20,7,0 "2007/01/01 19:03:00","ACTIVE",350,0,5,1,0 "2007/01/01 19:04:00","ACTIVE",203,0,7,0,0 例3 conductorに設定されている動作環境を表示します。 shuncstate -s shunc -i 表示例 Solaris/Linuxの場合 shuncstate -s shunc -i Shunsaku shuncstate 2007/01/01 19:01:00 Parameter LogFileFolder LogFileSize LogFileBackup LogFileSwitch PfmFileFolder PfmFileSize PfmFileBackup PfmFileSwitch CoreFileFolder AnsMax MaxConnection File File Domain InsertPoint InsertPoint DefaultFile SystemName Value /var/opt/FJSVshnsk/log/conductor/ 100MB 1 0 /var/opt/FJSVshnsk/log/conductor/ 100MB 1 0 /var/opt/FJSVshnsk/core/conductor/ 100 1000 file1 shund1 shund2 file2 shund3 shund4 dom1 file1 file2 shund1 file1 shund3 file2 file1 shunsaku Windowsの場合 shuncstate -s shunc -i Shunsaku shuncstate 2007/01/01 19:01:00 Parameter LogFileFolder \" Value "C:\Program Files\Interstage Shunsaku\Shunsaku\log\conductor - 20 - LogFileSize LogFileBackup LogFileSwitch PfmFileFolder \" PfmFileSize PfmFileBackup PfmFileSwitch CoreFileFolder \" AnsMax MaxConnection File File Domain InsertPoint InsertPoint DefaultFile SystemName 100MB 1 0 "C:\Program Files\Interstage Shunsaku\Shunsaku\log\conductor 100MB 1 0 "C:\Program Files\Interstage Shunsaku\Shunsaku\core\conductor 100 1000 file1 shund1 shund2 file2 shund3 shund4 dom1 file1 file2 shund1 file1 shund3 file2 file1 shunsaku 例4 conductorと接続しているsorterおよびdirectorの情報を表示します。 shuncstate -s shunc -p 表示例 shuncstate -s shunc -p Shunsaku shuncstate 2007/01/01 19:01:00 Type Sorter Director Director Director ID shuno1 shund1 shund2 shund3 Hostname DirSvr1 DirSvr1 DirSvr1 DirSvr1 State ACTIVE ACTIVE ACTIVE ACTIVE LatestTime(sec) 2.000 10.000 12.000 15.000 例5 アプリケーションへの応答時間が3秒を超えたコネクションの情報をテキストファイルヘ出力します。 Solaris/Linuxの場合 shuncstate -s shunc -t start -q 3 -o /home/shunsaku/ monitor/connection.txt shuncstate -s shunc -t end Windowsの場合 shuncstate -s shunc -t start -q 3 -o C:\shunwork \monitor\conection.txt shuncstate -s shunc -t end 備考.“-t start”指定でコネクション情報の収集を開始し、“-t end”指定で収集を終了します。 connection.txtの内容 - 21 - Client 192.168.0.1 Application RequestType QueryStarted Stage DirectorStarted SorterStarted Expression ShunsakuFile QueryElapse(sec) StageElapse(sec) DirectorEnded SorterEnded Results BusiestDirector Sorter application2 SORT file1 19:19:46.053 3.160 201 IDLE 0.000 19:19:46.091 19:19:47.133 shund1 19:19:47.134 19:19:49.211 shuno1 SEARCH: /document/base/prefecture == 'Nagoya' SORT: val(/document/base/price/text()), /document/base/in/text() RETURN: /document/base/name, /document/base/price, /document/base/ in 192.168.0.2 application1 SORT file1 19:19:46.250 3.162 283 IDLE 0.000 19:19:46.252 19:19:47.333 shund1 19:19:47.334 19:19:49.411 shuno1 SEARCH: /document/base/prefecture == 'Tokyo' SORT: val(/document/base/price/text()), /document/base/in/text() RETURN: /document/base/name, /document/base/price, /document/base/ in 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 形式2(状態の表示)によるオプションの指定において、pオプション、iオプション、およびcオプションを省略した場 合、wオプションが指定された場合と同等の動作が実施されます。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 出力ファイルに、ネットワークドライブまたはネットワークパスを指定することはできません。ローカルディスクのファイ ルを指定してください。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 表示項目の見出しと意味 wオプション指定時に出力される情報 Time 通常の形式による出力の場合 出力時間(hh:mm:ss) CSV形式による出力の場合 出力日時(YYYY/MM/DD hh:mm:ss) - 22 - State conductorの稼働状況 ACTIVE:起動状態 Connections conductorに対して確立されているコネクションの数 Searches 検索要求(ヒット件数取得・検索式による検索・レコードIDによる検索・ダイレクト検索)の累積回数 Sorts ソート指定付き検索要求の累積回数 Updates 更新要求(追加・更新・削除・ダイレクト更新・ダイレクト削除)の累積回数 Errors エラー応答の累積回数 pオプション指定時に出力される情報 Type プロセス種別 - Sorter - Director ID プロセスの識別子 Hostname ホスト名またはIPアドレス State 通信状態 - ACTIVE: 正常 - INACTIVE:異常 この項目は、conductorが起動したときはACTIVEとなっています。アプリケーションの処理の過程でdirectorやsorter との通信で異常が検出されるとINACTIVEになります。その後問題が解消され通信できるようになるとACTIVEに 戻ります。 LatestTime(sec) 最近のdirector/sorterの応答時間(秒) cオプションまたはtオプション指定時に出力される情報 Client アプリケーションが動作しているホストのIPアドレス Application アプリケーションの名前 (Javaアプリケーションの場合は完全修飾クラス名、.NETおよびCアプリケーションの場合はプログラム名が表示さ れます) RequestType アプリケーションの要求種別 - CONNECT:コネクト要求 - SEARCH:検索要求 - 23 - - SORT:ソート要求 - INSERT:挿入要求 - UPDATE:更新要求 - DELETE:削除要求 - COMMIT:コミット要求 - ROLLBACK:ロールバック要求 - SEARCHKEY:ダイレクト検索要求 - UPDATEKEY:ダイレクト更新要求 - DELETEKEY:ダイレクト削除要求 ShunsakuFile 接続先のShunsaku File名 (Shunsaku Fileを使用している場合のみ表示されます) QueryStarted クエリ発行時間(HH:MM:SS.mmm) QueryElapse(sec) クエリ発行からの総経過時間(秒) Results 検索結果件数 (RequestTypeがSEARCH、SORTまたはSEARCHKEYの場合のみ表示されます) Stage 要求の処理段階 (tオプションを指定した場合は、つねに“IDLE”または“ERROR”と出力されます) - CONDUCTOR:conductor処理中 - DIRECTOR:director依頼中 - SORTER:sorter依頼中 - IDLE:要求待ち - ERROR:エラー StageElapse(sec) 現在の処理段階に移行してからの経過時間(秒) (Stageが“ERROR”の場合、表示されません) DirectorStarted director処理開始時間(HH:MM:SS.mmm) DirectorEnded director処理終了時間(HH:MM:SS.mmm) BusiestDirector 最も処理時間を要したdirectorの識別子 SorterStarted sorter処理開始時間(HH:MM:SS.mmm) SorterEnded sorter処理終了時間(HH:MM:SS.mmm) Sorter ソート指定付き検索要求で使用されたsorterの識別子 Expression 検索要求の式(ダイレクトアクセスキー、検索式、リターン式、ソート式) - 24 - - 要求種別“SEARCH”の場合:検索式、リターン式を表示 - 要求種別“SORT”の場合:検索式、リターン式、ソート式を表示 - 要求種別“SEARCHKEY”の場合:ダイレクトアクセスキー、リターン式を表示 - 要求種別“UPDATEKEY”または“DELETEKEY”の場合:ダイレクトアクセスキーを表示 - 上記以外の場合:表示なし ダイレクトアクセスキーは、64KBまで表示されます。 当該ダイレクトアクセスキーの表示中に64KB(65535バイト)を超えた場合は、1つ前のダイレクトアクセスキーまで 表示します。 リターン式にNULLが指定された場合(レコード識別子の取得)は、“RECORD ID”と表示します。 表示形式は、以下のとおりです。 - ダイレクトアクセスキー SEARCHKEY:ダイレクトアクセスキー名="ダイレクトアクセスキー値" - 検索式 SEARCH:検索 - ソート式 SORT:ソート式 - リターン式 RETURN:リターン式 iオプション指定時に出力される情報 Parameter conductor用動作環境ファイルの実行パラメタ名 Value 実行パラメタに指定している値 3.3 shuncterm 名前 shuncterm -- コネクションの回収 形式 shuncterm -s conductor識別子 -h ホスト名またはIPアドレス 機能説明 アプリケーションからのコネクションを切断して、コネクション資源を回収します。切断対象のコネクション上でトランザクショ ンが実行されている場合、トランザクションをロールバックします。 オプション -s conductor識別子 conductor識別子を指定します。 -h ホスト名またはIPアドレス 指定したホストからのコネクションをすべて回収します。 使用例 - 25 - 例 IPアドレスが192.168.0.1であるサーバのコネクションを回収します。 shuncterm -s shunc -h 192.168.0.1 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 - 26 - 第4章 director用コマンド director用コマンドの詳細を説明します。 4.1 shundbackup 名前 shundbackup -- ディレクタデータファイルのバックアップ開始宣言および終了宣言 形式 shundbackup -s director識別子 { -b | -e | -c } 機能説明 ディレクタデータファイルのバックアップ開始宣言、終了宣言および開始宣言のキャンセルを行います。 オプション -s director識別子 director識別子を指定します。 -b バックアップ開始宣言をする場合に指定します。 -e バックアップ終了宣言をする場合に指定します。 本オプションは、バックアップ開始宣言が実行されている場合のみ指定可能です。 -c バックアップ開始宣言をキャンセルする場合に指定します。 本オプションは、バックアップ開始宣言が実行されている場合のみ指定可能です。 使用例 例1 director用動作環境ファイルのDataFileFolderに指定されたディレクタデータファイルのバックアップを行います。 Solaris/Linuxの場合 shundbackup -s shund1 -b cp /shunsaku/shund1/* /backup/shund1/ shundbackup -s shund1 -e Windowsの場合 shundbackup -s shund1 -b copy /b C:\Shunsaku\shund1\* shundbackup -s shund1 -e D:\backup\shund1\ - 27 - 例2 ディレクタデータファイルのバックアップが失敗したため、バックアップをキャンセルします。 Solaris/Linuxの場合 shundbackup -s shund1 -b cp /shunsaku/shund1/* /backup/shund1/ cp: writing '/backup/shund1/': No space left on device ・・・・・(エラーメッセージ) shundbackup -s shund1 -c Windowsの場合 shundbackup -s shund1 -b copy /b C:\Shunsaku\shund1\* D:\backup\shund1\ C:\Shunsaku\shund1\ ディスクに十分な空き領域がありま せん。 ・・・・・(エラーメッセージ) shundbackup -s shund1 -c 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 ・ copyコマンドを利用してディレクタデータファイルのバックアップを行う場合は、必ず/bオプションを指定してください。 4.2 shundcds 名前 shundcds -- ディレクタデータファイルの最適化 形式 shundcds -s director識別子 機能説明 ディレクタデータファイルを最適化します。 データの削除または更新を行った結果、ディレクタデータファイルにフラグメンテーションが発生している場合に、ディレ クタデータファイルのサイズを縮小することができます。 本コマンドは、shundstateコマンドのフラグメンテーション率を確認し、フラグメンテーションが発生している場合に実行し てください。 - 28 - オプション -s director識別子 director識別子を指定します。 使用例 例 ディレクタデータファイルを最適化します。 shundcds -s shund1 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンド実行中は、ディレクタデータファイルの2倍のサイズのディスク領域が、一時的に使用されます。使用され るディスク領域は、director用動作環境ファイルのDataFileFolderパラメタで指定されているディレクトリ配下の領域で す。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 4.3 shundclear 名前 shundclear -- ディレクタデータおよびサーチデータの破棄 形式 shundclear -s director識別子 機能説明 ディレクタデータおよびサーチデータを破棄します。 オプション -s director識別子 director識別子を指定します。 - 29 - 使用例 例 ディレクタデータおよびサーチデータを破棄します。 shundclear -s shund1 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 4.4 shundexport 名前 shundexport -- XML文書の抽出 形式1(XML文書の外部ファイルへの抽出) shundexport -s director識別子 [ -q 検索式ファイル名 ] -o 出力ファイル名 [ -maxsize 出力ファイルの最大サイズ ] 形式2(XML文書の削除) shundexport -s director識別子 [ -q 検索式ファイル名 ] -d [ -n ] 機能説明 directorに格納されているXML文書を外部テキストファイルに抽出します。 また、directorに格納されているXML文書を削除します。 本コマンド実行時点でコミット済みのXML文書を対象とします。 形式1のオプション - 30 - -s director識別子 director識別子を指定します。 -q 検索式ファイル名 抽出を行う条件である検索式を記述した検索式ファイルを、絶対パス名で指定します。 検索式ファイル名に指定できる長さは、255バイトまでです。 本オプションを省略した場合、directorに格納されているすべてのXML文書を抽出します。 -o 出力ファイル名 抽出するXML文書の出力先のテキストファイルを、絶対パス名で指定します。 出力ファイル名に指定できる長さは、maxsizeオプションの指定によって以下のようになります。 maxsizeオプション指定なし:255バイトまで maxsizeオプション指定あり:249バイトまで 注意 ・ 出力ファイルが存在する場合、コマンドはエラー終了します。 ・ 抽出データがない場合でも、出力ファイルは作成されます。 ・ 出力ファイルが入出力障害または、領域不足によってコマンドがエラーとなった場合は、出力ファイルは削除されず に残ります。 -maxsize 出力ファイルの最大サイズ 検索式に一致したXML文書をoオプションで指定した出力ファイルに抽出するときの、ファイルの最大サイズを指定 します。1以上の値をメガバイト単位で指定してください。 本オプションを指定した場合、出力ファイルには、以下の通番が付加され、出力ファイルが最大サイズに達するごと にファイルが作成されます。 出力ファイル名_XXXXX(注) 注)XXXXX:00001から始まる5桁の通番 本オプションを指定した場合、出力ファイル名の最大サイズは249バイトになります。 本オプションを省略した場合、検索式に一致したXML文書は、oオプションで指定した出力ファイルにすべて抽出し ます。 形式2のオプション -s director識別子 director識別子を指定します。 -q 検索式ファイル名 削除を行う条件である検索式を記述した検索式ファイルを、絶対パス名で指定します。 検索式ファイル名に指定できる長さは、255バイトまでです。 本オプションを省略した場合、directorに格納されているすべてのXML文書を削除します。 -d 検索条件に一致したXML文書を削除します。 -n director用動作環境ファイルのOperationLogFolderが指定されている場合、本コマンドの操作(レコードの削除)の操 作ログを、オペレーションログファイルに採取しません。 本オプションを指定することで、大量のレコードの削除を行う場合のオペレーションログファイルの増加を抑えることが できます。 - 31 - 注意 nオプションを指定してXML文書の削除を実施した後は、必ずディレクタデータファイルのバックアップを行ってください。 検索式ファイルの形式 検索式ファイルの記述方法について説明します。 ・ 検索式ファイルに指定できる検索式は1つです。 ・ 検索式は複数行で記述することができます。その場合、論理演算子の前または後ろで改行してください。 ・ 1行の最大長は、65535バイトです。(改行は含みません) ・ 行の先頭が“#”の場合、その行はコメントとして扱われます。 ・ 行の途中に“#”を指定してコメントを記述することはできません。 ・ 検索式は、システム用動作環境ファイルに指定された“CharacterCode”と同じ文字コードで記述してください。 参照 検索式の詳細については、“アプリケーション開発ガイド”を参照してください。 例 id が’A12345678’で、日付が2006年のデータを抽出する場合 # id が’A12345678’で、日付が2006年のデータを抽出 /root/id == ‘A12345678’ AND /root/date >= ‘2006/01/01 00:00:00’ AND /root/date < ‘2007/01/01 00:00:00’ 使用例 例1 Solaris/Linuxの場合 XML文書をテキストファイル(/home/shunsaku/data.xml)に抽出します。 shundexport -s shund1 -o /home/shunsaku/data.xml Windowsの場合 XML文書をテキストファイル(D:\USERS\DEFAULT\DATA.XML)に抽出します。 shundexport -s shund1 -o D:\USERS\DEFAULT\DATA.XML 例2 検索式ファイルに記述した検索式の条件に一致したXML文書を削除します。 Solaris/Linuxの場合 - 32 - 検索式ファイルの内容(/home/shunsaku/query.txt) /root/date < ‘2006/12/01 00:00:00’ shund1から検索条件に一致したXML文書を削除します。 shundexport -s shund1 -q /home/shunsaku/query.txt -d Windowsの場合 検索式ファイルの内容(D:\USERS\DEFAULT\QUERY.TXT) /root/date < ‘2006/12/01 00:00:00’ shund1から検索条件に一致したXML文書を削除します。 shundexport -s shund1 -q D:\USERS\DEFAULT\QUERY.TXT -d 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドによって抽出されるXML文書の順序性保証はありません。 ・ 本コマンドによって複数のXML文書を抽出する場合、XML文書とデータの間には、Shunsakuは区切り文字(改行文 字や終端文字など)をつけません。 ・ dオプションによるXML文書の削除では、qオプションを省略した場合は、shundclearコマンドと同じ動作となります。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 出力ファイルおよび検索式ファイルに、ネットワークドライブまたはネットワークパスを指定することはできません。ロー カルディスクのファイルを指定してください。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 4.5 shundimport 名前 shundimport -- XML文書の取込み 形式 shundimport -s director識別子 -f XML文書格納ファイルのパス 名 - 33 - [ -a | -d | -t symfoware ] [ -n ] 機能説明 テキストファイルまたは抽出データファイルからdirectorにXML文書を取込み、検索用データを作成します。 オプション -s director識別子 director識別子を指定します。 -f XML文書格納ファイルのパス名 XML文書を格納したファイルまたは抽出データファイルの絶対パス名を指定します。 XML文書格納ファイルのパス名に指定できる長さは、255バイトまでです。 dオプションを指定してデータの削除をする場合は、shunsearch2関数または、executeSearch2メソッド実行後のgetRecNo メソッドで通知されたレコード識別子をバイナリ形式のファイルに連続した形で格納しておいてください。 -a 指定されたXML文書を新規レコードとして取り込みます。 -d fオプションのファイルに格納された複数のレコード識別子に対応するレコードを削除します。 データを削除する場合は、ShunsakuのAPIを使用してアプリケーションから実施する方法を推奨します。本オプション は、データの削除に対応していない互換用のShunsakuのAPIを使用している場合に使用してください。 -t symfoware fオプションで指定したファイルの内容が、shunrdbコマンドで作成された抽出データファイルである場合に指定しま す。 -n director用動作環境ファイルのOperationLogFolderが指定されている場合、本コマンドの操作(レコードの取込みまた は削除)の操作ログを、オペレーションログファイルに採取しません。 本オプションを指定することで、大量のレコードの取り込みまたは削除を行う場合のオペレーションログファイルの増 加を抑えることができます。 注意 nオプションを指定してXML文書の取込みまたは削除を実施した後は、必ずディレクタデータファイルのバックアップを 行ってください。 使用例 例 Solaris/Linuxの場合 テキストファイル(/home/shunsaku/data.xml)を取り込みます。 shundimport -s shund1 -f /home/shunsaku/data.xml Windowsの場合 - 34 - テキストファイル(D:\USERS\DEFAULT\DATA.XML)を取り込みます。 shundimport -s shund1 -f D:\USERS\DEFAULT\DATA.XML 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドが完了するまで、取込み中のデータは検索対象となりません。 ・ 本コマンドには、整形式のXML文書を指定してください。 ・ aオプション、dオプションおよびtオプションを省略した場合、aオプションが指定されたものとみなします。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 入力ファイルに、ネットワークドライブまたはネットワークパスを指定することはできません。ローカルディスクのファイ ルを指定してください。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 4.6 shundrecover 名前 shundrecover -- ディレクタデータのリカバリ開始宣言または終了宣言、およびオペレーションログファイルのリカバリ 形式1(ディレクタデータファイルのリカバリ開始宣言または終了宣言) shundrecover -s director識別子 { -b | -e [ -p [ time ]] | -c } 形式2(オペレーションログファイルのリカバリ) shundrecover -s director識別子 -l 機能説明 shundbackupコマンドを利用してバックアップしたディレクタデータファイルおよびオペレーションログファイルをもとに、ディ レクタデータファイルのリカバリを行います。 または、オペレーションログファイルのリカバリを行います。 オプション -s director識別子 director識別子を指定します。 - 35 - -b リカバリ開始宣言をする場合に指定します。 -e リカバリ終了宣言をする場合に指定します。 本オプションは、リカバリ開始宣言が実行されている場合のみ指定可能です。 本オプションのみを指定した場合には、最新時点までリカバリします。 オペレーションログファイルを使用していない場合、またはバックアップ時点や任意の時点にリカバリする場合には、p オプションと組み合わせて指定します。 -c リカバリ開始宣言をキャンセルする場合に指定します。 本オプションは、以下のすべての条件を満たす場合にのみ指定可能です。 - リカバリ開始宣言を実行している。 - バックアップしたディレクタデータファイルをリストアしていない。 -p [ time ] ディレクタデータファイルを、バックアップ時点または任意の時点にリカバリする場合に指定します。 本オプションが省略された場合は、最新時点までリカバリします。 timeが省略された場合には、バックアップを行った時点にディレクタデータファイルをリカバリします。 timeが指定された場合には、指定された時点にディレクタデータファイルをリカバリします。 timeは、以下の形式である必要があります。 YYYY-MM-DD:hh:mm:ss 注意 ディレクタデータファイルのリカバリを実行した場合、必ずshundbackupコマンドでディレクタデータファイルのバックアッ プを行ってください。 -l オペレーションログファイルをリカバリする場合に指定します。 注意 オペレーションログファイルのリカバリを実行した場合、必ずshundbackupコマンドでディレクタデータファイルのバック アップを行ってください。 使用例 例1 バックアップしたディレクタデータファイルをリストアし、最新時点までリカバリします。 Solaris/Linuxの場合 shundrecover -s shund1 -b cp /backup/shund1/* /shunsaku/shund1/ shundrecover -s shund1 -e Windowsの場合 - 36 - shundrecover -s shund1 -b copy /b D:\backup\shund1\* shundrecover -s shund1 -e C:\Shunsaku\shund1\ 例2 最後にバックアップしたディレクタデータファイルをリストアし、2006年1月1日12時00分00秒の時点にリカバリします。 Solaris/Linuxの場合 shundrecover -s shund1 -b cp /backup/shund1/* /shunsaku/shund1/ shundrecover -s shund1 -e -p 2006-01-01:12:00:00 Windowsの場合 shundrecover -s shund1 -b copy /b D:\backup\shund1\* C:\Shunsaku\shund1\ shundrecover -s shund1 -e -p 2006-01-01:12:00:00 例3 director用動作環境ファイルのOperationLogFolderに指定されているオペレーションログファイルをリカバリします。 shundrecover -s shund1 -l 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ shundbackupコマンドを利用せずに取得したディレクタデータファイルのバックアップデータによるリカバリはできませ ん。 ・ ディレクタデータファイルを任意の時刻までリカバリする場合は、shundbackupコマンドで最後にバックアップした時刻 以降を指定してください。最後にバックアップした日時は、shundstateコマンドで確認することができます。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 ・ copyコマンドを利用してディレクタデータファイルのリストアを行う場合は、必ず/bオプションを指定してください。 4.7 shundresend 名前 shundresend -- サーチデータの再配置、および、サーチデータファイルの最適化 形式 - 37 - shundresend -s director識別子 機能説明 本コマンドは以下のような場合に使用できます。 ・ サーチデータの再配置 searcherごとのデータ量に偏りがある場合、サーチデータの再配置を行うことで検索速度の均一化が見込めます。 本コマンドは、shundstateコマンドでsearcherのデータ量を確認し、偏りがある場合に実行してください。 ・ サーチデータファイルの最適化 システム用動作環境ファイルのDirectorパラメタに、以下のいずれかを指定している場合、サーチデータの再配置と サーチデータファイルの最適化を同時に実施します。 - SearcherType=Disk - SearcherMaxMemorySize 本コマンドは、shundstateコマンドでサーチデータファイルのフラグメンテーション率を確認し、フラグメンテーションが 発生している場合に実行してください。 注意 サーチデータファイルの最適化を実行する場合には、サーチデータファイルの2倍のディスク領域が、一時的に使用され ます。使用されるディスク領域は、searcher用動作環境ファイルのSearchDataFileFolderパラメタで指定されているディレク トリ配下の領域です。 オプション -s director識別子 director識別子を指定します。 使用例 例 サーチデータを再配置します。 shundresend -s shund1 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 - 38 - 4.8 shundrestrict 名前 shundrestrict - XML文書への更新抑止、検索更新抑止の設定および解除 形式1(XML文書への抑止) shundrestrict -s director識別子 {-aw | -arw } 形式2(XML文書への抑止の解除) shundrestrict -s director識別子 -r 機能説明 directorに格納されているXML文書に対するアプリケーションによる更新抑止、または検索更新抑止を設定します。また は、XML文書への抑止を解除します。 オプション -s director識別子 director識別子を指定します。 -aw アプリケーションからdirectorに格納されているXML文書への検索のみが可能になり、XML文書の更新が抑止されま す。 -arw アプリケーションからdirectorに格納されているXML文書への検索および更新が抑止されます。 -r 設定されている抑止を解除します。 使用例 例1 XML文書に対する検索および更新を抑止します。 shundrestrict -s shund1 -arw 例2 XML文書に対する抑止を解除します。 - 39 - shundrestrict -s shund1 -r 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 検索更新抑止状態から、awオプションによる更新抑止の設定はできません。 ・ awオプションによる更新抑止状態、またはarwオプションによる検索更新抑止状態は、directorを再起動すると解除さ れます。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 4.9 shundservice 名前 shundservice -- directorのサービスへの登録・削除 形式 shundservice -s director識別子 [ -n Shunsakuシステム名 ] [ -a | -d ] 機能説明 directorをサービスに登録します。 または、directorをサービスから削除します。 オプション -s director識別子 director識別子を指定します。 -n Shunsakuシステム名 Shunsakuシステム名を指定します。 本オプションを省略した場合、director用動作環境ファイルのSystemNameパラメタに指定したShunsakuシステム名が 指定されたものとみなします。 ただし、SystemNameパラメタが指定されていない場合は、Shunsakuシステム名に“shunsaku”が指定されたものとみな します。 -a 指定されたdirectorをサービスに登録します。 - 40 - -d 指定されたdirectorをサービスから削除します。 使用例 例 Shunsakuシステム名が“shunsaku”、director識別子が“shund1”のdirectorをサービスに登録します。 shundservice -s shund1 -n shunsaku 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドでdirectorをサービスに登録するまでは、directorを起動することはできません。 ・ aオプションおよびdオプションを省略した場合は、aオプションが指定されたものとみなします。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 4.10 shundstate 名前 shundstate -- directorの状態表示 形式1(運用状態の表示) shundstate -s director識別子 [ -w [-e] ] [ -C ] [ 時間間隔 [ 繰返し回数 ] ] 形式2(プロセス情報/動作環境情報の表示) shundstate -s director識別子 { -p | -p disk | -i } [ -C ] 形式3(統計情報のリセット) - 41 - shundstate -s director識別子 -r 形式4(格納レコード件数/ファイル使用状況の表示) shundstate -s director識別子 -l [ -C ] 機能説明 directorの状態を出力します。 本コマンドは、以下のような場合に使用できます。 ・ directorの稼働状況を確認する ・ ディレクタデータの情報(データ量、フラグメンテーション率、バックアップ状況)を確認する ・ directorに接続されているsearcherに異常がないかを確認する ・ directorに接続されているsearcherのデータ量に偏りがないかを確認する ・ directorに接続されているsearcherのサーチデータファイルの使用状況を確認する ・ directorに設定されている動作環境を確認する ・ directorのレコードの件数やファイルの使用量が、警告値や最大値に達していないかを確認する 形式1のオプション -s director識別子 director識別子を指定します。 -w [ -e ] directorの運用状態を表示します。 eオプションを指定すると、directorのアクセス制限情報が表示されます。 -C CSV形式で出力します。 [ 時間間隔 [ 繰返し回数 ] ] directorの運用状態を表示する場合に、時間間隔(秒)で指定された間隔をあけて、繰返し回数で指定された回数分 の運用情報を表示します。 時間間隔が省略された場合、起動時からの累積の運用情報を表示します。繰返し回数が省略された場合は、1が指 定されたものとみなします。 形式2のオプション -s director識別子 director識別子を指定します。 -p directorに接続されているsearcherの情報を表示します。 - 42 - -p disk directorに接続されているsearcherのサーチデータファイルの情報を表示します。 -i directorに設定されている動作環境を表示します。 -C CSV形式で出力します。 形式3のオプション -s director識別子 director識別子を指定します。 -r directorの運用状態の統計情報をリセットします。 形式4のオプション -s director識別子 director識別子を指定します。 -l directorのレコード件数、ディレクタデータファイルおよびオペレーションログファイルの使用量の情報を表示します。 -C CSV形式で出力します。 使用例 例1 directorの運用状態を表示します。 shundstate -s shund1 -w 表示例 shundstate -s shund1 -w Shunsaku shundstate 2007/01/01 19:01:00 Time State Fragments(%) LastBackedUp Records DataFileStatus DataSize OperationLogStatus ReadRecords OperationLogSize ReadTime(sec) 19:01:00 ACTIVE 2007/01/01 12:00:00 100000 NORMAL NORMAL 12000 20.0MB 10.0KB 5.020 例2 directorの運用状態にdirectorのアクセス制限情報を追加して表示します。 - 43 - ReadSize 2 2.00MB shundstate -s shund1 -w -e 表示例 shundstate -s shund1 -w -e Shunsaku shundstate 2007/01/01 19:01:00 Time State DataFileStatus LastBackedUp Records 19:01:00 ACTIVE NORMAL 2007/01/01 12:00:00 100000 AccessState DataSize OperationLogStatus ReadRecords Fragments(%) OperationLogSize ReadTime(sec) ReadSize NORMAL 20.0MB NORMAL 12000 2 10.0KB 5.020 2.00MB 例3 directorの運用状態を60秒間隔で3回収集し、CSV形式で出力します。 Solaris/Linuxの場合 shundstate -s shund1 -w -C monitor/dirstate.csv 60 3 > /home/shunsaku/ Windowsの場合 shundstate -s shund1 -w -C \monitor\dirstate.csv 60 3 > C:\shunwork dirstate.csvの内容 "Time","State","DataFileStatus","DataSize","Fragments(%)","LastBackedUp","Operati onLogStatus","OperationLogSize","Records","ReadRecords","ReadTime(sec)","ReadSize " "2007/01/01 19:02:00","ACTIVE","NORMAL",21474836480,2,"2006/01/01 12:00:00","NORMAL",10240,100000,12000,2.080,1488977 "2007/01/01 19:03:00","ACTIVE","NORMAL",21474836480,2,"2006/01/01 12:00:00","NORMAL",10240,100000,20000,7.102,3145728 "2007/01/01 19:04:00","ACTIVE","NORMAL",21474836480,2,"2006/01/01 12:00:00","NORMAL",10240,100000,3130,1.050,325632 例4 現在有効となっているdirector用動作環境ファイルの実行パラメタを表示します。 shundstate -s shund1 -i 表示例 Solaris/Linuxの場合 shundstate -s shund1 -i Shunsaku shundstate 2007/01/01 19:01:00 Parameter Value - 44 - DataFileFolder MaxDataFileSize WarningDataFileSize LogFileFolder LogFileSize LogFileBackup LogFileSwitch PfmFileFolder PfmFileSize PfmFileBackup PfmFileSwitch CoreFileFolder OperationLogFolder MaxOperationLogSize WarningOperationLogSize MaxStoredRecords WarningStoredRecords AnsMax MultiMax SearcherWTimer(sec) ANKmix KNJmix SkipChar ExtendedQuery SeparateChar DirectKeyListFile DegradableSearcherCnt UsedTheShunrdbData SystemName /Shunsaku/ 10000MB 9000MB /var/opt/FJSVshnsk/log/director/ 100MB 1 0 /var/opt/FJSVshnsk/log/director/ 100MB 1 0 /var/opt/FJSVshnsk/core/director/ /Opelog/ 1000MB 900MB 4000000 3500000 100 100 180 0 0 "\s,\S,\n,\t" 0 Default DirectKey.txt 1 0 shunsaku Windowsの場合 shundstate -s shund1 -i Shunsaku shundstate 2007/01/01 19:01:00 Parameter DataFileFolder MaxDataFileSize WarningDataFileSize LogFileFolder LogFileSize LogFileBackup LogFileSwitch PfmFileFolder PfmFileSize PfmFileBackup PfmFileSwitch CoreFileFolder OperationLogFolder MaxOperationLogSize WarningOperationLogSize MaxStoredRecords WarningStoredRecords AnsMax MultiMax SearcherWTimer(sec) ANKmix KNJmix SkipChar ExtendedQuery SeparateChar DirectKeyListFile Value "C:\Shunsaku\" 10000MB 9000MB "C:\Program Files\Interstage Shunsaku\Shunsaku\log\director\" 100MB 1 0 "C:\Program Files\Interstage Shunsaku\Shunsaku\log\director\" 100MB 1 0 "C:\Program Files\Interstage Shunsaku\Shunsaku\core\director\" "D:\Shunsaku\Opelog\" 1000MB 900MB 4000000 3500000 100 100 180 0 0 "\s,\S,\n,\t" 0 Default "DirectKey.txt" - 45 - DegradableSearcherCnt UsedTheShunrdbData SystemName 1 0 shunsaku 例5 directorと接続しているsearcherの情報を表示します。 shundstate -s shund1 -p 表示例 shundstate -s shund1 -p Shunsaku shundstate 2007/01/01 19:01:00 Type LatestTime(sec) Searcher Searcher Searcher Searcher AlternativeSearcher ID Hostname State Records DataSize shuns04 shuns03 shuns02 shuns01 shuns05 SchSvr04 SchSvr03 SchSvr02 SchSvr01 SchWSvr01 INACTIVE ACTIVE ACTIVE ACTIVE ACTIVE 0 50000 50000 50000 50000 0.00KB 12.0MB 12.0MB 12.0MB 12.0MB 0.000 0.910 0.890 0.900 0.900 例6 directorと接続しているsearcherのサーチデータファイルの情報を表示します。 shundstate -s shund1 -p disk 表示例 shundstate -s shund1 -p disk Shunsaku shundstate 2007/01/01 19:01:00 Type Searcher(Disk) Searcher(Disk) Searcher(Disk) Searcher(Disk) AlternativeSearcher(Disk) ID shuns04 shuns03 shuns02 shuns01 shuns05 Hostname SchSvr04 SchSvr03 SchSvr02 SchSvr01 SchWSvr01 State INACTIVE ACTIVE ACTIVE ACTIVE ACTIVE Records 0 100000 100000 100000 100000 DataSize 0.00KB 1.80GB 1.80GB 1.80GB 1.80GB DataFileSize 0.00KB 330.0MB 330.0MB 330.0MB 330.0MB Fragments(%) 0 10 10 10 0 例7 directorのレコード件数、ディレクタデータファイルおよびオペレーションログファイルの使用量の情報を表示します。 shundstate -s shund1 -l 表示例 shundstate -s shund1 -l Shunsaku shundstate 2007/01/01 20:00:00 StoredRecordsStatus DataFileStatus OperationLogStatus NORMAL NORMAL NORMAL StoredRecords DataFileSize OperationLogSize 1500000 5200MB 300MB WarningStoredRecords WarningDataFileSize WarningOperationLogSize 3500000 9000MB 900MB - 46 - MaxStoredRecords MaxDataFileSize MaxOperationLogSize 4000000 10000MB 1000MB 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 形式1(運用状態の表示)のDataFileStatus(ディレクタデータファイルの状況)において、“WARNING”、“LIMIT”の状 況になった場合、ディレクタデータファイルの使用中サイズまたは、レコード件数が警戒値、最大値に達したことを表 しています。どちらの状況なのかは、lオプションを指定した形式4(格納レコード件数/ファイル使用状況の表示)で確 認してください。 ・ 形式1(運用状態の表示)において、Records(検索対象となる総レコード件数)が格納レコード件数の最大値に達する 前に、DataFileStatus(ディレクタデータファイルの状況)が“LIMIT”と表示される場合があります。これは、検索対象と なるレコード件数と追加処理中のレコードを含めた総レコード件数が最大値に達している場合に“LIMIT”となるため です。検索対象および追加処理中の総レコード件数については、lオプションを指定した形式4(格納レコード件数/ ファイル使用状況の表示)で確認することができます。 ・ 形式1(運用状態の表示)において、eオプションで表示される情報は、ShunsakuのV/Lによって情報が追加されたり、 表示位置が変更になる場合があります。 ・ 形式2(プロセス情報/動作環境情報の表示)によるオプションの指定において、pオプション、p diskオプション、および iオプションを省略した場合、wオプションが指定された場合と同等の動作が実施されます。 ・ 形 式 2 ( プ ロ セ ス 情 報 / 動 作 環 境 情 報 の 表 示 ) に お い て 、 p disk オ プ シ ョ ン で 表 示 さ れ る“Record”、“DataFileSize”、“Fragments(%)”は、各searcherから送信される情報を表示しています。そのため、以下 状態のときは、searcherの状態が“ACTIVE”でも処理が完了するまで状態が最新化されません。 - director起動処理における、searcherへのデータ配信処理中 - アプリケーションからのデータ追加、削除、更新処理中 - shundimportコマンドによる、データ格納、データ削除処理中 - shundrecoverコマンドによる、ディレクタデータファイルのリカバリ処理中 - shundresendコマンドによる、サーチデータの再配置処理中 - 縮退処理中 - 代替searcherへの切替え処理中 - 代替searcherから通常searcherへの切替え処理中 ・ 形式4(格納レコード件数/ファイル使用状況の表示)において、オペレーションログファイルに関する情報は、director 用動作環境ファイルのOperationLogFolderが指定されている場合のみ出力されます。 ・ directorに接続されているsearcherの情報は、directorの稼働状況が以下の時は、実際のsearcherの情報と一致しない 場合があります。 - ACTIVATING - DEGRADING - SWITCHING - WAITING ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 表示項目の見出しと意味 - 47 - wオプション指定時に出力される情報 Time 通常の形式による出力の場合 出力時間(hh:mm:ss) CSV形式による出力の場合 出力日時(YYYY/MM/DD hh:mm:ss) State directorの稼働状況 - ACTIVE:起動状態 - ACTIVATING:起動処理中 - DEGRADED:縮退状態 - DEGRADING:縮退処理中 - RESENDING:再配置中 - SWITCHING:searcherへの切替え中 - CONDENSING:最適化中 - BACKUP:バックアップ中 - RECOVER:リカバリ中 - WAITING:searcher接続待ち DataFileStatus ディレクタデータファイルの状況 - NORMAL:正常状態 - WARNING:ディレクタデータファイルの使用中サイズが警戒値に達した。または検索対象となるレコード件数 が警戒値に達した - LIMIT:ディレクタデータファイルの使用中サイズが最大値に達した。または検索対象および追加処理中の総 レコード件数が最大値に達した - FULL:ディレクタデータファイル領域不足 - IOERROR:ディレクタデータファイル入出力障害 DataSize ディレクタデータの総量 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 Fragments(%) フラグメンテーション率(%) LastBackedUp 最後のバックアップの開始宣言の実行時刻 (YYYY/MM/DD hh:mm:ss) OperationLogStatus オペレーションログファイルの格納ディレクトリの状況 (director用動作環境ファイルのOperationLogFolderが指定されている場合のみ出力されます) - NORMAL:正常状態 - WARNING:オペレーションログファイルの使用中サイズが警戒値に達した - LIMIT:オペレーションログファイルの使用中サイズが最大値に達した - FULL:オペレーションログファイル領域不足 - IOERROR:オペレーションログファイル入出力障害 OperationLogSize オペレーションログファイルの使用中サイズ (director用動作環境ファイルのOperationLogFolderが指定されている場合のみ出力されます) - 48 - 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 Records 検索対象となる総レコード件数 ReadRecords XMLデータ読込み累積件数 ReadTime(sec) XMLデータ読込み累積時間(秒) ReadSize XMLデータ読込み累積サイズ 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 以下は、wオプションかつeオプション指定時に出力されます。 AccessState directorのアクセス制限状態 - NORMAL :正常状態 - NON-UPDATE:アプリケーションからの更新抑止状態 - NON-ACCESS:アプリケーションからの検索更新抑止状態 pオプション指定時に出力される情報 Type プロセス種別 - Searcher:searcher - AlternativeSearcher:代替searcher - Searcher(Disk):ディスクsearcher(注) - Searcher(Disk):ディスクsearcher(注) 注) ディスク検索時のsearcherのことです。 ID searcher識別子 Hostname searcherのホスト名またはIPアドレス State searcherの稼働状況 - ACTIVE:起動状態 - ACTIVATING:起動処理中 - INACTIVE:停止状態 - IDLE:代替待機状態 Records 検索対象となるレコード件数 DataSize 検索対象となる総データ量 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 - 49 - LatestTime(sec) 最近の検索処理におけるsearcherの処理時間(秒) p diskオプション指定時に出力される情報 Type プロセス種別 - Searcher:searcher - AlternativeSearcher:代替searcher - Searcher(Disk):ディスクsearcher(注) - AlternativeSearcher(Disk):ディスク代替searcher(注) 注) ディスク検索時のsearcherのことです。 ID searcher識別子 Hostname searcherのホスト名またはIPアドレス State searcherの稼働状況 - ACTIVE:起動状態 - ACTIVATING:起動処理中 - INACTIVE:停止状態 Records 検索対象となるレコード件数 DataSize searcherにおいて検索対象となるデータを検索処理のために変換したサーチデータのサイズ 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 DataFileSize searcherが使用しているサーチデータファイル中のデータサイズ サーチデータファイル中のデータは、データの削除やデータの更新により、不要となった領域も含まれます。メモ リ検索の場合は、ハイフン(‘-’)が表示されます。 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトです Fragments(%) searcherが使用しているサーチデータファイルの無駄な領域の割合 メモリ検索の場合は、ハイフン(‘-’)が表示されます。 iオプション指定時に出力される情報 Parameter director用動作環境ファイルの実行パラメタ名 Value 実行パラメタに指定している値 lオプション指定時に出力される情報 StoredRecordsStatus directorの格納レコード件数の状況 - 50 - - NORMAL:正常状態 - WARNING:検索対象のレコード件数が警戒値に達した - LIMIT:検索対象および追加処理中の総レコード件数が最大値に達した StoredRecords 検索対象および追加処理中の総レコード件数 WarningStoredRecords 格納レコード件数の警戒値 director用動作環境ファイルのWarningStoredRecordsが指定されていない場合、通常の形式は“-”が出力され、CSV 形式は、値なしとして出力します。 MaxStoredRecords 格納レコード件数の最大値 director用動作環境ファイルのMaxStoredRecordsが指定されていない場合、通常の形式は“-”が出力され、CSV 形式は、値なしとして出力します。 DataFileStatus ディレクタデータファイルの状況 - NORMAL:正常状態 - WARNING:ディレクタデータファイルの使用中サイズが警戒値に達した - LIMIT:ディレクタデータファイルの使用中サイズが最大値に達した - FULL:ディレクタデータファイル領域不足 - IOERROR:ディレクタデータファイル入出力障害 DataFileSize ディレクタデータファイルの使用中サイズ 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 ディレクタデータファイルの状況が“IOERROR”の場合は、通常の形式は“-”が出力され、CSV形式は、値なしと して出力します。 WarningDataFileSize ディレクタデータファイルのサイズの警戒値 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 director用動作環境ファイルのWarningDataFileSizeが指定されていない場合、通常の形式は“-”が出力され、CSV 形式は、値なしとして出力します。 MaxDataFileSize ディレクタデータファイルのサイズの最大値 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 director用動作環境ファイルのMaxDataFileSizeが指定されていない場合、通常の形式は“-”が出力され、CSV形 式は、値なしとして出力します。 OperationLogStatus オペレーションログファイルの状況 director用動作環境ファイルのOperationLogFolderが指定されている場合のみ出力されます。 - NORMAL:正常状態 - WARNING:オペレーションログファイルの使用中サイズが警戒値に達した - LIMIT:オペレーションログファイルの使用中サイズが最大値に達した - 51 - - FULL:オペレーションログファイル領域不足 - IOERROR:オペレーションログファイル入出力障害 OperationLogSize オペレーションログファイルの使用中サイズ 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 director用動作環境ファイルのOperationLogFolderが指定されている場合のみ出力されます。またオペレーション ログファイルの状況が“IOERROR”の場合は、通常の形式は“-”が出力され、CSV形式は、値なしとして出力しま す。 WarningOperationLogSize オペレーションログファイルのサイズの警戒値 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 director用動作環境ファイルのOperationLogFolderが指定されている場合のみ出力されます。また、director用動 作環境ファイルのWarningOperationLogSizeが指定されていない場合、通常の形式は“-”が出力され、CSV形式 は、値なしとして出力します。 MaxOperationLogSize オペレーションログファイルのサイズの最大値 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 director用動作環境ファイルのOperationLogFolderが指定されている場合のみ出力されます。また、director用動 作環境ファイルのMaxOperationLogSizeが指定されていない場合、通常の形式は“-”が出力され、CSV形式は、 値なしとして出力します。 - 52 - 第5章 sorter用コマンド sorter用コマンドの詳細を説明します。 5.1 shunoservice 名前 shunoservice -- sorterのサービスへの登録・削除 形式 shunoservice -s sorter識別子 [ -n Shunsakuシステム名 ] [ -a | -d ] 機能説明 sorterをサービスに登録します。 または、sorterをサービスから削除します。 オプション -s sorter識別子 sorter識別子を指定します。 -n Shunsakuシステム名 Shunsakuシステム名を指定します。 本オプションを省略した場合、sorter用動作環境ファイルのSystemNameパラメタに指定したShunsakuシステム名が指 定されたものとみなします。 ただし、SystemNameパラメタが指定されていない場合は、Shunsakuシステム名に“shunsaku”が指定されたものとみな します。 -a 指定されたsorterをサービスに登録します。 -d 指定されたsorterをサービスから削除します。 使用例 例 Shunsakuシステム名が“shunsaku”、sorter識別子が“shuno1”のsorterをサービスに登録します。 shunoservice -s shuno1 -n shunsaku - 53 - 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドでsorterをサービスに登録するまでは、sorterを起動することはできません。 ・ aオプションおよびdオプションを省略した場合は、aオプションが指定されたものとみなします。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 5.2 shunostate 名前 shunostate -- sorterの状態表示 形式1(運用状態の表示) shunostate -s sorter識別子 [ -w ] [ -C ] [ 時間間隔 [ 繰返し回数 ] ] 形式2(動作環境情報の表示) shunostate -s sorter識別子 -i [ -C ] 形式3(統計情報のリセット) shunostate -s sorter識別子 -r 機能説明 sorterの状態を出力します。 本コマンドは、以下のような場合に使用できます。 ・ sorterの稼働状況を確認する ・ ソート要求の統計情報を確認する ・ sorterに設定されている動作環境を確認する - 54 - 形式1のオプション -s sorter識別子 sorter識別子を指定します。 -w sorterの運用状態を表示します。 -C CSV形式で出力します。 [ 時間間隔 [ 繰返し回数 ] ] sorterの運用状態を表示する場合に、時間間隔(秒)で指定された間隔をあけて、繰返し回数で指定された回数分の 運用情報を表示します。 時間間隔が省略された場合、起動時からの累積の運用情報を表示します。繰返し回数が省略された場合は、1が指 定されたものとみなします。 形式2のオプション -s sorter識別子 sorter識別子を指定します。 -i sorterに設定されている動作環境を表示します。 -C CSV形式で出力します。 形式3のオプション -s sorter識別子 sorter識別子を指定します。 -r sorterの運用状態の統計情報をリセットします。 使用例 例1 sorterの運用状態を表示します。 shunostate -s shuno1 -w 表示例 shunostate -s shuno1 -w Shunsaku shunostate 2007/01/01 19:01:00 Time State Requests Errors - 55 - AvgTime(sec) AvgUsedMemory 19:01:00 ACTIVE 2.000 22.0MB MaxTime(sec) MaxUsedMemory MaxTimeDetected MaxUsedMemoryDetected Concurrency 3515 30.000 32.0MB 0 2007/01/01 10:00:00 2007/01/01 10:00:00 5 例2 sorterの運用状態を60秒間隔で3回収集し、CSV形式で出力します。 Solaris/Linuxの場合 shunostate -s shuno1 -w -C 60 3 > /home/shunsaku/ monitor/srtstate.csv Windowsの場合 shunostate -s shuno1 -w -C 60 3 > C:\shunwork\monitor \srtstate.csv srtstate.csvへの出力内容 "Time","State","Requests","Errors","AvgTime(sec)","MaxTime(sec)","MaxTimeDet ected","AvgUsedMemory","MaxUsedMemory","MaxUsedMemoryDetected","Concurrency" "2007/01/01 19:02:00","ACTIVE",30,0,2.000,13.000,"2007/01/01 19:01:05", 20971520,29360128,"2007/01/01 19:01:10",2 "2007/01/01 19:03:00","ACTIVE",7,0,2.300,15.000,"2007/01/01 19:02:20", 23068672,33554432,"2007/01/01 19:02:30",5 "2007/01/01 19:04:00","ACTIVE",20,0,1.980,16.540,"2007/01/01 19:03:20", 24117248,34603008,"2007/01/01 19:03:30",3 例3 sorterに設定されている動作環境を表示します。 shunostate -s shuno1 -i 表示例 Solaris/Linuxの場合 shunostate -s shuno1 -i Shunsaku shunostate 2007/01/01 19:01:00 Parameter MultiMax LogFileFolder LogFileSize LogFileBackup LogFileSwitch PfmFileFolder PfmFileSize PfmFileBackup PfmFileSwitch CoreFileFolder SystemName Value 20 /var/opt/FJSVshnsk/log/sorter/ 100MB 1 0 /var/opt/FJSVshnsk/log/sorter/ 100MB 1 0 /var/opt/FJSVshnsk/core/sorter/ shunsaku - 56 - Windowsの場合 shunostate -s shuno1 -i Shunsaku shunostate 2007/01/01 19:01:00 Parameter MultiMax LogFileFolder \" LogFileSize LogFileBackup LogFileSwitch PfmFileFolder \" PfmFileSize PfmFileBackup PfmFileSwitch CoreFileFolder \sorter\" SystemName Value 20 "C:\Program Files\Interstage Shunsaku\Shunsaku\log\sorter 100MB 1 0 "C:\Program Files\Interstage Shunsaku\Shunsaku\log\sorter 100MB 1 0 "C:\Program Files\Interstage Shunsaku\Shunsaku\core shunsaku 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 形式2(状態の表示)によるオプションの指定において、iオプションを省略した場合、wオプションが指定された場合 と同等の動作が実施されます。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 表示項目の見出しと意味 wオプション指定時に出力される情報 Time 通常の形式による出力の場合 出力時間(hh:mm:ss) CSV形式による出力の場合 出力日時(YYYY/MM/DD hh:mm:ss) State sorterの稼働状況 ACTIVE:起動状態 Requests ソート処理要求の累積回数 Errors エラー応答の累積回数 - 57 - AvgTime(sec) 平均応答時間(秒) MaxTime(sec) 最大応答時間(秒) MaxTimeDetected 最大応答時間の検出日時(YYYY/MM/DD hh:mm:ss) AvgUsedMemory ソート要求ごとの平均使用メモリサイズ 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 MaxUsedMemory 1つのソート要求での最大使用メモリサイズ 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 MaxUsedMemoryDetected 1つのソート要求での最大使用メモリサイズの検出日時 Concurrency 現在処理中のソート要求数 iオプション指定時に出力される情報 Parameter sorter用動作環境ファイルの実行パラメタ名 Value 実行パラメタに指定している値 - 58 - 第6章 searcher用コマンド searcher用コマンドの詳細を説明します。 6.1 shunsservice 名前 shunsservice -- searcherのサービスへの登録・削除 形式 shunsservice -s searcher識別子 [ -n Shunsakuシステム名 ] [ -a | -d ] 機能説明 searcherをサービスに登録します。 または、searcherをサービスから削除します。 オプション -s searcher識別子 searcher識別子を指定します。 -n Shunsakuシステム名 Shunsakuシステム名を指定します。 本オプションを省略した場合、searcher用動作環境ファイルのSystemNameパラメタに指定したShunsakuシステム名が 指定されたものとみなします。 ただし、SystemNameパラメタが指定されていない場合は、Shunsakuシステム名に“shunsaku”が指定されたものとみな します。 -a 指定されたsearcherをサービスに登録します。 -d 指定されたsearcherをサービスから削除します。 使用例 例 Shunsakuシステム名が“shunsaku”、searcher識別子が“shuns01”のsearcherをサービスに登録します。 shunsservice -s shuns01 -n shunsaku - 59 - 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドでsearcherをサービスに登録するまでは、searcherを起動することはできません。 ・ aオプションおよびdオプションを省略した場合は、aオプションが指定されたものとみなします。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 6.2 shunsstate 名前 shunsstate -- searcherの状態表示 形式1(運用状態の表示) shunsstate -s searcher識別子 [ -w ] [ -C ] [ 時間間隔 [ 繰返し回数 ] ] 形式2(動作環境情報の表示) shunsstate -s searcher識別子 -i [ -C ] 形式3(統計情報のリセット) shunsstate -s searcher識別子 -r 機能説明 searcherの状態を出力します。 本コマンドは、以下のような場合に使用できます。 ・ searcherの稼働状況を確認する ・ 検索処理性能を確認する ・ searcherに設定されている動作環境を確認する - 60 - 形式1のオプション -s searcher識別子 searcher識別子を指定します。 -w searcherの運用状態を表示します。 -C CSV形式で出力します。 [ 時間間隔 [ 繰返し回数 ] ] searcherの運用状態を表示する場合に、時間間隔(秒)で指定された間隔をあけて、繰返し回数で指定された回数分 の運用情報を表示します。 時間間隔が省略された場合、起動時からの累積の運用情報を表示します。繰返し回数が省略された場合は、1が指 定されたものとみなします。 形式2のオプション -s searcher識別子 searcher識別子を指定します。 -i searcherに設定されている動作環境を表示します。 -C CSV形式で出力します。 形式3のオプション -s searcher識別子 searcher識別子を指定します。 -r searcherの運用状態の統計情報をリセットします。 使用例 例1 searcherの運用状態を表示します。 shunsstate -s shuns01 -w 表示例 shunsstate -s shuns01 -w Shunsaku shunsstate 2007/01/01 19:01:00 Time 19:01:00 State ACTIVE Records 5000 DataSize AvgTime(sec) MaxTime(sec) MaxTimeDetected 100KB 1.000 1.300 2007/01/01 13:00:00 - 61 - 例2 searcherの運用状態を60秒間隔で3回収集し、CSV形式で出力します。 Linuxの場合 shunsstate -s shuns01 -w -C 60 3 > /home/shunsaku/ monitor/srchstate.csv Windowsの場合 shunsstate -s shuns01 -w -C 60 3 > C:\shunwork \monitor\srchstate.csv srchstate.csvの内容 "Time","State","Records","DataSize","AvgTime(sec)","MaxTime(sec)","MaxTimeDetected" "2007/01/01 19:02:00","ACTIVE",5000,102400,1.010,1.200,"2007/01/01 13:00:00" "2007/01/01 19:03:00","ACTIVE",5020,107520,0.930,1.200,"2007/01/01 13:00:00" "2007/01/01 19:04:00","ACTIVE",5025,108544,0.805,1.200,"2007/01/01 13:00:00" 例3 searcherに設定されている動作環境を表示します。 shunsstate -s shuns01 -i 表示例 Linuxの場合 shunsstate -s shuns01 -i Shunsaku shunsstate 2007/01/01 19:01:00 Parameter LogFileFolder LogFileSize LogFileBackup LogFileSwitch PfmFileFolder PfmFileSize PfmFileBackup PfmFileSwitch CoreFileFolder SearchDataFileFolder SystemName Value /var/opt/FJSVshnsk/log/searcher/ 100MB 1 0 /var/opt/FJSVshnsk/log/searcher/ 100MB 1 0 /var/opt/FJSVshnsk/core/searcher/ /Shunsaku/ shunsaku Windowsの場合 shunsstate -s shuns01 -i Shunsaku shunsstate 2007/01/01 19:01:00 Parameter LogFileFolder \" LogFileSize LogFileBackup Value "C:\Program Files\Interstage Shunsaku\Shunsaku\log\searcher 100MB 1 - 62 - LogFileSwitch PfmFileFolder \" PfmFileSize PfmFileBackup PfmFileSwitch CoreFileFolder \" SearchDataFileFolder SystemName 0 "C:\Program Files\Interstage Shunsaku\Shunsaku\log\searcher 100MB 1 0 "C:\Program Files\Interstage Shunsaku\Shunsaku\core\searcher "C:\Shunsaku\" shunsaku 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 形式2(状態の表示)によるオプションの指定において、iオプションを省略した場合、wオプションが指定された場合 と同等の動作が実施されます。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 表示項目の見出しと意味 wオプション指定時に出力される情報 Time 通常の形式による出力の場合 出力時間(hh:mm:ss) CSV形式による出力の場合 出力日時(YYYY/MM/DD hh:mm:ss) State searcherの稼働状況 - ACTIVE:起動状態 - ACTIVATING:起動処理中 - IDLE:代替待機状態 Records 現在のレコード件数 DataSize 現在のデータ量 検索対象となるデータを検索処理のために変換した、内部データのデータ量を表示します。 通常の形式による出力の場合は、単位を付加して出力します。CSV形式による出力の場合は、単位はバイトで す。 AvgTime(sec) 平均検索時間(秒) - 63 - MaxTime(sec) 最大検索時間(秒) MaxTimeDetected 最大検索時間の検出日時(YYYY/MM/DD hh:mm:ss) iオプション指定時に出力される情報 Parameter searcher用動作環境ファイルの実行パラメタ名 Value 実行パラメタに指定している値 - 64 - 第7章 データベース連携用コマンド データベースとの連携で利用するコマンドの詳細を説明します。 7.1 shunrdb 名前 shunrdb -- Symfowareデータベースから抽出データファイルの作成 形式 shunrd b -r { all | diff } -l 抽出定義名 -f 抽出データファイルパス名 -w ワークディレクトリパス名 機能説明 Linkexpress Replication optionの抽出定義で指定したSymfowareのデータベースの表またはDSIに対して、shundimport コマンドの入力ファイルとなる抽出データファイルを作成します。 データベースとの連携方法については、“データベース連携ガイド”を参照してください。 オプション -r all 抽出定義で指定したデータベースの表に格納されているすべてのデータから、抽出データファイルを作成します。 -r diff Linkexpress Replication optionの機能で抽出した差分ログファイルから、抽出データファイルを作成します。 -l 抽出定義名 抽出定義名を指定します。 -f 抽出データファイルパス名 抽出データファイル出力先のファイルのパス名を絶対パス名で指定します。 抽出データファイルパス名に指定できる長さは、224バイトまでです。 -w ワークディレクトリパス名 本コマンドが利用する作業用領域のディレクトリのパス名を絶対パス名で指定します。 ワークディレクトリパス名に指定できる長さは、224バイトまでです。 作業用領域として必要な容量の見積りを以下に示します。 作業用領域 = 抽出対象とするBLOB列のサイズ × 2 使用例 - 65 - 例1 抽出定義(REPDEF01)で指定したデータベースの表に格納されているすべてのデータから、抽出データファイル(/ home/rdb2/list01)を作成します。 shunrdb -r all -l REPDEF01 -f /home/rdb2/list01 -w /tmp 例2 Linkexpress Replication optionの機能で抽出した差分ログファイルから、抽出データファイル(/home/rdb2/list02)を作 成します。 shunrdb -r diff -l REPDEF01 -f /home/rdb2/list02 -w /tmp 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンド実行前に、Linkexpress Replication optionを使用して抽出定義の登録処理(lxrepcreコマンド)により、抽出 定義をシステムに登録しておく必要があります。 ・ 差分ログファイルから抽出データファイルを作成する場合は、抽出定義の登録後、差分データの取得開始(lxrepena コマンド)を宣言しておく必要があります。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドにより作成される抽出データファイルは、スーパーユーザーの許可モードを持ちます。 ・ 抽出定義で指定したデータベースの表には、SELECT権が必要です。 ・ 抽出定義で指定したデータベースの表のDSOがSEQUENTIAL構造である必要があります。 ・ 本コマンドの実行中にキャンセルをした場合、ワークディレクトリパス配下に“TAIS”で始まるファイルが残ることがあり ます。この場合は、ファイルを削除してください。 ・ 本コマンドを実行すると、Symfoware Serverのrdbtaisコマンドが呼び出されます。そのため、RDBコマンドを動作させ るための環境変数をあらかじめ設定する必要があります。設定方法については、“FUJITSU Symfoware Server セッ トアップガイド”を参照してください。 - 66 - 第8章 V6.0系のコマンド V6.0系で提供していたコマンドの詳細を説明します。 最新のバージョンでも利用することが可能です。 8.1 shunccfgedit 名前 shunccfgedit -- conductor環境の動的変更 形式1(directorの追加) shunccfgedit -s conductor識別子 -a director番号 director識別子 形式2(directorの削除) shunccfgedit -s conductor識別子 -d director番号 形式3(検索起点directorの変更) shunccfgedit -s conductor識別子 -c director番号 機能説明 conductor環境を動的に変更します。 オプション -s conductor識別子 conductor識別子を指定します。 -a director番号 director識別子 directorを追加する場合に指定します。 追加するdirectorのdirector番号とdirector識別子を指定します。 -d director番号 directorを削除する場合に指定します。 削除するdirectorのdirector番号を指定します。 -c director番号 検索起点directorを変更する場合に指定します。 検索起点directorのdirector番号を指定します。 - 67 - 使用例 例1 directorを追加します。 shunccfgedit -s shunc -a 2 shund2 例2 directorを削除します。 shunccfgedit -s shunc -d 2 例3 検索起点directorを変更します。 shunccfgedit -s shunc -c 2 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドでは、システム用動作環境ファイルおよびconductor用動作環境ファイルの変更は行いません。本コマンド の実行と共に、システム用動作環境ファイル、またはconductor用動作環境ファイルの実行パラメタの値を変更してく ださい。 directorの追加(aオプション)およびdirectorの削除(dオプション)の場合は、システム用動作環境ファイルの 実行パラメタDirectorを変更してください。検索起点directorの変更(cオプション)の場合は、conductor用動作環境 ファイルの実行パラメタStartPointの値を変更してください。実行パラメタの値を変更せずにconductorを再起動する と、本コマンドを実行する前の環境に戻ります。 ・ 本コマンドは、稼働中システムに対する動的な変更の場合のみ有効です。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 8.2 shuncstart 名前 shuncstart -- conductorの起動 形式 shuncstart -s conductor識別子 機能説明 conductorを起動します。 - 68 - オプション -s conductor識別子 conductor識別子を指定します。 使用例 例 conductorを起動します。 shuncstart -s shunc 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ conductor用動作環境ファイルのSystemNameパラメタにShunsakuシステム名を指定する必要があります。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 8.3 shuncstop 名前 shuncstop -- conductorの停止 形式 shuncstop -s conductor識別子 [ -e ] 機能説明 conductorを停止します。 オプション -s conductor識別子 conductor識別子を指定します。 - 69 - -e 本オプションを指定した場合は、実行中の更新処理を強制的に終了し、conductorを強制的に停止します。 本オプションを省略した場合は、実行中の更新処理の終了を待ち合わせてから、conductorを停止します。 使用例 例 conductorを停止します。 shuncstop -s shunc 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 8.4 shundcfgedit 名前 shundcfgedit -- searcher数の動的変更 形式 shundcfgedit -s director識別子 -c searcher数 機能説明 searcher数を動的に変更します。 オプション -s director識別子 director識別子を指定します。 -c searcher数 searcherの総数を1~20の値で指定します。 本オプションは、システム用動作環境ファイルのSearcherパラメタで指定する、本directorに接続しているsearcher数よ りも大きな値を指定してください。 - 70 - 使用例 例 searcher数を18に変更します。 shundcfgedit -s shund1 -c 18 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドでは、システム用動作環境ファイルの変更は行いません。本コマンドの実行と共に、システム用動作環境 ファイルの実行パラメタSearcherを追加してください。実行パラメタの値を変更せずにdirectorを再起動すると、接続 searcher数は本コマンドを実行する前の数に戻ります。 ・ 本コマンドは、稼働中システムに対する動的なサーチサーバ増設の場合のみ有効です。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 8.5 shundstart 名前 shundstart -- directorの起動 形式 shundstart -s director識別子 機能説明 directorを起動します。 オプション -s director識別子 director識別子を指定します。 使用例 - 71 - 例 directorを起動します。 shundstart -s shund1 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ director用動作環境ファイルのSystemNameパラメタにShunsakuシステム名を指定する必要があります。 ・ 本コマンド投入後、directorがシステム用動作環境ファイルの実行パラメタSearcherにて指定したsearcher数分の接続 を受け付けるまで、またはディレクタデータが存在し、searcherへのディレクタデータのデータ配信が完了するまで、 コマンドは復帰しません。 ・ 本コマンド実行中は、データの検索および更新はできません。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 8.6 shundstop 名前 shundstop -- directorの停止 形式 shundstop -s director識別子 [ -a | -e ] 機能説明 directorを停止します。 または、接続しているすべてのsearcherを停止します。 オプション -s director識別子 director識別子を指定します。 -a 本オプションを指定した場合は、接続しているすべてのsearcherも同時に停止します。 本オプションを省略した場合は、directorのみが停止し、searcherは停止しません。 - 72 - -e 本オプションを指定した場合は、実行中のデータ検索または更新処理を強制的に終了し、directorを強制的に停止 します。 本オプションを省略した場合は、データの更新が実行中の場合は、本コマンドが異常終了します。 使用例 例1 directorおよびsearcherを停止します。 shundstop -s shund1 -a 例2 directorを強制的に停止します。 shundstop -s shund1 -e 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドにて、directorを停止させても、ディレクタデータは消去されません。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 8.7 shunostart 名前 shunostart -- sorterの起動 形式 shunostart -s sorter識別子 機能説明 sorterを起動します。 オプション - 73 - -s sorter識別子 sorter識別子を指定します。 使用例 例 sorterを起動します。 shunostart -s shuno1 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ sorter用動作環境ファイルのSystemNameパラメタにShunsakuシステム名を指定する必要があります。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 8.8 shunostop 名前 shunostop -- sorterの停止 形式 shunostop -s sorter識別子 [ -e ] 機能説明 sorterを停止します。 オプション -s sorter識別子 sorter識別子を指定します。 -e 実行中のソートまたは集計処理を強制的に終了し、sorterを強制的に停止します。 - 74 - 使用例 例 sorterを停止します。 shunostop -s shuno1 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 8.9 shunsstart 名前 shunsstart -- searcherの起動 形式 shunsstart -s searcher識別子 機能説明 searcherを起動します。 オプション -s searcher識別子 searcher識別子を指定します。 使用例 例 searcherを起動します。 shunsstart -s shuns01 - 75 - 終了ステータス 以下の終了ステータスが返されます。 0:正常終了 0以外:異常終了 注意 ・ searcher用動作環境ファイルのSystemNameパラメタにShunsakuシステム名を指定する必要があります。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 8.10 shunsstop 名前 shunsstop -- searcherの停止 形式 shunsstop -s searcher識別子 [ -e ] 機能説明 searcherを停止します。 オプション -s searcher識別子 searcher識別子を指定します。 -e データを保持している状態で本オプションを指定した場合は、強制停止を行います。 データを保持している状態で本オプションを省略した場合は、エラーとなります。 データを保持していない場合は、本オプションの指定に関係なく停止します。 使用例 例 searcherを停止します。 shunsstop -s shuns01 終了ステータス 以下の終了ステータスが返されます。 - 76 - 0:正常終了 0以外:異常終了 注意 ・ 通常、searcherを停止させる場合には、ディレクタサーバにてshundstopコマンドのaオプションを指定して、directorと 共に停止してください。 ・ 本コマンドは、スーパーユーザーのみ実行可能です。 ・ 本コマンドは、“Administrators”グループに属するユーザのみ実行可能です。 - 77 - 索 引 [C] conductorおよびコネクションの状態表示................................17 conductor環境の動的変更......................................................67 conductorの起動......................................................................68 conductorのサービスへの登録・削除......................................16 conductorの停止......................................................................69 conductor用コマンド..............................................................4,16 shunsysstart.................................................................................9 shunsysstate..............................................................................10 shunsysstop...............................................................................14 sorterの起動.............................................................................73 sorterのサービスへの登録・削除.............................................53 sorterの状態表示.....................................................................54 sorterの停止.............................................................................74 sorter用コマンド.....................................................................5,53 Symfowareデータベースから抽出データファイルの作成......65 [D] directorの起動..........................................................................71 directorのサービスへの登録・削除..........................................40 directorの状態表示..................................................................41 directorの停止..........................................................................72 director用コマンド..................................................................4,27 [V] V6.0系のコマンド..................................................................3,67 [X] XML文書の取込み.................................................................33 XML文書の抽出.....................................................................30 XML文書への更新抑止、検索更新抑止の設定および解除.... 39 [S] searcher数の動的変更.............................................................70 searcherの起動.........................................................................75 searcherのサービスへの登録・削除.........................................59 searcherの状態表示.................................................................60 searcherの停止.........................................................................76 searcher用コマンド.................................................................5,59 shunccfgedit..............................................................................67 shuncservice..............................................................................16 shuncstart..................................................................................68 shuncstate..................................................................................17 shuncstop..................................................................................69 shuncterm..................................................................................25 shundbackup.............................................................................27 shundcds...................................................................................28 shundcfgedit..............................................................................70 shundclear.................................................................................29 shundexport..............................................................................30 shundimport..............................................................................33 shundrecover.............................................................................35 shundresend..............................................................................37 shundrestrict..............................................................................39 shundservice.............................................................................40 shundstart..................................................................................71 shundstate.................................................................................41 shundstop..................................................................................72 shunoservice.............................................................................53 shunostart..................................................................................73 shunostate.................................................................................54 shunostop..................................................................................74 shunprtmsg..................................................................................7 shunrdb.....................................................................................65 Shunsakuの起動.........................................................................9 Shunsakuの停止.......................................................................14 Shunsakuの動作環境の動的な変更.........................................8 Shunsakuのプロセス構成情報の表示.....................................10 shunsservice..............................................................................59 shunsstart..................................................................................75 shunsstate..................................................................................60 shunsstop..................................................................................76 shunsyscfgedit............................................................................8 [あ] 運用............................................................................................2 [か] 環境変更....................................................................................2 起動・停止..................................................................................1 コネクション.................................................................................2 コネクションの回収...................................................................25 コマンド一覧...............................................................................1 コマンド一覧(機能別)...............................................................1 コマンド一覧(サーバ別)...........................................................3 コマンド使用時の注意...............................................................5 [さ] サーチデータの再配置、および、サーチデータファイルの最適化 ..................................................................................................37 サーバ共通のコマンド............................................................4,7 セットアップ.................................................................................1 [た] ディレクタデータおよびサーチデータの破棄.........................29 ディレクタデータのリカバリ開始宣言または終了宣言、およびオ ペレーションログファイルのリカバリ.........................................35 ディレクタデータファイルの最適化..........................................28 ディレクタデータファイルのバックアップ開始宣言および終了宣言 ..................................................................................................27 データベース連携......................................................................3 データベース連携用コマンド................................................5,65 [は] バックアップ・リカバリ..................................................................2 [ま] メッセージ...................................................................................3 メッセージの説明の表示............................................................7 モニタリング................................................................................2 - 78 -
© Copyright 2024 Paperzz