CLI zmrestore Network Edition only: Difference between revisions
No edit summary |
No edit summary |
||
(27 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
{{BC|Certified}} | |||
__FORCETOC__ | |||
<div class="col-md-12 ibox-content"> | |||
=CLI zmrestore Network Edition= | |||
{{KB|{{ZC}}|{{ZCS 10.0}}|{{ZCS 9.0}}|{{ZCS 8.0}}|{{ZCS 7.0}}|{{ZCS 6.0}}|}} | |||
{{WIP}} | |||
The CLI command zmrestore is available only on ZCS Network Edition. For the most recent information on this CLI, including syntax and description, see [http://www.zimbra.com/docs/ne/latest/administration_guide/A_app-command-line.20.1.html ZCS Administrator's Guide Network Edition > Appendix A Command-Line Utilities]. | |||
=ZCS 6.0.x= | |||
*[http://bugzilla.zimbra.com/show_bug.cgi?id=31824 Bug 35278] - Beginning in ZCS 6.0, a new option '''--skipDeletes''' has been added to zmrestore. If specified, zmrestore skips over deleted operations during replay. | |||
==zmrestore== | |||
This tool performs full restores and incremental restores for a designated mail host. You can either specify specific accounts, or, if no accounts are specified, all accounts are in the backup are restored. In addition, you can restore to a specific point in time. | |||
This utility has short option names and full names. The short option is preceded by a single dash, the full option is proceeded by a double dash. For example, '''-rf''' is the same as '''--restorefullBackupOnly'''. | |||
===Syntax=== | |||
zmrestore [options] | |||
===Description=== | |||
{|style="width:100%" border="1" cellpadding="5" cellspacing="0" | |||
< | ! align="left" bgcolor="tan" |Long Name | ||
! align="left" bgcolor="tan" |Short Name | |||
< | ! align="left" bgcolor="tan"|Description | ||
|- | |||
< | |style="background=white" |<nowiki>--account</nowiki> | ||
|<nowiki>-a</nowiki> | |||
|'''<arg>''' Specifies the account email addresses. Separate accounts with a blank space or type '''all''' to restore all accounts. | |||
| | |- | ||
|<nowiki>--backedupRedologs Only</nowiki> | |||
|<nowiki>-br</nowiki> | |||
|Replays the redo logs in backup only, which excludes archived and current redo logs of the system | |||
|- | |||
|<nowiki>--continueOnError</nowiki> | |||
|<nowiki>-c</nowiki> | |||
|Continue to restore other accounts when an error occurs | |||
|- | |||
|<nowiki>--createAccount</nowiki> | |||
|<nowiki>-ca</nowiki> | |||
|Restores accounts to target accounts whose names are prepended with prefix. (Can only be used in commands that use the '''<nowiki>-pre</nowiki>''' option.) | |||
|- | |||
|<nowiki>--debug</nowiki> | |||
|<nowiki>-d</nowiki> | |||
|Display diagnostics for debugging purposes | |||
|- | |- | ||
| | |<nowiki>--help</nowiki> | ||
< | |<nowiki>-h</nowiki> | ||
| | |Displays the usage options for this command | ||
< | |||
| | |||
|- | |- | ||
| | |<nowiki>--ignoreRedoErrors</nowiki> | ||
|<nowiki></nowiki> | |||
| | |If true, ignore all errors during redo log replay | ||
| | |||
|- | |- | ||
| | |<nowiki>--label</nowiki> | ||
|<nowiki>-lb</nowiki> | |||
| | |'''<arg>''' The label of the full backup to restore. Restores to the latest full backup if this is omitted. | ||
|- | |- | ||
| | |<nowiki>--prefix</nowiki> | ||
|<nowiki>-pre</nowiki> | |||
| | |'''<arg>''' The prefix to pre-pend to the original account names | ||
|- | |- | ||
| | |<nowiki>--restoreAccount</nowiki> | ||
< | |<nowiki>-ra</nowiki> | ||
| | |Restores the account in directory service | ||
< | |||
| | |||
|- | |- | ||
| | |<nowiki>-restoreToIncrLabel</nowiki> | ||
< | |<nowiki></nowiki> | ||
| | |'''<arg>'''Replay redo logs up to and including this incremental backup | ||
< | |||
| | |||
< | |||
|- | |- | ||
| | |<nowiki>-restoreToRedoSeq</nowiki> | ||
< | |<nowiki></nowiki> | ||
| | |'''<arg>''' Replay up to and including this redo log sequence | ||
< | |||
| | |||
< | |||
|- | |- | ||
| | |<nowiki>-restoreToTime</nowiki> | ||
< | |<nowiki></nowiki> | ||
| | |'''<arg>''' Replay rodo logs until this time | ||
< | |||
| | |||
< | |||
|- | |- | ||
| | |<nowiki>--restorefullBackup Only</nowiki> | ||
< | |<nowiki>-rf</nowiki> | ||
| | |Restores to the full backup only, not any incremental backups since that backup. | ||
< | |||
| | |||
|- | |- | ||
| | |<nowiki>--server</nowiki> | ||
< | |<nowiki>-s</nowiki> | ||
| | |'''<arg>''' Mail server host name. For format, use either the plain host name or the server.domain.com name. The default is the localhost name. | ||
< | |||
| | |||
|- | |- | ||
| | |<nowiki>--skipDeletes</nowiki> | ||
< | |<nowiki></nowiki> | ||
|If true, do not execute delete operation during redo log replay. See http://bugzilla.zimbra.com/show_bug.cgi?id=31824#c5 on what delete operations are. | |||
|- | |- | ||
| | |<nowiki>--skipDeletedAccounts</nowiki> | ||
< | |<nowiki></nowiki> | ||
| | |Do not restore if named accounts were deleted or did not exist at backup time. (This option is always enabled with '''<nowiki>-a all</nowiki>''') | ||
|- | |- | ||
| | |<nowiki>--systemData</nowiki> | ||
|<nowiki>-sys</nowiki> | |||
| | |Restores global tables and local config | ||
| | |||
|- | |- | ||
| | |<nowiki>--target</nowiki> | ||
|<nowiki>-t</nowiki> | |||
| | |'''<arg>''' Specifies the backup target location. The default is <zimbra_home>/backup. | ||
< | |||
|} | |} | ||
===Examples=== | |||
*Perform complete restore of all accounts on '''server1''', including last full backup and any incremental backups since last full backup. | |||
zmrestore -a all -s server1.domain.com | |||
*Perform restore only to last full backup, excluding incremental backups since then, for all accounts on '''server1'''. | |||
zmrestore -rf -a all -s server1.domain.com | |||
*Create a new account from a backup of the target account. The name of the new account will be new_user1@domain.com. | |||
zmrestore -a user1@domain.com -ca -pre new_ | |||
=ZCS 5.0= | |||
*[http://www.zimbra.com/docs/ne/5.0.19/administration_guide/A_app-command-line.18.13.html ZCS Administrator's Guide Network Edition 5.0 > Appendix A Command-Line Utilities > zmrestore] | |||
*[[5.0.x Network Edition Backup and Restore]] | |||
=ZCS 4.5= | |||
*[http://www.zimbra.com/docs/ne/4.5.10/administration_guide/A_app-command-line.14.8.html#1173605 ZCS Administrator's Guide Network Edition 4.5 > Appendix A Command-Line Utilities > zmrestore] | |||
*[http://www.zimbra.com/docs/ne/4.5.10/administration_guide/10_Backup_Restore.13.1.html 4.5 Backup and Restore Documentation] | |||
=Related Articles= | |||
*[[:Category:Backup and Restore]] | |||
*[[:Category:Disaster_Recovery]] | |||
*[http://www.zimbra.com/docs/ne/latest/administration_guide/10_Backup_Restore.17.01.html Latest Backup and Restore Documentation] | |||
*[[CLI_zmrestore_restoreToTime_Network_Edition_only|More information on the zmrestore restoreToTime option]] | |||
*[[Ajcody-Backup-Restore-Issues]] | |||
*[[Ajcody-Notes-Multi-Server-Restore-DR]] | |||
{{Article Footer|Zimbra Collaboration|5/2/2006}} | |||
[[Category:Backup and Restore]] | |||
[[Category:Command Line Interface]] | |||
[[Category:ZCS 10.0]] | |||
[[Category:ZCS 9.0]] | |||
[[Category:ZCS 8.0]] | |||
[[Category:ZCS 7.0]] | |||
[[Category:ZCS 6.0]] |
Latest revision as of 13:30, 1 September 2022
CLI zmrestore Network Edition
The CLI command zmrestore is available only on ZCS Network Edition. For the most recent information on this CLI, including syntax and description, see ZCS Administrator's Guide Network Edition > Appendix A Command-Line Utilities.
ZCS 6.0.x
- Bug 35278 - Beginning in ZCS 6.0, a new option --skipDeletes has been added to zmrestore. If specified, zmrestore skips over deleted operations during replay.
zmrestore
This tool performs full restores and incremental restores for a designated mail host. You can either specify specific accounts, or, if no accounts are specified, all accounts are in the backup are restored. In addition, you can restore to a specific point in time.
This utility has short option names and full names. The short option is preceded by a single dash, the full option is proceeded by a double dash. For example, -rf is the same as --restorefullBackupOnly.
Syntax
zmrestore [options]
Description
Long Name | Short Name | Description |
---|---|---|
--account | -a | <arg> Specifies the account email addresses. Separate accounts with a blank space or type all to restore all accounts. |
--backedupRedologs Only | -br | Replays the redo logs in backup only, which excludes archived and current redo logs of the system |
--continueOnError | -c | Continue to restore other accounts when an error occurs |
--createAccount | -ca | Restores accounts to target accounts whose names are prepended with prefix. (Can only be used in commands that use the -pre option.) |
--debug | -d | Display diagnostics for debugging purposes |
--help | -h | Displays the usage options for this command |
--ignoreRedoErrors | If true, ignore all errors during redo log replay | |
--label | -lb | <arg> The label of the full backup to restore. Restores to the latest full backup if this is omitted. |
--prefix | -pre | <arg> The prefix to pre-pend to the original account names |
--restoreAccount | -ra | Restores the account in directory service |
-restoreToIncrLabel | <arg>Replay redo logs up to and including this incremental backup | |
-restoreToRedoSeq | <arg> Replay up to and including this redo log sequence | |
-restoreToTime | <arg> Replay rodo logs until this time | |
--restorefullBackup Only | -rf | Restores to the full backup only, not any incremental backups since that backup. |
--server | -s | <arg> Mail server host name. For format, use either the plain host name or the server.domain.com name. The default is the localhost name. |
--skipDeletes | If true, do not execute delete operation during redo log replay. See http://bugzilla.zimbra.com/show_bug.cgi?id=31824#c5 on what delete operations are. | |
--skipDeletedAccounts | Do not restore if named accounts were deleted or did not exist at backup time. (This option is always enabled with -a all) | |
--systemData | -sys | Restores global tables and local config |
--target | -t | <arg> Specifies the backup target location. The default is <zimbra_home>/backup. |
Examples
- Perform complete restore of all accounts on server1, including last full backup and any incremental backups since last full backup.
zmrestore -a all -s server1.domain.com
- Perform restore only to last full backup, excluding incremental backups since then, for all accounts on server1.
zmrestore -rf -a all -s server1.domain.com
- Create a new account from a backup of the target account. The name of the new account will be new_user1@domain.com.
zmrestore -a user1@domain.com -ca -pre new_
ZCS 5.0
- ZCS Administrator's Guide Network Edition 5.0 > Appendix A Command-Line Utilities > zmrestore
- 5.0.x Network Edition Backup and Restore
ZCS 4.5
- ZCS Administrator's Guide Network Edition 4.5 > Appendix A Command-Line Utilities > zmrestore
- 4.5 Backup and Restore Documentation
Related Articles
- Category:Backup and Restore
- Category:Disaster_Recovery
- Latest Backup and Restore Documentation
- More information on the zmrestore restoreToTime option
- Ajcody-Backup-Restore-Issues
- Ajcody-Notes-Multi-Server-Restore-DR