CLI zmmailboxmove Network Edition only: Difference between revisions

No edit summary
No edit summary
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==<font size="4" color="#00007f" face="Arial"> ''' zmmailboxmove (Move Mailbox) '''</font>==
{{BC|Certified}}
__FORCETOC__
<div class="col-md-12 ibox-content">
=CLI zmmailboxmove Network Edition only=
{{KB|{{ZC}}|{{ZCS 7.0}}|{{ZCS 6.0}}|}}
{{Archive}}{{WIP}}
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].


<font size="2">(Network Edition only)</font>
=ZCS 6.0.x=
==zmmailboxmove==
This command is used to move a mailbox from one Zimbra server to another. Mailboxes can be moved between Zimbra servers that share the same LDAP server. All the files are copied to the new server and LDAP is updated. After the mailbox is moved to a new server, a copy still remains on the older server, but the status of old mailbox is closed. Users cannot log on and mail is not delivered. You should check to see that all the mailbox contents were moved successfully before purging the old mailbox.


<font size="2" color="#000000" face="Arial">This command is used to move a mailbox from one Zimbra server to another. Mailboxes can be moved between Zimbra servers that share the same LDAP server. All the files are copied to the new server and LDAP is updated. After the mailbox is moved to a new server, a copy still remains on the older server, but the status of old mailbox is closed. Users cannot log on and mail is not delivered. You should check to see that all the mailbox contents were moved successfully before purging the old mailbox. </font>
===Syntax===
zmmailboxmove {-a <arg>} {-t <arg>|-po} [options]


===<font size="3" color="#00007f" face="Arial"> ''' Syntax ''' </font>===
===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>''' Email address of account to move
|-
|<nowiki>--help</nowiki>
|<nowiki>-h</nowiki>
|Shows the help for the usage options for this command
|-
|<nowiki>--overwriteMailbox</nowiki>
|<nowiki>-ow</nowiki>
|Overwrite target mailbox, if it exists
|-
|<nowiki>--purgeOld</nowiki>
|<nowiki>-po</nowiki>
|Purge old mailbox on previous server. After a mailbox has been successfully moved to a new server, perform '''purgeOld''' to remove the mailbox and its contents from the previous server.
|-
|<nowiki>--server</nowiki>
|<nowiki>-s</nowiki>
|'''<arg>''' Mail server hostname. The default is the localhost. Server where the <nowiki>--account</nowiki> mailbox is located.
|-
|<nowiki>--targetServer</nowiki>
|<nowiki>-t</nowiki>
|'''<arg>''' Server where mailbox is moved to Use -t option to move a mailbox from the current server to the new server specified by the option.
|-
|<nowiki>--authtokenfile</nowiki>
|<nowiki>-Y</nowiki>
|Use auth token string (has to be in JSON format) from command line
|-
|<nowiki>--authtoken</nowiki>
|<nowiki>-y</nowiki>
|Use auth token string (has to be in JSON format) from command line
|}


<font size="2" color="#000000" face="Arial"> To move a mailbox to a new server, type  </font>
===Examples===
In these examples, two separate command lines are used to move the mailbox and to purge the old mailbox. This is because -t and -po are mutually exclusive.


<font size="3" color="#000000" face="Arial">  <font size="3" color="#000000" face=""Times New Roman"">  '''zmmailboxmove -a <email@address> -ow -s <servername> -t <movetoservername>''' </font>  </font>
*To move a mailbox from the default server to the target server:


<font size="2" color="#000000" face="Arial"> To purge the mailbox from the old server, type </font>
zmmailboxmove -a user1@domain.com -t server2.domain.com


<font size="3" color="#000000" face=""Times New Roman""> '''  zmmailboxmove -a <email@address) -po.  ''' </font>
*To move a mailbox from the default server to the target server, while overwriting any existing mailbox for the account on the target server:


<font size="2" color="#000000" face="Arial"> The mailbox and its contents and references are deleted from the server. </font>
zmmailboxmove -a user1@domain.com -t server2.domain.com -ow


===<font size="3" color="#00007f" face="Arial"> ''' Description ''' </font>===
*To purge an old mailbox from the default server, after checking that the contents of the mailbox were successfully moved to the target server:


{| border="1" cellpadding="8"
zmmailboxmove -a user1@domain.com -po
|+
 
|-
 
| valign="middle" |
=ZCS 5.0.x=
<font size="3" color="#00007f" face="Arial"> ''' Long Name ''' </font>
*[http://www.zimbra.com/docs/ne/5.0.19/administration_guide/A_app-command-line.18.17.html#1268617 ZCS Administrator's Guide Network Edition 5.0 > Appendix A Command-Line Utilities > zmmailboxmove]
| valign="middle" |
 
<font size="3" color="#00007f" face="Arial"> ''' Short Name''' </font>
=ZCS 4.5.x=
| valign="middle" |
*[http://www.zimbra.com/docs/ne/4.5.10/administration_guide/A_app-command-line.14.12.html#1173914 ZCS Administrator's Guide Network Edition 4.5 > Appendix A Command-Line Utilities > zmmailboxmove]
<font size="3" color="#00007f" face="Arial"> ''' Description ''' </font>
 
|-
 
| valign="top" |
{{Article Footer|ZCS 6.0|5/4/2006}}
<font size="3" color="#000000" face=""Times New Roman""> --account <arg> </font>
| valign="top" |
<font size="3" color="#000000" face=""Times New Roman""> -a </font>
| valign="top" |
<font size="3" color="#000000" face="Arial"> Email address of account to move. </font>
|-
| valign="top" |
<font size="3" color="#000000" face=""Times New Roman""> --overwriteMailbox </font>
| valign="top" |
<font size="3" color="#000000" face=""Times New Roman""> -ow </font>
| valign="top" |
<font size="3" color="#000000" face="Arial"> Overwrite target mailbox, if it exists. </font>
|-
| valign="top" |
<font size="3" color="#000000" face=""Times New Roman""> --purgeOld </font>
| valign="top" |
<font size="3" color="#000000" face=""Times New Roman""> -po </font>
| valign="top" |
<font size="3" color="#000000" face="Arial"> Purge old mailbox on previous server. After a mailbox has been successfully moved to a new server, perform purgeOld to remove the mailbox and its contents from the previous server.</font>
|-
| valign="top" |
<font size="3" color="#000000" face=""Times New Roman""> --server <arg> </font>
| valign="top" |
<font size="3" color="#000000" face=""Times New Roman""> -s </font>
| valign="top" |
<font size="3" color="#000000" face="Arial"> Server where the --account mailbox is located. Mail server hostname. The default is the localhost.</font>
|-
| valign="top" |
<font size="3" color="#000000" face=""Times New Roman""> --targetServer <arg> </font>
| valign="top" |
<font size="3" color="#000000" face=""Times New Roman""> -t </font>
| valign="top" |
<font size="3" color="#000000" face="Arial"> Server where mailbox is moved to. </font>
|}


'''-t''' and '''-po''' options are mutually exclusive. Use '''-t''' option to move a mailbox from the current server to the new server specified by the option. If '''-ow''' is specified, when a mailbox already exists for the target server, it is overwritten. After successfully moving the mailbox, use '''-po''' option to purge the old mailbox on the original server.
[[Category:Command Line Interface]]
[[Category:ZCS 7.0]]
[[Category:ZCS 6.0]]

Latest revision as of 16:02, 11 July 2015

CLI zmmailboxmove Network Edition only

   KB 1506        Last updated on 2015-07-11  




0.00
(0 votes)

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

zmmailboxmove

This command is used to move a mailbox from one Zimbra server to another. Mailboxes can be moved between Zimbra servers that share the same LDAP server. All the files are copied to the new server and LDAP is updated. After the mailbox is moved to a new server, a copy still remains on the older server, but the status of old mailbox is closed. Users cannot log on and mail is not delivered. You should check to see that all the mailbox contents were moved successfully before purging the old mailbox.

Syntax

zmmailboxmove {-a <arg>} {-t <arg>|-po} [options]

Description

Long Name Short Name Description
--account -a <arg> Email address of account to move
--help -h Shows the help for the usage options for this command
--overwriteMailbox -ow Overwrite target mailbox, if it exists
--purgeOld -po Purge old mailbox on previous server. After a mailbox has been successfully moved to a new server, perform purgeOld to remove the mailbox and its contents from the previous server.
--server -s <arg> Mail server hostname. The default is the localhost. Server where the --account mailbox is located.
--targetServer -t <arg> Server where mailbox is moved to Use -t option to move a mailbox from the current server to the new server specified by the option.
--authtokenfile -Y Use auth token string (has to be in JSON format) from command line
--authtoken -y Use auth token string (has to be in JSON format) from command line

Examples

In these examples, two separate command lines are used to move the mailbox and to purge the old mailbox. This is because -t and -po are mutually exclusive.

  • To move a mailbox from the default server to the target server:
zmmailboxmove -a user1@domain.com -t server2.domain.com
  • To move a mailbox from the default server to the target server, while overwriting any existing mailbox for the account on the target server:
zmmailboxmove -a user1@domain.com -t server2.domain.com -ow
  • To purge an old mailbox from the default server, after checking that the contents of the mailbox were successfully moved to the target server:
zmmailboxmove -a user1@domain.com -po


ZCS 5.0.x

ZCS 4.5.x


Verified Against: ZCS 6.0 Date Created: 5/4/2006
Article ID: https://wiki.zimbra.com/index.php?title=CLI_zmmailboxmove_Network_Edition_only Date Modified: 2015-07-11



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search