AWS Replication Agentインストール時にハマったポイントと対処方法

1. 【参考】AWS Replication Agentのインストール手順

AWS Replication Agentのインストール手順の公式ドキュメントは以下となっています。

Windows：Installing the AWS Replication Agent on Windows - AWS Elastic Disaster Recovery

Linux：Installing the AWS Replication Agent on Linux - AWS Elastic Disaster Recovery

今回、ハマったのはすべてLinux系OSでした。参考として、Linux系OSでのインストール手順の抜粋を以下に記載しておきます。詳細はドキュメントをご確認ください。

1. インストールスクリプトのダウンロード

   wget -O ./aws-replication-installer-init https://aws-elastic-disaster-recovery-<REGION>.s3.<REGION>.amazonaws.com/latest/linux/aws-replication-installer-init

2. インストールスクリプトの実行

   chmod +x aws-replication-installer-init; sudo ./aws-replication-installer-init

3. インストールが完了するのを待つ

   表示された指示に回答し、すべての処理が完了すると以下のメッセージが表示されます。

   ～省略～
    The AWS Replication Agent was successfully installed.

NTT東日本では、AWSなどクラウドに関するお役立ち情報をメールマガジンにて発信していますので、ぜひこちらからご登録ください。

2. ハマったポイント1：Kernel headersが存在しないか適切ではないエラー

2-1. 事象と原因

ハマったポイントの1つ目はKernel headersが存在しないか、適切ではない旨の以下のエラーです。

Error: Kernel headers are missing or not properly configured. Please install the appropriate kernel headers.
Installation failed.
Learn more about installation issues in our documentation at https://docs.aws.amazon.com/drs/latest/userguide/Troubleshooting-Agent-Issues.html

カーネルとkernel-headersのバージョンを確認すると以下の様に不一致であることが確認できました。

[root@ip-10-0-10-127 ~]# uname -r
5.14.0-570.72.1.el9_6.x86_64

[root@ip-10-0-10-127 ~]# rpm -qa | grep kernel-headers
kernel-headers-5.14.0-611.35.1.el9_7.x86_64

Linuxのインストール要件には少し異なるものの、カーネルとkernel-develのバージョンが一致することと記載があり、カーネルとkernel-headers/kernel-develのバージョンの一致は必要です。

不一致解消のためにカーネルのバージョンと一致したkernel-headersをインストールしたいところですが、インストール可能な一覧に存在しない状態でした。

[root@ip-10-0-10-127 ~]# dnf --showduplicates search kernel-headers | grep 5.14.0-570.72.1.el9_6.x86_64
Last metadata expiration check: 0:15:53 ago on Wed 25 Feb 2026 09:18:38 AM UTC.
[root@ip-10-0-10-127 ~]#

2-2. 対処方法

この場合、kernel-headersのバージョンをカーネルのバージョンに合わせるのではなく、カーネルのバージョンをkernel-headersのバージョンに合わせる事で対応します。

# dnf update kernel-5.14.0-611.35.1.el9_7.x86_64

なおカーネル更新後は再起動が必要になります。

再起動後以下の様にカーネルとkernel-headersのバージョンが一致していれば、問題なくAWS Replication Agentをインストールすることが可能となりました。

[root@ip-10-0-10-127 ~]# uname -r
5.14.0-611.35.1.el9_7.x86_64
[root@ip-10-0-10-127 ~]# rpm -qa | grep kernel-headers
kernel-headers-5.14.0-611.35.1.el9_7.x86_64

NTT東日本では、AWSなどクラウドに関するお役立ち情報をメールマガジンにて発信していますので、ぜひこちらからご登録ください。

3. ハマったポイント2：aws-replication-installer-initの処理が正常に完了せず落ちる

3-1. 事象と原因

ハマったポイントの2つ目はaws-replication-installer-initの実行中に処理が途中で終了してしまうという事象です。

[root@ip-10-0-10-169 ~]# chmod +x aws-replication-installer-init; sudo ./aws-replication-installer-init --region ap-northeast-3
The installation of the AWS Replication Agent has started.
Identifying volumes for replication.
Choose the disks you want to replicate. Your disks are: /dev/xvda,/dev/nvme0n1
To replicate some of the disks, type the path of the disks, separated with a comma (for example, /dev/sda, /dev/sdb). To replicate all disks, press Enter:
Identified volume for replication: /dev/nvme0n1 of size 8 GiB
All volumes for replication were successfully identified.
Downloading the AWS Replication Agent onto the source server...
[root@ip-10-0-10-169 ~]#

状況を確認すると、oom-killerによってaws-replication-installer-initの処理がキルされていたことが確認できました。メモリ不足ということですね。

[root@ip-10-0-10-169 ~]# dmesg | grep -i oom
[  172.318883] aws-replication invoked oom-killer: gfp_mask=0x140dca(GFP_HIGHUSER_MOVABLE|__GFP_COMP|__GFP_ZERO), order=0, oom_score_adj=0
[  172.324104]  oom_kill_process.cold+0xb/0x10
[  172.367761] [  pid  ]   uid  tgid total_vm      rss pgtables_bytes swapents oom_score_adj name
[  172.419212] oom-kill:constraint=CONSTRAINT_NONE,nodemask=(null),cpuset=/,mems_allowed=0,global_oom,task_memcg=/user.slice/user-0.slice/session-c1.scope,task=aws-replication,pid=2541,uid=0
[  172.421480] Out of memory: Killed process 2541 (aws-replication) total-vm:1039380kB, anon-rss:471476kB, file-rss:4kB, shmem-rss:10788kB, UID:0 pgtables:1184kB oom_score_adj:0

なおインスタンスタイプは以下となります。

[root@ip-10-0-10-169 ~]# ec2-metadata -t
instance-type: t3.micro

3-2. 対処法

検証用に立てたインスタンスはt3.micro(2vCPU/1GiB)を利用しており、メモリ不足ということですのでインスタンスサイズを上げて対応します。

今回はt3.small(2vCPU/2GiB)に上げて対応しました。

[root@ip-10-0-10-169 ~]# ec2-metadata -t
instance-type: t3.small
[root@ip-10-0-10-169 ~]#
[root@ip-10-0-10-169 ~]# ./aws-replication-installer-init --region ap-northeast-3
The installation of the AWS Replication Agent has started.
Identifying volumes for replication.
Choose the disks you want to replicate. Your disks are: /dev/xvda,/dev/nvme0n1
To replicate some of the disks, type the path of the disks, separated with a comma (for example, /dev/sda, /dev/sdb). To replicate all disks, press Enter:
Identified volume for replication: /dev/nvme0n1 of size 8 GiB
All volumes for replication were successfully identified.
Downloading the AWS Replication Agent onto the source server...
～省略～
The AWS Replication Agent was successfully installed.
[root@ip-10-0-10-169 ~]#

なお、aws-replication-agentが動作しているときのメモリ使用量は以下の様に250M前後でした。

そのためaws-replication-agentインストール後は、元々のワークロード次第ではインスタンスサイズを戻すことを検討することが可能でしょう。

[root@ip-10-0-10-169 ~]# systemctl status aws-replication-agent
● aws-replication-agent.service - AWS Replication Agent
Loaded: loaded (/etc/systemd/system/aws-replication-agent.service; disabled; preset: disabled)
Active: active (running) since Tue 2026-03-03 09:48:48 UTC; 1min 8s ago
Main PID: 1937 (java)
Tasks: 30 (limit: 1065)
Memory: 243.5M
CPU: 25.472s
～省略～
[root@ip-10-0-10-169 ~]#

NTT東日本では、AWSなどクラウドに関するお役立ち情報をメールマガジンにて発信していますので、ぜひこちらからご登録ください。

4. さいごに

本コラムでは、AWS Replication Agent導入時に実際に遭遇したハマりどころとその対処方法をご紹介しました。

商用環境へのインストールにあたっては今回ご紹介したポイントを事前に確認したり、あるいは検証環境等でインストールを行うなどを実施しておくと安心できるでしょう。

またAWSの公式ドキュメントには、エージェントのインストールだけではなく、その他のトラブルシューティング事例が掲載されています。もし、AWS Elastic Disaster Recoveryの導入にあたってトラブルが発生した場合、合わせてご確認いただけるとスムーズかと思います。

Troubleshooting Elastic Disaster Recovery - AWS Elastic Disaster Recovery

本コラムが誰かの参考になりましたら幸いです。

NTT東日本では経験豊かなエンジニアが、AWSの構築保守からネットワーク設計を含めエンドツーエンドでのソリューションを提供しております。ぜひお気軽にお問い合わせください。

• Amazon Web Services（AWS）およびその他のAWS商標は、米国その他の諸国における、Amazon.com, Inc.またはその関連会社の商標です。