ZNG Restore Deleted Account: Difference between revisions
(Created page with "= Restore Deleted Account [ZNG]= {{KB|{{ZC}}|{{ZCS 8.8}}|}} {{WIP}} == What is the Restore Deleted Account? == The Restore Deleted Account procedure allows you to restore a...") |
No edit summary |
||
(3 intermediate revisions by the same user not shown) | |||
Line 6: | Line 6: | ||
The Restore Deleted Account procedure allows you to restore a the contents and preferences of a mailbox as it was when said mailbox was deleted, in a completely new account. | The Restore Deleted Account procedure allows you to restore a the contents and preferences of a mailbox as it was when said mailbox was deleted, in a completely new account. | ||
== How does it work? == | == How does it work? == | ||
When a Restore Deleted Account starts a new account is created (the Destination Account) and all the items existing in the Source Account at the moment of the deletion are | When a Restore Deleted Account starts a new account is created (the Destination Account) and all the items existing in the Source Account at the moment of the deletion are recreated in the Destination Account, including the folder structure and all the user’s data. All restored items will be created in the Current Primary Store unless the '''Obey HSM Policy''' box is checked. | ||
recreated in the Destination Account, including the folder structure and all the user’s data. All restored items will be created in the Current Primary Store unless the Obey HSM | |||
Policy box is checked. | |||
'''NOTE:''' When restoring data on a new account, shared items consistency is not preserved. This is because the original share rules refer to the original account’s ID, not to the restored one's. | |||
=== From the Backup NG tab on AdminConsole: === | |||
From the Backup NG tab on AdminConsole: | |||
* In the Left Pane of the Administration Console select `Backup NG to show up the Backup NG tab. | * In the Left Pane of the Administration Console select `Backup NG to show up the Backup NG tab. | ||
Line 27: | Line 19: | ||
* On the Top Bar push the Restore Deleted Account button. | * On the Top Bar push the Restore Deleted Account button. | ||
* Choose the restore date. Day/Month/Year can be selected via a | * Choose the restore date. Day/Month/Year can be selected via a mini calendar, the hour via a drop-down menu, minute and second via two text boxes. Click Next. | ||
* Browse the list and select the account to be restored (Source) by clicking on it. | * Browse the list and select the account to be restored (Source) by clicking on it. | ||
Line 33: | Line 25: | ||
* Enter the name of the new account (Destination) in the text box. You can then choose whether to Hide in GAL the new account or not. When you’re done choosing, press Next. | * Enter the name of the new account (Destination) in the text box. You can then choose whether to Hide in GAL the new account or not. When you’re done choosing, press Next. | ||
* Verify all your choice in the Operation Summary window. You can also add additional email addresses to be notified when the Restore operation is finished. | * Verify all your choice in the Operation Summary window. You can also add additional email addresses to be notified when the Restore operation is finished. Please notice that the Admin account and the User who started the Restore procedure are notified by default. | ||
* Click Finish to start the Restore. | |||
=== From Command Line: === | |||
'''Note:''' Here we are using "Restore on New Account" concept but destination (new account) is same as source (deleted account). | |||
Syntax: | |||
zxsuite backup doRestoreOnNewAccount {source_account} {destination_account} {"dd/MM/yyyy HH:mm:ss"|last} [attr1 value1 [attr2 value2... | |||
PARAMETER LIST: | |||
NAME TYPE EXPECTED VALUES | |||
source_account(M) Account Name | |||
destination_account(M) Account Name/ID | |||
date(M) Date `dd/MM/yyyy HH:mm:ss`|last | |||
restore_chat_buddies(O) Boolean true|false | |||
notifications(O) Email Address[,..] | |||
(M) == mandatory parameter, (O) == optional parameter | |||
$ zxsuite backup dorestoreonnewaccount testuser@example.com testuser@example.com last | |||
operationId 105eeec2-9050-42e5-be55-39f0751c2489 | operationId 105eeec2-9050-42e5-be55-39f0751c2489 | ||
server mail.example.com | server mail.example.com | ||
monitorCommand zxsuite backup monitor 105eeec2-9050-42e5-be55-39f0751c2489 | monitorCommand <span style="color:lime">zxsuite backup monitor 105eeec2-9050-42e5-be55-39f0751c2489</span> | ||
Above command will send notification to admin account, we can also check progress on CLI using '''monitorCommand'''. | |||
$ zxsuite backup monitor 105eeec2-9050-42e5-be55-39f0751c2489 | |||
-- | -- | ||
Item restored: 0 | Item restored: 0 | ||
== Notifications == | == Notifications == | ||
Subject: Backup Notification, Restore On New Account started. | Subject: Backup Notification, Restore On New Account started. | ||
Date: 04/09/2017 12:15:37 | Date: 04/09/2017 12:15:37 | ||
Level: Information | Level: Information | ||
Server: mail.example.com | Server: mail.example.com | ||
Text: | Text: | ||
This is an automated notification from ZxBackup about Restore On New Account. | This is an automated notification from ZxBackup about Restore On New Account. | ||
Operation Restore On New Account Started. | Operation Restore On New Account Started. | ||
Operation Id: 105eeec2-9050-42e5-be55-39f0751c2489 | Operation Id: 105eeec2-9050-42e5-be55-39f0751c2489 | ||
Operation Host: mail.example.com | Operation Host: mail.example.com | ||
Monitor Command: zxsuite backup monitor 105eeec2-9050-42e5-be55-39f0751c2489 | Monitor Command: zxsuite backup monitor 105eeec2-9050-42e5-be55-39f0751c2489 | ||
Operation requested by: zimbra | Operation requested by: zimbra | ||
Network Modules NG Version: 2.6.0 | Network Modules NG Version: 2.6.0 | ||
commit: bec07a87628088894229b51c16b67d72f7a8ffb1 | commit: bec07a87628088894229b51c16b67d72f7a8ffb1 | ||
Zal Version: 2.0.0 | Zal Version: 2.0.0 | ||
Zal commit: bec07a87628088894229b51c16b67d72f7a8ffb1 | Zal commit: bec07a87628088894229b51c16b67d72f7a8ffb1 | ||
Zimbra version: 8.8.2_GA_1822 20170809063438 20170809-0542 NETWORK | Zimbra version: 8.8.2_GA_1822 20170809063438 20170809-0542 NETWORK | ||
Source account: testuser@example.com | Source account: testuser@example.com | ||
Destination account: testuser@example.com | Destination account: testuser@example.com | ||
Subject: Backup Notification, Restore On New Account completed. | Subject: Backup Notification, Restore On New Account completed. | ||
Date: 04/09/2017 12:16:59 | Date: 04/09/2017 12:16:59 | ||
Level: Information | Level: Information | ||
Server: mail.example.com | Server: mail.example.com | ||
Text: | Text: | ||
This is an automated notification from ZxBackup about Restore On New Account. | This is an automated notification from ZxBackup about Restore On New Account. | ||
Operation Restore On New Account Completed. | Operation Restore On New Account Completed. | ||
Operation Id: 105eeec2-9050-42e5-be55-39f0751c2489 | Operation Id: 105eeec2-9050-42e5-be55-39f0751c2489 | ||
Operation Host: mail.example.com | Operation Host: mail.example.com | ||
The account testuser@example.com has been restored. | The account testuser@example.com has been restored. | ||
If experiencing problems with the consistency of its shares, run the 'doFixShares' command of the zxsuite CLI (`zxsuite help backup` for syntax and more | If experiencing problems with the consistency of its shares, run the 'doFixShares' command of the zxsuite CLI (`zxsuite help backup` for syntax and more information) as the zimbra user. | ||
- stats - | |||
Restored Items: 20 | |||
Skipped Items: 0 | |||
Unrestored Items: 0 | |||
Operation requested by: zimbra | |||
Network Modules NG Version: 2.6.0 | |||
commit: bec07a87628088894229b51c16b67d72f7a8ffb1 | |||
Zal Version: 2.0.0 | |||
Zal commit: bec07a87628088894229b51c16b67d72f7a8ffb1 | |||
Zimbra version: 8.8.2_GA_1822 20170809063438 20170809-0542 NETWORK | |||
Source account: testuser@example.com | |||
Destination account: testuser@example.com | |||
- parameters - | |||
from: testuser@example.com | |||
to: testuser@example.com | |||
date: last available | |||
hide in GAL: false | |||
additional notification mails: | |||
- stats - | - stats - | ||
items restored: 20 | |||
$ | |||
Latest revision as of 12:26, 28 September 2017
Restore Deleted Account [ZNG]
What is the Restore Deleted Account?
The Restore Deleted Account procedure allows you to restore a the contents and preferences of a mailbox as it was when said mailbox was deleted, in a completely new account.
How does it work?
When a Restore Deleted Account starts a new account is created (the Destination Account) and all the items existing in the Source Account at the moment of the deletion are recreated in the Destination Account, including the folder structure and all the user’s data. All restored items will be created in the Current Primary Store unless the Obey HSM Policy box is checked.
NOTE: When restoring data on a new account, shared items consistency is not preserved. This is because the original share rules refer to the original account’s ID, not to the restored one's.
From the Backup NG tab on AdminConsole:
- In the Left Pane of the Administration Console select `Backup NG to show up the Backup NG tab.
- On the Top Bar push the Restore Deleted Account button.
- Choose the restore date. Day/Month/Year can be selected via a mini calendar, the hour via a drop-down menu, minute and second via two text boxes. Click Next.
- Browse the list and select the account to be restored (Source) by clicking on it.
- Enter the name of the new account (Destination) in the text box. You can then choose whether to Hide in GAL the new account or not. When you’re done choosing, press Next.
- Verify all your choice in the Operation Summary window. You can also add additional email addresses to be notified when the Restore operation is finished. Please notice that the Admin account and the User who started the Restore procedure are notified by default.
- Click Finish to start the Restore.
From Command Line:
Note: Here we are using "Restore on New Account" concept but destination (new account) is same as source (deleted account).
Syntax:
zxsuite backup doRestoreOnNewAccount {source_account} {destination_account} {"dd/MM/yyyy HH:mm:ss"|last} [attr1 value1 [attr2 value2... PARAMETER LIST: NAME TYPE EXPECTED VALUES source_account(M) Account Name destination_account(M) Account Name/ID date(M) Date `dd/MM/yyyy HH:mm:ss`|last restore_chat_buddies(O) Boolean true|false notifications(O) Email Address[,..] (M) == mandatory parameter, (O) == optional parameter
$ zxsuite backup dorestoreonnewaccount testuser@example.com testuser@example.com last
operationId 105eeec2-9050-42e5-be55-39f0751c2489
server mail.example.com
monitorCommand zxsuite backup monitor 105eeec2-9050-42e5-be55-39f0751c2489
Above command will send notification to admin account, we can also check progress on CLI using monitorCommand.
$ zxsuite backup monitor 105eeec2-9050-42e5-be55-39f0751c2489 -- Item restored: 0 == Notifications == Subject: Backup Notification, Restore On New Account started. Date: 04/09/2017 12:15:37 Level: Information Server: mail.example.com Text: This is an automated notification from ZxBackup about Restore On New Account. Operation Restore On New Account Started. Operation Id: 105eeec2-9050-42e5-be55-39f0751c2489 Operation Host: mail.example.com Monitor Command: zxsuite backup monitor 105eeec2-9050-42e5-be55-39f0751c2489 Operation requested by: zimbra Network Modules NG Version: 2.6.0 commit: bec07a87628088894229b51c16b67d72f7a8ffb1 Zal Version: 2.0.0 Zal commit: bec07a87628088894229b51c16b67d72f7a8ffb1 Zimbra version: 8.8.2_GA_1822 20170809063438 20170809-0542 NETWORK Source account: testuser@example.com Destination account: testuser@example.com Subject: Backup Notification, Restore On New Account completed. Date: 04/09/2017 12:16:59 Level: Information Server: mail.example.com Text: This is an automated notification from ZxBackup about Restore On New Account. Operation Restore On New Account Completed. Operation Id: 105eeec2-9050-42e5-be55-39f0751c2489 Operation Host: mail.example.com The account testuser@example.com has been restored. If experiencing problems with the consistency of its shares, run the 'doFixShares' command of the zxsuite CLI (`zxsuite help backup` for syntax and more information) as the zimbra user. - stats - Restored Items: 20 Skipped Items: 0 Unrestored Items: 0 Operation requested by: zimbra Network Modules NG Version: 2.6.0 commit: bec07a87628088894229b51c16b67d72f7a8ffb1 Zal Version: 2.0.0 Zal commit: bec07a87628088894229b51c16b67d72f7a8ffb1 Zimbra version: 8.8.2_GA_1822 20170809063438 20170809-0542 NETWORK Source account: testuser@example.com Destination account: testuser@example.com - parameters - from: testuser@example.com to: testuser@example.com date: last available hide in GAL: false additional notification mails: - stats - items restored: 20 $