Open-iSCSIのソースを表示

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

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

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

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

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

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

== 概要 ==
以下は構成要素の互いの関係を示した図式になります。より詳しいバージョンが次のページにあります: [http://www.open-iscsi.org/docs/open-iscsi-0.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 の [http://www.open-iscsi.org/docs/README README] より:

永続的な設定は DBM データベースとして実装され、以下の2つのテーブルを含みます:
* ディスカバリテーブル (/etc/iscsi/send_targets)
* ノードテーブル (/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 デバイスの {{ic|/dev}} ツリーにある場所は {{ic|ls -lh /dev/disk/by-path/* | grep ip}} でも確認できます。

サーバー (ターゲット) 側では acl の設定に {{ic|/etc/iscsi/initiatorname.iscsi}} からクライアントの iqn を記述する必要があります。

{{ic|iscsiadm}} の操作は基本的に iSCSI デーモン {{ic|iscsid}} が動作していることを必要とします。動作しているか確認するには、{{ic|open-iscsi.service}} の[[systemd#ユニットを使う|状態を確認]]してください。

== 参照 ==
* [[en2:iSCSI Boot|iSCSI ブート]] - iSCSI ターゲットで Arch Linux を起動。