Zx Backup Item Restore/pt

From ZeXtras Suite Wiki

Jump to: navigation, search
Língua: 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

O que é a Restauração de Elementos Individuais?

É um dos modos de restauração do módulo ZxBackup.

Como funciona?

Restaura um único elemento desde o store do backup para uma conta em particular. Com este método se pode recuperar qualquer tipo de elemento.

Recuperando elementos

A través do zimlet ZeXtras

A recuperação de elementos é somente possível a través da linha de comandos.

Através da linha de comandos

Para iniciar uma restauração se utiliza o comando "doItemRestore":

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

LISTA DE PARÂMETROS

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

(M) == parâmetro obrigatório, (O) == parámetro opcional

Exemplo de uso:

zxsuite backup doitemrestore john@example.com 4784
Restaura o elemento 4784 na conta "john@example.com"

Como obter o itemID?

O "itemID" é um dos chamados "metadados", que consiste em um côdigo único que identifica um elemento em uma conta.

Junto com outros metadados, se armazena em um arquivo dentro da pasta "itens" da propria conta no datastore de ZeXtras Backup. A localização exata dessa pasta é

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

Exemplo:

 Item 2057 da conta 4a217bb3-6861-4c9f-80f8-f345ae2897b5, caminho padrão
 /opt/zimbra/backup/zextras/accounts/4a217bb3-6861-4c9f-80f8-f345ae2897b5/items/57/2057


Os metadados estão armazenados em um arquivo de texto plano, pelo qual pé possível usar ferramentas tipo 'grep' e 'find' para buscar conteúdos. Para ver os metadados contidos em um arquivo no formato mais legível se pode usar o comando `zxsuite backup getItem`:

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

LISTA DE PARÂMETROS

NOME              TIPO               VALORES ESPERADOS          PADRÃO
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 obrigatório, (O) == parámetro opcional

Exemplo de uso:

zxsuite backup getitem a7300a00-56ec-46c3-9773-c6ef7c4f3636 1
Mostra elementos com id = 1 pertencente á conta a7300a00-56ec-46c3-9773-c6ef7c4f3636
zimbra@simone:~$ zxsuite backup getitem      

O comando getItem requer mais parámetros

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

LISTA DE PARÂMETROS

NOME              TIPO               VALORES ESPERADOS          PADRÃO
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 obrigatório, (O) == parámetro opcional

Exemplo de uso:

zxsuite backup getitem a7300a00-56ec-46c3-9773-c6ef7c4f3636 1
Mostra o elemento com id = 1 pertencente á conta a7300a00-56ec-46c3-9773-c6ef7c4f3636

Exemplo real

Suponhamos que um usuário apaga uma mensagem e vai parar na lixeira...

 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)

...e logo esvazia a lixeira:

 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.

Mais tarde chama o administrador do server para recuperar o email apagado. Conhecendo o itemID e o endereço de e-mail, o administrador somente precisa executar, como usuario `zimbra` o comando:

 zxsuite backup doItemRestore user@domain.com 339
Personal tools