Hitachi

Cosminexus V11 BPM/ESB基盤 サービスプラットフォーム ファーストステップガイド


3.3.3 Service Architect用Eclipseセットアップ機能を使用した開発環境の構築

ここでは,開発環境の構築で使用する,Service Architect用Eclipseセットアップ機能について説明します。

注意事項

Service Architect用Eclipseセットアップの実行時は,次の点に注意してください。

  • Service Architect用Eclipseセットアップの前に,次の環境変数が正しく設定されていることが必要です。

    環境変数名

    説明

    COSMINEXUS_HOME

    Cosminexusのインストールディレクトリのパス

    TEMPおよびTMP

    WindowsのTemp領域のパス

  • Service Architect用Eclipseセットアップは,管理者権限で実行する必要があります。

  • Service Architect用Eclipseセットアップは,Eclipseを停止した状態で実行する必要があります。

  • Service Architect用Eclipseセットアップは,Eclipseセットアップ実行後に実行する必要があります。

  • Service Architect用Eclipseセットアップは,複数回実行しないでください。

〈この項の構成〉

(1) Service Architect用Eclipseセットアップ機能の実行方法

Service Architect用Eclipseセットアップ機能を実行するには,Windowsの[スタート]メニューから,[Cosminexus]−[Service_Architect用Eclipseセットアップ]を選択します。

これによって,JDKバージョンに応じたService Architect用の-vmargsオプションが,eclipse.iniに追記されます。

Service Architect用Eclipseセットアップの実行時は,メッセージログに実行時の情報(通知・エラーなど)がメッセージとして出力されます。メッセージログについては「(2) Service Architect用Eclipseセットアップのメッセージログ」を参照してください。

(a) eclipse.iniに追記される内容

eclipse.iniに追記される内容を次に示します。

  • JDK 11をインストールした環境の場合

    -Xbootclasspath/a:<Service Architectのインストールディレクトリ>\jaxp\lib\csmjaxp.jar;<Service Architectのインストールディレクトリ>\jaxp\lib\csmstax.jar

  • JDK 17をインストールした環境の場合

    "--add-opens java.base/java.lang=ALL-UNNAMED"

(b) オプション追加後のeclipse.iniファイルの内容

オプション追加後のeclipse.iniファイルの内容の例を次に示します。

  • JDK 11をインストールした環境の場合

    -vm
    C:\Program Files\Hitachi\Cosminexus\jdk\bin\javaw.exe
     :(略)
    --add-modules=ALL-SYSTEM
    -Xbootclasspath/a:C:\Program Files\Hitachi\Cosminexus\jaxp\lib\csmjaxp.jar;C:\Program Files\Hitachi\Cosminexus\jaxp\lib\csmstax.jar
  • JDK 17をインストールした環境の場合

    -vm
    C:\Program Files\Hitachi\Cosminexus\jdk\bin\javaw.exe
     :(略)
    --add-modules=ALL-SYSTEM
    "--add-opens java.base/java.lang=ALL-UNNAMED"

(c) eclipse.iniファイルのデフォルトの格納先

eclipse.iniファイルのデフォルトの格納先を次に示します。

<Service Architectのインストールディレクトリ>\ADP\IDE\eclipse
ポイント

eclipse.iniは,Windowsのtemp領域にコピーして編集されたあとで,上記のインストールディレクトリに上書きコピーされます。

Service Architect用Eclipseセットアップで使用する,Windowsのtemp領域の構成を次に示します。

#

ディレクトリ

説明

1

<Windowsのtemp領域>

環境変数TEMPまたはTMPで取得されるパスです。

2

HITACHI

HITACHI製品で使用するディレクトリです。

3

CSCTE

CSCTEで使用するディレクトリです。

4

EclipseSetup_for_Service_Architect

[Service_Architect用Eclipseセットアップ]の実行時に使用されるディレクトリです。

5

yyyyMMddhhmmss

[Service_Architect用Eclipseセットアップ]の実行のたびに作成されるディレクトリです。

この配下にeclipse.iniが格納されます。

ディレクトリ名のタイムスタンプの値は,Service Architect用Eclipseセットアップが出力するログファイル名と同じになります。

上記の表の#2〜#5のディレクトリのライフサイクルを次に示します。

#

ディレクトリ

コマンド実行時

コマンド終了時

2

HITACHI

存在しなかった場合は新規作成されます。

削除されません。

3

CSCTE

4

EclipseSetup_for_Service_Architect

5

yyyyMMddhhmmss

毎回新規作成されます。

異常終了の場合,削除されません。

通常終了の場合,削除されます。

(2) Service Architect用Eclipseセットアップのメッセージログ

Service Architect用Eclipseセットアップを実行すると,メッセージログに実行時の情報(通知・エラーなど)がメッセージとして出力されます。

Service Architect用Eclipseセットアップのメッセージログを参照することで,過去に実行したコマンドの障害情報や稼働情報を確認できます。

ここでは,出力されたService Architect用Eclipseセットアップのメッセージログの確認方法について説明します。

(a) メッセージログの出力先

Service Architect用Eclipseセットアップのメッセージログの出力先およびログファイル名を次に示します。

<Service Architectのインストールディレクトリ>\CSCTE\setup\eclipse\log\yyyyMMddHHmmss.log

出力先は変更できません。

ログファイルはコマンドを実行するたびに生成されます。

ログファイル名「yyyyMMddHHmmss.log」は実行時刻が次の形式で出力されます(例:20250728103830.log)。

  • yyyy:西暦年

  • MM:月(01≦MM≦12)

  • dd:日(01≦dd≦31)

  • HH:時(00≦HH≦23)

  • mm:分(00≦mm≦59)

  • ss:秒(00≦ss≦59)

(b) メッセージログの出力形式

Service Architect用Eclipseセットアップのメッセージログの出力形式を次の図に示します。

図3‒2 Service Architect用Eclipseセットアップのメッセージログの出力形式

[図データ]

(c) メッセージログの出力内容

Service Architect用Eclipseセットアップのメッセージログに出力される内容を次の表に示します。

表3‒1 Service Architect用Eclipseセットアップのメッセージログに出力される内容

項目

サイズ

内容

DATE

10バイト

メッセージが出力された日付を出力します。

出力形式はyyyy/MM/dd。

TIME

12バイト

メッセージが出力された時刻を出力します。

出力形式はHH:mm:ss.SSS。

TYPE

可変

メッセージの種別を出力します。

  • INFO:動作を通知するメッセージ

  • ERROR:エラーメッセージ

MESSAGEID

11バイト

メッセージIDを出力します。

MESSAGE

可変

メッセージを次のどちらかの形式で出力します。

  • 例外メッセージの場合:<message>\n<stack trace>

  • 上記以外のメッセージの場合:<message>

<message>:メッセージIDと対応するメッセージ

<stack trace>:スローされた例外のスタックトレース

出力例を次に示します。

DATE         TIME           TYPE   MESSAGEID     MESSAGE
2025/12/11   15:06:13.382   INFO   KECT96001-I   Execution of the command will now start. (command = EclipseSetup_for_Service_Architect)
2025/12/11   15:06:13.400   INFO   KECT96002-I   Execution of the command ended normally. (command = EclipseSetup_for_Service_Architect, path= C:\Program Files\Hitachi\Cosminexus\CSCTE\setup\eclipse\log\20251211150613.log)

(d) メッセージログの削除

出力されたログファイルの削除について次に示します。

  • Eclipseのアンセットアップ時は,ログファイルは削除されません。

  • Service Architectのアンインストール時は,ログファイルは削除されません。