CLI zmschedulebackup Network Edition only: Difference between revisions
No edit summary |
|||
(4 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{ | {{BC|Certified}} | ||
__FORCETOC__ | |||
<div class="col-md-12 ibox-content"> | |||
=CLI zmschedulebackup Network Edition only= | |||
{{KB|{{ZC}}|{{ZCS 8.6}}|{{ZCS 8.5}}|{{ZCS 8.0}}|}} | |||
{{WIP}}For the most recent information on this CLI, including syntax and description, see [https://www.zimbra.com/docs/ne/latest/administration_guide/wwhelp/wwhimpl/js/html/wwhelp.htm#href=860_admin_ne.Appendix_A%E2%80%82Command_Line_Utilities.html ZCS Administrator's Guide Network Edition > Appendix A Command-Line Utilities]. | |||
= | ==zmschedulebackup== | ||
This command is used to schedule backups and add the command to your cron table. Since Zimbra Collaboration 6.0 '''zmschedulebackup''' supports -u for uncompressed zip blob storage. | |||
The default schedule is as follows: | The default schedule is as follows: | ||
*Full backup, every Saturday at 1:00 a.m. (0 1 * * 6) | *Full backup, every Saturday at 1:00 a.m. (0 1 * * 6) | ||
Line 26: | Line 29: | ||
===Description=== | ===Description=== | ||
{|style="width:100%" border="1" cellpadding="5" cellspacing="0" | {|style="width:100%" border="1" cellpadding="5" cellspacing="0" | ||
! align="left" bgcolor="#0087c3" |Name | ! style="color:white;" align="left" bgcolor="#0087c3" |Name | ||
! align="left" bgcolor="#0087c3" |Command Name | ! style="color:white;" align="left" bgcolor="#0087c3" |Command Name | ||
! align="left" bgcolor="#0087c3"|Description | ! style="color:white;" align="left" bgcolor="#0087c3"|Description | ||
|- | |- | ||
| help | | help | ||
Line 151: | Line 154: | ||
*To display the existing schedules | *To display the existing schedules | ||
<pre>zmschedulebackup -q | |||
Current Schedule: | |||
f 0 1 * * 6 -a all --mail-report | |||
i 0 1 * * 0-5 --mail-report | |||
d 1m 0 0 * * * --mail-report</pre> | |||
*To display the schedules on one line as a command, so that they can be copied to a text file and saved to be used if the application needs to be restored. | *To display the schedules on one line as a command, so that they can be copied to a text file and saved to be used if the application needs to be restored. | ||
<pre>zmschedulebackup -s | |||
-a all --mail-report f "0 1 * * 6" | |||
--mail-report i "0 1 * * 0-5" | |||
--mail-report d 1m "0 0 * * *"</pre> | |||
=Related Articles= | =Related Articles= |
Latest revision as of 16:12, 11 July 2015
CLI zmschedulebackup Network Edition only
For the most recent information on this CLI, including syntax and description, see ZCS Administrator's Guide Network Edition > Appendix A Command-Line Utilities.
zmschedulebackup
This command is used to schedule backups and add the command to your cron table. Since Zimbra Collaboration 6.0 zmschedulebackup supports -u for uncompressed zip blob storage.
The default schedule is as follows:
- Full backup, every Saturday at 1:00 a.m. (0 1 * * 6)
- Incremental backup, Sunday through Friday at 1:00 a.m. (0 1 * * 0-5)
Each crontab entry is a single line composed of five fields separated by a blank space. Specify the fields as follows:
- minute — 0 through 59
- hour — 0 through 23
- day of month — 1 through 31
- month — 1 through 12
- day of week — 0 through 7 (0 or 7 is Sunday, or use names)
Type an asterisk (*) in the fields you are not using.
This command automatically writes the schedule to the crontab.
Syntax
zmschedulebackup {-q|-s|-A|-R|-F|-D}[f|i|d|] [“schedule”]
Description
Name | Command Name | Description |
---|---|---|
help | -h | Displays the usage options for this command. |
query | -q | Default command. Displays the existing Zimbra backup schedule. |
save | -s | Save the schedule. Allows you to save the schedule command to a text file so that you can quickly regenerate the backup schedule when the system is restored. |
flush | -F | Removes the current schedule and cancels all scheduled backups. |
append | -A | Adds an additional specified backup to the current schedule. |
replace | -R | Replaces the current schedule with the specified schedule. |
default | -D | Replaces the current schedule with the default schedule. |
Options that will be passed to zmbackup | ||
no compression | -n | Backs up blobs as individual files rather than in zip files |
compress | -z | Backs up blobs in compressed zip files. Ignored if --zipStore is specified. |
--zipStore | Backs up blobs in zip file without compression. | |
target | -t | Can be used only to designate a full back target location. The default is /opt/zimbra/backup. Note: You cannot designate a target for incremental backups. If a target (-t) location is added for incremental scheduled backups, it is ignored. |
account | -a | Account specific. The default is all accounts. |
--mail-report | Send an email report to the admin user. | |
--server | server - Mail server hostname. Default is localhost. | |
--sync | Runs full backup synchronously. | |
--excludeBlobs | Exclude blobs from full backup. If unspecified, server config is used. | |
--includeBlobs | Include blobs in full backup. If unspecified, the server config is used. | |
--excludeHsmBlobs | Exclude blobs on HSM volumes from full backup. If unspecified, the server config is used. | |
--includeHsmBlobs | Include blobs on HSM volumes in full backup. If unspecified, the server config is used. | |
--excludeSearchIndex | Exclude search index form full backup. If unspecified, the server config is used. | |
--includeSearchIndex | Include search index in full backup. If unspecified, the server config is used. | |
Cron schedule | backup-type: | |
incremental backup | i | |
full backup | f | Full backup |
delete | d <arg> | m|y) |
Examples
- To schedule the default full and incremental backup
zmschedulebackup -D
- To replace the existing schedule with a new schedule
zmschedulebackup -R f [“schedule”]
- To add an additional full backup to the existing schedule
zmschedulebackup -A f [“schedule”]
- To add an additional incremental backup to the existing schedule
zmschedulebackup -A i [“schedule”]
- To display the existing schedules
zmschedulebackup -q Current Schedule: f 0 1 * * 6 -a all --mail-report i 0 1 * * 0-5 --mail-report d 1m 0 0 * * * --mail-report
- To display the schedules on one line as a command, so that they can be copied to a text file and saved to be used if the application needs to be restored.
zmschedulebackup -s -a all --mail-report f "0 1 * * 6" --mail-report i "0 1 * * 0-5" --mail-report d 1m "0 0 * * *"
Related Articles
- Zimbra Backup/Restore blog post -- contains more information on planning backup schedules and using the zmschedulebackup command.
- 5.0.x_Network_Edition_Backup_and_Restore