
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/
   ・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 で実行する。

  3-1. HinemosBuild/bin/deploy/ ディレクトリに、EJBモジュールが作成される。
       ・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

       
  3-2. HinemosBuild/bin/lib/ ディレクトリに、EJBライブラリモジュールが作成される。
       ・apllog.jar
       ・clustercontrol.jar
       ・FailoverMonitorService.jar
       ・hinemos-commons.jar
       ・message.jar
       ・PerfCollectorLib.jar
       ・PerfMonitorLib.jar
       ・performance.jar
       ・PerfService.jar
       ・SnmpSharedTable.jar
       ・SnmpTrapService.jar
       ・TroubleDetectionService.jar

       
  3-3. ./bin/Agent/ ディレクトリに、agent.jar が作成される。
   
  3-4. ./bin/SyslogForward/ ディレクトリに、syslogforward.jar が作成される。
  
  3-5. ./bin/QuartzSetup/ ディレクトリに、quartzsetup.jar が作成される。
    
  3-6. ./bin/LogAgent/ ディレクトリに、logagent.jar が作成される。


4. 以下のディレクトリを、Eclipse のワークスペースディレクトリに配置する。
   ・ClusterControl/
   ・CollectiveRun/
   ・HinemosAgent/
   ・Http/
   ・JobManagement/
   ・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/ 以下の
       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
	を HinemosBuild/bin/deploy/ 以下のものと置き換える。
	
  1.2. EJBの利用するライブラリの置き換え
	/opt/hinemos/jboss-4.0.3SP1/server/default/lib/ 以下の
	   JobManagementEJB.jar
       MonitorEJB.jar
       MonitorRunEJB.jar
       RepositoryEJB.jar
       apllog.jar
       clustercontrol.jar
       hinemos-commons.jar
       PerfCollectorLib.jar
       PerfMonitorLib.jar
       PerfService.jar
       SnmpSharedTable.jar
	を HinemosBuild/bin/deploy/、HinemosBuild/bin/lib/ 以下のものと置き換える。
	
   1.3. ログ転送プログラムの置き換え
	/opt/hinemos/lib/syslogforward/ 以下の
		syslogforward.jar
	を HinemosBuild/bin/SyslogForward/ 以下のものと置き換える。
	さらに、 /opt/hinemos/lib/ 以下の
		MonitorEJB.jar
		RepositoryEJB.jar
		SyslogNGEJB.jar
		CalendarEJB.jar
		clustercontrol.jar
		hinemos-commons.jar
	を HinemosBuild/bin/deploy/、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/agent/ 以下の
		agent.jar
	を HinemosBuild/bin/Agent/ 以下のものと置き換える。
	
	/opt/hinemos_agent/lib/log_agent/ 以下の
		logagent.jar
	を HinemosBuild/bin/LogAgent/ 以下のものと置き換える。
	
	さらに/opt/hinemos_agent/lib/ 以下の
		JobManagementEJB.jar
		LogTransferEJB.jar
		MonitorEJB.jar
		RepositoryEJB.jar
		clustercontrol.jar
		hinemos-commons.jar
	を HinemosBuild/bin/deploy/、HinemosBuild/bin/lib/ 以下のものと置き換える。

	置き換え完了後ジョブエージェント及びログ転送エージェントを再起動する。



III. JavaDocの生成方法

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

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