コンソールでフェイルオーバーを開始する

1. すべてのファイル共有のリストにナビゲートします。 IBM Cloud コンソールで、 ナビゲーション メニュー> インフラストラクチャ> ストレージ > ファイル ストレージ共有をクリックします。

2. レプリカファイル共有の名前をクリックすると、その詳細ページが開きます。

3. 「アクション」 メニュー から、 「フェイルオーバーの実行」 を選択します。 フェイルオーバーの前に、フェイルオーバー先の共有に最新のコンテンツが確実に反映されるよう、ファイルの最終同期が行われます。 フェイルオーバーが完了すると、レプリカ・ファイル共有が新しいソース・ファイル共有になります。 以前のソース共有は、新しい読み取り専用レプリカ共有になります。

4. タイムアウト値を設定するには、 「タイムアウト (オプション)」 の下のボックスにチェック・マークを付け、時間値を指定します。 この値は、フェイルオーバーが完了するまでの絶対時間制限を指定します。 ファイル共有をオフラインにできる期間に基づいてタイムアウトを設定します。

5. フェイルオーバー・ポリシーで、フェイルオーバー操作が成功しないかタイムアウトになる場合は、複製関係を保持するか変更するかを選択します。

   • 複製関係の維持 - レプリカ・ファイル共有またはソース・ファイル共有は変更されません。
   • レプリケーション関係を削除する - この操作により、2つの独立した読み取り専用および書き込み可能なファイル共有が作成されます。 関係が壊れているため、一方のファイル共有に対する変更が他方のファイル共有に影響を与えることはありません。

   一度関係を断ち切ってしまうと、それを元に戻すことはできません。

6. フェイルオーバーの実行をクリックします。 フェイルオーバーが要求され、実行中であることを示すメッセージが表示されます。

ファイル共有の詳細ページが更新され、レプリケーションの関係では、レプリカのファイル共有が新しいソースのファイル共有として表示されます。

CLI からのフェイルオーバーの開始

CLI を使用する前に、IBM Cloud CLI および VPC CLI プラグインをインストールする必要があります。 詳しくは、CLI の前提条件を参照してください。

1. ibmcloud is shares コマンドを使用してリージョン内のすべてのファイル共有をリストすることにより、フェイルオーバー先のレプリカ・ファイル共有を見つけます。

   ibmcloud is shares
   

   Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
   ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size
   r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2       10         defaults         none               none                    0                0
   r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2       10         defaults         none               none                    0                0
   r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2       10         defaults         replica            none                    0                0
   r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2       10         defaults         source             none                    0                0
   r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2       10         defaults         replica            none                    0                0
   r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2       10         defaults         source             none                    0                0
   
   

2. ibmcloud is share-replica-failover コマンドを実行し、fallback-policy プロパティーを指定します。 このプロパティーには、 fail または split を指定できます。

   • 以下の例では、 fallback-policy プロパティーに fail を指定しています。 フェイルオーバー操作が失敗した場合、またはタイムアウトに達した場合は、フェイルオーバー操作は失敗となります。 ソース共有はアクティブのままで、複製はスケジュールされたとおりに再開されます。

   ibmcloud is share-replica-failover r006-a60bfa90-a893-40ad-be34-28ab51a963f9 --fallback-policy fail
   

   The file share r006-a60bfa90-a893-40ad-be34-28ab51a963f9 failover request was accepted under account Test Account as user test.user@ibm.com...
   The file share failover request was accepted.
   

   • 以下の例では、 fallback-policy プロパティーに split を指定しています。 フェイルオーバー操作が失敗した場合、レプリカ共有はソース・ファイル共有から分割されます。 フェイルオーバーが失敗した場合、結果は 2 つの独立した読み取り/書き込みファイル共有になります。

   ibmcloud is share-replica-failover my-source-share-dal-2 --fallback-policy split
   

   The file share r006-4dadac27-cd17-42df-a5fe-1388705d33e0 failover request was accepted under account Test Account as user test.user@ibm.com...
   The file share failover request was accepted.
   

コマンド・オプションについて詳しくは、「 ibmcloud is share-replica-failover」を参照してください。

API を使用したフェイルオーバーの開始

POST /shares/{share_id}/failover 要求を作成し、timeout プロパティーと fallback_policy プロパティーを指定します。 最小のタイムアウトは 300 秒で、最大のタイムアウトは 3600 秒です。 この要求は、レプリカ・ファイル共有 ID で指定されたレプリカ共有へのソース・ファイル共有のフェイルオーバーを開始します。

fallback_policy プロパティーの値は、 split または fail のいずれかです。 fail が指定されている場合、フェイルオーバー操作が失敗したり、タイムアウトに達したりすると、フェイルオーバー操作は失敗となります。 複製関係は変更されません。

fallback_policy プロパティーに split を指定すると、フェイルオーバー操作が失敗するたびに、レプリカ共有がソース共有から分割されます。 その結果、2つの独立した読み書き可能なファイル共有が作成されます。 この場合、最終的なファイルの同期が完了しなかったため、レプリカ共有にはソースファイル共有のすべてのデータが含まれていない可能性があります。 このオプションは、ソース・ファイル共有が到達不能であることが分かっている場合に災害復旧に使用します。

要求に fallback_policy プロパティーが指定されていない場合、フェイルオーバー操作が失敗すると、システムはデフォルトで split になります。

この例では、 fallback_policy プロパティーに fail を指定しています。 timeout プロパティーはオプションです。 デフォルトのタイムアウトを使用できます。

curl -X POST \
"$vpc_api_endpoint/v1/shares/$replica_id?/failover?version=2023-08-08"\
-H "Authorization: Bearer $iam_token"\
-d '{
     "fallback_policy": "fail",
      "timeout": 600
    }'

正常な応答は、ファイル共有フェイルオーバー要求が受け入れられたことを示します。

このAPIを使用すると、レプリケーションのフェイルオーバーが成功したか、保留中か、あるいは失敗したかを確認できます。 GET /shares/{replica_id} 呼び出しを行います。 latest_job プロパティーを確認します。 詳しくは、API を使用した複製の検証を参照してください。

Terraform を使用したフェイルオーバーの開始

フェイルオーバーが実行されると、レプリカ共有がソースになり、ソース共有がレプリカになります。 この変更に合わせて Terraform 構成を変更する必要があります。 fallback_policy では、フェイルオーバー要求が受け入れられたものの、実行できない場合やタイムアウトした場合に実行するアクションを定義します。 受け入れられる値は、 split または fail です。 split を指定した場合、フェイルオーバーが失敗すると、システムは複製関係を中断し、2 つのファイル共有は相互に独立した状態になります。

resource "ibm_is_share_replica_operations" "test" {
  share_replica = ibm_is_share.replica.id
  fallback_policy = "split"
  timeout = 500
}

引数および属性について詳しくは、 ibm_is_share_replica_operationsを参照してください。