6.101. GlusterBricks

削除操作のデータ移行の後のデータ移行をアクティベートします。

ブリックからのデータ移行が完了し、ユーザーがブリックを削除したくないと、ブリックをアクティベートするために使用されます。削除用に以前にマークされていたブリックは、通常のブリックとして使用されるようになりました。

たとえば、データの移行元である glustervolume 123 のブリックを保持するには、次のようなリクエストを送信します。

POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/activate

リクエスト本文は以下のようになります。

<action>
  <bricks>
    <brick>
      <name>host1:/rhgs/brick1</name>
    </brick>
  </bricks>
</action>

gluster ボリュームに、ブリックの一覧を追加します。

ブリックを追加して gluster ボリュームを拡張するのに使用します。複製されたボリュームタイプの場合は、replica_count パラメーターを渡す必要があります。レプリカ数が増える場合、ブリックの数はレプリカセットの数と同じである必要があります。

たとえば、gluster ボリューム 123 にブリックを追加するには、次のようなリクエストを送信します。

POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks

リクエスト本文は以下のようになります。

<bricks>
  <brick>
    <server_id>111</server_id>
    <brick_dir>/export/data/brick3</brick_dir>
  </brick>
</bricks>

gluster ボリュームのブリックを一覧表示します。

たとえば、gluster ボリューム 123 のブリックを一覧表示するには、以下のように要求を送信します。

GET /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks

以下のような出力を提供します。

<bricks>
  <brick id="234">
    <name>host1:/rhgs/data/brick1</name>
    <brick_dir>/rhgs/data/brick1</brick_dir>
    <server_id>111</server_id>
    <status>up</status>
  </brick>
  <brick id="233">
    <name>host2:/rhgs/data/brick1</name>
    <brick_dir>/rhgs/data/brick1</brick_dir>
    <server_id>222</server_id>
    <status>up</status>
  </brick>
</bricks>

返される一覧の順序は、gluster ボリュームの作成時に提供されるブリックの順序に基づいています。

ブリックを削除する前にデータの移行を開始します。

ブリックの削除は 2 つのステップで、削除されるブリック上のデータが最初に残りのブリックに移行します。移行が完了すると、API remove を介してブリックの削除が確定されます。いずれの時点でも、stopmigrate をキャンセルするアクションを呼び出す必要があります。

たとえば、ID が 123 の gluster ボリュームからブリックを削除するには、次のリクエストを送信します。

POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/migrate

リクエスト本文は以下のようになります。

<action>
  <bricks>
    <brick>
      <name>host1:/rhgs/brick1</name>
    </brick>
  </bricks>
</action>

移行プロセスは、ジョブを使用して API から返されたジョブ ID と、ステップを使用して job の step から追跡できます。

gluster ボリュームからブリックを削除します。

データ損失なしでブリックを削除する場合は、最初に stopmigrate を使用してそれらのデータを削除してからそれらを削除する方法が推奨されます。削除前にイメージストリームで移行が呼び出されなかった場合、データ移行なしにブリックが削除され、データが失われる可能性があります。

たとえば、gluster ボリューム 123 からブリックを削除するには、以下のように要求を送信します。

DELETE /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks

リクエスト本文は以下のようになります。

<bricks>
  <brick>
    <name>host:brick_directory</name>
  </brick>
</bricks>

削除のブリック操作についてのデータのブリックからの移行を停止します。

ユーザーがブリックの使用を継続したい場合に備えて、2 ステップのブリック削除プロセスの一部として開始されたデータ移行をキャンセルするには。削除用にマーク付けされていたブリックは、この操作の後に通常のブリックとして機能します。

たとえば、gluster ボリューム 123 のブリックからデータの移行を停止するには、以下のように要求を送信します。

POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/stopmigrate

リクエスト本文は以下のようになります。

<bricks>
  <brick>
    <name>host:brick_directory</name>
  </brick>
</bricks>