「Avamar Capacity Management：「modify-snapups」ツールを使用してバックアップを一括で削除または期限切れにする方法

Summary: 「modify-snapups」ツールを使用してバックアップを一括で削除または期限切れにする方法。

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

この記事では、Avamarシステムで modify-snapupsツールを使用して、次のいくつかの課題を解決する方法について説明します。
  • 管理者は、大容量の状況を解決または防止するために、バックアップを一括で削除したいと考えています。
  • システムがいっぱいになり、保存ポリシーは削減されますが、このアクションは新しいバックアップにのみ影響します。また、既存のバックアップの有効期限を変更する必要もあります。
  • 既存のバックアップの有効期限が正しく設定されませんでした。
  • ビジネス要件が変更され、組織は当初の計画よりも多くまたは少ないバックアップを保存する必要があります。

    Cause

    「modify-snapups.sh」ユーティリティは、デフォルトで Avamar ユーティリティ ノードの /usr/local/avamar/bin の下に存在するスクリプトです。

    Resolution

    このユーティリティは、以前の形式のツールであるスクリプト「expire-snapups」と「delete-snapups」を置き換えます。これらの以前のスクリプトはどちらも廃止され、コマンドを実行すると、modify-snapupsを直接呼び出すようになりました(メモのアイテム#1を参照)。

    期限切れモードと削除モード:    
    modify-snapupsは、期限切れモードまたは削除モードのいずれかを使用して実行されます。
     
    modify-snapups --help
    modify-snapups - modify snapups
    バージョン: 7.1.0-370(1.11)
    使用方法:modify-snapups [--mode={delete|expire}] [--help] [options ]
    modify-snapupsとして呼び出された場合、このプログラムは何も実行しません。
    代わりに、このプログラムを delete-snapups または expire-snapups として呼び出すか、
    他のオプションの前に --mode={delete|expire} を使用して呼び出します。

    各モードに渡されるフラグはほぼ同一であり、コマンドに --help を追加することで表示されます。(メモのアイテム#2を参照)

    スクリプトは何をしますか?  
    Avamarサーバーに変更を加えないため、modify-snapupsを単独で実行しても安全です。

    正しい引数を指定してを実行すると、ユーティリティはコマンドのリストを含むスクリプトを生成します。スクリプトを実行すると、各バックアップの有効期限を変更したり削除したりするために、コマンドのリストがシリアルで実行されます。

    コマンドは、modify-snapupsに渡されるフラグに従って生成されます。  

    ユーザーは、バックアップを含めるかどうかを決定できます。      
    • 特定の日付範囲内(--after/-before)
    • 特定のドメイン(--domain)の下
    • 特定のクライアントの場合
    • AVI、EM、MCの内部Avamarデータベース バックアップを含めるかどうか
    • レプリケーション ターゲットにバックアップを含めるかどうか

    コマンド

    の例例1: 「mydomain」のすべてのバックアップを確認し、2015年3月1日より前に作成されたスクリプトを作成します。
     
    modify-snapups --mode=expire --domain=/mydomain --before=2015-03-01 > expire-backups-output-script.txt

    スクリプトは、適切なバックアップを MODIFY (この場合は期限切れにする)に対するmccli backup editコマンドのリストを生成します。基準に一致しないものもリストされますが、プレフィックスとしてハッシュ(#) と説明「CONSERVE:   
     
    # MODIFY Snapup date: 2015年2月17日8:04:30(GMT)Lab#: 418レプリケート: N/A
    エコー実行中: "mccli backup edit --domain=/mydomain --name=myclient.avamar.com --labelNum=418 --created=2015-02-17 --expiration=2015-05-18"
    mccli backup edit --domain=/mydomain --name=myclient.avamar.com --labelNum=418 --created=2015-02-17 --expiration=2015-05-18
    # CONSERVE Snapup date: 2015年4月17日8:05:18 IST Lab#: 457レプリケート: N/A
    # echo running: 「mccli backup edit --domain=/mydomain --name=myclient.avamar.com --labelNum=457 --created=2015-04-17 --expiration=2015-07-16」
    # mccli backup edit --domain=/mydomain --name=myclient.avamar.com --labelNum=457 --created=2015-04-17 --expiration=2015-07-16
    # CONSERVE Snapup date: 2015-04-16 08:03:46 IST Lab#: 456レプリケート: N/A
    # echo running: 「mccli backup edit --domain=/mydomain --name=myclient.avamar.com --labelNum=456 --created=2015-04-16 --expiration=2015-07-15」
    # mccli backup edit --domain=/mydomain --name=myclient.avamar.com --labelNum=456 --created=2015-04-16 --expiration=2015-07-15

    例2：1か月以上前に作成されたmydomainのすべてのバックアップを削除します。
     
    modify-snapups --mode=delete --domain=/mydomain --before='1 month ago' > output-script.txt

    例#1のように適切な日付を使用しますが、ここでは「分かりやすい」Linux日付表記(1か月前)を使用します。

    スクリプトには、次のように出力が含まれています(スペースの理由からトランケートされます)。ヘッダーでは、スクリプトが実行する操作と、有効なパラメーターを正確に説明します。スクリプトは2015年4月17日に実行されました。
    # ======
    ================================================================ # CLIENT: /mydomain/server
    # 操作: DELETE selected snapups
    # After: 「June 1 1999 00:00:00」(928191600)6月1日火曜日00:00:00 IST 1999
    # Before: 「1か月前」(1426614045)3月17日火曜日17:40:45 GMT 2015
    # ===================================================== =========
    =# *** NO SNAPUPS FOUND ***
    # ===
    ==================================================== CLIENT: /mydomain/myclient.avamar.com
    # 操作: DELETE selected snapups
    # After: 「June 1 1999 00:00:00」(928191600)6月1日火曜日00:00:00 IST 1999
    # Before: 「1か月前」(1426614045)3月17日火曜日17:40:45(GMT)2015
    # ===================== =================================================
    # 節約スナップアップ日: 2015年3月18日8:03:31(GMT)ラボ#: 437レプリケート: N/A
    # echo running: "mccli backup delete --domain=/mydomain --name=myclient.avamar.com --labelNum=437 --created=2015-03-18 --force=true"
    # mccli backup delete --domain=/mydomain --name=myclient.avamar.com --labelNum=437 --created=2015-03-18 --force=true
    # MODIFY Snapup date: 2015年3月16日8:03:57(GMT)ラボ#: 435レプリケート: N/A
    エコー実行中: "mccli backup delete --domain=/mydomain --name=myclient.avamar.com --labelNum=435 --created=2015-03-16 --force=true"
    mccli backup delete --domain=/mydomain --name=myclient.avamar.com --labelNum=435 --created=2015-03-16 --force=true
    # MODIFY Snapup date: 2015年3月13日8:01:30(GMT)Lab#: 434レプリケート: N/A
    エコー実行中: "mccli backup delete --domain=/mydomain --name=myclient.avamar.com --labelNum=434 --created=2015-03-13 --force=true"
    mccli backup delete --domain=/mydomain --name=myclient.avamar.com --labelNum=434 --created=2015-03-13 --force=true
    # MODIFY Snapup date: 2015年3月12日8:09:20(GMT)Lab#: 433レプリケート: N/A
    エコー実行中: 「mccli backup delete --domain=/mydomain --name=myclient.avamar.com --labelNum=433 --created=2015-03-12 --force=true」
    mccli backup delete --domain=/mydomain --name=myclient.avamar.com --labelNum=433 --created=2015-03-12 --force=true

    MODIFYとともにリストされているバックアップは、「mccli backup delete」コマンドを使用して変更されます。これらのバックアップはすべて、1か月前(2015年3月17日)より前に「作成」された日付を持っています。

    例3: 既存のバックアップの有効期限を延長します。
    次のコマンドは、/clientsドメインのクライアントに対して2018年5月15日から15日の間に作成されたバックアップを取得し、スクリプトを作成します。このスクリプトを実行すると、バックアップの有効期限が置き換わり、バックアップの作成から100日後に期限切れになります。
     
    modify-snapups --domain=/clients/ --mode=expire --after='2018-05-01' --before='2018-05-15' --days=100 > expire-backups-output-script.txt

    .
    8。
    #=======================================================================
    = # CLIENT: /clients/server.asl.lab.emc.com
    # 操作: EXPIRE selected snapups
    # After: 「2018-05-01」(1525158000)5月1日火曜日00:00:00 IOP 2018
    # 前: "2018-05-15" (1526367600) 5月15日火曜日 00:00:00 KPI 2018
    # =============== ===========================================================
    # MODIFY Snapup date: 2018-05-07 22:00:52 LAB#: 498レプリケート: N/A
    エコー実行中: "mccli backup edit --domain=/clients --name=server --labelNum=498 --created=2018-05-07 --expiration=2018-08-15"
    mccli backup edit --domain=/clients --name=server --labelNum=498 --created=2018-05-07 --expiration=2018-08-15
    # MODIFY Snapup date: 2018-05-06 22:00:46 LAB#: 497レプリケート: N/A
    エコー実行中: 「mccli backup edit --domain=/clients --name=server --labelNum=497 --created=2018-05-06 --expiration=2018-08-14"mccli backup edit --domain=/」
    clients --name=server --labelNum=497 --created=2018-05-06 --expiration=2018-08-14
    8#節約スナップアップ日: 2018-06-25 22:00:41 LAB#: 501レプリケート: N/A
    # echo running: 「mccli backup edit --domain=/clients --name=server --labelNum=501 --created=2018-06-25 --expiration=2018-10-03」
    # mccli backup edit --domain=/clients --name=server --labelNum=501 --created=2018-06-25 --expiration=2018-10-03
    # CONSERVE Snapup date: 2018年4月30日22:00:57 INFO Lab#: 491レプリケート: N/A
    # echo running: 「mccli backup edit --domain=/clients --name=server --labelNum=491 --created=2018-04-30 --expiration=2018-08-08」
    # mccli backup edit --domain=/clients --name=server --labelNum=491 --created=2018-04-30 --expiration=2018-08-08


    スクリプトを実行してバックアップ

    を変更または削除するこの手順を実行する前にチェックポイントを作成することを強くお勧めします。

    スクリプトを作成した後、内容を慎重に確認します。実行するアクションに満足したら、スクリプトを実行可能に設定します。

    たとえば、6か月を超える/mydomainのすべてのバックアップを削除するスクリプトを作成します。

    スクリプトを実行可能に設定し、権限を確認します。    
     
    admin@utility:~/modsnap/>: chmod +x delete-backups-mydomain-before-6monthsago.txt
    admin@utility:~/modsnap/>:  ls -l-rwx
    ------ 1 admin admin 15016 4月17日 18:55 delete-backups-mydomain-before-6monthsago.txt

    スクリプトを実行します。出力を別のファイルにリダイレクトして、変更内容を記録します。
     
    admin@utility:~/modsnap/>: ./delete-backups-mydomain-before-6monthsago.txt
    running:mccli backup delete --domain=/mydomain --name=myclient.customer.com --labelNum=323 --created=2014-09-25 --force=true
    0,22553,Backup deleted.

    属性値---------- --------------------------------------
    path /mydomain/myclient.customer.com
    retention N
    labelnum 323
    createtime 2014-09-25 18:07:04 IST
    plugin 3001

    スクリプトが完了するまで実行され、2回目に実行される場合は、次を参照してください。    
    1,22552,バックアップが存在しない

    スクリプトの実行に時間がかかり、停止する必要がある場合は、2回目に実行できます。以前に削除されたバックアップの再チェックを回避するには、スクリプトを手動で編集して、すでに処理されているコマンドを削除します。または、スクリプトを再度再生成します。

    スクリプトの生成と実行にはかなりの時間がかかる場合があります。作業を小さな期間または個々のドメインに分割することで、「分割して克服」すると便利です。

    Additional Information

    アイテム1
    ls -ls /usr/local/avamar/bin/ | grep modify-snapups
        0 lrwxrwxrwx 1 root root 14 11月28日 19:42 delete-snapups -> modify-snapups
    0 lrwxrwxrwx 1 root root 14 11月28日 19:42 expire-snapups -> modify-snapups
    24 -rwxr-xr-x 1 root root 24185 9月8日 23:46 modify-snapups

    「snapup」という用語は、バックアップを意味するために使用できる古いAvamar用語です。スナップショットとバックアップという単語のハイブリッドです。

    アイテム2
    削除モードと期限切れモードの使用方法に関する完全なドキュメントは、 コマンドに --help を追加することで使用できます。
     
    modify-snapups --mode=expire --help
    modify-snapups --mode=delete --help

    アイテム3
    次の記事に注意してください。 次のビデオをご覧ください。  
     

    Affected Products

    Avamar

    Products

    Avamar, Avamar Client, Avamar Server
    Article Properties
    Article Number: 000058216
    Article Type: Solution
    Last Modified: 19 Nov 2024
    Version:  9
    Find answers to your questions from other Dell users
    Support Services
    Check if your device is covered by Support Services.