開始前に

1. Block Storage for Classic ボリュームにアクセスするホストが、アクセス権限を持っていることを確認してください。 詳細については、 「コンソールでホストを承認する」、 「CLI からホストを承認する」、 「Terraform を使用してホストを承認する」 を参照してください。

2. IBM Cloud のプライベート・ネットワークにアクセスし、いくつかのサービスを利用するには、アクティブな VPN接続が 必要です。

3. サーバーへのSSH接続を確立します。 IPアドレス、ユーザー名、パスワードはコンソールで確認できる。 メニュー から、 インフラ > クラシック・インフラストラクチャー > Devices をクリックします。 次に、リストでサーバーを探し、その名前をクリックして詳細を表示します。

複数のホストが協調管理されずに同じ Block Storage for Classic ボリュームをマウントすると、データが破損する危険性があります。 複数のホストが同時にボリュームに変更を加えると、ボリュームの破損が発生する可能性があります。 データ損失を防ぐには、Microsoft Cluster Shared Volumes ( CSV )、 Red Hat Global File System ( GFS2 )、 VMware® VMFS など、クラスタを意識した共有ディスク・ファイル・システムが必要です。 詳細については、お使いのOSのドキュメントを参照してください。

OSをアップデートし、 iSCSI、マルチパスユーティリティをインストールする

システムが最新の状態であることを確認し、 iscsi-initiator-utils および device-mapper-multipath パッケージがインストールされていることを確認してください。 以下のコマンドを使用して、パッケージをインストールします。

1. OSをアップデートする。

   sudo dnf update
   

2. マルチパスユーティリティのインストール

   sudo dnf -y install device-mapper-multipath
   

   パッケージがインストールされたら、 mpathconf --enable --user_friendly_names n コマンドを入力して有効にする。

3. ISCSIユーティリティのインストール

   sudo dnf -y install iscsi-initiator-utils
   

   パッケージがインストールされたら、 systemctl start iscsid コマンドで起動する。

iSCSI の設定ファイルを更新する

1. 「 IBM Cloud® 」コンソールから取得したIQNを使用して、 /etc/iscsi/initiatorname.iscsi ファイルを更新してください。

   1. 次の例は、現在のイニシエータ名をチェックする方法を示している。

   [root@vsi4classic ~]# cat /etc/iscsi/initiatorname.iscsi
   InitiatorName=iqn.1994-05.com.redhat:7acdadcdc20
   

   1. テキストエディタでファイルを開きます：

   vi /etc/iscsi/initiatorname.iscsi
   

   1. 以下の例にあるように、IQNを以下のフォーマットで入力する InitiatorName=<value-from-the-Portal>。 IQNの値を自分の値に置き換える。

   InitiatorName=iqn.2025-11.com.ibm:sl02su1414935-v154455886
   

   1. ファイルを保存し（:w ）、終了する（:x ）。

2. IBM Cloud® コンソールのユーザー名とパスワードを使用して、 /etc/iscsi/iscsid.conf の以下のエントリーのコメントを解除し、更新する。 CHAP（Challenge-Handshake Authentication Protocol）名には大文字を使用する。

   node.session.auth.authmethod = CHAP
   node.session.auth.username = <Username-value-from-Portal>
   node.session.auth.password = <Password-value-from-Portal>
   discovery.sendtargets.auth.authmethod = CHAP
   discovery.sendtargets.auth.username = <Username-value-from-Portal>
   discovery.sendtargets.auth.password = <Password-value-from-Portal>
   

   その他のCHAP設定は変更しないでください。 IBM Cloud® ストレージでは、一方向認証のみが使用されます。 相互 CHAP を有効にしないこと。

3. iscsid サービスを再始動します。

   systemctl restart iscsid
   

4. iSCSI アレイに対してディスカバリを実行して、構成が正しいことを検証する。

   Block Storage for Classic SendTargets メソッドを使用した動的なターゲット検出が必要です。 静的なノード構成は使用しないでください。スケーラビリティに欠ける上、ストレージに変更が加えられた際（LUNへのホストのアクセス許可やアクセス権の解除など）、接続の問題を引き起こす可能性があります。 ダイナミック・ディスカバリーは、ホストがターゲット・ポータルへの変更を自動的に検出することを保証する。

   iscsiadm -m discovery -t sendtargets -p TARGET IP
   

   IPアドレス情報とアクセス詳細が表示されれば、検出は成功です。

   [root@vsi4classic ~]# iscsiadm -m discovery -t sendtargets -p 161.26.99.113
    161.26.99.113:3260,1034 iqn.1992-08.com.netapp:stfdal1006
    161.26.99.110:3260,1030 iqn.1992-08.com.netapp:stfdal1006
   

マルチパスのセットアップ

DM Multipathは、 mpathconf ユーティリティを使用して設定します。これにより、マルチパス設定ファイル /etc/multipath.conf が作成されます。 mpathconf ユーティリティの詳細については、 mpathconf(8)のマニュアルページを参照してください。

1. まだやっていなければ、mpathconfコマンドに --enable オプションを付けて入力する。

   mpathconf --enable --user_friendly_names n
   

2. nano, vi, またはお好みの他のエディターで /etc/multipath.conf ファイルを編集する。

   sudo vi /etc/multipath.conf
   

3. 以下の最小構成を追加してください。

   defaults {
   user_friendly_names no
   find_multipaths on
   max_fds max
   flush_on_last_del yes
   queue_without_daemon no
   dev_loss_tmo infinity
   fast_io_fail_tmo 5
   }
   # All data in the following section must be specific to your system.
   blacklist {
   wwid "SAdaptec*"
   devnode "^hd[a-z]"
   devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
   devnode "^cciss.*"
   }
   devices {
   device {
   vendor "NETAPP"
   product "LUN"
   path_grouping_policy group_by_prio
   features "2 pg_init_retries 50"
   no_path_retry queue
   prio "alua"
   path_checker tur
   failback immediate
   path_selector "round-robin 0"
   hardware_handler "1 alua"
   rr_weight uniform
   rr_min_io 128
   }
   }
   

   設定ファイルの「initial defaults」セクションでは、マルチパスデバイスの名前が「 /dev/mapper/mpath n」という形式になるようシステムを設定します。ここで、 mpath n はデバイスのWWID（World Wide Identifier）です。

4. 設定ファイルを保存して、エディタを終了します。

5. 以下のコマンドを発行します。

   systemctl start multipathd.service
   

   マルチパスデーモンを起動した後にマルチパスの設定ファイルを編集する必要がある場合は、変更を反映させるために systemctl reload multipathd.service コマンドを実行する必要があります。

ストレージ・デバイスのディスカバーとログイン

iscsiadm ユーティリティは、 iSCSI ターゲットの検出およびログイン、ならびにopen-iscsiデータベースへのアクセスと管理を行うためのコマンドラインツールです。 詳細については、 iscsiadm(8)のマニュアルページを参照してください。 このステップでは、IBM Cloud® コンソールから取得したターゲット IP アドレスを使用して、デバイスをディスカバーします。

1. iSCSI アレイに対してディスカバリーを実行します。

   iscsiadm -m discovery -t sendtargets -p TARGET IP
   

   IPアドレス情報とアクセス詳細が表示されれば、検出は成功です。

2. iSCSI アレイにログインします。

   iscsiadm -m node --login
   

   [root@vsi4classic ~]# iscsiadm -m node --login
   Login to [iface: default, target: iqn.1992-08.com.netapp:stfdal1006, portal: 161.26.99.110,3260] successful.
   Login to [iface: default, target: iqn.1992-08.com.netapp:stfdal1006, portal: 161.26.99.113,3260] successful.
   

構成の検証

1. iSCSI セッションが確立されていることを検証します。

   iscsiadm -m session -o show
   

2. 複数のパスがあることを検証します。

   multipath -l
   

   このコマンドはパスを報告します。 正しく設定されていれば、各ボリュームには1つのグループがあり、そのパス数は iSCSI セッションの数と一致します。 単一のパスでボリュームをマウントすることは可能ですが、サービスの中断を防ぐためには、両方のパスで接続が確立されていることが重要です。

   [root@vsi4classic ~]# multipath -l
   3600a0980383056716724514550666270 dm-0 NETAPP,LUN C-Mode
   size=20G features='3 queue_if_no_path pg_init_retries 50' hwhandler='1 alua' wp=rw
   |-+- policy='round-robin 0' prio=0 status=active
   | `- 2:0:0:0 sda 8:0  active undef running
   `-+- policy='round-robin 0' prio=0 status=enabled
     `- 3:0:0:0 sdb 8:16 active undef running
   

   MPIO が正しく構成されていないと、ネットワーク障害が発生した場合や、IBM Cloud® チームが保守を実行するときに、ストレージ・デバイスが切断され、オフラインと表示されます。 MPIOは、こうしたイベント発生時にさらなる接続性を提供し、アクティブな読み書き操作が行われているボリュームへの確立済みセッションを維持します。

3. 接続しているデバイスに関するパーティション表をリストします。

   fdisk -l | grep /dev/mapper
   

   デフォルトでは、ストレージ・デバイスは /dev/mapper/<wwid>に接続されます。 WWID は、ボリュームが存在する間は永続します。 コマンドは、次の例のような情報を報告します。

   [root@vsi4classic ~]# fdisk -l | grep /dev/mapper
   Disk /dev/mapper/3600a0980383056716724514550666270: 20 GiB, 21474836480 bytes, 41943040 sectors
   

   この例では、文字列 3600a0980383056716724514550666270 がWWIDである。 あなたのアプリケーションはWWIDを使うべきである。 また、 multipath.conf 内で「user_friendly_names」または「alias」キーワードを使用することで、より読みやすい名前を割り当てることも可能です。 詳細については、 multipath.conf のマニュアルページを参照してください。

   ボリュームはホスト上にマウント済みであり、アクセス可能です。 次に、ファイル・システムを作成できます。

ファイル・システムの作成 (オプション)

新しくマウントされたボリュームにファイル・システムを作成するには、以下の手順に従います。 ファイル・システムは、ほとんどのアプリケーションでボリュームを使用するために必要です。 2 TB より小さいドライブの場合は fdisk を使用し、2 TB より大きいディスクの場合は parted を使用します。

dnf install parted

MPIO 構成の検証

MPIO が正しく構成されていないと、ネットワーク障害が発生した場合や、IBM Cloud® チームが保守を実行するときに、ストレージ・デバイスが切断され、オフラインと表示されます。 MPIOは、こうしたイベント発生時にさらなる接続性を提供し、アクティブな読み書き操作が行われているボリュームへの確立済みセッションを維持します。

• マルチパスがデバイスをピックアップしているかどうかを確認するには、現在の構成をリストします。 正しく設定されていれば、各ボリュームに1つのグループが存在し、 iSCSI セッション数と同じ数のパスが存在する。

  multipath -l
  

  root@server:~# multipath -l
  3600a09803830304f3124457a45757067 dm-1 NETAPP,LUN C-Mode
  size=20G features='1 queue_if_no_path' hwhandler='0' wp=rw
  |-+- policy='round-robin 0' prio=-1 status=active
  | `6:0:0:101 sdd 8:48 active ready running
  `-+- policy='round-robin 0' prio=-1 status=enabled
   `- 7:0:0:101 sde 8:64 active ready running
  

  この例にある「 3600a09803830304f3124457a45757067 」という文字列は、そのボリュームの固有のWWIDです。 各ボリュームは固有のWWIDによって識別され、このIDはボリュームが存在する限り不変です。

• すべてのディスクが存在することを確認します。 正しい構成では、出力内に同じ ID を持つ 2 つのディスクが表示され、同じ ID で同じサイズの /dev/mapper がリストされている必要があります。 /dev/mapper デバイスが、マルチパスによってセットアップされるデバイスです。

  fdisk -l | grep Disk
  

  • 構成が正しい場合の出力例

  root@server:~# fdisk -l | grep Disk
  Disk /dev/sda: 500.1 GB, 500107862016 bytes Disk identifier: 0x0009170d
  Disk /dev/sdc: 21.5 GB, 21474836480 bytes Disk identifier: 0x2b5072d1
  Disk /dev/sdb: 21.5 GB, 21474836480 bytes Disk identifier: 0x2b5072d1
  Disk /dev/mapper/3600a09803830304f3124457a45757066: 21.5 GB, 21474836480 bytes Disk identifier: 0x2b5072d1
  

  マルチパスで作成されるデバイス名に WWID が含まれています。 WWIDはアプリケーションで使用することを推奨する。

  • 構成が間違っている場合の出力例。 /dev/mapper ディスクが存在しない。

  root@server:~# fdisk -l | grep Disk
  Disk /dev/sda: 500.1 GB, 500107862016 bytes Disk identifier: 0x0009170d
  Disk /dev/sdc: 21.5 GB, 21474836480 bytes Disk identifier: 0x2b5072d1
  Disk /dev/sdb: 21.5 GB, 21474836480 bytes Disk identifier: 0x2b5072d1
  

• マルチパスデバイスの一覧にローカルディスクが含まれていないことを確認するには、詳細レベル3で現在の設定を表示してください。 以下のコマンドの出力では、デバイスと、ブロック・リストに追加されたデバイスが表示されます。

  multipath -l -v 3 | grep sd <date and time>
  

• 2つ目のパスが停止している間にボリュームがプロビジョニングされ、アタッチされた場合、ホストは初めて検出スキャンが実行されたときに1つのパスを見るかもしれません。 このまれな現象が発生した場合は、 IBM Cloud® ステータスページをチェックして、ホストがストレージにアクセスする能力に影響を与えるイベントが進行中かどうかを確認してください。 イベントが報告されない場合は、ディスカバリスキャンを再度実行し、すべてのパスが正しく検出されていることを確認してください。 イベントが進行中であれば、ストレージはシングルパスで接続できる。 ただし、イベント終了後にパスを再スキャンすることが重要です。 再スキャンを行っても両方のパスが検出されない場合は、適切に調査できるよう、 サポートケースを作成してください。

Block Storage for Classic ボリュームのアンマウント

1. ファイル・システムをアンマウントします。

   umount /dev/mapper/XXXp1 /PerfDisk
   

2. そのターゲット・ポータルに他のボリュームがない場合は、ターゲットからログアウトできます。

   iscsiadm -m node -T <TARGET NAME> -p <PORTAL IP:PORT> --logout
   

3. そのターゲット・ポータルに他のボリュームがない場合は、ターゲット・ポータル・レコードを削除して、今後ログインを試行できないようにします。

   iscsiadm -m node -o delete -T <TARGET IQN> -p <PORTAL IP:PORT>
   

   詳細については、『 iscsiadm 』マニュアルを参照してください。