
HinemosビルドREADME
	Copyright (C) 2006 NTT DATA Corporation



本READMEは以下の項目についての記述があります。

I.   ソースからのビルド方法
II.  ビルドされたモジュールの配置方法
III. JavaDocの生成方法



I. ソースからのビルド方法

ここでのビルド手順では、Ant 及び Eclipse を使用したビルド方法を説明します。

以下のバージョンを利用して下さい。
 Eclipse：3.1.1
 JDK    ：1.5.0.09
 Ant    ：1.6.5
 
Ant 及び Eclipse 等のセットアップ方法、使い方については下記URLを参照下さい。
 Eclipse：http://www.eclipse.org/
 JDK    ：http://java.sun.com/j2se/
 Ant    ：http://ant.apache.org/


手順（HinemosのすべてのEJBモジュール）
1. Eclipse, JDK  及び Ant をセットアップする。
   ※Eclipseには日本語パッチを適用してください。
   
2. ソースを適当なディレクトリに展開する。
   ※展開先ディレクトリに、以下のファイル及び、ディレクトリが展開される。
   ・README (本ドキュメント)
   ・AccessControlEJB/
   ・Agent/
   ・AppLog/
   ・CalendarEJB/
   ・ClusterControl/
   ・CollectiveRun/
   ・CollectiveRunEJB/
   ・FailoverMonitorService/
   ・HinemosAgent/
   ・HinemosAgentEJB/
   ・HinemosBuild/
   ・HinemosCommons/
   ・HinemosWebRcp/
   ・Http/
   ・HttpEJB/
   ・JobManagement/
   ・JobManagementEJB/
   ・LogTransferAgent/
   ・LogTransferEJB/
   ・Maintenance/
   ・MaintenanceEJB/
   ・Monitor/
   ・MonitorEJB/
   ・MonitorRunEJB/
   ・NotifyEJB/
   ・Performance/
   ・PerformanceManagement/
   ・PerformanceMonitor/
   ・PerformanceService/
   ・Ping/
   ・PingEJB/
   ・PriorityJudgmentEJB/
   ・Process/
   ・ProcessEJB/
   ・QuartzManagerEJB/
   ・QuartzSetup/
   ・Repository/
   ・RepositoryEJB/
   ・Snmp/
   ・SnmpEJB/
   ・SnmpSharedTable/
   ・SnmpTrap/
   ・SnmpTrapEJB/
   ・SnmpTrapService/
   ・Sql/
   ・SqlEJB/
   ・SyslogForward/
   ・SyslogNG/
   ・SyslogNGEJB/
   ・TroubleDetection/
   ・TroubleDetectionEJB/
   ・TroubleDetectionService/
         
         
3. ソースの展開先ディレクトリ配下の HinemosBuild ディレクトリの build.xml を ant で実行する。

     ※実行前に、HinemosBuild/MANIFEST.MFを修正し、copy_manifest.xmlをantで実行してください。
       各プロジェクトの、src/META-INF配下にある、MANIFEST.MFファイルが更新されます。
       リリース時にはこれを徹底するようにしてください。
       
     ※パッチ作成時は各プロジェクトの、src/META-INF配下にある、MANIFEST.MFファイルを直接編集し、
       各プロジェクト配下にある、build.xmlを実行して、jarファイルを作成してください。
  
      実行すると、HinemosBuild/bin/ ディレクトリに、以下のディレクトリが作成され、
      インストール後と同じディレクトリ構造で、必要なモジュールが作成される。
      
       ・agent			エージェント
       ・default		マネージャ(JBossに配備されるモジュール)
       ・lib			マネージャ(ライブラリとして使用されるモジュール)
       ・QuartzSetup	
       
     以下、それぞれの構成について述べる。
  
  
  3-1. HinemosBuild/bin/agent ディレクトリ
  
     エージェントパッケージでは、利用するjarファイルは同じです。
     HinemosBuild/bin/agent ディレクトリ以下に、各種モジュールが作成されます。
     －agentディレクトリ
       ・agent.jar
       
     －log_agentディレクトリ
       ・logagent.jar
       
     －HinemosBuild/bin/agent ディレクトリ直下
       ・hinemos-commons.jar
       ・JobManagementEJB.jar
       ・LogTransferEJB.jar
       ・MonitorEJB.jar
       ・RepositoryEJB.jar
  
  
  3-2. HinemosBuild/bin/default/ ディレクトリ
  
     jbossに配備するためのモジュールが作成されています。
       
     －deployディレクトリ
       ・AccessControlEJB.jar
       ・CalendarEJB.jar
       ・CollectiveRunEJB.jar
       ・HinemosAgentEJB.jar
       ・HttpEJB.jar
       ・JobManagementEJB.jar
       ・LogTransferEJB.jar
       ・MonitorEJB.jar
       ・MonitorRunEJB.jar
       ・NotifyEJB.jar
       ・PerfCollectorEJB.jar
       ・PerfMonitorEJB.jar
       ・PingEJB.jar
       ・PriorityJudgmentEJB.jar
       ・ProcessEJB.jar
       ・QuartzManagerEJB.jar
       ・RepositoryEJB.jar
       ・SnmpEJB.jar
       ・SnmpTrapEJB.jar
       ・SqlEJB.jar
       ・SyslogNGEJB.jar
       ・TroubleDetectionEJB.jar
       
     －libディレクトリ
       ・apllog.jar
       ・clustercontrol.jar
       ・FailoverMonitorService.jar
       ・hinemos-commons.jar
       ・message.jar
       ・MonitorEJB.jar
       ・MonitorRunEJB.jar
       ・PerfCollectorLib.jar
       ・PerfMonitorLib.jar
       ・performance.jar
       ・PerfService.jar
       ・RepositoryEJB.jar
       ・SnmpSharedTable.jar
       ・SnmpTrapService.jar
       ・TroubleDetectionService.jar

       
  3-3. HinemosBuild/bin/lib/ ディレクトリ
       
     hinemos/libに配置するためのモジュールが作成されています。
       
       ・CalendarEJB.jar
       ・clustercontrol.jar
       ・hinemos-commons.jar
       ・MonitorEJB.jar
       ・RepositoryEJB.jar
       ・SyslogNGEJB.jar
       
     －syslogforwardディレクトリ
       ・syslogforward.jar


  3-4. ./bin/QuartzSetup/ ディレクトリ
  
     quartzsetup.jar が作成されます。



4. 以下のディレクトリを、Eclipse のワークスペースディレクトリに配置する。
   ・ClusterControl/
   ・CollectiveRun/
   ・HinemosAgent/
   ・Http/
   ・JobManagement/
   ・Maintenance/
   ・Monitor/
   ・Performance/
   ・Ping/
   ・Process/
   ・Repository/
   ・Snmp/
   ・SnmpTrap/
   ・Sql/
   ・SyslogNG/
   ・TroubleDetection/

5. Eclipseのワークスペースに既存プロジェクトをインポートする。

  5-1. Eclipseのインポートにて、既存プロジェクトをワークスペースへ を選択する。

  5-2. 4.で配置したディレクトリを選択し、OKボタンを押す。

  5-3. プロジェクトがインポートされる。

6. Eclipseにインポートしたプロジェクトをビルドする。
   ※テキスト・ファイル・エンコードを「UTF-8」に設定してください。
   ※新規テキスト・ファイルの行区切り文字を「Unix」に設定してください。
   ※コンパイラ準拠レベルを「5.0」に設定してください。
   ※以下の各プロジェクトのビルド手順を参照してください。



II. モジュールの配置方法

 ここでは、既にインストーラを用いて、Hinemosのマネージャ、エージェント、クライアントが
セットアップされいる環境に対して、モジュールを置き換える方法について説明します。

1. マネージャ
  以下を行なう前にHinemosマネージャを停止する。

  1.1. EJBモジュールの置き換え  
	/opt/hinemos/jboss-4.0.3SP1/server/default/deploy/ 以下に、
	HinemosBuild/bin/deploy/ 以下のものをコピーする。
	
  1.2. EJBの利用するライブラリの置き換え
	/opt/hinemos/jboss-4.0.3SP1/server/default/lib/ 以下に、
	HinemosBuild/bin/lib/ 以下のものをコピーする。	
	
  1.3. ログ転送プログラムの置き換え
	/opt/hinemos/lib/ 以下に、
	HinemosBuild/bin/lib/ 以下のものをコピーする。
	
	置き換え完了後Hinemosマネージャを起動する。
	Syslog-ngを再起動する。


2. クライアント
	「I.ソースからのビルド方法」6.の結果として生成されるディレクトリ内の./plugin/com.clustercontrol.××-2.*.*を
	<Hinemosクライアントをインストールしたディレクトリ>/eclipse-3.1.1/plugins/に存在するものと
	置き換える。
	
	置き換え完了後Hinemosクライアントを再起動する。	


3. エージェント
    以下を行なう前に、ジョブエージェント及びログ転送エージェントを停止する。

	/opt/hinemos_agent/lib/ 以下に
	HinemosBuild/bin/agent 以下のものをコピーする。
	
	置き換え完了後ジョブエージェント及びログ転送エージェントを再起動する。



III. JavaDocの生成方法

 ここでは、JavaDocを生成する方法について説明します。
 
    1. 「I.ソースからのビルド方法」を参考に、ビルドを実行します。
    
    2. ソースの展開先ディレクトリ配下の HinemosBuild ディレクトリの javadoc-build.xml を ant で実行する。

    3. HinemosBuild/javadoc/ ディレクトリに、JavaDocが生成される。
    
