すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:eRDMA の有効化

最終更新日:Apr 28, 2026

Ultra-low latency RDMA ネットワーキングを実現するには、対応インスタンスタイプでドライバーをインストールし、Elastic RDMA Interface (ERI) をバインドします。

ECS インスタンスでの eRDMA 有効化

ステップ 1:インスタンスおよびイメージの対応状況を確認

eRDMA は特定のインスタンスタイプおよびイメージでのみサポートされます。

ステップ 2:eRDMA ドライバーをインストール

重要
  • eRDMA ドライバーは Alibaba Cloud が開発および保守しています。

  • ドライバーのインストールには時間がかかる場合があります。

  • ドライバーインストールパッケージ

    eRDMA インストールパッケージのリリースノート(最新バージョンから古いバージョンの順に並べ替え)

    バージョン

    リリース日

    ダウンロード URL

    チェックサム

    変更内容

    1.5.7

    2026-03-31

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.5.7.tar.gz

    • MD5: 926e4625813d8f57a2f1dff04ae07087

    • SHA256: cb44f4c4aaaabfbd81224c85a9e7889732bda26cc832ff70ecc0559bcc14165c

    互換モードで MPCC をデフォルトの輻輳制御 (CC) アルゴリズムとして設定しました。
    1 GB Hugepages を使用して 4 GB メモリリージョン (MR) を登録する際に MR 長が異常になる問題を修正しました。

    1.5.6

    2026-03-30

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.5.6.tar.gz

    • MD5: fdba4eed123b4c16c37f14ebc38cef63

    • SHA256: a0529f5ca597ffb31a960c59b8c13ce854550c3512e6ce4c0542784f8e99fcc2

    標準モードで iw_ifname または iwcm->ifname が初期化されていないために RDMA_CM 接続確立が失敗する問題を修正しました。
    ENI のネットワーク名前空間 (netns) を切り替える際に発生するデッドロックを修正しました。
    NCCL バージョン 2.29 で ibv_create_qp-EINVAL を返す問題を修正しました。




    1.5.5

    2026-03-09

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.5.5.tar.gz

    • MD5: f19e223bce6e5a87a635f9a08f47366c

    • SHA256: e62dd73078ba2299cc943333748982281b6b5cf6a18724648788a110abba3d35

    Rocky Linux 9.2 のサポートを追加しました。
    init_net に ENI が存在しない場合に互換モードで RDMA_CM 接続が失敗する問題を修正しました。

    1.5.4

    2026-01-04

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.5.4.tar.gz

    • MD5: fef18757361ceb339cc64fc3033b5a97

    • SHA256: 25cc5fc527075b1845306594a0e2da120885a9fa500fc85bf4ad8f48b7bf82ab

    Debian 12.9 のサポートを追加しました。
    ハードウェアメモリ変換テーブル (MTT) エントリの残り数に関する統計情報を収集する機能を追加しました。

    1.5.3

    2025-12-10

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.5.3.tar.gz

    • MD5: 1b793a96d004915c9ddaff2c49072f11

    • SHA256: 99929345c65988b61997e805d85af2e761fa3319e4b5fc0db6781099fe512ba5

    DeepEP のサポートを追加しました。
    互換モードでポート番号割り当てポリシーを制御するための QPN ドメインを導入しました。

    1.5.2

    2025-11-10

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.5.2.tar.gz

    • MD5: da25bc06f1486baf0354cee3bafa1df8

    • SHA256: fc9648498846b4b949cc697f9c9c00eca2766c0e27bc0cc5cfdded5633243a35

    Hugepages 登録中に 4,096 バイトのページサイズが使用される問題を修正しました。

    1.5.0

    2025-09-26

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.5.0.tar.gz

    • MD5: 51e5c315543bba7ea5e79dfed00ad000

    • SHA256: 3bca1e6579a32b313e56cdf6add37de3605b5eb1bff8e0f7da81b0c8c3ee186e

    Alibaba Cloud Linux 4 のサポートを追加しました。
    Unreliable Datagram (UD) Queue Pairs (QPs) のループバック失敗を修正しました。
    rdma-core をコミュニティの安定版 56.2 にアップグレードしました。
    インストールパッケージのサイズを最適化しました。







    1.4.6

    2025-06-20

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.4.6.tar.gz

    • MD5: bd4b30f40fb02467298400fdc0e43d0a

    • SHA256: 26d555e6d7883f5315f6aab02a9e4c5564e53dd1b9840d3fa65dba59c594f484

    Rocky Linux 9.3 のサポートを追加しました。

    1.4.5

    2025-04-29

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.4.5.tar.gz

    • MD5: 37c89059d005aebe5d8bbde530b5bf56

    • SHA256: 83d810301f9141ca6f387a7e0cf99c89f40b27d484a312eb1d1bd605ebf8bc28

    • ユーザーモード qp flush をサポート

    • rdma-core コアライブラリの強化

    • Rocky Linux 8 をサポート

    1.4.3

    2025-03-13

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.4.3.tar.gz

    • MD5: 417d2fb88af5832475c7285187f57c11

    • SHA256: f82c1eb7a5f93387185a6c0ce7a78c39495d8a07a3e2ee8248cec8b9d525ba2f

    • MLNX OFED 24.10 をサポート

    • Ubuntu24.04 をサポート

    1.4.0

    2024-09-27

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.4.0.tar.gz

    • MD5: 77135d946dddc015000c8f3ea4e6c586

    • SHA256: 8613d3d81e8eb3b78bf840c37cbe02c79f62631df36cdc8b2c7c101f49f5af29

    異種 GPU シナリオにおけるパフォーマンスを最適化しました。

    1.3.3

    2023-10-09

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.3.3.tar.gz

    • MD5: 51ffb06266255139554275bc86fa4caa

    • SHA256: 5aad6d006662bd902ef5e913fb97d2a6623aadeeacd06f1c3f1c74cbd1f57ded

    最新のパッチで更新しました。

    1.3.2

    2023-09-08

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.3.2.tar.gz

    • MD5: 8492016fc96eece6a60687b0e4ea66dd

    • SHA256: 89ab265dc9fa8d56f1b2d8b13d7f50032390a265eddb2e04eeee3aa86fd169ce

    最新のパッチで更新しました。

    1.3.1

    2023-08-18

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.3.1.tar.gz

    • MD5: b9b90212e6ba49d57b81d3c5d4210deb

    • SHA256: 4ebe31760443613f8f61fcdbef7a85b277dabc59039d048898536ea4fe5d8d4a

    ドライバー側で厳密な順序保証配信のために基盤となるトランスポートモードを構成します。データパケットはシーケンス通りにのみメモリにコミットされます。

    1.3.0

    2023-06-26

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.3.0.tar.gz

    • MD5: 2da0c65643b5e2ffb61d75e1b5e5a7ab

    • SHA256: cce03aac0e07d0890884c35ad4f10e9d15f587535d788c8fc97ea268312ad4a9

    • MR 登録のためのマルチレベルページテーブルをサポート

    • IPv6 をサポート。完全な IPv6 機能にはハードウェアサポートも必要です。

    • Ubuntu 22.04 のサポートを追加

    • 最新のパッチで更新

    1.2.3

    2023-05-30

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.2.3.tar.gz

    • MD5: 7496a6324f3872469d7194c2e234b19f

    • SHA256: 16c2de0d90da6906db91c2e2469aaad9e24131c44ce52b9464036f1c3747f8a2

    最新のパッチで更新しました。

    1.2.2

    2023-05-04

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.2.2.tar.gz

    • MD5: f449d3961a41ff6a97a53cfa29e20d6c

    • SHA256: 11fdb4b3c778762ad0bdf2d0327008aa2ecb22dc508c9f9fae3568b41ae5462b

    Ubuntu 22.04 のサポートを追加しました。

    1.2.1

    2023-04-04

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.2.1.tar.gz

    • MD5: e080103934da76ce83924da789aecece

    • SHA256: be3a89e57143d7544cf968052250df92f911aebb035f07b06ebeb8c5f13bf976

    最新のパッチで更新しました。

    1.2.0

    2023-03-09

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.2.0.tar.gz

    • MD5: c8d440a6e35ec6d2aaf1a568affea876

    • SHA256: d484997e28e29f862dc580c112b55b389a00faf88dc6aa89eea588ee1369a8ca

    • 互換モードをサポート

    • 最新のパッチで更新

    1.1.0

    2023-01-16

    http://mirrors.cloud.aliyuncs.com/erdma/erdma_installer-1.1.0.tar.gz

    • MD5: 1fea69d819919a77384f902213eb681e

    • SHA256: 176c3bb35d5584e8c8e43eba9b1824b8cb2b43a19d802c4e469363ed8e33fea6

    最新のパッチで更新しました。

  • eRDMA ドライバーのインストール

    eRDMA ドライバーは、インスタンス作成時に自動的にインストールするか、既存のインスタンスに手動でインストールできます。

  • eRDMA カーネルドライバー

    eRDMA ドライバーをインストールした後、eadm ver を実行して eRDMA カーネルドライバーのバージョンを確認します。最新のインストーラーパッケージ (1.4.5) はカーネルドライバーバージョン 0.2.38 に対応しています。

    image

    eRDMA カーネルドライバーは、利用可能な接続確立方法を決定する 2 つのインストールモードをサポートしています。eRDMA 接続確立の詳細については、「RDMA_CM」をご参照ください。

ステップ 3:インスタンスに ERI をバインド

インスタンス作成時にプライマリ ENI で eRDMA インターフェイスを有効にするか、既存のインスタンスに ERI をバインドします。

説明

DescribeInstanceTypes API オペレーションを呼び出して、インスタンスタイプがサポートする ERI の最大数を照会できます。応答内の EriQuantity パラメーターの値を確認してください。値が 0 の場合、そのインスタンスタイプは ERI をサポートしていません。

  • バインド済み ENI の属性を変更して eRDMA インターフェイスを有効化

    ENI の属性の変更」をご参照ください。

  • API オペレーションを使用して eRDMA インターフェイスが有効なセカンダリ ENI を作成し、インスタンスにバインド

    API オペレーションを使用してセカンダリ ENI を作成およびバインドします。

    1. API オペレーションを呼び出して ERI を作成します。

      CreateNetworkInterface オペレーションを呼び出し、NetworkInterfaceTrafficMode パラメーターを HighPerformance に設定して、ERI 機能が有効なエラスティックネットワークインターフェイスを作成します。

      NetworkInterfaceId パラメーターで返された ENI ID を記録します。

    2. AttachNetworkInterface を呼び出します。NetworkInterfaceId に前のステップで取得した ID を、InstanceId にターゲットインスタンス ID を設定して、ERI が有効な ENI をバインドします。

      重要

      ご利用のインスタンスタイプが複数の ERI をサポートしている場合、ネットワーク帯域幅を最大化するために、各 ERI をバインドする際に異なる NetworkCardIndex を指定してください。これにより、ERI が異なるチャンネルにバインドされます。「ネットワークカードインデックス」をご参照ください。

eRDMA 構成の検証

デバイスのハードウェアプロパティ、ポートのステータス、およびサポートされている機能を確認するには、ibv_devinfo を実行します。RDMAコンポーネントが正常に動作している場合、ibv_devinfo の出力には少なくとも 1 つのポートが PORT_ACTIVE として表示されます。「RDMA 操作のテスト」をご参照ください。

ibv_devinfo-v フラグを付けて実行すると、ハードウェアバージョン、メッセージ最大サイズ、キュー数、メモリウィンドウサイズなどの詳細なデバイス情報が表示されます。

ibv_devinfo を実行して eRDMA 構成を検証します。

  • eRDMA が正しく構成されている場合:ENI 上で eRDMA インターフェイスが有効になっており、ドライバーが正しくインストールされています。

    説明
    • ご利用のインスタンスに複数の ERI がアタッチされている場合、各 eRDMA デバイスポートの statePORT_ACTIVE として表示される必要があります。

    • stateinvalid state と表示されている場合、eRDMA ネットワークインターフェイスに異常があります。セカンダリ ENI が正しく構成されているか確認してください。たとえば、ifconfig を実行して、すべてのネットワークインターフェイスと IP アドレスを確認します。「セカンダリエラスティックネットワークインターフェイスの構成」をご参照ください。

    image

  • eRDMA ドライバーが正しくインストールされていない場合:ドライバーが不足しているか、不適切にインストールされています。「ステップ 2:ECS インスタンスへの eRDMA ドライバーのインストール」をご参照ください。

    image

  • インスタンスに ERI がバインドされていない場合:ドライバーはインストールされていますが、ENI 上で ERI が有効になっていません。「ステップ 3:ECS インスタンスへの ERI のバインド」をご参照ください。

    image

診断ツールを使用して eRDMA をテストすることもできます。「診断ツールを使用した RDMA 関連の問題のチェックおよび eRDMA パフォーマンスの評価」をご参照ください。

eRDMA ネットワークパフォーマンスのテスト

perftest は、送信、受信、読み取り、書き込み操作の RDMA 操作レイテンシおよび帯域幅を測定します。RDMA デバイスのパフォーマンスを評価し、ネットワークの問題を診断するために使用します。「perftest ドキュメント」をご参照ください。

perftest テストスイート

perftest パッケージには、以下の帯域幅およびレイテンシテストが含まれています。

RDMA 操作

帯域幅テストプログラム

レイテンシテストプログラム

送信

ib_send_bw (送信帯域幅テスト)

ib_send_lat (送信レイテンシテスト)

RDMA 読み取り

ib_read_bw (読み取り帯域幅テスト)

ib_read_lat (読み取りレイテンシテスト)

RDMA 書き込み

ib_write_bw (書き込み帯域幅テスト)

ib_write_lat (書き込みレイテンシテスト)

RDMA アトミック

ib_atomic_bw (アトミック帯域幅テスト)

ib_atomic_lat (アトミックレイテンシテスト)

ネイティブイーサネット

raw_ethernet_bw (Raw Ethernet 帯域幅テスト)

raw_ethernet_lat (Raw Ethernet レイテンシテスト)

perftest のインストール

perftest は公式リポジトリ(パブリック IP アドレスが必要)または YUM/APT リポジトリからインストールできます。

公式リポジトリ
  1. ECS インスタンスにパブリック IP アドレスを割り当てます。

  2. 公式 perftest リポジトリから perftest をダウンロードしてインストールします。

YUM または APT リポジトリ
説明

ソフトウェアリポジトリ内の perftest のバージョンは Linux ディストリビューションによって異なるため、互換性の問題が発生する可能性があります。通信を行うすべてのインスタンスで同じディストリビューションを使用してください。それが不可能な場合は、公式リポジトリからインストールしてください。

  • Alibaba Cloud Linux 3、CentOS、または Anolis OS

    sudo yum install perftest -y
  • Ubuntu

    sudo apt install perftest -y

perftest 使用例

各テストは独立したコマンドとして実行されます。たとえば、ib_send_lat は送信レイテンシテストを実行します。

正確な perftest 結果を得るために、perftest の動作を制御する正しいテストパラメーターを設定します。以下のガイドラインに従って、perftest を構成および実行してください。

一般的なテストパラメーター

<subcommand> -h を実行して、テスト固有のパラメーターを表示します。

テストカテゴリ

テストパラメーター

レイテンシテスト

  • -C, --report-cycles:正確なレイテンシ測定のために時間を CPU サイクルでレポートします。

  • -H, --report-histogram:デフォルトのまとめではなくすべての結果を出力し、データ分布を表示します。

  • -U, --report-unsorted:生のデータ分布分析のためにソートされていない結果を出力します(デフォルトではソートされます)。

帯域幅テスト

  • -b, --bidirectional:双方向帯域幅を測定します(デフォルト:単方向)。

  • -N, --no peak-bw:ピーク帯域幅の計算を無効にします(デフォルトで有効)。

  • -t, --tx-depth=<dep>:送信キューのサイズを設定します。デフォルト:128。

  • -D, --duration=<sec>:テストの持続時間を秒単位で設定します。

送信テスト

  • -r, --rx-depth=<dep>:受信キューのサイズを設定します。デフォルト:512。

  • -g, --mcg=<num_of_qps><num_of_qps> 個の QP がアタッチされたマルチキャストグループにメッセージを送信します。

その他の高度なオプション

  • -u, --qp-timeout=<timeout>:QP タイムアウトを設定します。計算式:4 usec * 2^(timeout)。デフォルト:14。

  • --force-link=<type>:特定のリンクタイプ(IB または Ethernet)を強制的に使用します。

  • --use_hugepages:contig または memalign の代わりに Hugepages を使用して割り当てを行います。

  • --rate_limit=<limit>:パケット送信レートの上限を設定します。デフォルト単位:Gbps。--rate_units を使用して単位を変更できます。

参照

  • 大規模データ転送および高性能ネットワーキングのためにコンテナ内で eRDMA を使用します。「Docker コンテナでの eRDMA 有効化」をご参照ください。

  • Alibaba Cloud Container Service for Kubernetes (ACK) クラスターで eRDMA を使用して、サービス間の低レイテンシかつ高スループット通信を実現します。「eRDMA を使用したコンテナネットワークの高速化」をご参照ください。

  • Redis、Spark、Kafka などの TCP アプリケーションやその他の HPC アプリケーションと eRDMA を統合します。「アプリケーション統合」をご参照ください。

  • eRDMA のステータスをリアルタイムで監視、診断、トラッキングします。「eRDMA の監視および診断」をご参照ください。