Red Hat Training

A Red Hat training course is available for Red Hat Enterprise Linux

30.7. VDO コマンド

本セクションでは、以下の VDO ユーティリティーを説明します。
vdo
vdo ユーティリティーは、VDO の kvdo コンポーネントと UDS コンポーネントの両方を管理します。
圧縮の有効化または無効化にも使用されます。
vdostats
vdostats ユーティリティーは、Linux df ユーティリティーと同様に、構成された各（または指定した）デバイスの統計を表示します。

30.7.1. vdo

vdo ユーティリティーは、VDO の kvdo コンポーネントと UDS コンポーネントの両方を管理します。

概要

vdo { activate | changeWritePolicy | create | deactivate | disableCompression | disableDeduplication | enableCompression | enableDeduplication | growLogical | growPhysical | list | modify | printConfigFile | remove | start | status | stop } 
[ options... ]

Sub-Commands

表30.4 VDO Sub-Commands

Sub-Command説明
create
VDO ボリュームとその関連インデックスを作成し、利用できるようにします。if the positionactivate=disabled を指定すると、VDO ボリュームが作成されますが、利用できません。それ以外では、既存のファイルシステムまたはフォーマットされた VDO ボリューム を上書きしません。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
remove
停止した VDO ボリュームと関連するインデックスを削除します。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
start
1 つ以上の停止して、アクティブ化した VDO ボリュームと関連サービスを開始します。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
stop
1 つ以上の実行中の VDO ボリュームと関連サービスを停止します。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
activate
1 つ以上の VDO ボリュームを有効にします。アクティブ化したボリュームは、
start
コマンドを使用して起動できます。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
deactivate
1 つ以上の VDO ボリュームを非アクティブにします。
start
コマンドでは、非アクティブ化されたボリュームは起動できません。現在実行中のボリュームを無効にしても、停止しません。非アクティブ化した VDO ボリュームを停止したら、再起動する必要があります。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
status
YAML 形式で VDO システムおよびボリュームのステータスを報告します。このコマンドは root 権限を必要としませんが、情報は不完全となります。適用可能なオプションには以下が含まれます。
提供された出力については、表30.6「VDO ステータスの出力」 を参照してください。
list
起動した VDO ボリュームの一覧を表示します。いずれのボリュームも 指定する場合、開始済みボリュームと起動されていないボリュームの両方が表示されます。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
modify
1 つまたはすべての VDO ボリュームの設定パラメーターを変更します。変更は、次回 VDO デバイスが起動したときに反映されます。すでに実行されているデバイスには影響はありません。適用可能なオプションには以下が含まれます。
changeWritePolicy
実行している VDO ボリュームの 1 つまたはすべての書き込みポリシーを変更します。このコマンドは root 権限で実行する必要があります。
enableDeduplication
1 つ以上の VDO ボリュームでの重複排除を有効にします。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
disableDeduplication
1 つ以上の VDO ボリュームでの重複排除を無効にします。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
enableCompression
1 つ以上の VDO ボリュームで圧縮を有効にします。VDO ボリュームを実行している場合は、すぐに有効になります。VDO ボリュームが実行されていない場合は、次に VDO ボリュームが起動すると、圧縮が有効になります。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
disableCompression
1 つ以上の VDO ボリュームで圧縮を無効にします。VDO ボリュームを実行している場合は、すぐに有効になります。VDO ボリュームが実行されていない場合は、次回 VDO ボリュームを起動したときに、圧縮が無効になります。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
growLogical
VDO ボリュームに論理領域を追加します。ボリュームは存在している必要があり、実行中である必要があります。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
growPhysical
VDO ボリュームに物理領域を追加します。ボリュームは存在している必要があり、実行中である必要があります。このコマンドは root 権限で実行する必要があります。適用可能なオプションには以下が含まれます。
printConfigFile
設定ファイルを stdout に出力します。このコマンドには root 権限が必要になります。適用可能なオプションには以下が含まれます。

オプション

表30.5 VDO オプション

オプション説明
--indexMem=gigabytes
UDS サーバーメモリーの量をギガバイトで指定します。デフォルトのサイズは 1 GB です。特別な 10 進数値 0.25、0.5、0.75 を使用できます。これは、正の整数を使用できます。
--sparseIndex={enabled | disabled}
スパースインデックスを有効または無効にします。デフォルトは 無効にされています。
--all
コマンドが、設定済みのすべての VDO ボリュームに適用する必要があることを示します。--name と併用できません。
--blockMapCacheSize=megabytes
ブロックマップページのキャッシュに割り当てられるメモリーの量を指定します。この値は 4096 の倍数である必要があります。サフィックスが B(ytes)、K（キロバイト）、M （メガバイト）、G （ギガバイト）、T（テラバイト）、P （ペサバイト ）、または E（エクサバイト）のサフィックスを指定した値は任意です。サフィックスを指定しない場合、値はメガバイトとして解釈されます。デフォルトは 128M です。値は 128M で、16T 未満の値である必要があります。メモリーのオーバーヘッドは 15% であることに注意してください。
--blockMapPeriod=period
1 から 16380 までの値。キャッシュされたページがディスクにフラッシュされる前に累積されるブロックマップの更新数を決定します。値が大きいほど、通常の操作中のパフォーマンスが低下すると、クラッシュ後に復元時間が短縮されます。デフォルト値は 16380 です。このパラメーターをチューニングする前に、Red Hat の担当者にお問い合わせください。
--compression={enabled | disabled}
VDO デバイス内の圧縮を有効または無効にします。デフォルトは有効です。圧縮は、パフォーマンスを最大化したり、圧縮できないデータ処理を高速化する必要がある場合に無効にすることができます。
--confFile=file
代替設定ファイルを指定します。デフォルトは /etc/vdoconf.yml です。
--deduplication={enabled | disabled}
VDO デバイス内の重複排除を有効または無効にします。デフォルトは 有効です。重複排除は、データが適切な重複排除レートを持つことは想定されていませんが、圧縮は望ましいインスタンスにおいて無効になる場合があります。
--emulate512={enabled | disabled}
512 バイトのブロックデバイスエミュレーションモードを有効にします。デフォルトは 無効にされています。
--force
VDO ボリュームを停止する前に、マウントされたファイルシステムをアンマウントします。
--forceRebuild
読み取り専用の VDO ボリュームを起動する前にオフライン再構築を強制し、オンラインに戻して利用できるようにする。このオプションを使用すると、データの損失や破損につながる可能性があります。
--help
vdo ユーティリティーのドキュメントを表示します。
--logfile=pathname
このスクリプトのログメッセージが送付されるファイルを指定します。警告とエラーメッセージは、常に syslog に記録されます。
--name=volume
指定した VDO ボリュームで操作します。--all と併用できません。
--device=device
VDO ストレージに使用するデバイスの絶対パスを指定します。
--activate={enabled | disabled}
引数は 無効になる と、VDO ボリュームの作成のみが必要になります。ボリュームは起動または有効化されません。デフォルトでは有効です。
--vdoAckThreads=thread count
要求された VDO I/O 操作の完了の完了に使用するスレッドの数を指定します。デフォルトは 1 です。値は 0 以上で、100 以下である必要があります。
--vdoBioRotationInterval=I/O count
次回に作業を出す前に、各 bio-submission スレッドに対してキューに置く I/O 操作の数を指定します。デフォルトは 64 で、値は 1 以上で 1024 以下である必要があります。
--vdoBioThreads=thread count
ストレージデバイスへの I/O オペレーションの送信に使用するスレッドの数を指定します。最小は 1 です。最大値は 100 です。デフォルト値は 4 です。値は 1 以上で、100 以下である必要があります。
--vdoCpuThreads=thread count
ハッシュまたは圧縮などの CPU 集約型作業に使用するスレッドの数を指定します。デフォルトは 2 です。値は 1 以上で、100 以下に設定する必要があります。
--vdoHashZoneThreads=thread count
ブロックデータから計算されるハッシュ値に基づいて、VDO 処理の一部を細分化するスレッドの数を指定します。デフォルトは 1 です。値は 0 以上で、100 以下である必要があります。vdoHashZoneThreads、vdoLogicalThreads および vdoPhysicalThreads は、すべてのゼロまたはゼロ以外のものでなければなりません。
--vdoLogicalThreads=thread count
ブロックデータから計算されるハッシュ値に基づいて、VDO 処理の一部を細分化するスレッドの数を指定します。値は 0 以上で、100 以下に設定する必要があります。9 以上の論理スレッド数には、十分な大きさのブロックマップキャッシュサイズを明示的に指定する必要があります。vdoHashZoneThreads、vdoLogicalThreads、および vdoPhysicalThreads は、すべてのゼロまたはゼロ以外のものでなければなりません。デフォルトでは 1 回です。
--vdoLogLevel=level
VDO ドライバーのログレベルを指定します。critical、error、warning、notice、info、または debug を指定します。レベルは大文字と小文字を区別します。デフォルトは info です。
--vdoLogicalSize=megabytes
論理ボリュームのサイズをメガバイトで指定します。S(ectors)、B(ytes)、K （ キロバイト）、M （メガバイト）、G（メガバイト）、T （テラバイト）、P (etabytes)、または E(xabytes)の接尾辞をオプションで指定します。ボリュームのプロビジョニングに使用されます。これは、ストレージデバイスのサイズにデフォルト設定されます。
--vdoPhysicalThreads=thread count
物理ブロックアドレスに基づいて VDO 処理の一部を分割するスレッド数を指定します。値は 0 以上、16 以下でなければなりません。最初の後の追加のスレッドは、さらに 10 MB の RAM を使用します。vdoPhysicalThreads、vdoHashZoneThreads、および vdoLogicalThreads は、すべてのゼロまたはゼロ以外のものでなければなりません。デフォルトでは 1 回です。
--readCache={enabled | disabled}
VDO デバイス内の読み込みキャッシュを有効または無効にします。デフォルトは 無効にされています。キャッシュは、書き込みワークロードに多くの重複排除レベルがある場合や、高度に圧縮可能なデータの読み取り集約型のワークロードに対して有効である必要があります。
--readCacheSize=megabytes
追加の VDO デバイスの読み取りキャッシュサイズをメガバイトで指定します。このスペースは、システム定義の最小値に加えて追加されています。サフィックスが B(ytes)、K（キロバイト）、M （メガバイト）、G （ギガバイト）、T（テラバイト）、P （ペサバイト ）、または E（エクサバイト）のサフィックスを指定した値は任意です。デフォルトは 0M です。バイオスレッドごとに、指定された読み取りキャッシュの MB ごとに 1.12 MB のメモリーが使用されます。
--vdoSlabSize=megabytes
VDO が拡大する増分サイズを指定します。サイズを小さく指定すると、収容できる物理サイズの合計サイズを制限します。128M から 32G の 2 つの電源である必要があります。デフォルトは 2G です。S(ectors)、B(ytes)、K （ キロバイト）、M （メガバイト）、G（メガバイト）、T （テラバイト）、P (etabytes)、または E(xabytes)の接尾辞をオプションで指定します。サフィックスを使用しない場合、値はメガバイトとして解釈されます。
--verbose
コマンドの実行前にコマンドを出力します。
--writePolicy={ auto | sync | async }
書き込みポリシーを指定します。
  • auto: VDO の下にあるストレージ層に基づいて sync または async を選択します。書き込みバックキャッシュが存在する場合は、async が選択されます。それ以外の場合は、同期 が選択されます。
  • 同期: 書き込みは、データが大幅に書き込まれた後にのみ確認されます。これはデフォルトポリシーです。基となるストレージも同期しない場合、このポリシーはサポートされません。
  • Async: 書き込みは、データが安定したストレージに書き込むため にキャッシュされた 後に確認されます。フラッシュされていないデータは、このモードで永続化されません。
status サブコマンドは、以下の情報を YAML 形式で返し、以下のようにキーに分割します。

表30.6 VDO ステータスの出力

キー説明
VDO ステータス このキーの情報では、ステータスがquiry となっているホストおよび日時の名前に対応しています。この領域で報告されるパラメーターには以下が含まれます。
ノード VDO が実行しているシステムのホスト名
日付 vdo status コマンドを実行する日時。
カーネルモジュール このキー内の情報は、設定したカーネルに対応します。
Loaded カーネルモジュールがロードされているかどうか（True または False）。
バージョン情報 設定されている kvdo のバージョンに関する情報。
設定 このキー内の情報は、VDO 設定ファイルの場所とステータスをカバーしています。
ファイル VDO 設定ファイルの場所。
最終更新日 VDO 設定ファイルの最後の変更日。
VDO すべての VDO ボリュームの設定情報を提供します。各 VDO ボリュームに報告されたパラメーターには以下が含まれます。
ブロックサイズ VDO ボリュームのブロックサイズ（バイト単位）。
512 バイトのエミュレーション ボリュームが 512 バイトのエミュレーションモードで稼働しているかどうかを示します。
重複排除の有効化 ボリュームに対して重複排除が有効になっているかどうか。
論理サイズ VDO ボリュームの論理サイズ
物理サイズ VDO ボリュームの基礎となる物理ストレージのサイズ。
書き込みポリシー 書き込みポリシー（sync または async）の設定された値。
VDO の統計 vdostats ユーティリティーの出力。