PRIMECLUSTER Global Disk Services 説明書 4.2 (Linux版）

D.15 sdxshadowdisk − シャドウディスクの操作

■形式

sdxshadowdisk -C -c class -g group -d disk,...
            [-a attribute=value[,attribute=value]]

sdxshadowdisk -D -c class -g group -d disk

sdxshadowdisk -M -c class -d device=disk[:type][,device=disk[:type],...]

sdxshadowdisk -R -c class -d disk

 

■機能説明

sdxshadowdiskは、disk で指定されたシャドウディスクを操作するためのコマンドです。スーパユーザ権限を持つユーザだけがsdxshadowdisk コマンドを実行することができます。

 

■基本オプション

以下の基本オプションのうち、いずれかを指定します。

 

-C

Connect
disk,... で指定された1つあるいは複数のシャドウディスク(シングルタイプあるいは未定義タイプ)を、group で指定されたシャドウグループに接続します。class にはdisk が登録されているシャドウクラスのクラス名を指定します。

group と同じ名前を持つシャドウグループが存在しない場合は、自動的に作成されます。

シングルタイプのシャドウディスクは、すでに存在しているシャドウグループには接続できません。また、複数のシングルタイプのシャドウディスクを、1つのシャドウグループに同時に接続することはできません。

シャドウグループに接続されたシャドウディスクのタイプ属性は、シャドウグループと同じタイプ属性（ミラー、ストライプあるいはコンカチネーション）に変更されます。同じシャドウグループに接続されたシャドウディスクおよび下位シャドウグループは、タイプ属性に応じて、ミラーリング、ストライピングあるいはコンカチネートされます。

以下は、シャドウディスクを接続するシャドウグループがミラータイプの場合、ストライプタイプの場合、およびコンカチネーションタイプの場合、3つの場合に分けて説明します。

シャドウディスクをミラータイプのシャドウグループに接続する場合：

ミラータイプの同じシャドウグループに接続されたシャドウディスクおよび下位シャドウグループは、互いにミラーリングされます。ミラータイプのシャドウグループにシャドウディスクまたは下位シャドウグループが1つしか接続されていない場合、そのシャドウグループに作成されるシャドウボリュームはミラーリングされません。n多重のミラーリングを行う場合は、n個のシャドウディスクまたは下位シャドウグループを接続する必要があります。最大8多重までのミラーリングが可能です。

シャドウボリュームが存在するミラータイプのシャドウグループにシャドウディスクを接続しても、シャドウボリュームの等価性コピー処理は実行されません。ミラータイプのシャドウボリュームの等価性を保証するためには、シャドウボリュームに対応するミラーボリュームを管理しているGDSによってミラーボリュームの等価性を保証する必要があります。

シャドウボリュームが存在するシングルタイプのシャドウディスクをミラータイプのシャドウグループに接続することによって、シャドウボリュームをシングルタイプからミラータイプに変更することもできます。

ミラータイプのシャドウグループの有効サイズ（シャドウボリュームとして使用可能な容量）は、接続された最小のシャドウディスクまたは下位シャドウグループの有効サイズと同じになります。disk を接続することによってgroup の有効サイズが減少した場合、警告メッセージを標準エラー出力します。

シャドウディスクをストライプタイプのシャドウグループに接続する場合：

disk,... で指定されたシャドウディスクは、指定された順にgroup に接続されます。他のドメインでストライプグループに接続されているディスクを、他のドメインと同じ順に接続してください。または、ストライプグループに接続されているディスクをコピー元として、ディスク装置のコピー機能によってコピーされたコピー先のディスクを、コピー元と同じ順に接続してください。ディスクの接続順序は、sdxinfo -G コマンドで表示されるDISKSフィールドで確認できます。ストライプタイプの同じシャドウグループに接続されたシャドウディスクおよび下位シャドウグループは、各々がストライプ列の役割を果たし、接続された順にストライピングされます。ストライプタイプのシャドウグループにシャドウディスクまたは下位シャドウグループが1つしか接続されていない場合、そのシャドウグループにはシャドウボリュームを作成できません。n列のストライピングを行う場合は、n本のシャドウディスクまたは下位シャドウグループを接続する必要があります。2列以上、最大64列までのストライピングが可能です。

group で指定されたストライプタイプのシャドウグループがすでに存在している場合、group 内にすでに存在しているストライプ列の後に、disk,... で指定された順にストライプ列が追加されます。ただし、すでに存在しているストライプタイプのシャドウグループに、有効サイズがストライプ幅よりも小さいシャドウディスクを接続することはできません。また、すでにシャドウボリュームが存在するストライプグループ、および上位シャドウグループに接続されているストライプグループに対しては、シャドウディスクを接続してストライプ列数を増やすことはできません。

ストライプタイプのシャドウグループの有効サイズ（シャドウボリュームとして使用可能な容量）は、接続された最小のシャドウディスク（または下位シャドウグループ）の有効サイズに、ストライプ列数を掛けて、（ストライプ幅）×（ストライプ列数）とシリンダサイズとの公倍数に切り捨てたサイズとなります。disk を接続することによってgroup の有効サイズが減少した場合、警告メッセージを標準エラー出力します。

シングルタイプのシャドウディスクをストライプタイプのシャドウグループに接続することはできません。

シャドウディスクをコンカチネーションタイプのシャドウグループに接続する場合：

コンカチネーションタイプの同じシャドウグループに接続されたシャドウディスクは、disk,... で指定された順にコンカチネートされます。他のドメインでコンカチネーショングループに接続されているディスクを、他のドメインと同じ順に接続してください。または、コンカチネーショングループに接続されているディスクをコピー元として、ディスク装置のコピー機能によってコピーされたコピー先のディスクを、コピー元と同じ順に接続してください。ディスクの接続順序は、sdxinfo -G コマンドで表示されるDISKSフィールドで確認できます。最大64個までのコンカチネーションが可能です。


コンカチネーションタイプのシャドウグループの有効サイズ（シャドウボリュームとして使用可能な容量）は、接続されたシャドウディスクの有効サイズを合計したサイズとなります。

すでに存在しているコンカチネーションタイプのシャドウグループにシャドウディスクを接続することによって、シャドウグループの有効サイズを増加させることができます。group で指定されたコンカチネーションタイプのシャドウグループがすでに存在している場合、group 内で最後にコンカチネートされたシャドウディスクの後ろに、disk,... で指定された順にシャドウディスクがコンカチネートされます。ただし、ストライプタイプの最上位シャドウグループにすでにシャドウボリュームが存在する場合、コンカチネーションタイプの下位シャドウグループにシャドウディスクを接続することはできません。また、上位からミラータイプ、ストライプタイプ、コンカチネーションタイプの順にシャドウグループが接続されている場合、コンカチネーションタイプの最下位シャドウグループにシャドウディスクを接続することはできません。

シングルタイプのシャドウディスクをコンカチネーションタイプのシャドウグループに接続することはできません。

 

-D

Disconnect
disk で指定されたシャドウディスクを、group で指定されたシャドウグループから切断します。class にはdisk が登録されているシャドウクラスのクラス名、group にはdisk が接続されているシャドウグループのグループ名を指定します。

切断されたシャドウディスクのタイプ属性は、接続前のタイプ属性(シングルまたは未定義)に戻ります。

group にdisk のみが接続されている場合、disk が切断されると、group も自動的に削除されます。ただし、disk のみが接続されているgroup が上位シャドウグループに接続されている場合はエラーとなり、disk を切断することはできません。そのようなdisk を切断するには、まず、sdxshadowgroup -D コマンドを使用して、group を上位シャドウグループから切断してください。

disk を切断することによって、group 内に存在する任意のシャドウボリュームの状態が変化する可能性がある場合は、disk の切断はできません。

以下に、シャドウディスクを切断するシャドウグループがミラータイプの場合、ストライプタイプの場合、およびコンカチネーションタイプの場合、3つの場合に分けて切断できない条件について説明します。

シャドウディスクをミラータイプのシャドウグループから切断する場合：

たとえば、group で指定されたミラータイプのシャドウグループにシャドウボリュームが存在していて、かつgroup にdisk のみが接続されている場合、disk の切断はできません。

シャドウディスクをストライプタイプのシャドウグループから切断する場合：

シャドウボリュームが存在するストライプタイプのシャドウグループ、および上位シャドウグループに接続されているストライプタイプのシャドウグループから、シャドウディスクを切断することはできません。

シャドウディスクをコンカチネーションタイプのシャドウグループから切断する場合：

コンカチネーションタイプのシャドウグループから切断できるのは、最後にコンカチネートされたシャドウディスクのみです。

シャドウボリュームのデータが存在するシャドウディスクを、コンカチネーションタイプのシャドウグループから切断することはできません。

ストライプタイプの最上位シャドウグループにシャドウボリュームが存在する場合、コンカチネーションタイプの下位シャドウグループからシャドウディスクを切断することはできません。また、上位からミラータイプ、ストライプタイプ、コンカチネーションタイプの順にシャドウグループが接続されている場合、コンカチネーションタイプの最下位シャドウグループからシャドウディスクを切断することはできません。

 

-M

Make
device で指定された1つあるいは複数の物理ディスクを、シャドウクラスに登録します。class には登録先のシャドウクラスのクラス名を指定します。登録が完了した物理ディスクはGDSによって管理され、以降、ユーザはdisk で指定したディスク名を使ってディスクを操作します。ただし、シャドウクラスの構成情報は占有スライスには格納されず自ノードのメモリ上にのみ存在するため、自ノードを再起動した場合、および自ノードのGDSのデーモンが再起動された場合、シャドウクラスの構成情報は消滅し、以降、device はGDSでは管理されません。

class と同じ名前を持つシャドウクラスが存在しない場合は、自動的に作成されます。シャドウクラスのタイプ属性は「ローカル」であり、シャドウクラス内のオブジェクトは自ノードのみで使用可能です。

シャドウクラスには、自ドメインで他のクラスに登録されていない物理ディスクのうち、GDSの占有スライスが存在する物理ディスクを登録することができます。すなわち、他のドメインでクラスに登録されている物理ディスクや、ディスク装置のコピー機能によって他のSDXディスクの占有スライスがコピーされている物理ディスクを登録することができます。同じシャドウクラスに登録する物理ディスクは、他のドメインで同じ名前のクラスに登録されているか、または、同じ名前のクラスに登録されているSDXディスクの占有スライスがディスク装置のコピー機能によってコピーされている必要があります。また、占有スライスのサイズが異なるディスクを同じシャドウクラスに登録することはできません。

sdxdisk コマンドで登録された物理ディスク（キープディスクを除く）の内容は初期化されますが、sdxshadowdisk コマンドで登録された物理ディスクの内容は変更されません。

 

-R

Remove
disk で指定されたシャドウディスクを、class で指定されたシャドウクラスから削除します。class には、disk が登録されているシャドウクラスのクラス名を指定します。

削除が完了したシャドウディスクは、以降、GDSでは管理されません。

class に登録されている最後のシャドウディスクが削除された場合、シャドウクラスの定義も自動的に削除されます。

disk 内にシャドウボリュームが存在している場合、およびdisk がシャドウグループに接続されている場合は、削除できません。

 

■サブオプション

以下のサブオプションが指定できます。

 

-a attribute=value[,attribute=value] (-C指定時)

-C オプション指定時に新しいグループ名を-g オプションで指定した場合、自動的に新しいシャドウグループが作成されます。本オプションでは、作成されるgroup の属性としてattribute をvalue に設定します。

attribute には属性名、value には属性値を指定します。attribute とvalue の間には、必ずイコール(=)を入れます。複数の属性を設定する場合は、これらの指定子の組合せをカンマ(,)で区切って指定します。

シャドウグループが作成されない場合、既存のgroup の属性値と異なるvalue を指定するとエラーとなります。既存のgroup の属性値を変更することはできません。

attribute とvalue には、以下の任意の組合せが指定できます。

複数の属性が指定された場合、一部の処理でエラーが発生すると一切処理を行いません。

type=mirror, type=stripe またはtype=concat (省略時はmirror)

group のタイプ属性を設定します。

mirror

タイプ属性を「ミラー」に設定します。

stripe

タイプ属性を「ストライプ」に設定します。

concat

タイプ属性を「コンカチネーション」に設定します。

width=blks (省略時は32)

group のストライプ幅を設定します。blks には、ストライプ幅をブロック数（10進数）で指定します。1ブロックは512バイトです。blks に指定可能な値は、2のべき乗で、1以上、かつdisk,...で指定された最小のシャドウディスクの、有効サイズ以下の整数です。group がストライプタイプではない場合は、エラーとなります。

 

-c class

class には、操作対象となるシャドウディスクが登録されているシャドウクラス、または登録しようとしているシャドウクラスのクラス名を指定します。

 

-d device=disk[:type][,device=disk[:type],...] (-M指定時)

device には物理ディスク名、disk にはディスク名、type にはシャドウディスクのタイプ属性を指定します。device の後には必ずイコール(=)が続き、type を指定する場合はdisk との間をコロン(:)で区切ります。複数のdevice を登録する場合は、上記の指定子の組合せをカンマ(,)で区切ります。

物理ディスク名は、以下のいずれかの形式で指定できます。

sdX     (通常のハードディスクの場合)
emcpowerX     (emcpowerディスクの場合)
Xはデバイス識別名です。

device が他のドメインでクラスに登録されている場合、disk にはそのドメインと同じディスク名を指定します。device に、ディスク装置のコピー機能によってSDXディスクの占有スライスがコピーされている場合、disk にはコピー元のSDXディスクと同じディスク名を指定します。

type には以下のいずれかを指定します。省略時には、登録されたシャドウディスクは未定義タイプになります。

single

シングルタイプ

undef

未定義タイプ

type にsingleが指定された場合、device はシングルタイプのシャドウディスクとして登録されます。シングルタイプのシャドウディスクはシャドウグループへ接続しなくてもsdxshadowvolume コマンドを使ってシングルタイプのシャドウボリュームを作成することができます。

 

-d disk (-D,-R指定時)

disk には、操作対象となるシャドウディスクのディスク名を指定します。

 

-d disk,... (-C指定時)

disk には、操作対象となるシャドウディスクのディスク名を指定します。複数のシャドウディスクを接続する場合は、ディスク名をカンマ(,)で区切って指定します。

 

-g group (-C,-D指定時)

group には、操作対象となるシャドウディスクが接続されているシャドウグループ、または接続しようとしているシャドウグループのグループ名を指定します。

 

■戻り値

正常終了した場合には0を返し、そうでない場合には0以外の値を返します。