iSCSI を使用して FSx for ONTAP iSCSI LUN を EC2 Linux インスタンスにマウントする方法を教えてください。

解決策

注: 次の解決策は、Amazon Linux 2023 (AL2023)、Amazon Linux 2 (AL2)、Red Hat Enterprise Linux (RHEL) 8、および CentOS 8 を実行する Amazon EC2 インスタンスに適用されます。

前提条件:

• EC2 インスタンスは、TCP ポート 3260 でのアウトバウンドトラフィックを許可すること。
• NetApp ONTAP ファイルシステムは、TCP ポート 3260 でのインバウンドトラフィックを許可すること。
• 必要な iSCSI ファイルシステムとインスタンスを構成します。
  注: AL2 インスタンスには、AL2023 インスタンスと同じ要件が適用されます。

iSCSI を使用してファイルシステムをインスタンスにマウントする

次の手順を実行します。

1. 必要なパッケージをインストールするには、次のコマンドを実行します。

   sudo yum install -y iscsi-initiator-utils device-mapper-multipath

2. ファイルシステムにマルチパスを設定するには、次のコマンドを実行します。

   sudo mpathconf --enable --with_multipathd y
   sudo systemctl start multipathd
   sudo systemctl enable multipathd

3. ストレージ仮想マシン (SVM) のブロックストレージインターフェイスのアドレスを取得するには、ONTAP コマンドラインインターフェイス (CLI) を使用します。FSx ONTAP ファイルシステムで次のコマンドを実行します。

   network interface show -vserver svm_name

   注: svm_name を実際の SVM 名に置き換えてください。
   出力例:

               Logical               Status         Network            Current                    Current Is
   Vserver     Interface             Admin/Oper     Address/Mask       Node                       Port    Home
   ----------- ----------            ----------     ------------------ -------------              ------- ----
   svm_name
               iscsi_1               up/up          iscsi_1_IP/X       FSxId0123456789abcdef8-01  e0e     true
               iscsi_2               up/up          iscsi_2_IP/X       FSxId0123456789abcdef8-02  e0e     true
   2 entries were displayed.

4. iSCSI のターゲットを検出するには、EC2 インスタンスで次のコマンドを実行すると、ターゲットイニシエータを特定できます。

   sudo iscsiadm --mode discovery --op update --type sendtargets --portal iscsi_1_IP

   注: iscsi_1_IP を上記のコマンドで取得した iscsi_1 の IP アドレスに置き換えてください。
   出力例:

   iscsi_1:3260,1029 iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3
   iscsi_2:3260,1028 iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3

   上記の出力例では、ターゲットイニシエータは iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 です。

5. (オプション) アベイラビリティーゾーンごとに、各 ONTAP ノードの各イニシエータに 8 セッションを確立する場合は、次のコマンドを実行します。

   sudo iscsiadm --mode node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 --op update -n node.session.nr_sessions -v 8

   注: iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 をターゲットイニシエータに置き換えてください。

6. iSCSI のターゲットにログインするには、次のコマンドを実行します。

   sudo iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -l

   注: iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 をターゲットイニシエータに置き換えてください。

7. マルチパスデバイスを特定するには、次のコマンドを実行します。

   sudo multipath -ll

   出力例:

   3600a09806c5742314e5d52766e79614f dm-xyz NETAPP ,LUN C-Mode
   size=10G features='4 queue_if_no_path pg_init_retries 50 retain_attached_hw_handle' hwhandler='0' wp=rw
   |-+- policy='service-time 0' prio=50 status=active |
   |- 0:0:0:1 sda 8:0 active ready running |
   |- 1:0:0:1 sdc 8:32 active ready running |
   |- 3:0:0:1 sdg 8:96 active ready running | `
   - 4:0:0:1 sdh 8:112 active ready running `
   -+- policy='service-time 0' prio=10 status=enabled
   |- 2:0:0:1 sdb 8:16 active ready running
   |- 7:0:0:1 sdf 8:80 active ready running
   |- 6:0:0:1 sde 8:64 active ready running
   `- 5:0:0:1 sdd 8:48 active ready running

   上記の出力例では、シンボリックリンクは 3600a09806c5742314e5d52766e79614f です。シンボリックリンクは、パス /dev/mapper/wwid に配置されています。wwid をデバイス間の、LUN のユニーク識別子に置き換えてください。

8. ファイルシステムを作成するには、次のコマンドを実行します。

   sudo mkfs.xfs /dev/mapper/wwid

   注: wwid を LUN のユニーク識別子に置き換えてください。

9. マウントポイントを作成し、そのポイントにマウントするには、次のコマンドを実行します。

   sudo mkdir /mnt/fsx-iscsi
   sudo mount /dev/mapper/wwid /mnt/fsx-iscsi

10. (オプション) 起動中の自動マウントを構成する場合は、次のコマンドを実行して iSCSI サービスを有効化します。

sudo systemctl enable iscsid
sudo systemctl enable iscsi

次に、/etc/fstab ファイルに以下の行を追加します。

/dev/mapper/wwid /mnt/fsx-iscsi xfs _netdev,x-systemd.automount,x-systemd.requires=network-online.target 0 0

注: wwid を LUN のユニーク識別子に、/mnt/fsx-iscsi を実際のファイルパスに置き換えてください。 ファイルパスに /etc/systemd/system/ を指定し、iSCSI ログイン用の systemd サービスファイルを作成します。
ファイル例:

[Unit]
Description=iSCSI connection to FSx
After=network.target

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/sbin/iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -p iscsi_1_IP -l
ExecStop=/sbin/iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -p iscsi_1_IP -u

[Install]
WantedBy=multi-user.target

注: iscsi_1_IP を iscsi_1 の IP アドレスに、region を AWS リージョンに置き換えてください。 サービスを有効にして開始するには、次のコマンドを実行します。

sudo systemctl enable iscsi-fsx.service
sudo systemctl start iscsi-fsx.service
sudo systemctl status iscsi-fsx.service

iSCSI のマウントに関する問題のトラブルシューティング

重要: NetApp アカウントの作成をおすすめします。NetApp ナレッジベースにアクセスするには、NetApp アカウントが必要です。

EC2 Linux サーバーのトラブルシューティング

ファイルシステムのマウント時に問題が発生した場合は、次のトラブルシューティング手順を実行します。

• 必要なポートへの接続を確認するには、次のコマンドを実行します。

  telnet iscsi_1_IP 3260

  注: iscsi_1_IP を iscsi_1 の IP アドレスに置き換えてください。

• iSCSI の検出が想定通りに動作するかどうかを確認するには、次のコマンドを実行します。

  sudo iscsiadm -m discovery --op update -t sendtargets -p iscsi_1_IP

  注: iscsi_1_IP を iscsi_1 の IP アドレスに置き換えてください。

• 問題を特定するために、アクティブな iSCSI セッションのステータスを確認するには、次のコマンドを実行します。

  sudo iscsiadm -m session

• マルチパスが想定通りに動作することを確認するには、次のコマンドを実行します。

  sudo multipath -ll

• ログにエラーがないか確認するには、次のいずれかのコマンドを実行します。

  dmesg | grep iSCSI

  または、

  journalctl -u iscsid

マウントに関する問題の追加トラブルシューティング方法については、NetApp のウェブサイトで「iSCSI LUN がホストで表示されない場合のトラブルシューティング」を参照してください。

FSx for ONTAP サーバーのトラブルシューティング

iSCSI サービスが実行中かどうかを確認するには、次のコマンドを実行します。

vserver iscsi show
iscsi session show

LUN 構成に問題がないかを確認するには、次のコマンドを実行します。

lun show -vserver vserver_name

注: vserver_name を実際のサーバー名に置き換えてください。

ストレージへのアクセスが正しく構成されていることを確認するには、次のコマンドを実行して LUN とイニシエータグループ間のマッピングを確認します。

lun mapping show

igroup の構成を参照し、使用するイニシエータが含まれていることを確認するには、次のコマンドを実行します。

igroup show -instance