Menu Close

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... ]

サブコマンド

表30.4 VDO サブコマンド

サブコマンド説明
create
VDO ボリュームと、その関連インデックスを作成し、使用できるようにします。−−activate=disabled を指定すると、VDO ボリュームが作成されますが、使用できません。--force が指定されていない場合は、既存のファイルシステムまたはフォーマットされた VDO ボリュームを上書きしません。このコマンドは、root 権限で実行する必要があります。適用可能なオプションは以下のとおりです。
remove
停止している 1 つまたは複数の VDO ボリュームと関連するインデックスを削除します。このコマンドは、root 権限で実行する必要があります。適用可能なオプションは以下のとおりです。
start
停止、アクティブ化されている 1 つ以上の VDO ボリュームおよび関連サービスを開始します。このコマンドは、root 権限で実行する必要があります。適用可能なオプションは以下のとおりです。
stop
1 つ以上の VDO ボリュームおよび関連サービスの実行を停止します。このコマンドは、root 権限で実行する必要があります。適用可能なオプションは以下のとおりです。
アクティベート
1 つ以上の VDO ボリュームをアクティブにします。アクティブなボリュームは、
start
コマンドを使用して起動できます。このコマンドは、root 権限で実行する必要があります。適用可能なオプションは以下のとおりです。
deactivate
1 つ以上の VDO ボリュームを非アクティブにします。アクティブでないボリュームは、
start
コマンドでは起動できません。現在実行中のボリュームを非アクティブにしても、ボリュームは停止しません。停止したら、再起動する前に、無効にした VDO ボリュームを有効にする必要があります。このコマンドは、root 権限で実行する必要があります。適用可能なオプションは以下のとおりです。
status
VDO システムとボリュームのステータスを YAML 形式で報告します。このコマンドは root 権限を必要としませんが、root 権限なしで実行すると、情報は不完全になります。適用可能なオプションは以下のとおりです。
提供される出力は、表30.6「VDO ステータス出力」 を参照してください。
list
起動している VDO ボリュームの一覧を表示します。--all を指定すると、起動したボリュームと、起動していないボリュームの両方が表示されます。このコマンドは、root 権限で実行する必要があります。適用可能なオプションは以下のとおりです。
変更
1 つまたはすべての VDO ボリュームの設定パラメーターを変更します。変更は、次に VDO デバイスを起動したときに有効になります。すでに実行中のデバイスには影響しません。適用可能なオプションは以下のとおりです。
changeWritePolicy
実行中の 1 つまたはすべての VDO ボリュームの書き込みポリシーを変更します。このコマンドは、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 サーバーメモリーの量をギガバイト単位で指定します。デフォルトサイズは 1GB です。特殊な10 進数の値である 0.25、0.5、0.75 は、正の整数として使用できます。
--sparseIndex={enabled | disabled}
スパースインデックス作成を有効または無効にします。既定値は disabled です。
--all
このコマンドを、設定した VDO ボリュームすべてに適用する必要があることを示しています。--name と併用しないでください。
--blockMapCacheSize=megabytes
ブロックマップページのキャッシュに割り当てるメモリーの量を指定します。値は、4096 の倍数にする必要があります。B(ytes)、K(ilobytes)、M(egabytes)、G(igabytes)、T(erabytes)、P(etabytes)、またはE(xabytes) の接尾辞が付いた値の使用はオプションです。接尾辞が指定されていない場合、値はメガバイトとして解釈されます。デフォルトは 128M です。値は 128M 以上、16T 未満にする必要があります。メモリーオーバーヘッドは 15% であることに注意してください。
--blockMapPeriod=period
キャッシュされたページがディスクにフラッシュされる前に蓄積される可能性のあるブロックマップ更新の数を決定する 1 から 16380 までの値。値を大きくすると、通常の操作中のパフォーマンスが低下しますが、クラッシュ後の回復時間が短くなります。デフォルト値は 16380 です。このパラメーターを調整する前に、RedHat の担当者に相談してください。
--compression={enabled | disabled}
VDO デバイス内での圧縮を有効または無効にします。デフォルトでは有効になっています。パフォーマンスを最大化するため、または圧縮される可能性が低いデータの処理を高速化するために、必要に応じて圧縮を無効にすることができます。
--confFile=file
別の設定ファイルを指定します。既定値は /etc/vdoconf.yml です。
--deduplication={enabled | disabled}
VDO デバイス内での重複排除を有効または無効にします。既定値は enabled です。データの重複排除率が高くないと予想されるが、圧縮が必要な場合は、重複排除を無効にすることができます。
--emulate512={enabled | disabled}
512 バイトのブロックデバイスエミュレーションモードを有効にします。既定値は disabled です。
--force
VDO ボリュームを停止する前に、マウントされたファイルシステムをアンマウントします。
--forceRebuild
読み取り専用の VDO ボリュームを開始する前に、オフラインでの再構築を強制して、オンラインに戻して使用できるようにします。このオプションを使用すると、データの損失や破損が生じる可能性があります。
--help
vdo ユーティリティーのドキュメントを表示します。
--logfile=pathname
このスクリプトのログメッセージの出力先となるファイルを指定します。警告メッセージおよびエラーメッセージは、常に syslog にも記録されます。
--name=volume
指定した VDO ボリュームで動作します。--all と併用しないでください。
--device=device
VDO ストレージに使用するデバイスの絶対パスを指定します。
--activate={enabled | disabled}
引数 disabled は、VDO ボリュームのみを作成することを示しています。ボリュームは起動されたり、有効化されたりしません。既定値は enabled です。
--vdoAckThreads=thread count
要求された VDOI/O 操作の完了を確認するために使用するスレッドの数を指定します。デフォルトは 1 です。値は 0 以上、100 以下である必要があります。
--vdoBioRotationInterval=I/O count
作業を次のスレッドに転送する前に、bio 送信スレッドごとにキューに入れる 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
論理 VDO ボリュームのサイズをメガバイト単位で指定します。S(ectors)、B(ytes)、K(ilobytes)、M(egabytes)、G(igabytes)、T(erabytes)、P(etabytes) または E(xabytes) の接尾辞が付いた値の使用はオプションです。ボリュームのオーバープロビジョニングに使用されます。これはデフォルトでストレージデバイスのサイズになります。
--vdoPhysicalThreads=thread count
物理ブロックアドレスに基づいて、VDO 処理の一部を細分化するスレッド数を指定します。この値は、0 以上、16 以下である必要があります。最初のスレッド以降にスレッドを追加するたびに、さらに 10 MB の RAM を使用します。vdoPhysicalThreads、vdoHashZoneThreads、および vdoLogicalThreads は、すべてゼロにするか、すべてゼロ以外にする必要があります。デフォルトでは 1 回です。
--readCache={enabled | disabled}
VDO デバイス内の読み取りキャッシュを有効または無効にします。デフォルトは disabled です。書き込みワークロードで重複排除のレベルが高いことが予想される場合、または高圧縮性のデータの読み取り集中型ワークロードの場合は、キャッシュを有効にする必要があります。
--readCacheSize=megabytes
追加の VDO デバイス読み取りキャッシュサイズをメガバイト単位で指定します。この領域は、システム定義の最小領域に追加されます。B(ytes)、K(ilobytes)、M(egabytes)、G(igabytes)、T(erabytes)、P(etabytes)、またはE(xabytes) の接尾辞が付いた値の使用はオプションです。デフォルトは 0M です。bio スレッドごとに、指定された読み取りキャッシュの MB ごとに 1.12 MB のメモリーが使用されます。
--vdoSlabSize=megabytes
VDO が拡張される増分のサイズを指定します。サイズを小さくすると、収納可能な物理サイズの合計が制約されます。128M から 32G の間の 2 の累乗である必要があります。デフォルトは 2G です。S(ectors)、B(ytes)、K(ilobytes)、M(egabytes)、G(igabytes)、T(erabytes)、P(etabytes) または E(xabytes) の接尾辞が付いた値の使用はオプションです。接尾辞を使用しない場合、この値はメガバイトとして解釈されます。
--verbose
コマンドを実行する前に出力します。
--writePolicy={ auto | sync | async }
書き込みポリシーを指定します。
  • auto: VDO の下にあるストレージレイヤーに基づいて、sync または async を選択します。ライトバックキャッシュが存在する場合は、async が選択されます。それ以外の場合は sync が選択されます。
  • sync - 書き込みは、データが安定して書き込まれないと確認されません。これはデフォルトポリシーになります。基本となるストレージも同期していない場合は、このポリシーはサポートされません。
  • async: 安定したストレージに書き込むためにデータがキャッシュされた 後、書き込みが確認されます。フラッシュされていないデータがこのモードで持続する保証はありません。
status サブコマンドは、YAML 形式で、次の情報を返します。キーは以下のように分割されます。

表30.6 VDO ステータス出力

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