キャッシュを管理する

Azure portal のキャッシュの概要ページには、キャッシュのプロジェクトの詳細、キャッシュの状態、および基本的な統計情報が表示されます。 また、キャッシュの停止または開始、キャッシュの削除、長期ストレージへのデータのフラッシュ、ソフトウェアの更新を行うコントロールもあります。

この記事では、Azure CLI を使用してこれらの基本的なタスクを実行する方法についても説明します。

概要ページを開くには、Azure portal でキャッシュ リソースを選択します。 たとえば、[ すべてのリソース ] ページを読み込み、キャッシュ名をクリックします。

ページの上部にあるボタンは、キャッシュの管理に役立ちます。

• 開始 と 停止 - キャッシュ操作を再開または中断します
• フラッシュ - 変更されたデータをストレージ ターゲットに書き込む
• アップグレード - キャッシュ ソフトウェアを更新します
• 診断の収集 - デバッグ情報をアップロードする
• 更新 - 概要ページを再読み込みします
• 削除 - キャッシュを完全に破棄します

これらのオプションの詳細については、以下を参照してください。

Tip

個々のストレージ ターゲットを管理することもできます。詳細については、「 ストレージ ターゲットの表示と管理 」を参照してください。

キャッシュを停止する

キャッシュを停止して、非アクティブ期間中のコストを削減できます。 キャッシュが停止している間はアップタイムに対して課金されませんが、キャッシュに割り当てられたディスク ストレージに対して課金されます。 (詳細については 、価格 ページを参照してください)。

停止したキャッシュは、クライアント要求に応答しません。 キャッシュを停止する前に、クライアントのマウントを解除する必要があります。

ポータル

[停止] ボタンは、アクティブなキャッシュを中断します。 [ 停止] ボタンは、キャッシュの状態が 正常 または 低下している場合に使用できます。

[はい] をクリックしてキャッシュの停止を確認すると、キャッシュはその内容をストレージ ターゲットに自動的にフラッシュします。 このプロセスには時間がかかる場合がありますが、データの一貫性が確保されます。 最後に、キャッシュの状態が [停止済み] に変わります。

停止したキャッシュを再アクティブ化するには、[ スタート ] ボタンをクリックします。 確認は必要ありません。

Azure CLI

Azure HPC Cache 向けに Azure CLI を設定します。

az hpc-cache stop コマンドを使用してキャッシュを一時的に中断します。 このアクションは、キャッシュの状態が 正常 または 低下している場合にのみ有効です。

キャッシュは、停止する前に、その内容をストレージ ターゲットに自動的にフラッシュします。 このプロセスには時間がかかる場合がありますが、データの一貫性が確保されます。

アクションが完了すると、キャッシュの状態が 停止状態に変わります。

az hpc-cache start を使用して、停止したキャッシュを再アクティブ化します。

start または stop コマンドを発行すると、操作が完了するまでコマンド ラインに "実行中" 状態メッセージが表示されます。

$ az hpc-cache start --name doc-cache0629
 - Running ..

完了すると、メッセージは "Finished" に更新され、リターン コードやその他の情報が表示されます。

$ az hpc-cache start --name doc-cache0629
{- Finished ..
  "endTime": "2020-07-01T18:46:43.6862478+00:00",
  "name": "c48d320f-f5f5-40ab-8b25-0ac065984f62",
  "properties": {
    "output": "success"
  },
  "startTime": "2020-07-01T18:40:28.5468983+00:00",
  "status": "Succeeded"
}

キャッシュされたデータをフラッシュする

概要ページの [ フラッシュ ] ボタンは、キャッシュに格納されているすべての変更されたデータをバックエンド ストレージ ターゲットに直ちに書き込むようキャッシュに指示します。 キャッシュは定期的にストレージ ターゲットにデータを保存するため、バックエンド ストレージ システムが最新の状態であることを確認する必要がない限り、これを手動で行う必要はありません。 たとえば、ストレージ スナップショットを取得したり、データ セットのサイズを確認したりする前に 、Flush を使用できます。

Note

フラッシュ プロセス中、キャッシュはクライアント要求を処理できません。 キャッシュ アクセスは中断され、操作の完了後に再開されます。

キャッシュ フラッシュ操作を開始すると、キャッシュはクライアント要求の受け入れを停止し、概要ページのキャッシュの状態が [フラッシュ] に変わります。

キャッシュ内のデータは、適切なストレージ ターゲットに保存されます。 フラッシュする必要があるデータの量によっては、プロセスに数分または 1 時間以上かかる場合があります。

すべてのデータがストレージ ターゲットに保存されると、キャッシュは自動的にクライアント要求の取得を再開します。 キャッシュの状態が 正常に戻ります。

ポータル

キャッシュをフラッシュするには、[ フラッシュ ] ボタンをクリックし、[ はい ] をクリックしてアクションを確認します。

Azure CLI

Azure HPC Cache 向けに Azure CLI を設定します。

az hpc-cache flush を使用して、変更されたすべてのデータをストレージ ターゲットに強制的に書き込みます。

Example:

$ az hpc-cache flush --name doc-cache0629 --resource-group doc-rg
 - Running ..

フラッシュが完了すると、成功メッセージが返されます。

{- Finished ..
  "endTime": "2020-07-09T17:26:13.9371983+00:00",
  "name": "c22f8e12-fcf0-49e5-b897-6a6e579b6489",
  "properties": {
    "output": "success"
  },
  "startTime": "2020-07-09T17:25:21.4278297+00:00",
  "status": "Succeeded"
}
$

Tip

キャッシュの内容全体を書き込まずに特定の個々のファイルをストレージ ターゲットに書き戻す必要がある場合は、PC Cache NFSv3 クライアント ライブラリディストリビューションに含まれるflush_file.py スクリプトの使用を検討してください。 詳細については、 Azure HPC Cache でのファイル ライトバックのカスタマイズに関するページを参照してください。

キャッシュ ソフトウェアのアップグレード

新しいソフトウェア バージョンが使用可能な場合、[ アップグレード ] ボタンがアクティブになります。 また、ソフトウェアの更新に関するメッセージがページの上部に表示されます。

クライアント アクセスはソフトウェアのアップグレード中に中断されませんが、キャッシュのパフォーマンスが低下します。 ピーク時以外の使用時間または計画メンテナンス期間中にソフトウェアをアップグレードすることを計画します。

ソフトウェアの更新には数時間かかる場合があります。 高いスループットで構成されたキャッシュは、ピーク時のスループット値が小さいキャッシュよりもアップグレードに時間がかかります。 キャッシュの状態は、操作が完了するまで アップグレード に変わります。

ソフトウェアのアップグレードが利用可能な場合は、手動で適用するために 1 週間ほどかかることがあります。 終了日がアップグレード メッセージに表示されます。 その期間中にアップグレードしない場合、Azure によって新しいソフトウェアがキャッシュに自動的に適用されます。

Azure portal を使用して、アップグレードのより便利な時間をスケジュールできます。 以下の ポータル タブの指示に従います。

終了日が経過したときにキャッシュが停止した場合、キャッシュは次回起動時にソフトウェアを自動的にアップグレードします。 (更新プログラムはすぐには開始されない場合がありますが、最初の 1 時間以内に開始されます)。

ポータル

[ アップグレード ] ボタンをクリックして、ソフトウェア更新プログラムを構成します。 ソフトウェアをすぐにアップグレードするか、特定の日時にアップグレードをスケジュールするオプションがあります。

すぐにアップグレードするには、[ 今すぐアップグレード ] を選択し、[ 保存 ] ボタンをクリックします。

別のアップグレード時刻をスケジュールするには、[ 後でスケジュールする ] を選択し、新しい日付と時刻を選択します。

• 日付と時刻は、ブラウザーのローカル タイム ゾーンに表示されます。
• 元のメッセージの期限より後の時刻を選択することはできません。

カスタム日付を保存すると、バナー メッセージが変更され、選択した日付が表示されます。

スケジュールされたアップグレード日を変更する場合は、[ アップグレード ] ボタンをもう一度クリックします。 [ 日付のリセット ] リンクをクリックします。 これにより、スケジュールされた日付がすぐに削除されます。

以前にスケジュールされた値をリセットすると、日付セレクターは使用可能な最新の日付と時刻にリセットされます。 新しい日付を選択して保存するか、[ 破棄 ] をクリックして最新の日付を保持できます。

アップグレードの残り時間が 15 分未満の場合は、スケジュールを変更できません。

Azure CLI

Azure HPC Cache 向けに Azure CLI を設定します。

Azure CLI では、キャッシュ状態レポートの最後に新しいソフトウェア情報が含まれます。 ( az hpc-cache show を使用して確認します)。メッセージで文字列 "upgradeStatus" を探します。

az hpc-cache upgrade-firmware を使用して、ソフトウェア アップグレードが存在する場合は適用します。

更新プログラムが使用できない場合、この操作は無効になります。

この例では、キャッシュの状態 (アップグレードは使用できません) と upgrade-firmware コマンドの結果を示します。

$ az hpc-cache show --name doc-cache0629
{
  "cacheSizeGb": 3072,
  "health": {
    "state": "Healthy",
    "statusDescription": "The cache is in Running state"
  },

<...>

  "tags": null,
  "type": "Microsoft.StorageCache/caches",
  "upgradeStatus": {
    "currentFirmwareVersion": "5.3.61",
    "firmwareUpdateDeadline": "0001-01-01T00:00:00+00:00",
    "firmwareUpdateStatus": "unavailable",
    "lastFirmwareUpdate": "2020-06-29T22:18:32.004822+00:00",
    "pendingFirmwareVersion": null
  }
}
$ az hpc-cache upgrade-firmware --name doc-cache0629
$

診断を収集する

[ 診断の収集 ] ボタンは、システム情報を収集し、トラブルシューティングのために Microsoft サービスとサポートにアップロードするプロセスを手動で開始します。 キャッシュの重大な問題が発生した場合、キャッシュは自動的に同じ診断情報を収集してアップロードします。

Microsoft サービスとサポートが要求する場合は、このコントロールを使用します。

ボタンをクリックした後、[ はい ] をクリックしてアップロードを確認します。

キャッシュを削除する

[削除] ボタンをクリックすると、キャッシュが破棄されます。 キャッシュを削除すると、そのすべてのリソースが破棄され、アカウント料金は発生しなくなります。

キャッシュを削除しても、ストレージ ターゲットとして使用されるバックエンド ストレージ ボリュームは影響を受けません。 後で将来のキャッシュに追加することも、個別に使用を停止することもできます。

Note

Azure HPC Cache は、キャッシュを削除する前に、変更されたデータをキャッシュからバックエンド ストレージ システムに自動的に書き込むことはありません。

キャッシュ内のすべてのデータが長期ストレージに書き込まれていることを確認するには、 キャッシュを削除する 前に停止します。 削除する前に、状態が [停止済み ] と表示されていることを確認します。

ポータル

キャッシュを停止した後、[ 削除 ] ボタンをクリックしてキャッシュを完全に削除します。

Azure CLI

Azure HPC Cache 向けに Azure CLI を設定します。

Azure CLI コマンド az hpc-cache delete を使用して、キャッシュを完全に削除します。

Example:

$ az hpc-cache delete --name doc-cache0629
 - Running ..

<...>

{- Finished ..
  "endTime": "2020-07-09T22:24:35.1605019+00:00",
  "name": "7d3cd0ba-11b3-4180-8298-d9cafc9f22c1",
  "startTime": "2020-07-09T22:13:32.0732892+00:00",
  "status": "Succeeded"
}
$

警告を表示する

キャッシュが異常な状態になった場合は、[ 警告 ] ページを確認します。 このページには、キャッシュ ソフトウェアからの通知が表示され、その状態を理解するのに役立ちます。

これらの通知は、Azure portal によって制御されないため、アクティビティ ログには表示されません。 多くの場合、ユーザーが行ったカスタム設定に関連付けられます。

ここに表示される警告の種類は次のとおりです。

• キャッシュが NTP サーバーに到達できない
• キャッシュが拡張グループのユーザー名情報をダウンロードできませんでした
• ストレージ ターゲットでカスタム DNS 設定が変更されました

次のステップ

• 統計を使用してキャッシュを監視する
• Azure HPC Cache に関するヘルプを表示する