名称

書式

解説

記憶域プール中のすべてのデータセットは、同じ空間を共有します。データセットを管理に関する情報については、 zfs(8) を参照してください。

# zpool create mypool mirror da0 da1 mirror da2 da3

# zpool create pool mirror da0 da1 spare da2 da3

# zpool create pool da0 da1 log da2

# zpool create pool da0 da1 cache da2 da3

サブコマンド

zpool コマンドは、記憶域プールを作成して破壊する、記憶域プールに容量を追加する、記憶域プールに関して情報を提供するサブコマンドを提供しています。次のサブコマンドがサポートされています:

zpool [ -?]

ヘルプメッセージを表示します。

zpool add [ -fn] pool vdev ...

指定された仮想のデバイスを与えられたプールに追加します。 vdev 仕様は、“ 仮想のデバイス”セクションで説明されています。 -f オプションの振る舞いと、実行されたデバイスチェックは、“ zpool create”サブコマンドで説明されています。

-f

たとえ、それらが、使用中であると思われるか、または競合する複製レベルを指定したとしても、 vdev の使用を強制します。このように、すべてのデバイスを上書きできるというわけではありません。

-n

実際に vdev を追加せずに使用される設定を表示します。実際のプールの作成は、不十分な特権またはデバイス共有のために、まだ失敗するかもしれません。

現在、quorum デバイスとして設定されているディスクを zpool に追加しません。ディスクがプールにある後に、quorum デバイスとして、そのディスクを設定することができます。

zpool attach [ -f] pool device new_device

new_device を既存の zpool デバイスにアタッチします。既存のデバイスを raidz 設定の一部とすることはできません。 device 現在ミラーリングされた設定の一部でなければ、 device は、自動的に device と new_device の双方向のミラーに変換します。 device が双方向のミラーの一部であるなら、 new_device をアタッチすることは、3 方向のミラーを作成し、その他もろもろ。どちらの場合にも、 new_device は、直ちに再ミラーリングを始めます。

-f

たとえ、使用中であるように思えたとしても、 new_device の使用を強制します。このように、すべてのデバイスを上書きできるというわけではありません。

zpool clear [ -F [ -n]] pool [ device]

プール中のデバイスエラーをクリアします。引数が指定されていないなら、プール中のすべてのデバイスエラーは、クリアされます。 1 つ以上のデバイスが指定されるなら、指定されたデバイスまたはデバイスに関連しているそれらのエラーだけがクリアされます。

-F

オープンできないプールのための復旧モードを始めます。オープン可能な状態に戻すためにプール中の最後の少しのトランザクションを廃棄しようと試みます。すべての破損したプールを、このオプションを使用することによって復旧することができるわけではありません。成功するなら、廃棄されたトランザクションからのデータは、取り返しのつかないほど失われます。

-n

-F フラグと組み合わせて使用されます。トランザクションの廃棄は、プールをオープン可能とするかどうかチェックしますが、実際にはあらゆるトランザクションを廃棄しません。

zpool create [ -fnd][ -o property= value] ... [ -O file-system-property= value] ... [ -m mountpoint][ -R root] pool vdev ...

コマンド行で指定された仮想デバイスを含む新しい記憶域プールを作成します。プール名は、文字で始まらなけれならず、下線 ("_")、ダッシュ dash ("-") とピリオド (".") と同様に英数字のみを含むことができます。プール名、"mirror"、"raidz"、"spare"と "log"は、パターン "c[0-9]"で始まる名前のように予約されています。 vdev 仕様は、“ 仮想デバイス”セクションで説明されています。

コマンドは、指定されたそれぞれのデバイスがアクセス可能で、現在、別のサブシステムによって使用中でないことを確かめます。デバイスが ZFS によっていつも使用し続けることを防ぐ、現在マウントされているか、または専用ダンプデバイスとして指定されるような、いくつかの用途があります。前もって存在する UFS ファイルシステムを持つことなどの、他の用途を -f オプションで上書きすることができます。

また、コマンドは、プールのための複製の戦略が一貫していることをチェックします。単一のプールの冗長と冗長でない記憶域を組み合わせる試み、またはディスクとファイルを混在させる試みは、 -f が指定されないなら、エラーの結果となります。単一の raidz またはミラーグループ内のサイズの異なるデバイスの使用は、 -f が指定されないなら、エラーとして、またフラグが揚げられます。

-R オプションが指定されないなら、デフォルトのマウントポイントは、“ /pool”です。マウントポイントは、存在してはいけません、または空でなければなりません、あるいは、root のデータセットをマウントすることができません。 -m オプションで、これを上書きすることができます。

デフォルト、すべてのサポートされた機能は、 -d オプションが指定されなければ、新しいプールで有効にされます。

-f

それらが、たとえ使用中に現れるか、または競合する複製レベルを指定するとしても、強制的に vdev を使用します。このように、すべてのデバイスを上書きできるというわけではありません。

-n

実際にプールを作成しないで使用される設定を表示します。実際のプールの作成は、不十分な特権またはデバイス共有のために、いまだに失敗するかもしれません。

-d

新しいプールであらゆる機能を有効にしません。 -o オプションをつけて 有効にされた それらの対応するプロパティを設定することにより個々の機能を有効にすることができます。機能のプロパティに関する詳細については、 zpool-features(7) を参照してください。

-o property= value [ -o property= value] ...

与えられたプールのプロパティを設定します。設定できる有効なプロパティのリストについては、“ プロパティ”を参照してください。

-O file-system-property= value [ -O file-system-property= value] ...

プールのルートファイルシステムに与えられたファイルシステムのプロパティを設定します。設定できる有効なプロパティのリストについては、 zfs(8) の“ プロパティ”のセクションを参照してください。

-R root

“ -o cachefile=none,altroot= root”と同等です。

-m mountpoint

root のデータセットのためのマウントポイントを設定します。デフォルトのマウントポイントは、 altroot が指定されているなら、“ /pool”または“ altroot /pool”です。マウントポイントは、絶対パス、“ legacy”または“ none”でなければなりません。データセットのマウントポイントに関する詳細については、 zfs(8) を参照してください。

zpool destroy [ -f] pool

他の使用のための任意のデバイスを解放して、与えられたプールを破壊します。このコマンドは、プールを破壊する前に、任意のアクティブなデータセットをアンマウントしようと試みます。

-f

プール内に含まれる任意のアクティブなデータセットをアンマウントするように強制します。

zpool detach pool device

ミラーから device をデタッチします。データの他の有効な複製がないなら、操作は、拒否されます。

zpool export [ -f] pool ...

与えられたプールをシステムからエクスポートします。すべてのデバイスは、エクスポートされるとマークされますが、また、他のサブシステムによって使用中であると見なされます。 (異なったエンディアンのものさえ) デバイスをシステム間で移動でき、十分な数のデバイスが存在している限り、インポートすることができます。

プールをエクスポートする前に、プールの中のすべてのデータセットは、アンマウントされます。現在使用されている共有されたスペア (予備) があるなら、プールをエクスポートすることはできません。

プールに移植性があるようにするために、 ZFS が移植性がある EFI ラベルでディスクをラベル付けでききるように、利用者は、スライスだけではなく、全体のディスクを zpool コマンドに与えなければなりません、そうでなければ、異なったエンディアンのプラットフォームのディスクドライバは、ディスクを認識しません。

-f

“ unmount -f”コマンドを使用して、強制的にすべてのデータセットをアンマウントします。

このコマンドは、たとえ現在使用されている共有されたスペア (予備) があっても、プールを強制的にエクスポートします。これは、潜在的なデータの破損を導くかもしれません。

zpool get all | property[ , ...] pool ...

指定された記憶域プールに対して、プロパティ (または“ all”が使用されるなら、すべてのプロパティ) の与えられたリストを検索します。これらのプロパティは、次のフィールドとともに表示されます:

name	記憶域プールの名前
property	プロパティの名前
value	プロパティの値
source	プロパティのソース, 'default' または 'local' のいずれか.

利用可能なプールのプロパティの詳しい情報については、“ プロパティ”セクションを参照してください。

zpool history [ -il][ pool] ...

指定されたプールまたは、プールが指定されないなら、すべてのプールのコマンド履歴を表示します。

-i

ユーザが開始しているイベントに追加された内部的にログ記録された ZFS イベントを表示します。

-l

標準形式に加えて、ユーザ名、ホスト名と操作が実行されたゾーン (zone) の長い形式のログ記録を表示します。

zpool import [ -d dir | -c cachefile][ -D]

インポートするために利用可能なプールをリストします。 -d オプションが指定されないなら、このコマンドは、“ /dev”でデバイスを検索します。複数回 -d オプションを指定でき、すべてのディレクトリが検索されます。デバイスがエクスポートされたプールの一部として現れるなら、このコマンドは、 vdev レイアウトと各デバイスまたはファイルに対するデバイスの現在の健全性と同様に、プールの名前をつけてプールの概要、数値識別子を表示します。“ zpool destroy”コマンドで以前に破壊されたプールである、破壊されたプールは、 -D オプションが指定されないなら、リストされません。

数値識別子は、ユニークであり、同じ名前の複数のエクスポートされたプールが利用可能であるときに、プール名の代わりに使用することができます。

-c cachefile

“ cachefile”プールのプロパティで作成された、与えられた cachefile から設定を読み込みます。この cachefile は、デバイスを検索する代わりに使用されます。

-d dir

dir 中のデバイスまたはファイルを検索します。複数回 -d オプションを指定することができます。

-D

破壊されたプールだけをリストします。

zpool import [ -o mntopts][ -o property= value] ... [ -d dir | -c cachefile][ -D][ -f][ -m][ -N][ -R root][ -F [ -n]] -a

検索ディレクトリで見つけられたすべてのプールをインポートします。利用可能な十分な数のデバイスがあるすべてのプールがインポートされることを除いて、前のコマンドと同じです。“ zpool destroy”コマンドで以前に破壊されたプールである、破壊されたプールは、 -D オプションが指定されないなら、インポートされません。

-o mntopts

プール内でマウントされたデータセットであるときに使用するマウントオプションのコンマで区切られたリスト。データセットのプロパティとマウントオプションの説明については、 zfs(8) を参照してください。

-o property= value

インポートされたプールで指定されたプロパティを設定します。利用可能なプールのプロパティの詳しい情報については、“ プロパティ”セクションを参照してください。

-c cachefile

“ cachefile”プールのプロパティで作成された、与えられた cachefile から設定を読み込みます。この cachefile は、デバイスを検索する代わりに使用されます。

-d dir

dir 中のデバイスまたはファイルを検索します。複数回 -d オプションを指定することができます。このオプションは、 -c オプションとともに使用できません。

-D

破壊されたプールだけをインポートします。また、 -f オプションも必要です。

-f

プールが潜在的にアクティブであるように思われても、強制的にインポートします。

-m

失われたログデバイスでインポートを有効にします。

-N

インポートされたプールから任意のファイルシステムをマウントしません。

-R root

“ cachefile”プロパティを“ none”に、“ altroot”プロパティを“ root”に設定します。

-F

インポート不可能なプールのための復旧モード。最後の少ないトランザクションを廃棄することによって、インポート可能な状態にプールに戻すことを試みます。すべての破損したプールを、このオプションを使用することによって復旧することができるわけではありません。成功するなら、廃棄されたトランザクションからのデータは、取り返しのつかないほど失われます。このオプションは、プールがインポート可能か、または既にインポートされているなら、無視されます。

-n

-F 復旧オプションとともに使用されます。インポート不可能なプールを再びインポート可能にすることができるかどうか判断しますが、実際にはプールの復旧を行ないません。プールの復旧モードに関するより詳細については、上記の -F オプションを参照してください。

-a

見つかったすべてのプールを検索して、インポートします。

zpool import [ -o mntopts][ -o property= value] ... [ -d dir | -c cachefile][ -D][ -f][ -m][ -N][ -R root][ -F [ -n]] pool | id [ newpool]

特定のプールをインポートします。名前または数値識別子によってプールを識別することができます。 newpool が指定されるなら、プールは、 newpool という名前を使用してインポートされます。そうでなければ、エクスポートされた名前として同じ名前でインポートされます。

デバイスが、最初に“ zpool export”を実行することなしにシステムから削除されるなら、デバイスは、潜在的にアクティブであると見なされます。これが失敗したエクスポートであったか、またはデバイスが実際に別のホストから使用中であるかどうかは決定することはできません。この状態でプールをインポートするためには、 -f オプションが必要です。

-o mntopts

プール内のデータセットをマウントするときに使用するマウントオプションのコンマで区切られたリスト。データセットのプロパティとマウントオプションの説明については、 zfs(8) を参照してください。

-o property= value

インポートされたプールで指定されたプロパティを設定します。利用可能なプールのプロパティの詳しい情報については、“ プロパティ”セクションを参照してください。

-c cachefile

“ cachefile”プールのプロパティで作成された、与えられた cachefile から設定を読み込みます。この cachefile は、デバイスを検索する代わりに使用されます。

-d dir

dir 中のデバイスまたはファイルを検索します。複数回 -d オプションを指定することができます。このオプションは、 -c オプションとともに使用できません。

-D

破壊されたプールをインポートします。また、 -f オプションも必要です。

-f

たとえプールが潜在的にアクティブであるように思われても、強制的にインポートします。

-m

失われたログデバイスでインポートを有効にします。

-N

インポートされたプールから任意のファイルシステムをマウントしません。

-R root

“ -o cachefile=none,altroot= root”と同等です。

-F

インポート不可能なプールのための復旧モード。最後の少ないトランザクションを廃棄することによって、インポート可能な状態にプールに戻すことを試みます。すべての破損したプールを、このオプションを使用することによって復旧することができるわけではありません。成功するなら、廃棄されたトランザクションからのデータは、取り返しのつかないほど失われます。このオプションは、プールがインポート可能か、または既にインポートされているなら、無視されます。

-n

-F 復旧オプションとともに使用されます。インポート不可能なプールを再びインポート可能にすることができるかどうか判断しますが、実際にはプールの復旧を行ないません。プールの復旧モードに関するより詳細については、上記の -F オプションを参照してください。

zpool iostat [ -T d| u][ -v][ pool] ... [ interval [ count]]

与えられたプールのための I/O 統計値を表示します。間隔を与えるとき、統計値は、 Ctrl-C が押されるまで、 interval 秒毎に印刷されます。 pools が指定されないなら、システムのあらゆるプールに対する統計値が表示されます。 count が指定されるなら、 count レポートが印刷された後にコマンドは、終了します。

-T d| u

タイムスタンプを印刷 (表示) します。

標準の日付の形式のためには、修飾子 d を使用します。 date(1) を参照してください。 UNIX 時間 (“ date +%s”と等しい) のためには、修飾子 u を使用します。

-v

冗長な統計。プール全体の統計に加えて、プール内の個々の vdev のための使用状況の統計値を報告します。

zpool labelclear [ -f] device

指定された device から ZFS ラベル情報を取り除きます。 device は、アクティブなプール設定の部分であってはなりません。

-v

アクティブでないとしてエクスポートされているか、または外部のデバイスを扱います。

zpool list [ -Hv][ -o property[ , ...]][ -T d| u][ pool] ... [ inverval [ count]]

健全な状態と空間の使用法とともに与えられたプールをリストします。引数を与えないとき、システム中のすべてのプールがリストされます。

間隔を与えるとき、出力は、 Ctrl-C が押されるまで、 interval 秒毎に印刷されます。 count が指定されるなら、 count レポートが印刷された後にコマンドは、終了します。

-H

スクリプトモード。ヘッダと任意の空白の代わりに単一のタブによって分離されたフィールドを表示しません。

-v

より多くの詳細情報を表示します。

-o property[ , ...]

表示するためのプロパティのコンマで区切られたリスト。有効なプロパティのリストについては、“ プロパティ”セクションを参照してください。デフォルトのリストは、 name, size, used, available, capacity, health, altroot です。

-T d| u

タイムスタンプを印刷 (表示) します。

標準の日付の形式のためには、修飾子 d を使用します。 date(1) を参照してください。 UNIX 時間 (“ date +%s”と等しい) のためには、修飾子 u を使用します。

zpool offline [ -t] pool device ...

指定された物理的なデバイスをオフラインと見なします。 device がオフラインである間に、デバイスへの読み込み、または書き込みを試みません。

-t

一時的。リブートのときに、指定された物理的なデバイスは、前の状態に戻ります。

zpool online [ -e] pool device ...

指定された物理的なデバイスをオンラインにします。

このコマンドは、スペアまたはキャッシュデバイスに適用可能ではありません。

-e

すべての利用可能な空間を使用するデバイスを拡張します。デバイスがミラーまたは raidz の一部であるなら、新しい空間がプールで利用可能になる前に、すべてのデバイスは、拡張されなければなりません。

zpool reguid pool

プールのための新しいユニークな識別子を生成します。このプールのすべてのデバイスがこのアクションを行なう前にオンラインであり健全であることを保証しなければなりません。

zpool remove pool device ...

プールから指定されたデバイスを削除します。このコマンドは、現在、ホットスペア、キャッシュとログデバイスの削除のみをサポートしています。ログのためのトップレベルのミラーを指定することによって、ミラーリングされたログデバイスを削除することができます。“ zpool detach”コマンドを使用して、ミラーリングされた設定の一部であるログデバイス以外を削除することができます。プールから冗長でない、 raidz デバイスを削除することはできません。

zpool replace [ -f] pool device [ new_device]

old_device を new_device で置き換えます。これは、 new_device のアタッチと同等で、 resilver をウェートし、次に old_device をデタッチします。

new_device のサイズは、ミラーまたは raidz 設定のすべてのデバイスの最小のサイズ以上でなければなりません。

プールが冗長ででないなら、 new_device が要求されます。 new_device が指定されないなら、 old_device をデフォルトとします。既存のディスクが故障して、物理的に置き換えられた後に、この置き換えの形式は、役に立ちます。この場合、新しいディスクには、それが実際に異なったディスクであっても、古いデバイスと同じ /dev パスがあります。 ZFS は、これを認識します。

-f

たとえ使用中に現れても、 new_device の使用を強制します。このようにすべてのデバイスを上書きすることができるというわけではありません。

zpool scrub [ -s] pool ...

scrub を始めます。 scrub は、チェックサムが正しいか確認するために指定されたプールのすべてのデータを調査します。複製された (ミラーまたは raidz) デバイスに関しては、 ZFS は、自動的に scrub の間に発見されたあらゆる損傷を修理します。“ zpool status”コマンドは、scrub の進捗を報告して、完了するときに scrub の結果を要約します。

scrubbing と resilvering は、たいへんよく似た操作です。違いは、resilvering が、 ZFS が (例えば、新しいデバイスをミラーにアタッチするか、または既存のデバイスを置き換えるとき) 期限切れであることを知っているデータを調査するためだけであるのに対して、scrubbing が、ハードウェアの故障またはディスクの故障によって静かなエラーを発見するためにすべてのデータを調査することです。

scrubbing と resilvering が、 I/O 集中的な操作であるので、 ZFS は、一度に 1 つだけ許可されます。 scrub が既に進行しているなら、“ zpool scrub”コマンドは、エラーを返します。新しい scrub を開始するためには、最初に古い scrub を“ zpool scrub -s”コマンドで停止しなければなりません。 resilver が進行しているなら、 ZFS は、scrub が resilver が完了するまで、開始することを scrub に許可しません。

-s

scrubbing を停止します。

zpool set property= value pool

指定されたプールで与えられたプロパティを設定します。どのようなプロパティを設定できるか、と受け付け可能な値に関する詳しい情報については、“ プロパティ”セクションを参照してください。

zpool split [ -n][ -R altroot][ -o mntopts][ -o property= value] pool newpool [ device ...]

プール中の各ミラーされたトップレベルの vdev から 1 つのディスクを切り離し、切り離されたディスクから新しいプールを作成します。元のプールは、1 つ以上のミラーから構成されていなければならず、 resilvering が進行中ではあってはなりません。 split サブコマンドは、コマンド行のデバイス指定によって上書きされなければ、各ミラー vdev の最後のデバイスを選択します。

device 引数を使用するとき、 split は、新しいプールで指定されたデバイスを含み、どんなデバイスも指定されないままにするべきで、それが通常行うように、そのプールに各ミラー vdev の最後のデバイスを割り当てます。 split コマンドの結果について確信がないなら、利用者のコマンドが意図する効果があることを保証するために -n ("予行演習") オプションを使用していください。

-R altroot

新しいプールの代替のルートのために指定された altroot パラメータを使用して、分割された後に、新しく作成されたプールを自動的にインポートします。上記の“ プロパティ”セクションの altroot の説明を参照してください。

-n

実際にプールを分割せずに作成される設定を表示します。分割された実際のプールは、まだ、不十分な特権またはデバイス状態のために失敗するかもしれません。

-o mntopts

プール内のデータセットをマウントするとき使用するマウントオプションのコンマで区切られたリスト。データセットのプロパティとマウントオプションの説明については、 zfs(8) を参照してください。 -R オプションと共に指定されるときだけ有効です。

-o property= value

新しいプール上で指定されたプロパティを設定します。利用可能なプールのプロパティに関する詳細については、上記の“ プロパティ”セクションを参照してください。

zpool status [ -vx][ -T d| u][ pool] ... [ interval [ count]]

与えられたプールのための詳細な健全な状態を表示します。 pool が指定されないなら、システムのそれぞれのプールの状態が、表示されます。プールとデバイスの健全性に関する詳しい情報については、“ デバイスの故障と復旧”セクションを参照してください。

間隔を与えるとき、出力は、 Ctrl-C が押されるまで、 interval 秒毎に印刷されます。 count が指定されるなら、 count レポートが印刷された後にコマンドは、終了します。

scrub または resilver が進行しているなら、このコマンドは、行われた割合と完了するためのおよそ時間を報告します。システムのプール内のデータ量と他の仕事量は、変更できるので、これらの両方は、おおよそのみです。

-x

エラーの表示、またはそうでなければ利用不可能なプールのための状態のみを表示します。最新のディスク上の形式を使用しないプールに関する警告は、含まれません。

-v

詳細なデータエラー情報を表示し、最後の完全なプール scrub 以来のすべてのデータエラーの全てのリストを印刷します。

-T d| u

タイムスタンプを印刷 (表示) します。

標準の日付の形式のためには、修飾子 d を使用します。 date(1) を参照してください。 UNIX 時間 (“ date +%s”と等しい) のためには、修飾子 u を使用します。

zpool upgrade [ -v]

有効にされたすべてのサポートされた機能と古い ZFS バージョン番号を使用するフォーマットされたプールがないプールを表示します。これらのプールは、使用し続けることができますが、いくつかの機能は、利用可能ではありません。すべてのプールですべての機能を有効にするためには、 zpool upgrade -a を使用します。

-v

現在のソフトウェアによってサポートされている古い ZFS バージョンを表示します。現在のソフトウェアによってサポートされている機能フラグの説明については、 zpool-features.5 を参照してください。

zpool upgrade [ -V version] -a | pool ...

与えられたプールでサポートされているすべての機能を有効にします。いったん、これが行われるなら、プールは、もはや機能フラグをサポートしないシステムでアクセス可能となりません。システム sthat サポート機能フラグと互換性に関する詳細については、 zpool-features.5 を参照しますが、プールで有効にされたすべての機能をサポートしません。

-a

すべてのプールでサポートされているすべての機能を有効にします。

-V version

指定された古いバージョンをアップグレードします。 -V フラグが指定されるなら、機能は、プールで有効にされません。最後にサポートされている古いバージョン番号までバージョン番号を増加させるためだけに、このオプションを使用することができます。

終了ステータス

0

成功して終了。

1

エラーが発生しました。

2

無効のコマンド行のオプションが指定されました。

使用例

使用例 1 RAID-Z 記憶域プールを作成する

次のコマンドは、6 つのディスクから成る単一の raidz root vdev でプールを作成します。

# zpool create tank raidz da0 da1 da2 da3 da4 da5

使用例 2 ミラーリングされた記憶域プールを作成する

次のコマンドは、各ミラーが 2 つのディスクを含む、2 つのミラーがあるプールを作成します。

# zpool create tank mirror da0 da1 mirror da2 da3

使用例 3 パーティションを使用することによって ZFS 記憶域プールを作成する

次のコマンドは、2 つの GPT パーティションを使用してミラーされないプールを作成します。

# zpool create tank da0p3 da1p3

使用例 4 ファイルを使用することによって ZFS 記憶域プールを作成する

次のコマンドは、ファイルを使用してミラーされないプールを作成します。推薦されませんが、ファイルに基づくプールは、実験目的のために役に立たつかもしれません。

# zpool create tank /path/to/file/a /path/to/file/b

使用例 5 ZFS 記憶域プールへのミラーを追加する

次のコマンドは、プールが既に 2 つの方法でミラーを作っていることを仮定して、プール tank に 2 つのミラーされたディスクを追加します。追加された空間は、プール内のあらゆるデータセットを直ちに利用可能とします。

# zpool add tank mirror da2 da3

使用例 6 利用可能な ZFS 記憶域プールをリストする

次のコマンドは、システムで利用可能なすべてのプールをリストします。

# zpool list 
NAME SIZE ALLOC FREE CAP DEDUP HEALTH ALTROOT pool 2.70T 473G 2.24T 17% 1.00x 
ONLINE - test 1.98G 89.5K 1.98G 0% 1.00x ONLINE -

使用例 7 プールのためのすべてのプロパティをリストする

次のコマンドは、プールのためのすべてのプロパティをリストします。

# zpool get all pool 
pool size 2.70T - pool capacity 17% - pool altroot - default pool health 
ONLINE - pool guid 2501120270416322443 default pool version 28 default pool 
bootfs pool/root local pool delegation on default pool autoreplace off default 
pool cachefile - default pool failmode wait default pool listsnapshots off 
default pool autoexpand off default pool dedupditto 0 default pool dedupratio 
1.00x - pool free 2.24T - pool allocated 473G - pool readonly off -

使用例 8 ZFS 記憶域プールを破壊する

次のコマンドは、プール“ tank”と中に含まれたあらゆるデータセットを破壊します。

# zpool destroy -f tank

使用例 9 ZFS 記憶域プールをエクスポートする

次のコマンドは、それらを再配置するか、または後でインポートすることができるように、プール tank のデバイスをエクスポートします。

# zpool export tank

使用例 10 ZFS 記憶域プールをインポートする

次のコマンドは、利用可能なプールを表示して、次に、システムで使用するプール“ tank”をインポートします。

このコマンドの結果は、次と同様です:

# zpool import 
 
  pool: tank 
    id: 15451357997522795478 
 state: ONLINE 
action: The pool can be imported using its name or numeric identifier. 
config: 
 
        tank        ONLINE 
          mirror    ONLINE 
               da0  ONLINE 
               da1  ONLINE

使用例 11 すべての ZFS 記憶域プールを現在の版にアップグレードする

次のコマンドは、すべての ZFS 記憶域プールをソフトウェアの現在の版にアップグレードします。

# zpool upgrade -a 
This system is currently running ZFS pool version 28.

使用例 12 ホットスペアを管理する

次のコマンドは、利用可能なホットスペアで新しいプールを作成します:

# zpool create tank mirror da0 da1 spare da2

ディスクの 1 つが故障したなら、プールは、低下している状態に減少されます。次のコマンドを使用して故障したデバイスを取り替えることができます:

# zpool replace tank da0 da2

いったんデータが resilver されると、スペアは、自動的に取り除かれ、利用可能にされ、別のデバイスの障害とするべきです。次のコマンドを使用してプールからホットスペアを永久に削除することができます:

# zpool remove tank da2

使用例 13 ミラーされ分離された目的 (intent) ログのある ZFS プールを作成する

次のコマンドは、両方向のミラーとミラーされたログデバイスの 2 つから成る ZFS 記憶域プールを作成します:

# zpool create pool mirror da0 da1 mirror da2 da3 log mirror da4 da5

使用例 14 ZFS プールにキャッシュデバイスを追加する

次のコマンドは、 ZFS 記憶域プールにキャッシュデバイスとして使用される 2 つのディスクを追加します:

# zpool add pool cache da2 da3

いったん追加されると、キャッシュデバイスは、主メモリからの内容で徐々に満たされます。利用者のキャッシュデバイスのサイズによって、満杯になるには 1 時間かかるかもしれません。次のように iostat サブコマンドを使用して容量と読み込みをモニタすることができます:

# zpool iostat -v pool 5

使用例 15 ミラーリングされたログデバイスを取り外す

次のコマンドは、ミラーリングされたログデバイス mirror-2 を取り外します。

次の設定を与えます:

   pool: tank 
  state: ONLINE 
  scrub: none requested 
 config: 
 
         NAME        STATE     READ WRITE CKSUM 
         tank        ONLINE       0     0     0 
           mirror-0  ONLINE       0     0     0 
                da0  ONLINE       0     0     0 
                da1  ONLINE       0     0     0 
           mirror-1  ONLINE       0     0     0 
                da2  ONLINE       0     0     0 
                da3  ONLINE       0     0     0 
         logs 
           mirror-2  ONLINE       0     0     0 
                da4  ONLINE       0     0     0 
                da5  ONLINE       0     0     0

ミラーリングされたログ mirror-2 を取り除くコマンドは、次の通りです:

# zpool remove tank mirror-2

使用例 16 障害となった ZFS プールを復旧する

プールが障害となったが、復元可能であるなら、この状態を示すメッセージは、プールがキャッシュされているなら、 (上記の -c cachefile 引数を参照) または、プールの障害となった“ zpool import”からのエラー出力の一部として、“ zpool status”によって提供されます。

“ zpool clear”コマンドでキャッシュされたプールを復旧します:

# zpool clear -F data 
Pool data returned to its state as of Tue Sep 08 13:23:35 2009. 
Discarded approximately 29 seconds of transactions.

プール設定がキャッシュされていなかったなら、次の復旧モードフラグを付けて“ zpool import”を使用します:

# zpool import -F data 
Pool data returned to its state as of Tue Sep 08 13:23:35 2009. 
Discarded approximately 29 seconds of transactions.

関連項目

作者

このマニュアルページの mdoc(7) の実装は、最初に Martin Matuska <mm@FreeBSD.org>によって書かれました。