EC2 インスタンスで ENA による拡張ネットワーキングを有効にする

インスタンスに接続します。

インスタンスから、次のコマンドを実行して、ena を含む最新のカーネルドライバーでインスタンスを更新します。

[ec2-user ~]$ sudo yum update

ローカルコンピュータから、Amazon EC2 コンソールまたは次のいずれかのコマンドを使用して、インスタンスを再起動します。reboot-instances (AWS CLI)、Restart-EC2Instance (AWS Tools for Windows PowerShell)。

インスタンスに再接続し、ena の modinfo ena コマンドを使用して、拡張ネットワーキングが有効化されているかどうかのテスト カーネルドライバーが最小推奨バージョンでインストールされていることを確認します。

[EBS-backed インスタンス] ローカルコンピュータから、Amazon EC2 コンソールまたは次のいずれかのコマンドを使用して、インスタンスを停止します。stop-instances (AWS CLI)、Stop-EC2Instance (AWS Tools for Windows PowerShell)。

[Instance store-backed インスタンス] インスタンスを停止して属性を変更することはできません。代わりに、この手順に進んでください: Amazon Linux AMI で拡張ネットワーキングを有効にするには (Instance store-backed インスタンス)。

ローカルコンピュータから、次のいずれかのコマンドを使用して拡張ネットワーキングの属性を有効化します。

(オプション) Amazon EBS-backed AMI を作成するの説明に従って、インスタンスから AMI を作成します。AMI は、インスタンスから拡張ネットワーキング enaSupport 属性を継承します。このため、この AMI を使用することで、拡張ネットワーキングがデフォルトで有効になっている別のインスタンスを起動できます。

ローカルコンピュータから、Amazon EC2 コンソールまたは次のいずれかのコマンドを使用して、インスタンスを開始します。start-instances (AWS CLI)、Start-EC2Instance (AWS Tools for Windows PowerShell)。

インスタンスに接続し、拡張ネットワーキングが有効化されているかどうかのテスト の ethtool -i ethn コマンドを使用して、ena カーネルドライバーがインストールされ、ネットワークインターフェイスにロードされていることを確認します。

拡張ネットワーキングを有効にした後にインスタンスに接続できない場合、Linux での ENA カーネルドライバーのトラブルシューティングを参照してください。

インスタンスに接続します。

パッケージキャッシュおよびパッケージを更新します。

ubuntu:~$ sudo apt-get update && sudo apt-get upgrade -y linux-aws

[EBS-backed インスタンス] ローカルコンピュータから、Amazon EC2 コンソールまたは次のいずれかのコマンドを使用して、インスタンスを停止します。stop-instances (AWS CLI)、Stop-EC2Instance (AWS Tools for Windows PowerShell)。

[Instance store-backed インスタンス] インスタンスを停止して属性を変更することはできません。代わりに、この手順に進んでください: Ubuntu で拡張ネットワーキングを有効にするには (Instance store-backed インスタンス)。

ローカルコンピュータから、次のいずれかのコマンドを使用して拡張ネットワーキングの属性を有効化します。

(オプション) Amazon EBS-backed AMI を作成するの説明に従って、インスタンスから AMI を作成します。AMI は、インスタンスから拡張ネットワーキング enaSupport 属性を継承します。このため、この AMI を使用することで、拡張ネットワーキングがデフォルトで有効になっている別のインスタンスを起動できます。

ローカルコンピュータから、Amazon EC2 コンソールまたは次のいずれかのコマンドを使用して、インスタンスを開始します。start-instances (AWS CLI)、Start-EC2Instance (AWS Tools for Windows PowerShell)。

インスタンスに接続します。

https://github.com/amzn/amzn-drivers の GitHub からインスタンスで ena カーネルドライバーのソースコードのクローンを作成します。(SUSE Linux Enterprise Server 12 SP2 以降には、デフォルトで ENA 2.02 が含まれているため、ENA ドライバーをダウンロードしてコンパイルする必要はありません。SUSE Linux Enterprise Server 12 SP2 以降では、必要なドライバーバージョンを標準カーネルに追加するためリクエストを申請する必要があります。)

git clone https://github.com/amzn/amzn-drivers

インスタンスで ena カーネルドライバーをコンパイルし、インストールします。これらの手順は Linux ディストリビューションによって異なります。Red Hat Enterprise Linux でのカーネルドライバーのコンパイルの詳細については、「RHEL を実行する Amazon EC2 インスタンスに拡張ネットワークサポート用の最新の ENS ドライバーをインストールする方法」を参照してください。

sudo depmod コマンドを実行して、カーネルドライバーの依存関係を更新します。

起動時に新しいカーネルドライバーがロードされるように、インスタンスの initramfs を更新します。例えば、ディストリビューションで dracut がサポートされる場合、次のコマンドを使用できます。

dracut -f -v

システムがデフォルトで予測可能なネットワークインターフェイス名を使用するかどうかを確認します。systemd または udev のバージョン 197 以上を使用するシステムの場合、イーサネットデバイスの名前を変更でき、単一ネットワークインターフェイスの名前が eth0 になることは保証されません。この動作は、インスタンスに接続する際に問題の原因となる可能性があります。詳細と他の設定オプションについては、freedesktop.org ウェブサイトでPredictable Network Interface Names/を参照してください。

1. 次のコマンドを使用して、RPM ベースのシステムで systemd または udev のバージョンを確認できます。

   rpm -qa | grep -e '^systemd-[0-9]\+\|^udev-[0-9]\+'
   systemd-208-11.el7_0.2.x86_64

   上記の Red Hat Enterprise Linux 7 の例では、systemd のバージョンは 208 であるため、予測可能なネットワークインターフェイス名は無効になっている必要があります。

2. net.ifnames=0 オプションを GRUB_CMDLINE_LINUX の /etc/default/grub 行に追加することによって、予測可能なネットワークインターフェイス名を無効にします。

   sudo sed -i '/^GRUB\_CMDLINE\_LINUX/s/\"$/\ net\.ifnames\=0\"/' /etc/default/grub

3. grub の設定ファイルを再ビルドします。

   sudo grub2-mkconfig -o /boot/grub2/grub.cfg

[EBS-backed インスタンス] ローカルコンピュータから、Amazon EC2 コンソールまたは次のいずれかのコマンドを使用して、インスタンスを停止します。stop-instances (AWS CLI)、Stop-EC2Instance (AWS Tools for Windows PowerShell)。

[Instance store-backed インスタンス] インスタンスを停止して属性を変更することはできません。代わりに、この手順に進んでください: Linux で拡張ネットワーキングを有効にするには (Instance store-backed インスタンス)。

ローカルコンピュータから、次のいずれかのコマンドを使用して拡張ネットワーキングの enaSupport 属性を有効化します。

(オプション) Amazon EBS-backed AMI を作成するの説明に従って、インスタンスから AMI を作成します。AMI は、インスタンスから拡張ネットワーキング enaSupport 属性を継承します。このため、この AMI を使用することで、拡張ネットワーキングがデフォルトで有効になっている別のインスタンスを起動できます。

インスタンスオペレーティングシステムに /etc/udev/rules.d/70-persistent-net.rules が含まれている場合には、AMI を作成する前にそれを削除する必要があります。このファイルには、元のインスタンスのイーサネットアダプターの MAC アドレスが保存されています。別のインスタンスがこのファイルを使用して起動した場合、オペレーティングシステムがそのデバイスを検出できなくなり、eth0 が失敗して、起動に関する問題が発生することがあります。このファイルは次の起動サイクルで再び生成され、AMI から起動されるインスタンスごとに独自のバージョンが作成されます。

ローカルコンピュータから、Amazon EC2 コンソールまたは次のいずれかのコマンドを使用して、インスタンスを開始します。start-instances (AWS CLI)、Start-EC2Instance (AWS Tools for Windows PowerShell)。

(オプション) インスタンスに接続し、カーネルドライバーがインストールされていることを確認します。

拡張ネットワーキングを有効にした後にインスタンスに接続できない場合、Linux での ENA カーネルドライバーのトラブルシューティングを参照してください。

Ubuntu のステップ 1 および 2 を行います。

build-essential パッケージをインストールしてカーネルドライバーと dkms パッケージをコンパイルし、カーネルが更新されるたびに ena カーネルドライバーが再構築されるようにします。

ubuntu:~$ sudo apt-get install -y build-essential dkms

https://github.com/amzn/amzn-drivers の GitHub からインスタンスで ena カーネルドライバーのソースのクローンを作成します。

ubuntu:~$ git clone https://github.com/amzn/amzn-drivers

amzn-drivers パッケージを /usr/src/ ディレクトリに移動して、カーネルの更新のたびに DKMS がこのパッケージを見つけて構築できるようにします。ソースコードのバージョン番号 (現在のバージョン番号はリリースノートにあります) をディレクトリ名に付加します。例えば、バージョン 1.0.0 は以下のようになります。

ubuntu:~$ sudo mv amzn-drivers /usr/src/amzn-drivers-1.0.0

以下の値を使用して DKMS 設定ファイルを作成し、ena のバージョンに置き換えます。

ファイルを作成します。

ubuntu:~$ sudo touch /usr/src/amzn-drivers-1.0.0/dkms.conf

ファイルを編集し、次の値を追加します。

ubuntu:~$ sudo vim /usr/src/amzn-drivers-1.0.0/dkms.conf
PACKAGE_NAME="ena"
PACKAGE_VERSION="1.0.0"
CLEAN="make -C kernel/linux/ena clean"
MAKE="make -C kernel/linux/ena/ BUILD_KERNEL=${kernelver}"
BUILT_MODULE_NAME[0]="ena"
BUILT_MODULE_LOCATION="kernel/linux/ena"
DEST_MODULE_LOCATION[0]="/updates"
DEST_MODULE_NAME[0]="ena"
AUTOINSTALL="yes"

DKMS を使用して、インスタンスで ena カーネルドライバーを追加、構築、インストールします。

DKMS にカーネルドライバーを追加します。

ubuntu:~$ sudo dkms add -m amzn-drivers -v 1.0.0

dkms コマンドでカーネルドライバーを構築します。

ubuntu:~$ sudo dkms build -m amzn-drivers -v 1.0.0

dkms を使用してカーネルドライバーをインストールします。

ubuntu:~$ sudo dkms install -m amzn-drivers -v 1.0.0

起動時に正しいカーネルドライバーがロードされるように、initramfs を再構築します。

ubuntu:~$ sudo update-initramfs -u -k all

拡張ネットワーキングが有効化されているかどうかのテスト から modinfo ena コマンドを使用して、ena カーネルドライバーがインストールされていることを確認します。

ubuntu:~$ modinfo ena
filename:	   /lib/modules/3.13.0-74-generic/updates/dkms/ena.ko
version:		1.0.0
license:		GPL
description:	Elastic Network Adapter (ENA)
author:		 Amazon.com, Inc. or its affiliates
srcversion:	 9693C876C54CA64AE48F0CA
alias:		  pci:v00001D0Fd0000EC21sv*sd*bc*sc*i*
alias:		  pci:v00001D0Fd0000EC20sv*sd*bc*sc*i*
alias:		  pci:v00001D0Fd00001EC2sv*sd*bc*sc*i*
alias:		  pci:v00001D0Fd00000EC2sv*sd*bc*sc*i*
depends:
vermagic:	   3.13.0-74-generic SMP mod_unload modversions
parm:		   debug:Debug level (0=none,...,16=all) (int)
parm:		   push_mode:Descriptor / header push mode (0=automatic,1=disable,3=enable)
		  0 - Automatically choose according to device capability (default)
		  1 - Don't push anything to device memory
		  3 - Push descriptors and header buffer to device memory (int)
parm:		   enable_wd:Enable keepalive watchdog (0=disable,1=enable,default=1) (int)
parm:		   enable_missing_tx_detection:Enable missing Tx completions. (default=1) (int)
parm:		   numa_node_override_array:Numa node override map
(array of int)
parm:		   numa_node_override:Enable/Disable numa node override (0=disable)
(int)

Ubuntu のステップ 3 に進みます。

インスタンスに接続してローカル管理者としてログインします。

[Windows Server 2016 と 2019 のみ] 以下の EC2Launch PowerShell スクリプトを実行して、ドライバーのインストール後にインスタンスを設定します。

PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -Schedule

インスタンスから、次のようにドライバーをインストールします。

1. インスタンスに最新のドライバーをダウンロードします。

2. zip アーカイブを展開します。

3. install.ps1 PowerShell スクリプトを実行してドライバーをインストールします。

   注記

   実行ポリシーエラーが発生した場合は、ポリシーを Unrestricted に設定します (デフォルトでは、Restricted または RemoteSigned に設定されています)。コマンドラインで、Set-ExecutionPolicy -ExecutionPolicy Unrestricted を実行し、次に PowerShell スクリプト install.ps1 を再度実行します。

ローカルコンピュータから、Amazon EC2 コンソールまたは次のいずれかのコマンドを使用して、インスタンスを停止します。stop-instances (AWS CLI/AWS CloudShell)、Stop-EC2Instance (AWS Tools for Windows PowerShell)。

次のように、インスタンスの ENA サポートを有効にします。

1. ローカルコンピュータから、次のいずれかのコマンドを実行して、インスタンスの EC2 インスタンス ENA サポート属性を確認します。属性が有効になっていない場合、出力は「[]」 または空白です。EnaSupportはデフォルトで false に設定されます。

   • describe-instances (AWS CLI/AWS CloudShell)

     aws ec2 describe-instances --instance-ids instance_id --query "Reservations[].Instances[].EnaSupport"

   • Get-EC2Instance (Windows PowerShell 用のツール）

     (Get-EC2Instance -InstanceId instance-id).Instances.EnaSupport

2. ENA サポートを有効にするには、次のいずれかのコマンドを実行します:

   • modify-instance-attribute (AWS CLI/AWS CloudShell)

     aws ec2 modify-instance-attribute --instance-id instance_id --ena-support

   • Edit-EC2InstanceAttribute (AWS Tools for Windows PowerShell)

     Edit-EC2InstanceAttribute -InstanceId instance_id -EnaSupport $true

   インスタンスを再開するときに問題が発生した場合は、次のいずれかのコマンドを使用して ENA サポートを無効にすることもできます。

   • modify-instance-attribute (AWS CLI/AWS CloudShell)

     aws ec2 modify-instance-attribute --instance-id instance_id --no-ena-support

   • Edit-EC2InstanceAttribute (AWS Tools for Windows PowerShell)

     Edit-EC2InstanceAttribute -InstanceId instance_id -EnaSupport $false

3. 前述のように describe-instances または Get-EC2Instance を使用して、属性が true に設定されていることを確認します。次のような出力が表示されます。

   [
   	true
   ]

ローカルコンピュータから、Amazon EC2 コンソールまたは次のいずれかのコマンドを使用して、インスタンスを開始します。start-instances (AWS CLI/AWS CloudShell)、Start-EC2Instance (AWS Tools for Windows PowerShell)。

インスタンスで、次のように ENA ドライバーがインストールされて有効であることを検証します。

1. ネットワークアイコンを右クリックして、[Open Network and Sharing Center] を選択します。

2. イーサネットアダプター ([Ethernet 2] など) を選択します。

3. [Details] を選択します。[Network Connection Details] で、[Description] が [Amazon Elastic Network Adapter] であることを確認します。

(オプション) インスタンスから AMI を作成します。AMI は、インスタンスから enaSupport 属性を継承します。したがって、この AMI を使用して、ENA がデフォルトで有効になっている別のインスタンスを起動できます。