統合RAS収集コマンドは，Collaborationのシステム上に格納されている各コンポーネントのjarファイルを収集し，さらに一つのjarファイルにするコマンドです。統合RAS収集コマンドを実行すると，収集したjarファイルが格納され統合RASファイルが生成されます。

各コンポーネントは，confファイルを用意します。

RAS収集機能の概要の例を次に示します。

図6-1　RAS収集機能の概要の例

図の説明

1. RAS収集コマンドを実行します。
2. プロパティファイル（CollaboRAS.properties）を呼び出します。
3. CollaboRAS.propertiesに記述されている各コンポーネントのconfファイルを呼び出します。
4. 各コンポーネントのjarファイルを作成します。jarファイルには各コンポーネントのconfファイルに記述されているファイルが格納されます。
5. 各コンポーネントのjarファイルを一つのjarファイルにまとめます。

 
ClbRAS△プロパティファイルパス名△出力ファイルパス名
 

注

形式中の「△」は半角の空白文字を表します。

コーディング例

ClbRAS D:\Collaboration\conf\CollaboRAS.properties D:\Collaboration\RAS\clbras.jar

0	RAS収集コマンドが正常に終了しました。
1以上	RAS収集コマンドでエラーが発生しました。

(a)　プロパティファイル

各コンポーネントのconfファイルの絶対パスを記述します。

RAS収集プロパティファイルの記述例（CollaboRAS.propertiesの内容）を次に示します。

# <Collaboration - Common Utility>
CCU=C:\\Program Files\\Hitachi\\Collaboration\\clb_home\\conf\\hptl_clb_ccu_ras.conf
# <Collaboration - Online Community Management>
CCM=C:\\Program Files\\Hitachi\\Collaboration\\clb_home\\conf\\hptl_clb_ccm_ras.conf
# <Collaboration - Mail>
CML=C:\\Program Files\\Hitachi\\Collaboration\\clb_home\\conf\\hptl_clb_cml_ras.conf
# <Collaboration - Schedule>
CSC=C:\\Program Files\\Hitachi\\Collaboration\\clb_home\\conf\\hptl_clb_csc_ras.conf
# <Collaboration - Forum>
CFR=C:\\Program Files\\Hitachi\\Collaboration\\clb_home\\conf\\hptl_clb_cfr_ras.conf
# <Collaboration - File Sharing>
CFS=C:\\Program Files\\Hitachi\\Collaboration\\clb_home\\conf\\hptl_clb_cfs_ras.conf
# <Collaboration - Directory Access>
CUM=C:\\Program Files\\Hitachi\\Collaboration\\clb_home\\conf\\hptl_clb_cum_ras.conf
# <Collaboration - Calendar>
CCC=C:\\Program Files\\Hitachi\\Collaboration\\clb_home\\conf\\hptl_clb_ccc_ras.conf
# <Collaboration - Bulletin board>
CBB=C:\\Program Files\\Hitachi\\Collaboration\\clb_home\\conf\\hptl_clb_cbb_ras.conf
# <Collaboration - Navigation View>
CNV=C:\\Program Files\\Hitachi\\Collaboration\\clb_home\\conf\\hptl_clb_cnv_ras.conf

　

• CollaboRAS.properties内の先頭が「#」で始まる行はコメント行として扱います。
• 各行（CCU，CCM，CML，CSC，CFR，CFS，CUM，CCC，CBB，CNV）のコメントを外し，confファイルのパスを指定してください。
• CollaboRAS.propertiesのフォーマットは，JavaのPropertiesクラスの仕様に従ってください。
• CollaboRAS.propertiesは次の形式で指定します。
  キー名＝各コンポーネントのconfファイルの絶対パス
  
• キー名はアプリケーション識別子とします。
• パス名は絶対パス名で指定してください。
• 日本語を含む値を指定する場合は，uCosminexus Application Server付属のJDKコマンド（native2asciiコマンド）によってファイルを変換する必要があります。

(b)　confファイル

各コンポーネントのjarファイルに格納するファイルの絶対パスを記述します。

Collaborationのconfファイル（hptl_clb_ccu_ras.conf）の記述例を次に示します。

C:\Program Files\Hitachi\Collaboration\clb_home\log
C:\Program Files\Hitachi\Collaboration\clb_home\conf
C:\Program Files\Hitachi\CosmiPortalLight\conf
C:\Program Files\Hitachi\Collaboration\deploy_work\WEB-INF\conf
C:\Program Files\Hitachi\CosmiPortalLight\log
C:\Program Files\Hitachi\Cosminexus\CC\server\public\ejb\server1\logs
C:\Program Files\Hitachi\Cosminexus\CC\server\usrconf\ejb\server1
　

• confファイルには取得するファイルの存在するディレクトリ名またはファイル名を指定してください。
• confファイル内の先頭が「#」で始まる行はコメント行として扱います。
• パス名にはワイルドカード（*）は指定できません。
• パス名は絶対パス名で指定してください。
• 日本語を含む値を指定する場合もnative2asciiコマンドを実行する必要はありません。実行環境の文字コードに合わせてファイルを保存してください。
• 同一confファイル内に同じファイルを2回指定した場合，または別ドライブで同じファイル名を指定した場合は，あとから指定したファイルでjarファイルの内容が上書きされます。
• hptl_clb_ccu_ras.confファイルには次のディレクトリを設定してください。
  <Collaborationインストールディレクトリ>\clb_home\log
  <Collaborationインストールディレクトリ>\clb_home\conf
  <Collaborationインストールディレクトリ>\clb_home\message
  <uCosminexus Portal Frameworkの設定ファイルディレクトリ>^※
  <uCosminexus Portal FrameworkのPortal Managerで指定したログ出力先ディレクトリ>
  <該当するJ2EEサーバの作業ディレクトリ>\ejb\<サーバ名称>\logs
  <Component Containerのインストールディレクトリ>\server\usrconf\ejb\<サーバ名称>
  

  注※

  <uCosminexus Portal Frameworkのインストールディレクトリ>\confおよび次のディレクトリ

  Windows Server 2008 R2，Windows Server 2008 x64，Windows Server 2012 R2，Windows Server 2012の場合

  C:\Program Files(x86)\Hitachi\Collaboration\deploy_work\WEB-INF\conf

  そのほかのOS（Windows）を使用している場合

  C:\Program Files\Hitachi\Collaboration\deploy_work\WEB-INF\conf

• 「出力ファイルパス名」は絶対パス名で指定してください。
• 統合RAS収集コマンド実行後，2段のjarファイルを展開し，障害の状況に応じたキーワードで収集した全ファイルを文字列検索してください。
• CollaboRAS.propertiesに指定するconfファイルのパスに誤りがあった場合，動作は停止しないで，ログファイルにエラーメッセージを出力後，ほかのconfファイルの読み込みを継続します。
• 「<出力ファイルパス名>_log.log」というファイル名でログファイルが作成されます。
• ClbRASコマンドを途中で中断した場合は一時ディレクトリが残るため，一時ディレクトリを手動で削除してください。一時ディレクトリは，ClbRASコマンドの実行時に指定した，出力ファイルパス名の下にあります。一時ディレクトリの名称と意味を次に示します。
  

  一時ディレクトリの名称

  logyyyymmdd_hhmmss

  意味

  log：固定です。

  yyyy：年（西暦（4桁））です。

  mm：月（01〜12）です。

  dd：日（01〜31）です。

  _（アンダーバー）：固定です。

  hh：時（00〜23）です。

  mm：分（00〜59）です。

  ss：秒（00〜59）です。

  例

  log20040301_101050