CLI - zmbackup Network Edition Only: Difference between revisions

m (wording per bug 28721 - now matches help & NE guide)
No edit summary
Line 112: Line 112:
|}
|}


<font size="3" color="#00007f" face="Arial"> '''  Examples  ''' </font>
 
===<font size="3" color="#00007f" face="Arial"> ''' Notes ''' </font>===
Resulting backup sessions make use of ''hard links'' to previous backup sessions to save space on the filesystem. Take this into account when performing tape backups and when foreseeing disk usage, eg.:
 
<pre>[zimbra@gw1a ~]$ cd /opt/zimbra/backup/sessions
[zimbra@gw1a sessions]$ du -sh full-20080805.101920.991
75G    full-20080805.101920.991
[zimbra@gw1a sessions]$ du -sh *full*
75G    full-20080801.230004.637
2.5G    full-20080805.101920.991
[zimbra@gw1a sessions]$ du -shl *full*
75G    full-20080801.230004.637
75G    full-20080805.101920.991</pre>
 
 
===<font size="3" color="#00007f" face="Arial"> '''  Examples  ''' </font>===


<font size="3" color="#000000" face="Arial"> In these examples, the server (-s) is ''' ''' <font size="2" face=""Courier New"">server1.domain.com</font>. The (-t) is not required if the target is the default directory, <font size="3" color="#000000" face=""Times New Roman"">'''(zimbra_home/backup'''</font>).</font>
<font size="3" color="#000000" face="Arial"> In these examples, the server (-s) is ''' ''' <font size="2" face=""Courier New"">server1.domain.com</font>. The (-t) is not required if the target is the default directory, <font size="3" color="#000000" face=""Times New Roman"">'''(zimbra_home/backup'''</font>).</font>

Revision as of 11:41, 5 August 2008

zmbackup

(Network Edition only)

This tool performs full backups and incremental backups for a designated mail host. You can either specify specific accounts, or, if no accounts are specified, all accounts are included.

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, -fb is the same as --fullBackup.

Syntax

One of -f, -i, or -del must be specified.

zmbackup {-f | -i | del} -acct (account) [options]

Description

Long Name

Short Name

Description

--fullBackup

-f

Starts a full backup.

-- incrementalBackup

-i

Starts an incremental backup.

--account

-a

Specifies the account email addresses. Separate accounts with a blank space. Enter all to backup all accounts. Required.

--delete

-del

< label|date > Deletes the backups including and prior to the specified label/date.

Common Options

--fullBackup

-f

Starts full backup.

--incrementalBackup

-i

Starts incremental 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.

--sync

-sync

Runs full backup synchronously.

--target

-t

<arg> Specifics the target backup location. The default is <zimbra_home>/backup.

--zip

-z

Zips email blobs in backup.

--help

-h

Displays the usage options for this command.


Notes

Resulting backup sessions make use of hard links to previous backup sessions to save space on the filesystem. Take this into account when performing tape backups and when foreseeing disk usage, eg.:

[zimbra@gw1a ~]$ cd /opt/zimbra/backup/sessions
[zimbra@gw1a sessions]$ du -sh full-20080805.101920.991
75G     full-20080805.101920.991
[zimbra@gw1a sessions]$ du -sh *full*
75G     full-20080801.230004.637
2.5G    full-20080805.101920.991
[zimbra@gw1a sessions]$ du -shl *full*
75G     full-20080801.230004.637
75G     full-20080805.101920.991


Examples

In these examples, the server (-s) is server1.domain.com. The (-t) is not required if the target is the default directory, (zimbra_home/backup).

Perform a full backup of all mailboxes on server1.

zmbackup -f -a all -s server1.domain.com

Perform incremental backup of all mailboxes on server1 since last full backup.

zmbackup -i -a all -s server1.domain.com

Perform full backup of only user1’s mailbox on server1. Note that hostname does not need full domain if account is used.

zmbackup -f -s server1 -a user1@domain.com

Perform incremental backup of user1’s mailbox on server1.

zmbackup -i -s server1 -a user1@domain.com

Jump to: navigation, search