バックアップサーバとの通信プロトコルが FTP の場合、vCenter Server のファイルベースバックアップが保持数の制限を超えて残り続けることがある

Products

• VMware vCenter Server

Issue/Introduction

Symptoms:

• vCenter Server のバックアップが保持するバックアップの数の設定を超えて残り続けます。
  

  保持するバックアップ数の設定は次の画面で確認できます:

  1. vCenter Server 管理 (VAMI) にログインします。
  2. 左側のペインかのバックアップをクリックします。
  3. バックアップスケジュールの設定の編集をクリックします。
  4. 保持するバックアップの数というフィールドを確認してください。
     この画像の例では、vCenter Server のバックアップの最大保持数は 3 です。
     
• ファイルベースバックアップは FTP で設定されています。
• FTP サーバの vCenter/sn_vcsa_fqdn ディレクトリに、バックアップが保持制限を超えて保存されていることが確認できます。
  例えば、FTP サーバが Windows Server 上で実行されており、バックアップの保存場所で dir コマンドを実行すると、出力は次のようになります。各フォルダには vCenter Server のバックアップが含まれており、この例では 5 つのバックアップが残っています。

  2025/01/01  00:01    <DIR>          S_8.0.3.00000_20250101-000113_
  2025/01/02  00:01    <DIR>          S_8.0.3.00000_20250102-000116_
  2025/01/03  00:01    <DIR>          S_8.0.3.00000_20250103-000111_
  2025/01/04  00:01    <DIR>          S_8.0.3.00000_20250104-000111_
  2025/01/05  00:01    <DIR>          S_8.0.3.00000_20250105-000114_
  ...

  コマンドの結果は構成、バージョン、その他の要因によって異なる場合があります。

• vCenter Server の backupScheduler.log に UnboundLocalError が記録されます。backupScheduler.log は vCenter Server Appliance の /var/log/vmware/applmgmt にあります。 ログの例を以下に示します:

  YYYY-MM-DDTHH:mm:SS.sss [0] [MainProcess:PID-####] [Scheduler::ExecArchiveList:Scheduler.py:119] ERROR: Failed to issue the Archive.list request. Exception: {messages : [LocalizableMessage(id='vapi.method.invoke.exception', default_message="Error in method invocation 'UnboundLocalError' object has no attribute 'errcode'", args=["'UnboundLocalError' object has no attribute 'errcode'"], params=None, localized=None)], data : None, error_type : INTERNAL_SERVER_ERROR}

Environment

VMware vCenter Server 7.x

VMware vCenter Server 8.x

Cause

FTP サーバのバックアップディレクトリに ASCII 以外の文字列が含まれていることが原因です。

バックアップの削除のジョブは、まず FTP サーバ上のディレクトリのリストを取得して古いバックアップを検索します。このリストの中に UTF-8 でデコードできないファイル名またはディレクトリが含まれている場合、UnboundLocalError で削除のジョブが失敗することがあります。

Resolution

次のいずれかの回避策をお試しください。

オプション 1: ファイル名またはディレクトリ名に ASCII 以外の文字列を含むものがある場合は、それらを削除します。

オプション 2: バックアップ保存先のディレクトリを、名前に ASCII 以外の文字列を含むファイルがない場所に変更します。

バックアップの削除は、毎日午前 0 時 (深夜) に cron により実行されます。オプション 1 を実行したあと、cron が実行されるまで待機し古いバックアップが正常に削除されているか確認してください。

Additional Information

この記事ではバックアップの削除が失敗する問題について説明していますが、バックアップが正常に作成されない問題が発生することがあります。詳細は vCenter Server's file based backup to FTP server failed due to "Internal error. See logs for details. https://***/appliance/support-bundle". をご覧ください。