DataKeeperボリュームリソースは、SIOS DataKeeperを使用してブロックレベルのストレージレプリケーションとフェイルオーバーを提供します。プライマリーサーバーで障害が発生すると、LifeKeeperはスタンバイサーバー上でレプリケートされたボリュームをアクティブ化し、アプリケーションが同じドライブレターを使用して処理を継続できるようにします。
リソースタイプ: filesys/volume
エイリアス: volume
前提条件
- このリソースをホストするすべてのサーバーにSIOS DataKeeperをインストールする必要があります。
- 保護対象のドライブレターはプライマリーサーバー上に存在し、かつDataKeeperでレプリケーション対象として指定されている必要があります。
- ミラーベースの拡張(
Create MirrorまたはExisting Mirror)を行う場合、スタンバイサーバーにもレプリケーションに使用可能な対応するボリュームが必要であり、かつサーバー間で適切なネットワークエンドポイントに到達できる必要があります。
サブコマンド
DataKeeper Volumeリソースは、次の形式のコマンドで管理されます。
lkcli resource filesys/volume <サブコマンド> [フラグ]
| サブコマンド | 説明 | 必要なロール |
|---|---|---|
create
|
新しいDataKeeperボリュームリソースを作成します | admin |
extend
|
スタンバイサーバーに拡張します | admin |
get-property
|
リソースプロパティを読み取ります | guest |
set-property
|
編集可能なリソースプロパティを更新します | admin |
break
|
スタンバイサーバーに対してDataKeeperのミラーを解除します | operator |
continue
|
スタンバイサーバーに対してDataKeeperのミラーを再開(継続)します | operator |
pause
|
スタンバイサーバーに対するレプリケーションを一時停止します | operator |
pause-unlock
|
スタンバイサーバーでレプリケーションを一時停止し、ボリュームのロックを解除します | operator |
resync
|
スタンバイサーバーへのミラーの完全再同期を開始します | operator |
splitbrain-recovery
|
DataKeeperミラーのスプリットブレイン状態を解消します | operator |
update-delete-mirror-flag
|
リソースが削除されたときにミラーを削除するかどうかを設定します | operator |
create
lkcli resource filesys/volume create --volume=<文字列> [フラグ]
| フラグ | 短縮表記 | タイプ | 必須 | デフォルト | 制約 | 説明 |
|---|---|---|---|---|---|---|
--volume
|
— | 文字列 | 必須 | — | — | 複製するボリュームのドライブレター(例:E:) |
--tag
|
— | 文字列 | 任意 | 自動生成 | — | リソースタグ名 |
--switchback
|
— | 列挙型 | 任意 | INTELLIGENT
|
INTELLIGENT, AUTOMATIC
|
スイッチバックタイプ |
--quickcheck-interval
|
— | 整数 | 任意 | 180
|
最小: 0、最大: 604800 | クイックチェックの間隔(秒) |
--deepcheck-interval
|
— | 整数 | 任意 | 300
|
最小: 0、最大: 604800 | ディープチェックの間隔(秒) |
extend
lkcli resource filesys/volume extend \
--primary-sys=<文字列> --primary-tag=<文字列> --volume-type=<列挙型> [フラグ]
| フラグ | 短縮表記 | タイプ | 必須 | デフォルト | 制約 | 説明 |
|---|---|---|---|---|---|---|
--primary-sys
|
— | 文字列 | 必須 | — | — | 既存のリソースの拡張元サーバーのホスト名 |
--primary-tag
|
— | 文字列 | 必須 | — | — | 拡張する既存リソースのタグ |
--volume-type
|
— | 列挙型 | 必須 | — | Existing Mirror, Create Mirror, Shared Disk
|
スタンバイボリュームの構成方法 |
--standby-sys
|
— | 文字列 | 任意 | --hostの値(デフォルトはlocalhost)
|
— | スタンバイサーバーのホスト名 |
--network-endpoints
|
— | 文字列 | 任意 | --volume-type="Create Mirror"が指定され、かつ --network-endpointsに値が指定されていない場合、プライマリーサーバーとスタンバイサーバー間の利用可能なコミュニケーションパスに基づいて、デフォルト値が自動的に選択されます
|
— | プライマリーとこのスタンバイ間のレプリケーション用ネットワークエンドポイント(例:10.0.0.2/10.0.0.1) |
--additional-endpoints
|
— | オブジェクト | 任意 | — | — | このスタンバイから他のスタンバイへのレプリケーション用エンドポイント(例:server3=10.0.0.3/10.0.0.2) |
--sync-mode
|
— | 列挙型 | 任意 | Asynchronous
|
Asynchronous, Synchronous
|
レプリケーションモード |
--switchback
|
— | 列挙型 | 任意 | INTELLIGENT
|
INTELLIGENT, AUTOMATIC
|
スイッチバックタイプ |
--primary-priority
|
— | 整数 | 任意 | デフォルトは、--primary-sysサーバーの現在の優先順位。リソースが拡張されていない場合は1
|
最小: 1、最大: 999 | プライマリーサーバーのフェイルオーバーの優先順位 |
--standby-priority
|
— | 整数 | 任意 | デフォルトは現在使用中の優先順位に基づいて動的に算出される、未使用の値 | 最小: 1、最大: 999 | スタンバイサーバーのフェイルオーバーの優先順位 |
get-property / set-property
lkcli resource filesys/volume get-property --tag=<文字列> --property=<文字列>
lkcli resource filesys/volume set-property --tag=<文字列> --property=<文字列> --value=<文字列>
| フラグ | 短縮表記 | タイプ | 必須 | 説明 |
|---|---|---|---|---|
--tag
|
-t
|
文字列 | 必須 | リソースタグ名 |
--property
|
-p
|
文字列 | 必須 | プロパティ名(「プロパティ」の表を参照) |
--value
|
-v
|
文字列 | 必須 (set-propertyのみ)
|
新しいプロパティ値 |
ミラーアクションサブコマンド (break, continue, pause, pause-unlock, resync)
これらのアクションは、プライマリーサーバーと特定のスタンバイサーバー間のミラーリングに対して実行されます。
lkcli resource filesys/volume break --tag=<文字列> --standby-server=<文字列> [フラグ]
| フラグ | 短縮表記 | タイプ | 必須 | 説明 |
|---|---|---|---|---|
--tag
|
— | 文字列 | 必須 | リソースタグ名 |
--standby-server
|
— | 文字列 | 必須 | スタンバイサーバーのホスト名 |
注意: ミラーの解除または一時停止を行うと、レプリケーションが中断され、ミラーの再開または再同期が行われるまでLifeKeeperによるフェイルオーバー保護が解除されます。
splitbrain-recovery
‘splitbrain-server‘ フラグで指定されたサーバー上でリソースをIn-Serviceにすることで、関連するすべてのスプリットブレインボリュームリソースを復旧します。
lkcli resource filesys/volume splitbrain-recovery \
--tag=<文字列> --splitbrain-server=<文字列> [フラグ]
| フラグ | 短縮表記 | タイプ | 必須 | デフォルト | 制約 | 説明 |
|---|---|---|---|---|---|---|
--tag
|
— | 文字列 | 必須 | — | — | リソースタグ名 |
--splitbrain-server
|
— | 文字列 | 必須 | — | — | スプリットブレインシナリオの解消時にミラーソースとして残すサーバー |
update-delete-mirror-flag
リソースがサービスから削除された際に、DataKeeperミラーを削除するかどうかを制御します。 プライマリー サーバー上で実行する必要があります。
lkcli resource filesys/volume update-delete-mirror-flag \
--tag=<文字列> --delete-mirror-flag=<列挙型> [フラグ]
| フラグ | 短縮表記 | タイプ | 必須 | デフォルト | 制約 | 説明 |
|---|---|---|---|---|---|---|
--tag
|
— | 文字列 | 必須 | — | — | リソースタグ名 |
--delete-mirror-flag
|
— | 列挙型 | 必須 | — | enabled, disabled
|
リソースの拡張を解除する際にミラーを削除するかどうかを指定します |
プロパティ
| プロパティ | タイプ | 制約 | 編集可否 | 説明 |
|---|---|---|---|---|
volume-letter
|
文字列 | — | 不可 | ドライブレター(例:E:) |
volume-name
|
文字列 | — | 不可 | ボリューム名 |
volume-size
|
整数 | — | 不可 | バイト単位のボリュームサイズ |
volume-state
|
列挙型 | Primary, Shared, Split-brain, Maintenance, Mirrored, Paused, Broken, Resync, Resync pending, None, ISP, ISU, OSU, OSF
|
不可 | 現在のDataKeeperボリュームの状態 |
driver-version
|
文字列 | — | 不可 | DataKeeperドライバーのバージョン |
service-version
|
文字列 | — | 不可 | DataKeeperサービスのバージョン |
kit-name
|
文字列 | — | 不可 | Recovery Kit名 |
maintenance-mode
|
列挙型 | enabled, disabled
|
可 | 有効にすると、そのリソースのヘルスモニタリングは無効になります |
switchback
|
列挙型 | INTELLIGENT, AUTOMATIC
|
可 | スイッチバックタイプ |
quickcheck-interval
|
整数 | 最小: 0、最大: 604800 | 可 | クイックチェックの間隔(秒)(デフォルト:180) |
deepcheck-interval
|
整数 | 最小: 0、最大: 604800 | 可 | ディープチェックの間隔(秒) (default: 300) |
使用例
# Create a DataKeeper volume resource on the primary server
lkcli resource filesys/volume create \
--host=server1 \
--volume=E: \
--tag=DataKeeper-E
# Extend to server2 using a new mirror with synchronous replication
lkcli resource filesys/volume extend \
--primary-sys=server1 \
--primary-tag=DataKeeper-E \
--standby-sys=server2 \
--volume-type="Create Mirror" \
--network-endpoints="10.0.1.2/10.0.1.1" \
--sync-mode=Synchronous
# Check the current volume state
lkcli resource filesys/volume get-property \
--host=server1 \
--tag=DataKeeper-E \
--property=volume-state
# Break the mirror to server2 (suspends replication)
lkcli resource filesys/volume break \
--host=server1 \
--tag=DataKeeper-E \
--standby-server=server2
# Resync the mirror to server2
lkcli resource filesys/volume resync \
--host=server1 \
--tag=DataKeeper-E \
--standby-server=server2



このトピックへフィードバック