メインコンテンツへ移動

金蝶天燕 ADMQ 統合手順

金蝶Apusic分布式消息中间件（「ADMQ」）は、金蝶天燕公司による分散型メッセージキュー製品です。マルチテナント対応、クラスタ間データレプリケーション、強い一貫性、高可用性、高スループットなどの特長があります。

HAP のプライベートデプロイメント版では、デフォルトで Kafka をメッセージキューとして採用し、高効率なデータ処理を実現しています。一方で、信創要件への対応として金蝶天燕社「ADMQ」にも正式対応しており、Kafka の代わりに ADMQ を選択可能です。

統合手順は以下の通りです。

  1. 金蝶天燕社製 ADMQ を購入してください。シングルモードまたはクラスタモードを選択します。

    HAP の単一ノードまたはコンパクトクラスター構成では単一ノードモードを、標準またはプロフェッショナルクラスター構成ではクラスターモードを選択できます。

  2. デプロイ時には、以下の点に注意してください。

    • KAFKA プラグインを有効にします。

    • 以下のパラメータを追加するか、値を例のとおりに変更します。

      transactionCoordinatorEnabled=true
      kafkaTransactionCoordinatorEnabled=true
      brokerDeleteInactiveTopicsEnabled=false
      defaultNumPartitions=10

  3. デプロイ後、以下のトピックを手動で作成します。パーティション数は 10 を推奨します。

    ws-word
    ws-excel
    ws-rowindex
    ws-formulaensure
    ws-exattachment
    ws-largerelation
    ws-slowexcel
    ws-publicform
    ws-editcontrols
    ws-passiverelation

  4. デプロイ後、ADMQ KAFKA サービスのノード接続アドレス、ポート、パスワードを取得します。

  5. HAP マイクロサービスの設定ファイルに以下の変数を追加し、外部メッセージミドルウェアへの接続を設定します。

    ENV_KAFKA_ENDPOINTS: "192.168.0.251:9092"     # ADMQ Kafka サービスアドレス

    # HAP 単一ノードモードでは、以下の環境変数でコンテナ内のデフォルト Kafka サービスの起動を無効化できます
    ENV_STANDALONE_DISABLE_SERVICES: "kafka"

  6. HAP マイクロサービスを再起動し、設定を反映します。