Avamar: Het dump_root_hashes.rb-script gebruiken om een lijst met clients en back-ups te genereren

In dit artikel worden functies van het Avamar Engineering-script beschrevendump_root_hashes.rb" en geeft de lezer basisrichtlijnen voor het gebruik ervan.

Typische gebruiksscenario's:

• Het genereren van een lijst van klanten en hun eigenschappen (bijvoorbeeld klant-ID, domein) op een systeem.
• Vergelijking van een lijst met clients tussen twee systemen.
• Een lijst genereren van alle back-ups op een Avamar-raster en hun eigenschappen. Deze omvatten root-hash, grootte, plug-in-id, domein, clientnaam, vervaldatum, retentie en grootte.
• Het vergelijken van back-ups die zijn opgeslagen op twee replicerende Avamar-rasters (handig voor het identificeren van ontbrekende of overtollige back-ups per Avamar: Een replicatiepaar toont verschillende niveaus van capaciteitsgebruik. Hoe de oorzaken te onderzoeken. Mogelijk moet u zich aanmelden bij Dell Support om toegang te krijgen tot dit artikel.)

Het script is op de hoogte van back-ups die worden uitgevoerd vanuit Avamar, maar naar Data Domain worden verzonden.

Het script downloaden:

Raadpleeg het volgende artikel voor informatie over het vinden en downloaden van het script: Avamar: Avamar scripts en tools vinden en downloaden op de Dell Central Avamar pagina.

Het script uitvoeren:

Het script wordt uitgevoerd door de scriptnaam te laten voorafgaan door "ruby" (zoals hieronder te zien is):

ruby dump_root_hashes.rb --help

Starting up dump_root_hashes.rb version 0.10.2 at 2019-10-21 02:17:21 +0000 (2019-10-21 02:17:21 UTC)

Usage: dump_root_hashes.rb [options]

Overview of the script's features
Running the script with the --help flag shows a list of features.  Below is output showing features of the script as of release 0.10.2.


Options:
    -q, --quiet                      Suppress progress counters
        --mode=<backuplist|backupcompare|clientlist|clientcompare|genpasswordfile|connchk>

                                     Specify the script mode. Supported modes:
                                     backuplist (default) - generate a report showing the list of all backups on the system; include the following information:
                                       -system name
                                       -client name
                                       -domain
                                       -backup create time
                                       -backup expiration time
                                       -retention tags
                                       -backup size
                                       -root hash
                                     backupcompare - generate a report showing backup information for both source and target; requires a --dstaddr parameter
                                     clientlist - generate a report showing the client information for all client accounts
                                     clientcompare - generate a report showing the client information for both source and target; requires a --dstaddr parameter
                                     genpasswordfile - generate a file containing obfuscated login credentials
                                     connchk - run a GSAN connectivity test
    -s, --srcaddr=ADDRESS            Specify the replication source. Defaults to the local system.
        --src-password-file=FILENAME Specify a file containing credentials for the source system. Only needed if source and destination passwords differ.
    -d, --dstaddr=ADDRESS            Specify the replication destination for "compare" modes
        --dst-password-file=FILENAME Specify a file containing credentials for the destination system. Only needed if source and destination passwords differ.

Filtering Options:

NOTE: Filter flags apply to BOTH source AND destination systems unless otherwise noted!

        --before=DATE                Only report on backups created before DATE.
                                     This date can be any string understood by the GNU "date" utility.
        --after=DATE                 Only report on backups created after DATE.
                                     This date can be any string understood by the GNU "date" utility.
        --srcpath=PATH               Limit reporting on the source system to domains and clients under the specified path.
        --dstpath=PATH               Limit reporting on the destination system to domains and clients under the specified path.
        --mc-deleted=<include|skip>  Skip the MC_DELETED domain by default
        --mc-retired=<include|skip>  Traverse the MC_RETIRED domain by default
        --partials=<include|skip>    Skip partial backups by default
        --expired=<include|skip>     Skip expired backups by default
        --replicate=<include|skip>   Traverse the REPLICATE domain by default
        --system-accounts=<include|skip>
                                     Skip the system accounts MC_BACKUPS, EM_BACKUPS, AVI_BACKUPS, etc. by default
        --adme=<include|skip>        Skip the ADME domain by default

Output Options:

        --outfile=FILENAME           The report is written to this file.
                                     Defaults to "<mode>.csv", where <mode> is the script mode.
                                     The file is overwritten if it exists.
        --format=<csv>               Data format to use for export. Supported formats:
                                     csv (default) - comma separated values; suitable for spreadsheet import
        --[no-]showprectime          Include the backup creation precision time in report
        --[no-]show-ddr-info         Include DDR presence information and ddrindex in report
        --[no-]show-tier-info        Include cloud tiering information in report
        --[no-]showbackuptype        Include the backup type (Full, Incremental+Full, etc. in report
        --[no-]showhybridbackups     Detect hybrid backups, where a DD backup has data on GSAN (slow)
        --hybridsearchtimeout=n      How long to wait for hybrid backup search avtar calls to return in seconds. Defaults to 300s. Set to 0 to disable timeout.
        --[no-]showlabel             Include the backup's text label in report
        --[no-]showpidnum            Include the backup's plugin id (pid number / pidnum) in report
        --[no-]showpiddesc           Include a short plugin description for each backup in report
        --compression=<none|gzip>    Use the specified compression for the output file. Defaults to gzip.
        --presence=src,dst,both      Limit output to records only on the src, only on the dst, on both systems, or some combination thereof
                                     Shows all records by default (equivalent to --presence=src,dst,both)
        --[no-]header                Include the header line in CSV files

Script Options:

        --debug                      Enable debug logging.
        --memory-limit=n             How much virtual memory the script can use in bytes. Defaults to 4GB.
        --avmgrdebug=<none|getl|getb|all>
                                     Enable debugging for avmgr queries. Defaults to none.
        --avmgr-debug-file=FILENAME  Write avmgr debug information to the specified file. Defaults to drh_avmgr_debug.log.
        --getl-timeout=n             How long to wait for avmgr getl to return in seconds. Defaults to 60s. Set to 0 to disable timeout.
        --getl-retries=n             How many times to retry an avmgr getl command before giving up. Defaults to 5.
        --getb-timeout=n             How long to wait for avmgr getb to return in seconds. Defaults to 300s (5 minutes). Set to 0 to disable timeout.
        --getb-retries=n             How many times to retry an avmgr getb command before giving up. Defaults to 5.
        --encrypt=<none|proprietary|ssl|tls|tls-sa>
                                     Set encryption mode. Defaults to tls.
        --src-encrypt=<none|proprietary|ssl|tls|tls-sa>
                                     Set source encryption mode. Overrides --encrypt if both are specified. Defaults to tls.
        --dst-encrypt=<none|proprietary|ssl|tls|tls-sa>
                                     Set destination encryption mode. Overrides --encrypt if both are specified. Defaults to tls.
    -h, --help                       Display help text
    -v, --version                    Display version information

Het script gebruiken om back-ups te vergelijken die zijn opgeslagen op twee Avamar replicatierasters:

De dump_root_hashes.rb script kan nuttig zijn voor het identificeren van overtollige of ontbrekende back-ups waarbij klanten mogelijk twee replicerende Avamar-rasters hebben geconfigureerd. Over het algemeen is de verwachting dat de capaciteitsniveaus vergelijkbaar zijn en dat de back-ups van ten minste tot de voorgaande dagen zijn gerepliceerd.

Voorbeeld:
de volgende opdrachten moeten worden uitgevoerd op het Avamar-raster van de bron. Specificeer de naam van de Avamar-server in de opdracht en de backupcompare de modus wordt aangeroepen. (De meest recente versies van het script rapporteren automatisch over alle back-ups die zijn gedetecteerd op Data Domain):

ruby dump_root_hashes.rb --dstaddr=<target-avamar-servername>

Failed to connect to GSAN on avamar2.xxx.com. Check name resolution, network connectivity, and firewall settings.

Om het script met succes te laten uitvoeren, moet een versluierd wachtwoordbestand worden gegenereerd door het script uit te voeren in de modus "genpasswordfile".

Om veiligheidsredenen kunnen referenties niet rechtstreeks aan het script worden doorgegeven via de opdrachtregel:

admin@avamar1:~/>: ruby dump_root_hashes.rb --mode=genpasswordfile

Starting up dump_root_hashes.rb version 0.8.3 at 2018-02-16 14:14:34 +0000 (2018-02-16 14:14:34 UTC)

Running in password file generation mode.

Password filename: avamar2.pass
Username [root]:
Password:

Encoding password
Writing encoded password to /space/home/admin/avamar2.pass

Password information successfully written to /space/home/admin/avamar2.pass

Use --src-password-file=/space/home/admin/avamar2.pass or --dst-password-file=/space/home/admin/avamar2.pass to pass these credentials into the script.

Dit wachtwoordbestand kan vervolgens worden doorgegeven aan het script met behulp van een van de bovenstaande parameters (afhankelijk van of u op afstand verbinding probeert te maken met de bron of bestemming).

Voorbeeld:

ruby dump_root_hashes.rb --dstaddr=<target-avamar-servername> --dst-password-file=<path-to-password-file> --show-ddr-info

Nadat het script is voltooid, wordt een .csv bestand gegenereerd met een naam met een indeling die er ongeveer zo uitziet:
backupcompare_<source>_to_<target>.domain.com_YYYY-MM-DD_HHMM

Het bestand kan worden geopend in Excel en is opgemaakt met de volgende kolomnamen:

• Sleutel
• Root Hash
• Op Data Domain
• Source Grid
• Brondomein
• Bronclient
• src_created (UTC)
• src_expires (UTC)
• src_retention_type
• src_bytes
• src_labelnum
• src_ddrindex
• Doelraster
• Bestemmingsdomein
• Doelclient
• dst_created (UTC)
• dst_expires (UTC)
• dst_retention_type
• dst_bytes
• dst_labelnum
• dst_ddrindex

Deze kolommen kunnen worden gebruikt om de gegevens te sorteren en te filteren.

Van bijzonder nut in deze situatie, is de eerste kolom 'Sleutel'. De waarden geven hier aan of de back-up is opgeslagen op het bronsysteem (S), op het doel (D) of op beide systemen (B).

We verwachten dat het bronsysteem back-ups heeft die (nog) niet aanwezig zijn op het doel. Dit komt door de natuurlijke vertraging tussen het moment waarop de back-up naar de bronback-up wordt geschreven en naar het doel wordt gerepliceerd (meestal de volgende dag).

Bekijk deze video: