Avamar: Administración de capacidad: cómo eliminar o hacer caducar respaldos de forma masiva con la herramienta "modify-snapups"
Resumen: Cómo eliminar o hacer caducar respaldos de forma masiva con la herramienta "modify-snapups".
Este artículo se aplica a
Este artículo no se aplica a
Este artículo no está vinculado a ningún producto específico.
No se identifican todas las versiones del producto en este artículo.
Síntomas
El objetivo de este artículo es documentar cómo utilizar la herramienta modify-snapups en un sistema Avamar para ayudar con algunos de los siguientes desafíos.
- El administrador desea eliminar los respaldos de forma masiva para resolver o evitar una situación de alta capacidad.
- El sistema se está llenando y, aunque las políticas de retención se reducen, esta acción afecta solo a los respaldos nuevos. También es necesario modificar la fecha de vencimiento de los respaldos existentes.
- Los respaldos existentes se configuraron con fechas de vencimiento incorrectas.
- Los requisitos del negocio cambian y la organización debe almacenar más o menos respaldos de los que se planearon originalmente.
Causa
La utilidad "modify-snapups.sh" es un script que está presente de manera predeterminada en el nodo de utilidad de Avamar en /usr/local/avamar/bin.
Resolución
La utilidad reemplaza los scripts 'expire-snapups' y 'delete-snapups', que eran formas anteriores de la herramienta. Estos dos scripts anteriores están obsoletos y los comandos ahora llaman directamente a modify-snapups, si se ejecutan (consulte el elemento # 1 en Notas).
Modos de vencimiento y eliminación:
modify-snapups se ejecuta mediante el modo de vencimiento o el modo de eliminación.
Las marcas que se pasan a cada modo son casi idénticas y se ven anexando --help al comando. (ver ítem #2 en Notas)
¿Qué hace el script?
La ejecución de modify-snapups por su cuenta es segura, ya que no realiza ningún cambio en el servidor Avamar.
Cuando se ejecuta con argumentos correctos, la utilidad genera un script que contiene una lista de comandos. La ejecución del script ejecuta la lista de comandos en serie, a fin de cambiar las fechas de vencimiento de cada respaldo o eliminarlo.
Los comandos se generan de acuerdo con las marcas pasadas a modify-snapups.
Un usuario puede decidir si desea incluir respaldos:
Comandos de
ejemploEjemplo 1: Compruebe todas las copias de seguridad en 'mydomain' y cree un script que haga caducar las creadas antes del 1 de marzo de 2015.
El script genera una lista de comandos de edición de respaldos de MCCLI para MODIFICAR (que, en este caso, vencen) los respaldos correspondientes. Aquellos que no coinciden con los criterios también se enumeran, pero tienen el prefijo un hash (#) y la descripción CONSERVE:
Ejemplo 2: Elimine todos los respaldos en mydomain que se crearon hace más de un mes.
Use fechas adecuadas como en el ejemplo # 1 pero, para ilustrar, aquí se usan notaciones de fecha 'amigables' de Linux (hace 1 mes).
El script contiene el resultado que se muestra a continuación (truncado por razones de espacio). En el encabezado, el script explica exactamente qué operación está llevando a cabo y los parámetros que están vigentes. El guión se ejecutó el 17 de abril de 2015.
Los respaldos que se enumeran con MODIFY se modifican con el comando "mccli backup delete". Todos estos respaldos tienen fechas de "creación" anteriores a 1 mes atrás (17 de marzo de 2015).
Ejemplo 3: Extienda el vencimiento de los respaldos existentes.
El siguiente comando toma respaldos creados entre el 1 y el 15 de mayo de 2018 para clientes bajo el dominio /clients y crea un script que, cuando se ejecuta, reemplaza el vencimiento de esos respaldos para que venzan 100 días después de su creación.
Ejecución del script para modificar o eliminar respaldos
Se recomienda encarecidamente crear un punto de control antes de ejecutar este procedimiento.
Después de crear el script, revise el contenido cuidadosamente. Cuando esté satisfecho con las acciones que se van a llevar a cabo, configure el script para que sea ejecutable.
Por ejemplo, cree un script para eliminar todos los respaldos en /mydomain que tengan más de 6 meses.
Configure el script para que sea ejecutable y compruebe los permisos:
Ejecute el script. Redirija la salida a otro archivo para registrar los cambios realizados.
Si el script se ejecutó hasta completarse y se ejecuta por segunda vez, se muestra lo siguiente:
Si el script tarda mucho tiempo en ejecutarse y se debe detener, se puede ejecutar por segunda vez. Para evitar volver a comprobar los respaldos eliminados anteriormente, edite el script manualmente para eliminar los comandos ya procesados. Como alternativa, vuelva a generar el script.
Generar y ejecutar el script puede tardar una cantidad significativa de tiempo. Es útil "dividir y conquistar" dividiendo el trabajo en períodos de tiempo más pequeños o dominios individuales.
Modos de vencimiento y eliminación:
modify-snapups se ejecuta mediante el modo de vencimiento o el modo de eliminación.
modify-snapups --help
modify-snapups - modify snapups
Version: 7.1.0-370 (1.11)
Usage: modify-snapups [--mode={delete|expire}] [--help] [options ]
This program does nothing when invoked as modify-snapups.
Instead, invoke this program as delete-snapups or expire-snapups,
or else with --mode={delete|expire} before any other options.
¿Qué hace el script?
La ejecución de modify-snapups por su cuenta es segura, ya que no realiza ningún cambio en el servidor Avamar.
Cuando se ejecuta con argumentos correctos, la utilidad genera un script que contiene una lista de comandos. La ejecución del script ejecuta la lista de comandos en serie, a fin de cambiar las fechas de vencimiento de cada respaldo o eliminarlo.
Los comandos se generan de acuerdo con las marcas pasadas a modify-snapups.
Un usuario puede decidir si desea incluir respaldos:
- Dentro de un determinado rango de fechas (--after / --before)
- Bajo un dominio determinado (--domain)
- Para un cliente determinado
- Si se deben incluir respaldos internos de bases de datos de Avamar para AVI, EM, MC
- Si se deben incluir respaldos en el destino de replicación
Comandos de
ejemploEjemplo 1: Compruebe todas las copias de seguridad en 'mydomain' y cree un script que haga caducar las creadas antes del 1 de marzo de 2015.
modify-snapups --mode=expire --domain=/mydomain --before=2015-03-01 > expire-backups-output-script.txt
# MODIFY Snapup date: 2015-02-17 08:04:30 GMT Lab#: 418 Replicated: N/A echo running: "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-04-17 08:05:18 IST Lab#: 457 Replicated: 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 Replicated: 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
Ejemplo 2: Elimine todos los respaldos en mydomain que se crearon hace más de un mes.
modify-snapups --mode=delete --domain=/mydomain --before='1 month ago' > output-script.txt
Use fechas adecuadas como en el ejemplo # 1 pero, para ilustrar, aquí se usan notaciones de fecha 'amigables' de Linux (hace 1 mes).
El script contiene el resultado que se muestra a continuación (truncado por razones de espacio). En el encabezado, el script explica exactamente qué operación está llevando a cabo y los parámetros que están vigentes. El guión se ejecutó el 17 de abril de 2015.
# ====================================================================== # CLIENT: /mydomain/server # Operation: DELETE selected snapups # After: "June 1 1999 00:00:00" (928191600) Tue Jun 1 00:00:00 IST 1999 # Before: "1 month ago" (1426614045) Tue Mar 17 17:40:45 GMT 2015 # ====================================================================== # *** NO SNAPUPS FOUND *** # ====================================================================== # CLIENT: /mydomain/myclient.avamar.com # Operation: DELETE selected snapups # After: "June 1 1999 00:00:00" (928191600) Tue Jun 1 00:00:00 IST 1999 # Before: "1 month ago" (1426614045) Tue Mar 17 17:40:45 GMT 2015 # ====================================================================== # CONSERVE Snapup date: 2015-03-18 08:03:31 GMT Lab#: 437 Replicated: 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-03-16 08:03:57 GMT Lab#: 435 Replicated: N/A echo running: "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-03-13 08:01:30 GMT Lab#: 434 Replicated: N/A echo running: "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-03-12 08:09:20 GMT Lab#: 433 Replicated: N/A echo running: "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
Los respaldos que se enumeran con MODIFY se modifican con el comando "mccli backup delete". Todos estos respaldos tienen fechas de "creación" anteriores a 1 mes atrás (17 de marzo de 2015).
Ejemplo 3: Extienda el vencimiento de los respaldos existentes.
El siguiente comando toma respaldos creados entre el 1 y el 15 de mayo de 2018 para clientes bajo el dominio /clients y crea un script que, cuando se ejecuta, reemplaza el vencimiento de esos respaldos para que venzan 100 días después de su creación.
modify-snapups --domain=/clients/ --mode=expire --after='2018-05-01' --before='2018-05-15' --days=100 > expire-backups-output-script.txt . 8<----------------------SNIP------------------8< . # ====================================================================== # CLIENT: /clients/server.asl.lab.emc.com # Operation: EXPIRE selected snapups # After: "2018-05-01" (1525158000) Tue May 1 00:00:00 PDT 2018 # Before: "2018-05-15 " (1526367600) Tue May 15 00:00:00 PDT 2018 # ====================================================================== # MODIFY Snapup date: 2018-05-07 22:00:52 PDT Lab#: 498 Replicated: N/A echo running: "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 PDT Lab#: 497 Replicated: N/A echo running: "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<----------------------SNIP------------------8< . # CONSERVE Snapup date: 2018-06-25 22:00:41 PDT Lab#: 501 Replicated: 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-04-30 22:00:57 PDT Lab#: 491 Replicated: 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
Ejecución del script para modificar o eliminar respaldos
Se recomienda encarecidamente crear un punto de control antes de ejecutar este procedimiento.
Después de crear el script, revise el contenido cuidadosamente. Cuando esté satisfecho con las acciones que se van a llevar a cabo, configure el script para que sea ejecutable.
Por ejemplo, cree un script para eliminar todos los respaldos en /mydomain que tengan más de 6 meses.
Configure el script para que sea ejecutable y compruebe los permisos:
admin@utility:~/modsnap/>: chmod +x delete-backups-mydomain-before-6monthsago.txt admin@utility:~/modsnap/>: ls -l -rwx------ 1 admin admin 15016 Apr 17 18:55 delete-backups-mydomain-before-6monthsago.txt
Ejecute el script. Redirija la salida a otro archivo para registrar los cambios realizados.
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. Attribute Value ---------- -------------------------------------- path /mydomain/myclient.customer.com retention N labelnum 323 createtime 2014-09-25 18:07:04 IST plugin 3001
Si el script se ejecutó hasta completarse y se ejecuta por segunda vez, se muestra lo siguiente:
1,22552,Backup does not exist
Si el script tarda mucho tiempo en ejecutarse y se debe detener, se puede ejecutar por segunda vez. Para evitar volver a comprobar los respaldos eliminados anteriormente, edite el script manualmente para eliminar los comandos ya procesados. Como alternativa, vuelva a generar el script.
Generar y ejecutar el script puede tardar una cantidad significativa de tiempo. Es útil "dividir y conquistar" dividiendo el trabajo en períodos de tiempo más pequeños o dominios individuales.
Información adicional
Articulo #1
ls -ls /usr/local/avamar/bin/ | grep modify-snapups 0 lrwxrwxrwx 1 root root 14 Nov 28 19:42 delete-snapups -> modify-snapups 0 lrwxrwxrwx 1 root root 14 Nov 28 19:42 expire-snapups -> modify-snapups 24 -rwxr-xr-x 1 root root 24185 Sep 8 23:46 modify-snapups
El término "snapup" es una terminología obsoleta de Avamar que puede interpretarse como un respaldo. Es un híbrido de las palabras snapshot y backup.
Elemento #2
La documentación completa sobre cómo utilizar los modos de eliminación y vencimiento está disponible agregando --help al comando.
modify-snapups --mode=expire --help modify-snapups --mode=delete --help
Elemento #3
Tenga en cuenta el siguiente artículo.
- Artículo interno: 000191562 : Avamar: modify-snapups --domain no funciona según lo previsto y provoca que el script indique "NO SNAPUPS FOUND".
Consulte este video:
Productos afectados
AvamarProductos
Avamar, Avamar Client, Avamar ServerPropiedades del artículo
Número del artículo: 000058216
Tipo de artículo: Solution
Última modificación: 14 ene 2026
Versión: 10
Encuentre respuestas a sus preguntas de otros usuarios de Dell
Servicios de soporte
Compruebe si el dispositivo está cubierto por los servicios de soporte.