


{"id":3676,"date":"2015-04-30T13:04:55","date_gmt":"2015-04-30T20:04:55","guid":{"rendered":"https:\/\/xmission.com\/blog\/?p=3676"},"modified":"2015-04-30T13:04:55","modified_gmt":"2015-04-30T20:04:55","slug":"zimbra-server-admin-tip-mailbox-password-migration-and-server-settings-comparison","status":"publish","type":"post","link":"https:\/\/xmission.com\/blog\/2015\/04\/30\/zimbra-server-admin-tip-mailbox-password-migration-and-server-settings-comparison","title":{"rendered":"Zimbra Server Admin Tip: Mailbox Password Migration and Server Settings Comparison"},"content":{"rendered":"<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/xmission.com\/blog\/wp-content\/uploads\/2015\/04\/zimbra-settings.png\" alt=\"zimbra-settings\" width=\"220\" height=\"220\" class=\"alignright size-full wp-image-3737\" srcset=\"https:\/\/xmission.com\/blog\/wp-content\/uploads\/2015\/04\/zimbra-settings.png 220w, https:\/\/xmission.com\/blog\/wp-content\/uploads\/2015\/04\/zimbra-settings-150x150.png 150w, https:\/\/xmission.com\/blog\/wp-content\/uploads\/2015\/04\/zimbra-settings-120x120.png 120w\" sizes=\"auto, (max-width: 220px) 100vw, 220px\" \/><\/p>\n<p class=\"p1\">Mail server administration is not easy. That is why, for over 8 years, XMission has provided\u00a0<a title=\"XMission Zimbra \" href=\"https:\/\/xmission.com\/zimbra\" target=\"_blank\">Zimbra Email &amp; Collaboration<\/a> services for thousands of businesses that don&#8217;t have the time and resources to manage their own mail server. We also sell <a title=\"XMission Zimbra Server Licensing - buy or lease\" href=\"https:\/\/xmission.com\/licensing\" target=\"_blank\">Zimbra server licensing<\/a> for those that do have the resources. This post will focus on the latter.<\/p>\n<p class=\"p1\">While your <a title=\"Zimbra licensing support.\" href=\"https:\/\/wiki.xmission.com\/Purchasing_Zimbra_Licensing_and_Support#Zimbra.com_Support\" target=\"_blank\">licensing support<\/a> is provided\u00a0directly from the support team at <a title=\"Zimbra Support\" href=\"https:\/\/zimbra.com\/support\" target=\"_blank\">Zimbra.com<\/a> we still get plenty of questions after the sale. The most common questions deal with user data migration, particularly on how to transfer user passwords, and how to compare settings from an old server to a new server when upgrading.<\/p>\n<p class=\"p1\">This post is a bit\u00a0more technical than most of our power tips, but will be very helpful for many Zimbra admins\u00a0looking to have a smooth transition. I&#8217;m assuming that the reader has working knowledge of Linux systems as well as some\u00a0experience with Zimbra servers. Throughout this post I will use &#8220;example.tld&#8221; in place of your domain name.<\/p>\n<p class=\"p1\">Let&#8217;s start with how to transfer\u00a0password credentials, because requiring an immediate password change at server transition time only fuels end-user anxiety and increases your workload.<\/p>\n<p class=\"p1\"><strong>USER PASSWORD\u00a0MIGRATION<\/strong><\/p>\n<p class=\"p1\"><span class=\"s1\">Admins often worry that they can&#8217;t transfer passwords between servers. Let me put your mind at ease: it is possible to transfer mailbox passwords from one Zimbra server to another. Now, relax, and I will explain how to do this.<\/span><\/p>\n<p class=\"p1\">Inside Zimbra, the password crypts are stored in the &#8220;userPassword&#8221; attribute\u00a0on an account. Crypts can be copied from one install to another to preserve\u00a0account passwords across Zimbra installations. Depending on the crypt format,\u00a0it&#8217;s also possible to use crypts from a non-Zimbra mail server. (This is a trick we use when migrating new hosted\u00a0Zimbra customers to our service from other\u00a0providers.)<\/p>\n<p>You can access crypts in the userPassword attribute via either the <a title=\"The zmprov tool from Zimbra.\" href=\"https:\/\/wiki.zimbra.com\/wiki\/Zmprov\" target=\"_blank\">zmprov tool<\/a> or\u00a0directly through Zimbra&#8217;s LDAP. Let&#8217;s discuss how to use zmprov. The attribute is accessed almost like any other account attribute, however,\u00a0it will only print the crypt when getting account information with &#8216;-l&#8217;.<\/p>\n<p class=\"p1\">The zmprov command-line tool performs all provisioning tasks in Zimbra LDAP, including creating accounts, aliases, domains, CoS, distribution lists, and calendar resources.<\/p>\n<p class=\"p1\">Here is an example command:<\/p>\n<pre class=\"code\">\r\nzimbra@oldserver:~# zmprov -l ga user@example.tld userPassword\r\n# name user@example.tld\r\nuserPassword: {SSHA}ZPyiP3Rt8OJHiwNgZJkhT\/0ZifRJdW+M\r\n<\/pre>\n<p>So the crypt for this user is &#8216;{SSHA}ZPyiP3Rt8OJHiwNgZJkhT\/0ZifRJdW+M&#8217;. You<br \/>\ncan transfer this user&#8217;s password to any other account by copying this crypt:<\/p>\n<pre class=\"code\" style=\"white-space: pre-wrap; background:#eee !important; background-image:transparent\">\r\nzimbra@newserver:~# zmprov ma user@example.tld userPassword '{SSHA}ZPyiP3Rt8OJHiwNgZJkhT\/0ZifRJdW+M'\r\n<\/pre>\n<p>Note that &#8216;-l&#8217; isn&#8217;t needed when *setting* the userPassword attribute.<\/p>\n<p>The zmprov tool supports piping commands into standard input, so you can actually create\u00a0a file with a list of commands to do mass changes. If the file looked like this:<\/p>\n<pre class=\"code\">\r\nma user1@example.tld userPassword '{SSHA}ZPyiP3Rt8OJHiwNgZJkhT\/0ZifRJdW+M'\r\nma user2@example.tld userPassword '{SSHA}4bha2xATPc35uz3QFp1CPLxhG9d2q8r8'\r\n<\/pre>\n<p>you could then pipe the file to zmprov, and set the passwords for both of these users.<\/p>\n<p class=\"p1\">Next up, how not to miss a critical detail.<\/p>\n<p class=\"p1\"><strong>COMPARING AN OLD SERVER TO NEW SERVER<\/strong><\/p>\n<p class=\"p1\">It can be useful to compare settings between the old server and the new server for any number of reasons. Some of the critical components you check may revolve around Class of Service (CoS) settings, backup schedules, or you may have critical settings around how LDAP is handled for your end users.<\/p>\n<p class=\"p1\">The following tools can be run from the command line\u00a0on the Zimbra server(s) to output data for easy review:<\/p>\n<p class=\"p1\" style=\"padding-left: 30px;\">\n<pre class=\"code\">zmlocalconfig<\/pre>\n<p><a title=\"Zimbra.com zmlocalconfig link\" href=\"https:\/\/wiki.zimbra.com\/wiki\/CLI_zmlocalconfig_(Local_Configuration)\" target=\"_blank\">Zimbra.com zmlocalconfig document<\/a><\/p>\n<pre class=\"code\">zmprov gs servername.example.tld<\/pre>\n<p><a title=\"Zimbra Zmprov link\" href=\"https:\/\/wiki.zimbra.com\/wiki\/Zmprov\" target=\"_blank\">Zimbra.com zmprov document<\/a><\/p>\n<p class=\"p1\"><span class=\"s1\">If all the mail accounts are migrated, you can<\/span><span class=\"s1\">\u00a0run the following<\/span>\u00a0command on both servers to get\u00a0mailbox size and message count for every account.<\/p>\n<p class=\"p1\">\n<pre class=\"code\">zmprov -l gaa | awk '{ print \"sm \" $1 }' | zmmailbox -z | egrep \"^mailbox\"<\/pre>\n<\/p>\n<p>Zimbra has a lot\u00a0of attributes,\u00a0so you will want to\u00a0use a\u00a0tool that\u00a0compares the contents of the two files, ie diff, such as\u00a0<a title=\"Vimdiff tool.\" href=\"http:\/\/vimcasts.org\/episodes\/comparing-buffers-with-vimdiff\/\" target=\"_blank\">vimdiff<\/a>. It prints all the lines, side-by-side, hides all that\u00a0are the same, and makes it very easy to go attribute-by-attribute checking for\u00a0differences.<\/p>\n<p>I hope you found this post useful. Please, share this post with your tech friends, co-workers, and social networks by clicking on the social media icons below.<\/p>\n<p>You can post any questions in the comments below and I\u00a0will respond.<\/p>\n<p>When you need <a title=\"Purchase Zimbra Licensing from XMission.\" href=\"https:\/\/xmission.com\/licensing\" target=\"_blank\">Zimbra licensing<\/a> for your on-site server, or are considering\u00a0<a title=\"Zimbra Professional Services from XMission\" href=\"http:\/\/xmission.com\/licensing#options\" target=\"_blank\">Zimbra Professional Services<\/a> to help with your install, please contact me for a quote.<\/p>\n<p><em><a title=\"Connect with me on LinkedIn, john801\" href=\"https:\/\/www.linkedin.com\/in\/john801\" target=\"_blank\">John Webster<\/a>, VP of Business Development and <a title=\"XMission Zimbra Email &amp; Collaboration\" href=\"https:\/\/xmission.com\/zimbra\" target=\"_blank\">Zimbra<\/a> Email Product Manager, has worked at <a title=\"Go, XMission!\" href=\"https:\/\/xmission.com\/\" target=\"_blank\">XMission<\/a> for over 19 years doing his favorite thing: helping companies communicate with\u00a0customers\u00a0through\u00a0technology to grow their\u00a0business. When he\u2019s not uncovering <a title=\"More Zimbra tips from John\" href=\"http:\/\/xmission.com\/blog\/?s=zimbra&amp;searchsubmit=Search\" target=\"_blank\">Zimbra\u2019s secrets<\/a>\u00a0you might find him in our beautiful Utah mountains. \u00a0<a title=\"Connect with me on LinkedIn, john801\" href=\"https:\/\/www.linkedin.com\/in\/john801\" target=\"_blank\">Connect with him on LinkedIn today!<\/a><\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Mail server administration is not easy. That is why, for over 8 years, XMission has provided\u00a0Zimbra Email &amp; Collaboration services for thousands of businesses that don&#8217;t have the time and resources to manage their own mail server. We also sell Zimbra server licensing for those that do have the resources. This post will focus on [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[449,253,255,376,180,397,396,310,352,130,5,399,398,39],"tags":[457,456,501],"class_list":["post-3676","post","type-post","status-publish","format-standard","hentry","category-collaboration","category-email-2","category-exchange-replacement","category-google-apps","category-hosting","category-licensing","category-mail-server","category-open-source","category-system-administration","category-tech","category-tips-helpful-information","category-value-added-reseller","category-var","category-zimbra","tag-administration","tag-email-admin","tag-zimbra"],"_links":{"self":[{"href":"https:\/\/xmission.com\/blog\/wp-json\/wp\/v2\/posts\/3676","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/xmission.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/xmission.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/xmission.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/xmission.com\/blog\/wp-json\/wp\/v2\/comments?post=3676"}],"version-history":[{"count":56,"href":"https:\/\/xmission.com\/blog\/wp-json\/wp\/v2\/posts\/3676\/revisions"}],"predecessor-version":[{"id":3738,"href":"https:\/\/xmission.com\/blog\/wp-json\/wp\/v2\/posts\/3676\/revisions\/3738"}],"wp:attachment":[{"href":"https:\/\/xmission.com\/blog\/wp-json\/wp\/v2\/media?parent=3676"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/xmission.com\/blog\/wp-json\/wp\/v2\/categories?post=3676"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/xmission.com\/blog\/wp-json\/wp\/v2\/tags?post=3676"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}