Zx Backup Item Restore/es

From ZeXtras Suite Wiki

Jump to: navigation, search
Idioma: English  • español • português
ZxBackup logo box.png
Available since version: 0.87
Latest Version: 2.12.2
Released on: January 2nd, 2019
Compatibility List
Admin Guide
FAQ
Troubleshooting
Backup Initialization
ZspBackup logo box.png

¿Qué es la restauración de objetos por ID?

Es uno de los modos de restauración de ZxBackup.

¿Cómo funciona?

Un único elemento es restaurado desde el store del backup hacia una cuenta. Con este método se puede recuperar cualquier tipo de elemento.

Recuperando elementos

A través del zimlet de Zextras

La recuperación de elementos solo es posíble a través de la línea de comandos.

A través de la línea de comandos

Para iniciar una restauración se utiliza el comando "doItemRestore":

Sintaxis:
   zxsuite backup doItemRestore {account_name} {item_id} [attr1 value1 [attr2 value2...]]

LISTA DE PARÁMETROS

NOMBRE                TIPO            
account_name(M)      Account Name    
item_id(M)           Integer         
restore_folder(O)    String          

(M) == parámetro obligatorio, (O) == parámetro opcional

Ejemplo de uso:

zxsuite backup doitemrestore john@example.com 4784
Restaura el elemento 4784 en la cuenta "john@example.com"

¿Cómo obtener el itemID?

El "itemID" es uno de los llamados "metadatos", que consiste en un código único que identifica un elemento en una cuenta.

Junto con otros metadatos, se almacena en un archivo dentro del directorio "items" de la propia cuenta en el datastore de ZeXtras Backup. La localización exacta de ese directorio es

  [backup path]/accounts/[accountID]/items/[últimos 2 elementos del itemID]/[itemID]

Ejemplo:

 Item 2057 de la cuenta 4a217bb3-6861-4c9f-80f8-f345ae2897b5, ruta por defecto
 /opt/zimbra/backup/zextras/accounts/4a217bb3-6861-4c9f-80f8-f345ae2897b5/items/57/2057


Los metadatos estan almacenados en un archivo de texto plano, por lo tanto se pueden usar herramientas tipo 'grep' y 'find' para buscar contenidos. Para ver los metadatos contenidos en un archivo en un formato mas legible se puede usar el comando `zxsuite backup getItem`:

Sintaxis:
   zxsuite backup getItem {account} {item} [attr1 value1 [attr2 value2...]]

LISTA DE PARÁMETROS

NOMBRE            TIPO               VALORES ESPERADOS          POR DEFECTO
account(M)        Account Name/ID                               
item(M)           Integer                                       
backup_path(O)    Path                                          /opt/zimbra/backup/zextras/
dump_blob(O)      Boolean            true|false                 false
date(O)           Date               dd/mm/yyyy hh:mm:ss|all    last

(M) == parámetro obligatorio, (O) == parámetro opcional

Ejemplo de uso:

zxsuite backup getitem a7300a00-56ec-46c3-9773-c6ef7c4f3636 1
Muestra elementos con id = 1 perteneciente a la cuenta a7300a00-56ec-46c3-9773-c6ef7c4f3636
zimbra@simone:~$ zxsuite backup getitem      

El comando getItem requiere más parámetros

Sintaxis:
   zxsuite backup getItem {account} {item} [attr1 value1 [attr2 value2...]]

LISTA DE PARÁMETROS

NOMBRE            TIPO               VALORES ESPERADOS          POR DEFECTO
account(M)        Account Name/ID                               
item(M)           Integer                                       
backup_path(O)    Path                                          /opt/zimbra/backup/zextras/
dump_blob(O)      Boolean            true|false                 false
date(O)           Date               dd/mm/yyyy hh:mm:ss|all    last

(M) == parámetro obligatorio, (O) == parámetro opcional

Ejemplo de uso:

zxsuite backup getitem a7300a00-56ec-46c3-9773-c6ef7c4f3636 1
Muestra el elemento con id = 1 perteneciente a la cuenta a7300a00-56ec-46c3-9773-c6ef7c4f3636

Ejemplo real

Supongamos que un usuario elimina un mensaje y este va a parar a la papelera...

 2013-07-18 15:22:01,495 INFO  [btpool0-4361://localhost/service/soap/MsgActionRequest]
[name=user@domain.com;mid=2538;oip=258.236.789.647;ua=zclient/7.2.4_GA_2900;] mailop - moving Message (id=339) to Folder Trash (id=3)

...y luego vacía la papelera

 2013-07-18 15:25:08,962 INFO  [btpool0-4364://localhost/service/soap/FolderActionRequest]
[name=user@domain.com;mid=2538;oip=258.236.789.647;ua=zclient/7.2.4_GA_2900;] mailbox - Emptying 9 items from /Trash,
removeSubfolders=true.

Mas tarde llama al administrador del servidor para recuperar el mail eliminado. Conociendo el itemID y la dirección de e-mail el administrador solo necesita ejecutar como usuario `zimbra`:

 zxsuite backup doItemRestore user@domain.com 339
Personal tools