Azure での SAP HANA データベースのバックアップをトラブルシューティングする

この記事では、Azure 仮想マシン上で SAP HANA データベースをバックアップするためのトラブルシューティング情報を提供します。 現在サポートされている SAP HANA バックアップ シナリオの詳細については、「シナリオのサポート」を参照してください。

前提条件とアクセス許可

バックアップを構成する前に、「前提条件」と「事前登録スクリプトで実行される処理」セクションをご覧ください。

一般的なユーザー エラー

UserErrorHANAInternalRoleNotPresent

UserErrorInOpeningHanaOdbcConnection

UserErrorHanaInstanceNameInvalid

UserErrorHANALSNValidationFailure

UserErrorSDCtoMDCUpgradeDetected

UserErrorInvalidBackintConfiguration

UserErrorIncompatibleSrcTargetSystemsForRestore

UserErrorHANAPODoesNotExist

UserErrorInsufficientPrivilegeOfDatabaseUser

UserErrorDatabaseUserPasswordExpired

UserErrorInconsistentSSFS

UserErrorCannotConnectToAzureActiveDirectoryService

UserErrorMisConfiguredSslCaStore

UserErrorBackupFailedAsRemedialBackupInProgress

OperationCancelledBecauseConflictingOperationRunningUserError

OperationCancelledBecauseConflictingAutohealOperationRunning UserError

環境の登録前スクリプトの実行エラー

UserErrorHanaPreScriptNotRun

UserErrorPreregistrationScriptNotRun

UserErrorTargetPOExistsOverwriteNotSpecified

UserErrorRecoverySysScriptFailedToTriggerRestore

UserErrorDBNameNotInCorrectFormat

UserErrorDefaultSidAdmDirectoryChanged

UserErrorHDBsettingsScriptNotFound

UserErrorInsufficientSpaceOnSystemDriveForExtensionMetadata

CloudDosAbsoluteLimitReached

CloudDosAbsoluteLimitReachedWithRetry

UserErrorInvalidBackint

UserErrorHanaSQLQueryFailed

UserErrorRestoreTargetDirectoriesAbsent

JobCancelledOnExtensionUpgrade

復元の確認

単一コンテナー データベース (SDC) の復元

HANA 用の単一コンテナー データベース (SDC) を別の SDC マシンに復元するときは、入力に注意してください。 データベース名は小文字で指定し、かっこで囲んだ sdc を後に付ける必要があります。 HANA インスタンスは大文字で表示されます。

SDC HANA インスタンス "H21" がバックアップされているとします。 バックアップ項目のページに、バックアップ項目名が h21(sdc) と表示されます。 このデータベースを別のターゲット SDC (たとえば H11) に復元する場合は、次の入力を指定する必要があります。

以下の点に注意してください。

• 既定では、復元されるデータベース名に、バックアップ項目名が設定されます。 例では、 h21(sdc)が使用されます。
• ターゲットを H11 として選択しても、復元されるデータベース名は自動的に変更されません。 h11(sdc) となるように編集する必要があります。 SDC に関しては、復元されるデータベース名は、小文字のターゲット インスタンス ID の後に sdc をかっこで囲んで付けたものです。
• SDC はデータベースを 1 つしか含むことができないため、復旧ポイント データによる既存のデータベース データのオーバーライドを許可するチェックボックスをオンにすることも必要です。
• Linux では大文字と小文字が区別されます。 そのため、大文字と小文字を維持するように注意してください。

複数コンテナー データベース (MDC) の復元

HANA 用の複数コンテナー データベースの場合、標準構成は SYSTEMDB と 1 つ以上のテナント DB です。 SAP HANA インスタンス全体を復元すると、SYSTEMDB とテナント DB の両方が復元されます。 最初に SYSTEMDB を復元してから、テナント DB の処理に進みます。 基本的にシステム DB では、選択したターゲットのシステム情報がオーバーライドされます。 この復元では、ターゲット インスタンス内の BackInt 関連情報もオーバーライドされます。 そのため、システム DB がターゲット インスタンスに復元された後に、事前登録スクリプトを再実行します。 その後でのみ、後続のテナント DB の復元が成功します。

レプリケートされた VM のバックアップ

シナリオ 1

元の VM は Azure Site Recovery または Azure VM バックアップを使用してレプリケートされています。 新しい VM は古い VM をシミュレートするように構築されています。 つまり、設定はまったく同じです (これは、元の VM が削除され、VM バックアップまたは Azure Site Recovery から復元が行われたためです)。

このシナリオでは、2 つのケースが考えられます。 両方の場合について、レプリケートされた VM をバックアップする方法を説明します。

1. 新しく作成された VM は同じ名前で、削除された VM と同じリソース グループとサブスクリプションに存在する場合。

   • 拡張機能は VM に既に存在していますが、どのサービスにも表示されていません
   • 事前登録スクリプトを実行します
   • Azure portal で同じコンピューターに対して拡張機能を再登録します ([バックアップ] ->[詳細の表示] ->[関連する Azure VM の選択] -> [再登録])
   • (削除された VM からの) 既存のバックアップ データベースが正常にバックアップされるようになります

2. 新しく作成された VM が次のいずれかの場合。

   • 削除された VM とは名前が異なる
   • 削除された VM と同じ名前だが、(削除された VM とは) 別のリソース グループまたはサブスクリプションに存在する

   その後、次の操作を行います。

   • 拡張機能は VM に既に存在していますが、どのサービスにも表示されていません
   • 事前登録スクリプトを実行します
   • 新しいデータベースを検出して保護すると、ポータルに重複するアクティブなデータベースが表示されます。 これを回避するには、古いデータベースのデータを保持して保護を停止します。 その後、残りの手順に進みます。
   • データベースを検出する
   • これらのデータベースでバックアップを有効にします
   • (削除された VM から) 既存のバックアップ されたデータベースは、引き続きコンテナーに格納されます。 これらは、ポリシーに従ってバックアップが保持された後に保存されます。

シナリオ 2

元の VM は Azure Site Recovery または Azure VM バックアップを使用してレプリケートされています。 新しい VM は、テンプレートとして使用するために—コンテンツから構築されています。 VM は新しい SID で新しいです。

新しい VM でバックアップを有効にするには、次の手順に従います。

• 拡張機能は VM に既に存在していますが、どのサービスにも表示されていません
• 事前登録スクリプトを実行します。 新しい VM の SID に基づいて、次の 2 つのシナリオが考えられます
  • 元の VM と新しい VM に同じ SID が割り当てられている。 事前登録スクリプトは正常に実行されます。
  • 元の VM と新しい VM に異なる SID が割り当てられている。 事前登録スクリプトが失敗します。 このシナリオで支援が必要な場合は、Microsoft サポートにお問い合わせください。
• バックアップするデータベースを検出する
• これらのデータベースでバックアップを有効にします

同じ VM 上の SDC バージョン アップグレードまたは MDC バージョン アップグレード

SID が変更されない OS のアップグレード、SDC バージョンの変更、または MDC バージョンの変更は、次のように処理できます。

• 新しい OS バージョン、SDC、または MDC バージョンが現在 Azure Backup でサポートされていることを確認してください
• そのデータベースのデータを保持して保護を停止します
• アップグレードまたは更新を実行します
• 事前登録スクリプトを再実行します。 多くの場合、アップグレード プロセスで必要なロールが削除されます。 事前登録スクリプトを実行して、必要なすべてのロールを確認します。
• データベースの保護を再開します

SID の変更がない SDC から MDC へのアップグレード

SID が変更されない SDC から MDC へのアップグレードは、次のように処理できます。

• 新しい MDC バージョンが現在 Azure Backup でサポートされていることを確認してください
• 古い SDC データベースのデータを保持して保護を停止します
• アップグレードを実行します。 完了後、HANA システムはシステム DB とテナント DB を備えた MDC になります
• 事前登録スクリプトを再実行します
• Azure portal で同じコンピューターに対して拡張機能を再登録します ([バックアップ] ->[詳細の表示] ->[関連する Azure VM の選択] -> [再登録])
• 同じ VM に対して [DB の再検出] を選択します。 このアクションにより、手順 3 の新しい DB が表示されます (SDC ではなく SYSTEMDB とテナント DB)
• 古い SDC データベースは引き続きコンテナーに存在し、ポリシーに従って古いバックアップ データが保持されます。
• これらのデータベースのバックアップを構成します

SID が変更される SDC から MDC へのアップグレード

SID が変更される SDC から MDC へのアップグレードは、次のように処理できます。

• 新しい MDC バージョンが現在 Azure Backup でサポートされていることを確認してください
• 古い SDC データベースのデータを保持して保護を停止します
• /opt/msawb/etc/config/SAPHana/にあるconfig.json ファイルを移動します。
• アップグレードを実行します。 完了後、HANA システムはシステム DB とテナント DB を備えた MDC になります。
• 適切な詳細 (新しい SID と MDC) を指定して、事前登録スクリプトを再実行します。 SID の変更により、スクリプトの正常な実行に関する問題が発生する可能性があります。 問題が発生した場合は、Azure Backup サポートにお問い合わせください。
• Azure portal で同じコンピューターに対して拡張機能を再登録します ([バックアップ] ->[詳細の表示] ->[関連する Azure VM の選択] -> [再登録])。
• 同じ VM に対して [DB の再検出] を選択します。 このアクションにより、手順 3 の新しい DB が表示されます (SDC ではなく SYSTEMDB とテナント DB)。
• 古い SDC データベースは引き続きコンテナーに存在し、ポリシーに従って古いバックアップ データが保持されます。
• これらのデータベースのバックアップを構成します。

再登録エラー

再登録操作をトリガーする前に、次の兆候が 1 つ以上ないか確認してください。

• VM ですべての操作 (バックアップ、復元、バックアップの構成など) が次のいずれかのエラー コードで失敗している。WorkloadExtensionNotReachable、UserErrorWorkloadExtensionNotInstalled、WorkloadExtensionNotPresent、WorkloadExtensionDidntDequeueMsg。

• バックアップ項目の [バックアップ状態] 領域に [到達できません] が表示されている場合は、同じ状態になる可能性のある他のすべての原因を除外します。

  • VM でバックアップ関連の操作を実行する権限がない
  • VM がシャットダウンされているため、バックアップが実行できない
  • ネットワークの問題

これらの兆候は、次の 1 つ以上の理由によって発生する可能性があります。

• 拡張機能がポータルから削除またはアンインストールされた。
• VM がインプレース ディスク復元を使用して時間内に復元された。
• VM が長期間シャットダウンされたため、その拡張機能構成の期限が切れた。
• VM が削除された。 また、削除された VM と同じ名前で同じリソース グループに別の VM が作成されました。

前のシナリオにおいて、VM で再登録操作をトリガーすることをお勧めします。

SAP HANA データベースのログをバックアップする

完全バックアップが成功したにもかかわらず、ログ バックアップがトリガーされない。

考えられる原因: SAP HANA データベースの値が正しくないため、ログ バックアップがトリガーされません。

推奨されるアクション: SAP HANA 構成の次の値が正しく設定されていることを確認します。

• enable_auto_log_backup: Yes
• log_backup_using_backint: True
• catalog_backup_using_backint: True
• log_mode: normal
• log_backup_timeout_s: Azure portal のログ バックアップ ポリシーと同じ (頻度は秒単位)。

次のステップ

• Azure VM 上の SAP HANA データベースのバックアップに関するよく寄せられる質問を確認する。