Open-iSCSIのソースを表示

[[Category:ストレージ]]
[[Category:ネットワーク]]
[[en:ISCSI Initiator]]
[[zh-hans:ISCSI initiator]]
{{Related articles start}}
{{Related|iSCSI ターゲット}}
{{Related|iSCSI ブート}}
{{Related articles end}}

[[Wikipedia:ja:iSCSI|iSCSI]] を使うことで IP ベースのネットワーク上のストレージにアクセスすることができます。

エクスポートされるストレージエンティティが'''[[iSCSI ターゲット|ターゲット]]'''でインポートするエンティティが'''イニシエータ'''です。

この記事では [https://github.com/open-iscsi/open-iscsi Open-iSCSI] イニシエータを使って iSCSI ターゲットにアクセスする方法を説明します。

== インストール ==
[[公式リポジトリ]]から {{Pkg|open-iscsi}} パッケージを[[pacman|インストール]]してください。

{{Note|旧式のイニシエータ [https://sourceforge.net/projects/linux-iscsi/ Linux-iSCSI] は2005年4月に Open-iSCSI に統合されました。[http://linux-iscsi.org/ linux-iscsi.org] は LIO [[iSCSI ターゲット|ターゲット]]のウェブサイトなので間違えないで下さい。}}

== 概要 ==
以下は構成要素の互いの関係を示した図式になります。より詳しいバージョンが次のページにあります: [https://archive.is/HHYKR/90a7a1c178a2c069a7cbc0b578b6fb5854f827fa.jpg Open-iSCSI modules]
{{bc|<nowiki>
 +-------------------------------------------------------+             
 | Targets & Sessions configuration Database (DBM based) |             
 +-------------------------------------------------------+             
                                                                       
 +--------------------------+     +----------------------------------+ 
 | iscsiadm                 |     | iscsid: iSCSI daemon             | 
 |                          |     |                                  | 
 |  * Command line tool     |<--->|  * Implements Session management | 
 |  * Manages database of   |     |  * Communicates with iscsiadm    | 
 |    sessions and targets  |     |    and iscsi kernel modules      | 
 +--------------------------+     +---------------+------------------+ 
                                                  |                    
 User space                                       |                    
- - - - - - - - - - - - - - - - - - - - - - - - - | - - - - - - - - - -
 Kernel                                           v                    
         +-----------------------------------------------------------+ 
         | kernel modules: scsi_transport_iscsi, iscsi_tcp, libiscsi | 
         +-----------------------------------------------------------+ 
</nowiki>}}

Open-iSCSI の [https://github.com/open-iscsi/open-iscsi README] より:

永続的な設定は DBM データベースとして実装され、以下の2つのテーブルを含みます:
* ディスカバリテーブル ({{ic|/etc/iscsi/send_targets}})
* ノードテーブル ({{ic|/etc/iscsi/nodes}})

== 設定 ==
=== サービスの起動 ===
{{ic|iscsid}} は systemd ユニットで管理します。

[[systemd#ユニットを使う|systemd]] で {{ic|open-iscsi.service}} を起動してください。

SCSI ターゲットがイニシエータによる認証を必要とする場合、設定ファイル {{ic|/etc/iscsi/iscsid.conf}} を更新してください。

イニシエータのログインセッションを認証してターゲットからイニシエータにセッションを確立するのには以下のパラメータを使います:

 node.session.auth.authmethod = CHAP
 node.session.auth.username = <username in target>
 node.session.auth.password = <password in target>
 node.session.auth.username_in = <username in initiator>
 node.session.auth.password_in = <password in initiator>

イニシエータのディスカバリセッションを認証してターゲットからイニシエータにセッションを確立するのには以下のパラメータを使います:

 discovery.sendtargets.auth.authmethod = CHAP
 discovery.sendtargets.auth.username = <username in target>
 discovery.sendtargets.auth.password = <password in target>
 discovery.sendtargets.auth.username_in = <username in initiator>
 discovery.sendtargets.auth.password_in = <password in initiator>

{{Warning|同一のパスワードを設定することはできません。上記の設定では別々の4つのパスワードを設定する必要があります。}}

=== ターゲットのディスカバリ ===
{{bc|# iscsiadm -m discovery -t sendtargets -p <portalip>}}
=== ターゲットの削除 ===
{{bc|# iscsiadm -m discovery -p <portalip> -o delete}}

=== 利用可能なターゲットにログイン ===
{{bc|# iscsiadm -m node -L all}}
もしくは特定のターゲットにログイン:
{{bc|<nowiki># iscsiadm -m node --targetname=<targetname> --login</nowiki>}}

ログアウト:
{{bc|# iscsiadm -m node -U all}}

=== 情報の確認 ===
実行中のセッションを確認するには:
{{bc|# iscsiadm -m session -P 3}}
上のコマンドの最後の行にはアタッチされたデバイスの名前が表示されます。例:
{{bc|Attached scsi disk '''sdd''' State: running}}

既知のノードを確認するには:
{{bc|# iscsiadm -m node}}

=== ボリュームのオンラインリサイズ ===
iscsi ブロックデバイスにパーティションテーブルが含まれている場合、オンラインリサイズを行うことはできません。その場合、ファイルシステムをアンマウントしてからパーティションのサイズを変更する必要があります。
# 現在のセッションで有効なノードを再スキャン: {{bc|# iscsiadm -m node -R}}
# マルチパスを使っている場合、マルチパスのボリューム情報も再スキャンしてください: {{bc|# multipathd -k"resize map sdx"}}
# 最後にファイルシステムをリサイズ: {{bc|# resize2fs /dev/sdx}}

== ヒントとテクニック ==

=== 接続されている iSCSI デバイスを確認する ===

次のコマンドを使用して、接続されている iSCSI デバイスが {{ic|/dev/}} ツリー内のどこにあるかを確認することもできます:

 $ ls -l /dev/disk/by-path/ip-*

=== 起動時にターゲットにログインする ===

ブート中にターゲットにログインするには、{{ic|iscsi.service}} を [[有効化]] して実行し、ノードの設定に {{ic|1=node.startup = automatic}} が含まれていることを確認します ({{ic|/var/lib/iscsi/nodes/iqn.''node-name''/''node-ip-address'',''port''}})

{{Note|1=systemd ユニット名は {{ic|iscsi'''d'''.service}} ではなく {{ic|iscsi.service}} です。[https://bbs.archlinux.org/viewtopic.php?pid=1961776#p1961776]}}

== トラブルシューティング ==

=== Client IQN ===

サーバー (ターゲット) では、アカウント設定に {{ic|/etc/iscsi/initiatorname.iscsi}} のクライアント IQN を含める必要がある場合があります。

=== iSCSI デーモンのデバッグ ===

iSCSI デーモンをデバッグモードで実行するには (事前に {{ic|iscsid.service}} を停止していることを確認してください)

 # iscsid -d 8 -c /etc/iscsi/iscsid.conf -i /etc/iscsi/initiatorname.iscsi -f

== 参照 ==

* [[iSCSI ブート]] - iSCSI ターゲットで Arch Linux を起動。